BlogCase StudiesLogin

Pixel via Google Tag Manager (GTM)

In this guide, you'll learn how to set up the Addressable Pixel using the Google Tag Manager.

If you don't have Google Tag Manager set up yet, please refer to Google's docs before continuing or consider another implementation path.

Enabled with the Addressable Pixel

Once set up, the following features become available:

  • User Insights — Insights into each of your users

  • Clear Reporting — In-Depth marketing & funnel reports

  • Campaign Details — Detailed attribution for paid campaigns

Getting Started — Required

Set up the Base Pixel

The following steps will walk you through setting up the base pixel on your website or platform. This will enable attribution and additional insights for each of your users. If you need any help, please let us know.

— Step 1 —

First, we need to get your Pixel ID for the next step

Follow These Steps:

  1. Log into Addressable and click Data Sources

  2. Select Addressable Pixel then click on Connect

  3. Copy the Pixel ID for the third step

  4. Either keep this page open or paste the ID somewhere else

— Step 2 —

Second, we need to add the official Community Template for the Addressable Pixel.

Follow These Steps:

  1. Log into Google Tag Manager

  2. Select the correct Account/Container

  3. On the left sidebar, click on Template

  4. Under Tag Templates, click the Search Gallery button

  5. Click on the Magnifying Glass icon (Search icon) on the top right of the side panel

  6. Search for Addressable Pixel and select it

  7. Click the Add to workspace button

  8. Click the Add button

— Step 3 —

Third, we need to configure the newly added template.

Follow These Steps:

  1. Back to Google Tag Manager, aka the tab from Step 1

  2. On the left sidebar, click on Tags

  3. Then click on New button

  4. Click Tag Configuration and select Addressable Pixel from the "Custom" section

  5. Paste your Pixel ID from Step 1.

  6. Make sure the following is set:

    1. Do not rename yet — it'll ask you when you save

    2. Make sure to keep "Standard" and "Pageview" selected under Event Name

    3. Leave "Mark as conversion event" as unchecked (do not check)

  7. Click Triggering (scroll down) and select All Pages under "Chose a trigger".

  8. Click Save.

  9. In the Rename Tab popup, enter Addressable - Page View — This is not required.

  10. Go back to Overview on the left sidebar

  11. Click Submit on the top right (blue button)

  12. Give the release clear name, such as Added Addressable Pixel

  13. Click Publish on the top right (blue button)

  14. Note: If your platform has Content Security Policy (CSP), you will need to configure our domains as well — If you're unsure, we're happy to help.

Congratulations 🎉

You successfully set up Page View and Wallet Connect events in Addressable.

Please allow up to 24 hours for these events to show up in our platform.

Debugging Details

(Advanced) This is only helpful if you're tech-savvy and running into issues.

  • You can see a live feed of event's logged by the Pixel every ~60 seconds.

  • This is also where you can access the Troubleshoot Tool as well.

  • You can log back into Addressable, click on Data Sources, click on View Events under Addressable Pixel, and go to the Raw Events tab.

Custom Events & Revenue — Advanced

For those who want additional insights and information within the Addressable Pixel, we allow you to set up and track Custom Events as well as Revenue.

Custom events enable more in your Addressable dashboard by helping you measure meaningful user actions, identify drop-off points, and track conversions more precisely across your funnel.

Jump to:

Setting up Custom Events

After setting up the Addressable Pixel, we recommend setting up custom events to better understand how users interact with your website or platform.

It's recommended to define at least one custom event as a conversion event to get deeper insight on those who complete the most impactful events.

Follow These Steps:

  1. Log into Google Tag Manager

  2. Select the correct Account/Container

  3. Go to Tags > New, and give your tag a descriptive name (such as "Addressable - Signing Up")

  4. Click Tag Configuration and select Addressable Pixel from the "Custom" section.

  5. Enter your Pixel ID — which can be found in Addressable by selecting Data Sources then Addressable Pixel then click on Connect.

  6. Under Event Name, select Custom.

  7. Name your custom event — such as "Signing Up", "Booking a Demo", or "Completing a Purchase"

    Important: This will be the name that you will see in the Addressable Dashboard

  8. If the event is a conversion, check the corresponding box.

    What is an conversion event?

    Any meaningful action that represents progress in your funnel. This can be events such as completing a signup, making a purchase, or submitting a lead form. These events are often used to measure the success of your campaigns or optimize ad targeting.

  9. Optionally, add Properties for added context

    1. Below the event type and name, you’ll see an Object Properties section.

    2. Click Add Row to define each property:

      1. Property Name → Use a clear name, such as "Amount" or "Transaction ID"

      2. Property Value → Select a dynamic variable defined in GTM using the brick icon.

    3. For more information on GTM's properties, see Google's docs.

  10. Click Save

  11. Click Submit and then Publish

Reminder: You do not need to manually configure a 'Wallet Connect' event — these events are tracked automatically when the pixel is installed across all pages.

Validate Your Configuration

For proper funnel configuration, please configure at least two events:

  1. Standard Page View event.

  2. At least one Custom Event with Conversion checked.

You can validate events are coming in through our dashboard, by selecting Data Sources then Addressable Pixel then click on View Events then click Raw Events.

Configure Revenue Reporting

Enabling Revenue Reporting enables ROI tracking, User-level revenue, ROAS for campaigns, and more.

Revenue tracking is sent using Custom Events and follow similar steps to any other event set up.

Events with revenue enabled still function the same as any other customer event but have this added feature. As such, a single event can serve a dual purpose for funnel tracking and revenue tracking.

Supported Transaction Type Examples

When configuring a custom event, you can send additional Properties, which Google Tag Manager calls "Object Properties". These are simply additional context sent along the event when it fires.

Transaction Type
Example Use Case
Required "Object Properties"

USD

  • Payments

  • Trading

  • Unique Transaction Identifier

  • Transaction Amount

Token

  • Stablecoin payments

  • DeFi interactions

  • Unique Transaction Identifier

  • Transaction Amount

  • Network/Chain ID

  • Token Contract Address

Native Token

  • Value transfer between wallets

  • Staking

  • Unique Transaction Identifier

  • Transaction Amount

  • Network/Chain ID

Foreign Currency Exchange

  • Converting EUR to USD

  • Unique Transaction Identifier

  • Transaction Amount

  • USD Exchange Rate (at time of transaction)

Follow These Steps:

  1. Log into Google Tag Manager

  2. Select the correct Account/Container

  3. Go to Tags > New, and give your tag a descriptive name (such as "Addressable - Signing Up")

  4. Click Tag Configuration and select Addressable Pixel from the "Custom" section.

  5. Enter your Pixel ID — which can be found in Addressable by selecting Data Sources then Addressable Pixel then click on Connect.

  6. Under Event Name, select Custom.

  7. Name your custom event — such as "Signing Up", "Booking a Demo", or "Completing a Purchase"

    Important: This will be the name that you will see in the Addressable Dashboard

  8. If the event is a conversion, check the corresponding box. It's safe to assume it is.

  9. Add the revenue Properties for added context:

    1. Below the event type and name, you’ll see an Object Properties section.

    2. Click Add Row to define each property:

      1. Property Name → Use a clear name, such as "Amount" or "Transaction ID"

      2. Property Value → Select a dynamic variable defined in GTM using the brick icon.

  10. Click Save

  11. Click Submit and then Publish

  12. Contact Addressable for final validation and configuration.

Don't forget to contact your Customer Service representative to ensure your revenue events are properly configured and everything is set up on our end.

Last updated

Was this helpful?