Only this pageAll pages
Powered by GitBook
1 of 44

Knowledge Base

welcome

Loading...

Solution Suite

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Integrations

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Event Tracking

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

APIs

Loading...

About Addressable

Addressable is the leading Web3 growth platform dedicated to revolutionizing digital marketing by bridging the gap between Web2 and Web3 and empowering Web3 companies with data-driven insights and user friendly marketing solutions to optimize strategies, enhance user acquisition, and drive sustainable growth.

Our solution suite provides advanced tooling for user aquisition, deep funnel attribution and optimized ad spend. By collecting and processing data from all user touch points, Addressable empowers marketers with actionable insights to drive growth, increase revenue, and lower customer acquisition costs (CAC).

Our platform's innovative approach allows our clients to plan and execute their growth strategies and measure success with unparalleled accuracy and ease.

Discover Addressable

Data Sources & Integrations

Find out which integrations you need to get started and leverage our advanced tools

Audience Builder

Create audiences you'd like to target, explore their characteristics, and track trends

Multi-Channel Targeting

Launch campaigns for your target audiences, track performance and gain insights

Insights & Analytics

Reveal the potential behind the data with our templated dashboards

Cover
Cover
Cover
Cover

Targeting

Addressable allows you to run campaigns across multiple channels such as social and programmatic display networks. All campaigns are created & managed under a single screen - Campaign management page.

Multi-Channel Targeting

Campaign Creation

Regardless of where you will be running your campaign, Addressable has streamlined the campaign creation process into three main steps; network selection, campaign setup and content upload. There are, however, slight variations for each channel:

Twitter (X) Ads campaign creation

Display campaign creation

Audiences

An audience is a group of users who share common attributes (behavior, location, interest, balance and so on). Audiences are based on user activities and characteristics, as opposed to targeting parameters which define when and where to deliver a promoted post or a banner.

You can create audiences in order to:

  • Explore the characteristics and behaviors of an interest group.

  • Target audiences across social platforms & display campaigns.

  • Analyze campaign results based on audience groups (for example, see which audiences your converted users fall under).

The Audience feature is composed of three parts:

  1. - An aggregated view of all your audiences in a single table.

  2. - A user segment builder where you create an audience by defining various rules and conditions.

  3. - This is where you explore the on/off-chain characteristics of your audience.

Audience Manager
Audience Builder
Audience Dashboard
Audience Dashboard

Metrics Glossary

This page provides a detailed overview of the key metrics tracked and analyzed within the Addressable platform. These metrics offer insights into user behavior, marketing performance, and technical attributes related to your campaigns and traffic.

Categories of metrics

Our metrics are divided into six categories:

  1. Marketing: Metrics focused on campaign performance and marketing channel attribution (e.g. "Conversion Rate", "Marketing Channel").

  2. User Attributes: Metrics related to user demographics and engagement (e.g. "Is Engaged Session", "Country").

  3. Technical Attributes: Metrics capturing technical details of user sessions (e.g. "Platform", "Browser Type").

  4. Web3: Metrics specific to blockchain interactions (e.g. "Wallet Address", "Blockchain Name").

  5. Attribution Fields: Metrics from the mid-attribution engine that identify traffic sources and campaign parameters (e.g. "First Session Source", "Session Referrer").

  6. Addressable Pixel Custom Properties: Metrics defined by you as properties for custom events in Google Tag Manager using our pixel. (See for further details)

Metric Name
Description

Note: Trends are calculated by comparing your selected timeframe to the preceding timeframe.

Number of users who visited your website or app and interacted with your content for at least 30 seconds, excluding identified bots.

Domain

The domain name of your visited website on which the pixel is installed.

URL Path

The specific path of the URL visited on the domain.

Event Name

The name of the event triggered during the session as configured in Google Tag Manager and tracked by the pixel.

Session Referrer

The source of traffic (e.g., referring domain) for the session, categorized under attribution fields.

Language

The detected language of the user, categorized under user attributes.

Browser Type

The type of browser used during the session, categorized as a technical attribute.

OS

The operating system of the user's device, categorized as a technical attribute.

Device Family

The type of device used (e.g. Desktop, Mobile, Tablet), categorized as a technical attribute.

Country

The country of origin of the user, categorized under user attributes.

First Session Source (utm_source)

The source (e.g., Google, Facebook) of the user's first session, as captured by UTM source parameter.

First Session Medium (utm_medium)

The type of traffic (e.g., CPC, organic) for the user's first session, as captured by UTM medium parameter.

First Session Campaign (utm_campaign)

The campaign name associated with the user's first session, as captured by UTM campaign parameter. Note that Addressable internal campaigns are stated under the "campaign name" metric.

First Session Searched Term (utm_term)

The search term used by the user to arrive at the website during their first session, as captured by UTM term parameter.

Session Ad Content (utm_content)

The specific ad content clicked during the session, as captured by UTM content parameter.

Blockchain

The blockchain network (e.g., Ethereum, Polygon) associated with the user's wallet as extracted by the pixel.

Is Conversion

Indicates whether the session resulted in a conversion event.

First Session Marketing Channel

The marketing channel associated with the user's first session, categorized under attribution fields.

Is Engaged Session

Indicates whether the session met engagement criteria, where the user interacted with your content for at least 30 seconds, excluding identified bots.

Marketing Channel

The attributed marketing channel for the session, categorized under marketing.

Source (utm_source)

The attributed source of the traffic for the user, categorized under marketing.

Medium (utm_medium)

The attributed medium of the traffic for the user (e.g., CPC, organic), categorized under marketing.

Campaign (utm_campaign)

The attributed campaign of the traffic for the user, categorized under marketing.

Searched Term (utm_term)

The attributed search term for the user, categorized under marketing.

Referrer

The referring URL attributed to the user, as determined by the attribution engine, categorized under marketing.

Display Inventory Domain

The domain of the website hosting the display ad, categorized as a technical attribute.

URL Query String

The query string parameters in the URL visited, categorized as a technical attribute.

Addressable Campaign Name

The name of the campaign within Addressable, categorized under marketing.

Is Wallet Owner

Indicates whether the user owns a blockchain wallet, even if not connected to your website, categorized under user attributes.

Social Network

The social network platform (e.g., Twitter, Facebook) associated with the session traffic source, categorized under marketing.

Wallet Provider

The wallet provider used by the user, (e.g MetaMask, Fantom) , categorized under Web3.

Advertiser Network

The advertising platform (e.g., Adform, Google) responsible for driving the user, categorized as a technical attribute.

Addressable Campaign ID

The unique identifier of the campaign within Addressable, categorized as a technical attribute.

Is Wallet Connected

Indicates whether the user's wallet was connected during the attribution window, categorized under marketing.

Display Banner

The banner used in a display ad, categorized as a technical attribute.

Platform

The platform used (e.g., desktop, mobile) during the session, categorized as a technical attribute.

Connected Wallets

Number of users who connected their wallet in the selected date range as automatically identified by the pixel.

Conversions

Number of converted users within the selected date range. Visit Event Manager screen to review what qualifies as a conversion event.

Conversion Rate

Number of converted users divided by the total engaged users who visited during the selected date range.

Description of metrics

Custom Events

Engaged Users

Insights & Analytics

Addressable's dashboard templates provide ready-to-use, customizable tools to quickly access the insights needed to enhance marketing strategies and drive results.

The template gallery provides a selection of out-of-the box dashboards. Simply click on 'Request a Dashboard', and we will customize the selected template to your business and particular points of interest.

User Radar

See how your user base is changing so you can spot opportunities and issues early.

User Radar

User Radar gives you a single place to understand who your users are and how they’re interacting with your product. It combines high-level trends with a detailed list of individual users so you can move smoothly from “what’s happening?” to “who is driving this?”

Use User Radar when you want to answer questions like:

  • How is my user base changing over time?

  • Which types of users are most active or most valuable?

  • Who are the users behind a specific trend, spike, or issue?

User Radar is made up of two main sections: User Overview and User Profiles.

The User Overview shows an aggregated view of your users.

It gives you a clear, high-level picture of:

  • How many users you have and how that’s changing over time

  • Key behavior and engagement metrics (for example, activity, conversions, or feature usage)

  • How different user groups compare to each other, based on the filters you choose

This is the best place to start when you want to spot patterns, monitor trends, or quickly check the health of your user base before drilling into specific users.

The User Profiles section is a table of individual users.

Each row represents a single user and typically includes:

  • Core identifiers (such as user ID, wallet, or email)

  • Key attributes (for example, country, device, or plan)

  • Activity summaries (such as first seen, last seen, and basic engagement)

You can search, sort, and filter this table to find specific users or groups of users that match your criteria. This is useful when you want to:

  • Investigate the users behind a spike or drop seen in the User Overview

  • Look up a specific user to understand their history and behavior

  • Build or refine segments based on real user patterns

On top of the Summary and Profile tab, you'll see a button called "Save As Audience", this button unlocks retargeting and prospecting for your users. When you save an audience, you have created a list of wallets that are ready for ads and insights.

To create an audience, apply some filters and have at least 100 total wallets and saving will be enabled.

A new audience can take up to 60 seconds to create, but once created, you can use this Audience in a new campaign to target these users and their lookalikes. You can also click the Audience name from the Audience page to see everything about this segment of users. Additional stats, what topics they're actively engaging on Twitter about, what holding they have, and what communities they're in.

User Overview

User Profiles

Functionality Overview

Save As Audience

chart-lineGo to User Overview
tableGo to User Profiles

Data Sources & Integrations

Addressable ingests and processes data across all user touch points to include:

  1. Engagement data from your sites and apps. Addressable supports a variety of methods to collect, process and present engagement data to best suite your business needs and set up (website, mobile and server to server APIs).

  2. Performance data from your social and programatic campaigns. Connect your Ad networks to allow Addressable to generate paid campaigns, track their performance over time and automatically optimize them to drive your goals.

  3. Full on-chain data of 7 EVM compatible blockchains; Avalanche, Arbitrum, Optimism, Polygon, Etherium, Base, Binance Smart Chain.

Together, these sources of data are the basis for user behaviour analysis & insights, market share, opportunities and trends, campaign optimization and impactful targeting.

Data Sources & Integrations

Twitter (X) Integration

When you integrate your Twitter (X) Ads account with Addressable, you can leverage Addressable audiences, optimization engine, insights and analytics to maximize the impact of your Twitter (X) paid ads. This integration enables you to:

  1. Target your Addressable audiences on Twitter (X).

  2. Configure and manage Twitter (X)-Ads campaigns directly from your Addressable account.

  3. Leverage Addressable's optimization engine to auto-optimize your campaign in accordance to your objective.

  4. Gain insights and advanced analytics about your audience and their user journeys.

Your X-ads account needs to be authorised by Twitter (X) to run paid ads campaigns. If your X account is halted, or you are experiencing difficulties in getting your account authorised and/or getting approved for particular geo-locations, contact our account team for assistance.

  1. Log in to your Twitter (X) Ads account

  2. Select 'Edit access to account' from the drop-down menu located at the top right corner of the screen

  3. Click 'Add access'

  4. Enter @addressableid in the left hand input field, select 'Ad Manager' in the right hand drop-down menu, select the "can compose promotable tweets" box and save changes

  1. Log into your Twitter (X) Ads account

  2. Click your Handle name › Business settings

  3. Go to Collaborator tab > People

  4. Click 'Invite people'

  • Copy your Ads Manager account number, located below your account name

  • Log into your Addressable account

  • Select the Campaign tab › Launch new campaign › X campaign

  • Enter your account number in the dedicated field and click 'Connect'

  • Select the 'Employee' permission level

  • Enter adrsbl@addressable.io › Invite

  • Once Addressable accepts the invite and is approved by Twitter (X) it is added to your Twitter (X) business account, but this entry must receive a role

  • Go to Accounts tab › Ads accounts › Add

  • Assign Addressable the 'Campaign Manager' role › Save

  • Copy the account ID

  • Log into your Addressable account

  • Select the Campaign tab › Launch new campaign › X campaign

  • Enter your account number in the dedicated field and click 'Connect'

  • Pre-requisites

    if you have a legacy Twitter (X) Business Ads account, please refer to the

    Twitter (X) Integration Guide

    Twitter (X) Business integration guide

    Twitter (X) Business integration guide

    AppsFlyer Integration

    When you integrate your AppsFlyer account, you can report Install events as well as other significant in-app events, to Addressable and leverage our campaign optimization, retargeting and advanced analytics.

    Reddit Integration

    Crypto businesses stand to gain significantly from Reddit's paid ads due to the platform's depth, community framework, and user engagement. There are approximately 20k highly engaged communities with 35M Redditors seeking and sharing crypto information and participating in various crypto discussions - offering an ideal environment for interactive and effective advertising. When advertising on Reddit, crypto businesses can tap into a passionate user base, ensuring their messaging resonates with a highly relevant and interested audience, fostering engagement and growth.

    Leveraging Addressable on Reddit

    When you integrate your Reddit advertising account with Addressable, you can leverage Addressable audiences, optimization, insights and analytics to maximize the impact of your Reddit paid ads.

    Reddit Integration Guide

    1. Log into your Reddit Ads account

    2. Select 'Account › Members' from the Dashboard drop down menu

    3. Enter adrsbl@addressable.io in the invite email field

    4. Assign Addressable the 'Creator' permission level and click 'Invite'

    Pixel via Google Tag Manager (GTM)

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

    Using the previous version of the template?

    If you're still using the older Addressable Pixel template (prior to Apr 15th 2026), see our to upgrade. Additionally, the is still available.


    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


    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.

    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 then click on

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

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

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

      NOTE: There is a 24 hour delay for the tool to show data in our system as completed.

    • You can log back into Addressable, click on Data Sources


    After setting up the base pixel, we recommend setting up additional events to better understand how users interact with your website or platform. Events enable more of your Addressable dashboard by helping you measure meaningful user actions, identify drop-off points, and track conversions more precisely across your funnel.

    Understanding Event Types

    Beyond the base PageView, there are three types of events you can set up. Think of them as three buckets:

    Type
    What It Is
    Example

    Use this when you want to explicitly track wallet connections from your own UI — for example, when a user connects via your app's wallet connect flow.

    1

    Follow These Steps:

    1. Log into

    2. Select the correct Account/Container

    Custom events let you track any action that matters to your funnel using a name you define. These are great for tracking specific steps or milestones that don't fit the suggested events.

    1

    Follow These Steps:

    1. Log into

    2. Select the correct Account/Container

    Revenue events let you track financial transactions — purchases, deposits, swaps — and tie them back to campaigns, users, and attribution. This enables ROI tracking, user-level revenue, ROAS for campaigns, and more in your Addressable dashboard.

    The template includes three pre-built revenue event types:

    Event Type
    When to Use

    For other revenue events (swaps, withdrawals, custom transactions), select (Custom Revenue Tracking) and define your own event name.

    Each revenue event requires a Transaction Type, which determines what additional fields are needed:

    Transaction Type
    Example Use Case
    Required Fields
    1

    Follow These Steps:

    1. Log into

    2. Select the correct Account/Container

    For proper funnel configuration, we recommend configuring at least:

    1. A PageView tag (the base pixel, firing on All Pages)

    2. At least one Event Tracking tag marked as a conversion

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

    User Properties let you attach additional data to a user's profile — such as their internal User ID, wallet address, email, or social handles. This enriches the identity data in your Addressable dashboard beyond what the pixel automatically detects.

    The template includes pre-built property types that Addressable automatically recognizes:

    Property
    What It Is
    1

    Follow These Steps:

    1. Log into

    2. Select the correct Account/Container

    If you need to send properties not included in the suggested list, select Custom under User Property Name and define your own key-value pairs in the table.

    The steps are the same as above, except you'll type in your own Property Name (e.g. "membership_tier", "signup_source") instead of selecting from a dropdown.

    Addressable Pixel

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

    The Addressable Pixel lets you track key actions on your website—like page views, signups, and wallet connections—and connect them to blockchain activity such as on-chain conversions.


    By setting up the Addressable Pixel and Custom Events, the following features become available depending your plan:

    • Campaign Manager – Understand visitor behavior, calculate ROAS, revenue tracking, and attribute conversions to your Paid Campaigns.

    User Radar — Understand your users, enriched with Web2 attribution and Web3 on-chain activities.

  • Marketing Report – Understand the effectiveness of all your marketing efforts, even if it's not through Addressable.


  • There are two primary ways to configure your Pixel:

    • Google Tag Manager (GTM) – A quick and easy install method (Recommended) — Go to Page

    • JavaScript Snippet (JS) – For adding the pixel directly to your website — Go to Page

    • Help Me Decide — If you're unsure, keep on reading — Jump to Section


    Use this option if any of the following are true (and is recommended):

    • You're already using Google Tag Manager

    • Your team has limited development resources

    • You want a fast and non-technical installation

    • Go to Page

    Use this option if any of the following are true:

    • You’re not using Google Tag Manager

    • You already have other tracking code set up in your codebase

    • You want full control over how and where the pixel is deployed

    • Go to Page

    If you're still not sure, please contact customer support


    If you run into issues, we're here to help. Here are some common issues and tools to help you along. If you still need anything, feel free to reach out.

    • If you have a CSP set up, you must also add us to your policy for our domains.

    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.

    Otherwise, contact customer support for help!

    Enabled By The Pixel

    Getting Started

    Configuration Options

    Note: Using both integrations together, in any capacities, is not supported or recommended.

    Help Me Decide

    When to use Google Tag Manager (GTM)

    When to use the Javascript SDK (JS)

    If you have a downloadable app — such as an iOS, Android, or Desktop — please contact us for additional help. Recommendations for these configurations are reviewed on a case by case to ensure accurate tracking within the Addressable Platform.

    Troubleshooting

    Content Security Policy (CSP)

    View Event Logs

    Connect
  • Copy the Pixel ID for the third step

  • Either keep this page open or paste the ID somewhere else

  • 2

    Add the Community Template

    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 Templates

    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

    3

    Configure the template and publish

    Third, we need to configure the newly added template.

    Follow These Steps:

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

    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. Under Tracking Mode, keep PageView (default) selected

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

    8. Click Save

    9. In the Rename Tag 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 a 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 as well — If you're unsure, we're happy to help.

    , click on
    View Events
    under Addressable Pixel, and go to the
    tab.

    Financial transactions you want to track — dollars (or tokens) in the platform. Always treated as conversions.

    "Purchase", "First Time Deposit", "Deposit"

    Go to Tags > New
  • Click Tag Configuration and select Addressable Pixel from the "Custom" section

  • Enter your Pixel ID

  • Under Tracking Mode, select Event Tracking

  • Under Choose Event Tracking Type, select Suggested Events

  • Under Event Type, select Wallet Connect (User Defined)

  • Enter the Wallet Address — use a GTM variable (click the brick icon) to dynamically pass the user's wallet address

  • Enter the Chain ID — the EVM chain ID (e.g. 1 for Ethereum Mainnet, 137 for Polygon)

    1. Set the appropriate Trigger for when this event should fire

    2. Click Save and name the tag (e.g. Addressable - Wallet Connect)

    3. Click Submit and then Publish

    Go to Tags > New
  • Click Tag Configuration and select Addressable Pixel from the "Custom" section

  • Enter your Pixel ID

  • Under Tracking Mode, select Event Tracking

  • Under Choose Event Tracking Type, select Custom

  • Enter your Event Name — choose an explicit and memorable name, as this is exactly what you'll see in the Addressable dashboard

    1. If this event represents a meaningful completion in your funnel, check Mark as conversion event

      When should I mark something as a conversion?

      A conversion is any action that represents meaningful progress, completing a signup, making a purchase, submitting a lead form, or reaching a key milestone. If you'd use it to measure campaign success, it's probably a conversion.

    2. Optionally, expand Additional Event Properties to send extra context with the event

      1. Click Add Row to define each property

      2. Property Name → Use a clear name, such as "plan_type" or "referral_source"

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

    3. Set the appropriate Trigger for when this event should fire

    4. Click Save and name the tag (e.g. Addressable - Started Checkout)

    5. Click Submit and then Publish

    • Value transfer between wallets

    • Staking

    • Unique Transaction Identifier

    • Transaction Amount

    • Chain ID

    Foreign Currency Exchange

    • Converting EUR to USD

    • Unique Transaction Identifier

    • Transaction Amount

    • USD Exchange Rate (Spot Rate)

    Go to Tags > New
  • Click Tag Configuration and select Addressable Pixel from the "Custom" section

  • Enter your Pixel ID

  • Under Tracking Mode, select Event Tracking

  • Under Choose Event Tracking Type, select Suggested Events

  • Under Event Type, select one of the following:

    • Purchase — for one-time payments or trades

    • First Time Deposit — for a user's first deposit

    • Deposit — for subsequent deposits

    • (Custom Revenue Tracking) — for any other revenue event (you'll also enter a custom Event Name)

  • Select the Transaction Type that matches your use case (see table above)

  • Fill in the required fields:

    • Unique Transaction Identifier — A unique string for each transaction (e.g. a blockchain tx hash, order number, or internal ID). This ensures each transaction is processed only once.

    • Transaction Amount — The total value of the transaction

  • Fill in any additional fields based on your transaction type:

    • Chain ID — The EVM chain ID (shown for Token Contract and Native Token types)

    • Token Contract Address — The smart contract address of the token (shown for Token Contract type only)

    • USD Exchange Rate (Spot Rate) — The exchange rate at the time of transaction (shown for Foreign Currency Exchange only)

    1. Set the appropriate Trigger for when this event should fire

    2. Click Save and name the tag (e.g. Addressable - Purchase)

    3. Click Submit and then Publish

    The user's X (Twitter) handle

    Telegram Handle

    The user's Telegram handle

    Go to Tags > New
  • Click Tag Configuration and select Addressable Pixel from the "Custom" section

  • Enter your Pixel ID

  • Under Tracking Mode, select User Properties

  • Under User Property Name, select Suggested

  • In the table, click Add Row:

    • Property Name → Select from the dropdown (e.g. User ID, Wallet Address, Email Address)

    • Property Value → Use a GTM variable (click the brick icon) to dynamically pass the value

  • Add as many rows as needed — you can send multiple properties at once

  • Set the appropriate Trigger for when this should fire (e.g. when a user is logged in)

  • Click Save and name the tag (e.g. Addressable - User Properties)

  • Click Submit and then Publish

  • Key Events

    Any notable action a user takes that signifies early progress toward your business goals. These help you understand behavior and measure engagement across your funnel.

    "Started Signup", "Downloaded App", "Viewed Pricing Page"

    Conversion Events

    The 1–3 end-goal actions that mean a user hit a business goal. These are what you'd use to measure campaign success.

    "Completed Registration", "Submitted Lead Form", "Completed Swap"

    Purchase

    One-time payments, trades, or purchases

    First Time Deposit (FTD)

    A user's first deposit — commonly used in gaming, DeFi, and exchanges

    Deposit

    Any subsequent deposit after the first

    United States Dollar (USD)

    • Payments

    • Trading

    • Unique Transaction Identifier

    • Transaction Amount

    Token Contract (Non-Native)

    • Stablecoin payments

    • DeFi interactions

    • Unique Transaction Identifier

    • Transaction Amount

    • Chain ID

    • Token Contract Address

    User ID

    Your platform's internal user identifier

    Wallet Address

    The user's blockchain wallet address

    Email Address

    The user's email

    Getting Started — Required

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

    Settings up the Base Pixel

    Get your Pixel ID

    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 or troubleshooter.

    Debugging Details

    Custom Events & Revenue Tracking — Recommended

    How these build on each other: Key events track progress. Conversions track success. Revenue tracks money. Start with key events, add conversions for the actions that matter most, and layer in revenue tracking when you need ROAS and ROI data.

    Not sure which events to set up? Your Addressable team can help you identify the right ones for your funnel.

    Wallet Connect Event (User Defined)

    Basic wallet connect events are already tracked automatically when the PageView pixel is installed. This suggested event is for when you want to track wallet connections from your own connect flow, with the specific wallet address and chain ID that you have access to.

    Configure a Wallet Connect event

    Setting up Key Events & Conversion Events

    Configure a custom event

    Setting up Revenue Tracking

    Revenue events are always treated as conversions. You don't need to check a separate conversion box, it's automatic.

    Suggested Revenue Events

    Supported Transaction Types

    Configure revenue tracking

    Validate Your Configuration

    Setting up User Properties

    User Properties don't fire as events in your funnel. They enrich the user's profile so you can identify and understand them better across the platform.

    Suggested User Properties

    Using Suggested Properties

    Configure suggested user properties

    Using Custom Properties

    Addressable Pixel
    Troubleshoot Tool
    Google Tag Manager
    Google Tag Manager
    Google Tag Manager
    Addressable Pixel
    Google Tag Manager
    Migration Guide
    previous setup guide

    Revenue Events

    Native Token

    X Handle

    Your Pixel ID is a 32-character code (e.g. a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4).

    You can always find it in Data Sources > Addressable Pixel > Connect.

    We use the standard for chain IDs. You can find a list of chain IDs at .

    Important: The event name you enter here will be the exact name shown in the Addressable dashboard. Choose something clear and consistent.

    Use GTM variables (click the brick icon) to dynamically pass values like transaction amount, transaction ID, and chain ID from your website's dataLayer.

    After setting up revenue tracking, contact your Addressable Customer Service representative to ensure your revenue events are properly configured on our end.

    Raw Events

    DEPRECATED: Pixel via Google Tag Manager

    Once set up, the following features become available:

    • User Insights — Insights into each of your users

    • Clear Reporting — In-Depth marketing & funnel reports

    configure our domains
    EIP-155
    chainlist.org
    Campaign Details — Detailed attribution for paid campaigns


    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

    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 as well — If you're unsure, we're happy to help.

    (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.


    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:

    • Custom Events

    • Revenue Reporting

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

    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 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"

    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:

    10. Click Save

    11. Click Submit and then Publish

    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.


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

    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

    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 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"

    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:

    10. Click Save

    11. Click Submit and then Publish

    12. Contact Addressable for final validation and configuration.

    This is the legacy version. If you're not using the previous version (prior to Apr 15th 2026), then please view the latest version, which can be found here.

    Enabled with the Addressable Pixel

    Getting Started — Required

    Set up the Base Pixel

    — Step 2 —

    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

    Custom Events & Revenue — Advanced

    Setting up Custom Events

    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:

    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

    Configure Revenue Reporting

    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

    Follow These Steps:

    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.

    Google Tag Manager Template - Migration Guide

    This guide covers how to upgrade from the previous Addressable Pixel template (v1) to the new version in Google Tag Manager. The process typically takes 10–15 minutes.

    The template was released and updated on Apr 15th, 2026. If you installed the template prior, you will need to do this migration, otherwise you can skip to the .

    The new template replaces the old Standard/Custom event selector with three Tracking Modes:

    • PageView — Same as before, tracks page views and automatic wallet connects

    Property Name → Use a clear name, such as "Amount" or "Transaction ID"
  • Property Value → Select a dynamic variable defined in GTM using the brick icon.

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

  • Property Name → Use a clear name, such as "Amount" or "Transaction ID"
  • Property Value → Select a dynamic variable defined in GTM using the brick icon.

  • 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)

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

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

    configure our domains
    Addressable Pixel
    Addressable Pixel

    Event Tracking — Suggested events (Registration, Wallet Connect, Purchase, FTD, Deposit) and custom events with built-in revenue fields

  • User Properties — New capability for enriching user profiles (User ID, wallet, email, social handles)

  • When you accept the template update in GTM:

    • The template fields update to the new version

    • Existing tags will show the new fields, but previous values (event name, conversion checkbox, object properties) will be cleared

    • You will need to reconfigure each tag

    Your Pixel ID, triggers, and historical data in Addressable are not affected.

    1

    Document your existing tags

    Open GTM and go to Tags. Most setups have 2–5 Addressable Pixel tags. For each one, record the following:

    • Tag name in GTM

    • Standard or Custom under Event Name

    • Event name (e.g. PageView, Lead, Purchase, Subscribe, or a custom name)

    • Whether Mark as conversion event was checked

    • Any Object Properties (name/value pairs)

    • The Trigger assigned to the tag

    A screenshot of each tag works fine.

    2

    Use the table below to understand how your existing configuration maps to the new template:

    Old Template (v1)
    New Template
    3

    Follow These Steps:

    • Log into

    • Select the correct Account/Container

    4

    Using your notes from Step 1 and the mapping from Step 2, update each tag:

    • Go to Tags on the left sidebar

    • Click on the tag to edit it

    5

    Once all tags are reconfigured:

    • Use GTM's Preview mode to verify each tag fires correctly

    • Go back to Overview on the left sidebar

    6

    After publishing, verify events are flowing correctly:

    • Log into Addressable and click Data Sources

    • Click View Events under Addressable Pixel

    For the full setup guide for the new template, see Pixel via Google Tag Manager (GTM). For the previous version's documentation, see Legacy (v1).

    Before You Start

    When did it change

    What changed

    proper docs

    What to expect

    Migration Steps

    Common Questions

    Will I lose historical data?

    No. Historical event data in Addressable is not affected. The template change only affects how future events are sent.

    Can I use the old and new template at the same time?

    No. GTM allows one version of a community template per workspace. Accepting the update applies to all tags using the template.

    I already accepted the update without documenting my tags.

    Your tags still exist — they just have empty configurations. Go to GTM's Version History (under Admin) to view previous published versions and see what your tags looked like before the update.

    Do I need to change my Pixel ID?

    No. Your Pixel ID stays the same. The new template validates the format more strictly (32-character hex string), but existing valid IDs are unaffected.

    I was sending revenue data using Object Properties.

    Use the new Suggested Events revenue types (Purchase, FTD, Deposit, or Custom Revenue Tracking). The template now has dedicated fields for Transaction ID, Amount, Chain ID, Token Contract Address, and Exchange Rate. See the in the setup guide.

    Additional Steps for Single Page Application (SPA)

    If your website is a Single-Page Application or Progressive Web App, you may need one additional step so PageView events are tracked on client-side navigations.

    This can apply to websites built with frameworks like React, Next.js, Vue, Nuxt, and Angular — specifically when the site uses client-side routing where the URL changes without a full page reload.

    When Is This Needed

    Use this if:

    • Your website uses client-side routing

    Why This Happens

    The Addressable Pixel tracks a PageView when the page loads. On SPAs, most navigations happen without a full reload, so only the first pageview is captured automatically.

    To track subsequent page changes, you need to trigger a PageView on each route change.

    Make sure the URL updates first and the PageView fires second. This ensures Addressable records the correct page_url for the new page.

    Also be careful not to send duplicate pageviews — this can happen if multiple triggers fire on the same route change, or if both GTM and JavaScript are sending the same event.


    Google Tag Manager (GTM)

    Use this section if your Addressable Pixel is installed through Google Tag Manager.

    The standard All Pages trigger only fires on full page loads. You need an additional trigger for soft navigations.

    1. Log into

    2. Select the correct Account/Container

    3. Go to your existing Addressable Pixel tag configured for PageView


    Use this section if your Addressable Pixel is installed using the JavaScript SDK.

    After each client-side route change, fire:

    Note: Make sure the URL has already updated before calling this. For example:

    Standard → Lead

    →

    Tracking Mode: Event Tracking → Custom → Event Name: "Lead"

    Standard → Purchase

    →

    Tracking Mode: Event Tracking → Suggested Events → Purchase

    Standard → Subscribe

    →

    Tracking Mode: Event Tracking → Custom → Event Name: "Subscribe"

    Custom → (any name)

    →

    Tracking Mode: Event Tracking → Custom → Event Name: (same name)

    Custom → with conversion checked

    →

    Tracking Mode: Event Tracking → Custom → (same name) + check Mark as conversion event

    Custom → with Object Properties for revenue

    →

    Tracking Mode: Event Tracking → Suggested Events → Purchase, FTD, or Deposit (with built-in revenue fields)

    No equivalent

    →

    Tracking Mode: User Properties (new capability)

    You should see a notification bar at the top indicating a template update is available — click View
  • Click on the Addressable Pixel entry

  • Review the changes, then click Accept update

  • If you don't see the update notification, go to Templates on the left sidebar, find Addressable Pixel under Tag Templates, click on it, and check for an update prompt.

    Your Pixel ID should still be populated
  • Set the correct Tracking Mode and fill in the fields according to the mapping table

  • Verify the Trigger is still correctly assigned

  • Click Save

  • Alternatively, you can delete the old tags and create new ones from scratch using the setup guide. The result is the same.

    Click Submit on the top right (blue button)
  • Give the release a clear name, such as Migrated to Addressable Pixel v2

  • Click Publish on the top right (blue button)

  • Go to the Raw Events tab

  • Confirm your events are showing up with the correct names and properties

  • Standard → PageView

    →

    Tracking Mode: PageView (default)

    Map your old tags to the new template

    Accept the template update

    Do not publish after this step. Accept the update, then reconfigure your tags in Step 4 before publishing. Publishing before reconfiguring will cause your live tags to send events without the correct configuration.

    Reconfigure each tag

    Test and publish

    Validate in Addressable

    Google Tag Manager
    Revenue Tracking section

    If you were previously using Object Properties to send revenue data (transaction ID, amount, etc.), switch to the Suggested Events revenue types in the new template. The fields are now built in — no need to manually type property names.

    Once validated, your migration is complete. Please allow up to 24 hours for events to fully populate in the dashboard.

    Add an additional trigger such as History Change or a custom dataLayer event
  • Make sure the trigger fires only once per route change

  • Use Preview mode to verify the tag fires correctly on soft navigations

  • Submit and Publish

  • The URL changes without a full page reload

  • You see the first pageview but not subsequent soft navigations

  • Follow These Steps

    If you are using GTM, do not also add a separate JavaScript implementation for the same pixel. Using both together is not supported and may result in duplicate events.

    JavaScript SDK (JS)

    Follow These Steps

    Please do not manually send a PageView for the initial page load as the base pixel already handles that. This method should only be used for soft navigations after the first load.

    Google Tag Manager
    window.__adrsbl.run('PageView', false);
    history.pushState({}, '', '/swap');
    window.__adrsbl.run('PageView', false);

    Content Security Policy (CSP)

    If your website uses a Content Security Policy (CSP), you’ll need to allow Addressable’s scripts and images to load properly.

    When Is This Needed

    Use this if:

    • You have CSP headers configured on your site

    Required CSP Directives

    To support Addressable and Adform tracking, update your CSP to include the following domains:

    For scripts:

    script-src
      https://*.adrsbl.io
      
    script-src-elem
      https://*.adrsbl.io
      
    connect-src
      https://*.adrsbl.io

    For images:

    img-src
      https://*.adrsbl.io
      https://*.adform.net;

    These rules ensure the Addressable Pixel and Adform integrations function correctly without CSP-related errors.

    If your policy uses a default-src directive with 'none', make sure to explicitly allow these sources in the appropriate directives above.

    Pixel via Javascript SDK (JS)

    In this guide, you'll learn how to set up the Addressable Pixel using the Javascript SDK.

    Once set up, the following features become available:

    • User Insights — Insights into each of your users

    • Clear Reporting — In-Depth marketing & funnel reports

    Addressable Event API

    In this guide, you'll learn how to set up the Event Tracking or Postback using the Events API.

    The Addressable Event API lets you track key actions on your platform—like page views, signups, and first time deposit—and set up proper attribution with or without the Addressable Pixel.


    By setting up the Addressable Events API, the following features become available depending your plan:

    • Campaign Manager – Understand visitor behavior, calculate ROAS, revenue tracking, and attribute conversions to your Paid Campaigns.

    Events API - Reference

    The Event's API, also know as the S2S (Server-to-Server) API is used in place of Pixel tracking when there's a 3rd party platforms/applications.

    In complex use cases, where the user journey includes 3rd party platforms/applications (e.g. Telegram chatbot, Mobile Sandboxed WebApp, Discord, Telegram games), the best way to report on user engagement and conversion events is directly from your server to your Addressable account using a secure API.

    The Addressable API has a request structured with the following fields:

    • An endpoint url:

    You see blocked requests in the browser console related to adrsbl.io or adform.net

    User Radar — Understand your users, enriched with Web2 attribution and Web3 on-chain activities.

  • Marketing Report – Understand the effectiveness of all your marketing efforts, even if it's not through Addressable.


  • Within this section you'll find a easy to follow guide and multiple detailed reference documents for the API and attribution setup.

    Step-by-Step (Recommended) Follow this guide for step-by-step instructions — Go to Guide

    Additional Reference:

    • Event API Docs — Go to Page

    • Event API Attribution Doc — Go to Page

    Enabled By The Event API

    Getting Started

    Campaign Details — Detailed attribution for paid campaigns


    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.

    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

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

    Follow These Steps:

    1. Copy the JavaScript Base Snippet below.

    2. Paste the script inside the <head> tag

      1. Importantly, this code needs to fire on every page across the website, app, and landing pages.

    3. Replace REPLACE_PIXEL_ID_HERE (Line 12) with your actual Pixel ID from Step 1.

    4. If your platform has Content Security Policy (CSP), you will need to as well — If you're unsure, we're happy to help.

    <!-- Addressable Pixel base code -->
    <script>
    !function(w, d){
        w.__adrsbl = {
            queue: [],
            run: function(){
                this.queue.push(arguments);
            }
        };
        var s = d.createElement('script');
        s.async = true;
        s.src = 'https://tag.adrsbl.io/p.js?tid=REPLACE_PIXEL_ID_HERE';
        var b = d.getElementsByTagName('script')[0];
        b.parentNode.insertBefore(s, b);
    }(window, document);
    </script>
    <!-- End Addressable Pixel base code -->

    • 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.


    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:

    • Custom Events

    • Revenue Reporting

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

    window.__adrsbl.run(event_name, is_conversion, properties)

    Parameters:

    • event_name (string) — A clear name of the event, displayed in Addressable

    • is_conversion (boolean) — Set to true if the event is a conversion; otherwise false

    • properties (optional array of objects) — Additional details and context about the event

    • Event Name: This is a clear name of the event that will be displayed in the Addressable Dashboard — for example "signup" or "download_app" .

    • Conversion Events: A conversion event is any meaningful action that represents progress in your funnel—such as completing a signup, starting a checkout, making a purchase.

    • Optional Properties: Each property is defined as an object with the keys of name and value. You can define up to 6 properties per event.

    This sends a purchase event, marks it as a conversion, and includes two properties:

    This sends a downloaded app event that is not a conversion, and one property without a value:

    This sends a primary click event, marks it as a conversion, and did not include any properties:

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

    1. Standard Page View event.

    2. At least one Custom Event with is_conversion set to true.

    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.


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

    When configuring a custom event, you can send additional Properties that include what's needed to configure Revenue Reporting. These are simply additional context sent along the event when it fires.

    Revenue must be reported in one of the four types of transaction amounts, each of which have thier benefits, but generally the USD is the recommended pathway.

    The Four (4) Options for Transactions:

    Transaction Type
    Example Use Case
    Required Properties"
    Code Examples
    Transaction Type
    Example Use Case
    Required Properties"
    Code Examples
    Transaction Type
    Example Use Case
    Required Properties"
    Code Examples
    Transaction Type
    Example Use Case
    Required Properties"
    Code Examples

    1. Follow the same steps as setting up a custom event.

    2. When it comes to defining Parameters, include the correct ones (from table).

    3. Contact Addressable for final validation and configuration.

    If you already have Google Tag Manager (GTM) set up, consider that implementation path as well.

    Enabled with the Addressable Pixel

    window.__adrsbl.run('purchase', true, [
        { "name": "transaction", "value": "VAC123D432" },
        { "name": "amount", "value": 50 }
    ]);
    window.__adrsbl.run('downloaded_app', false, [
      { "name": "cta_location", "value": "navbar" }
    ]);
    window.__adrsbl.run('primary_click', true, '');

    Getting Started — Required

    Set up the Base Pixel

    — Step 1 —

    — Step 2 —

    Once installed, the base pixel will automatically trigger a Page View and Wallet events on every page the script loads on. There's no need to track them manually.

    JavaScript Snippet

    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 Tools

    Custom Events & Revenue — Advanced

    Setting up Custom Events

    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.

    Code Syntax

    Tips for Each Parameter

    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.

    Code Examples

    Validate Configuration

    Configure Revenue Reporting

    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

    Follow These Steps:

    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.

    Three parameters:
    1. is_conversion Use is_conversion=true, When you wish to designate an event as a conversion event for it to be recognized as such across all counters that track attributed conversions in our product. Use is_conversion=false for all other events. Note: You can have multiple conversion events with this attribute set to true

    2. data data is a base64-wrapped JSON parameter that contains event metadata according to the table below.

    Parameter Name
    Is Mandatory
    Type
    Value
    Usage

    tid

    Mandatory

    String

    Addressable pixel ID which can be found under 'Settings' in your Addressable account.

    For associating events with your tenant

    Based on the table above, a request could be formulated in the following manner:

    1. Request Headers Please use the following headers to pass user information to our servers. Refer to the table below:

    Header
    Is Mandatory
    Value
    Usage

    Content-Type

    Mandatory

    application/json

    For proper functioning of server-to-server API

    Accept-Language

    Optional

    In the context of utilizing the Addressable Pixel, our software manages the definition of user sessions and user IDs. Conversely, the responsibility for managing S2S events lies with you.

    To improve your comprehension of user behavior, make use of the properties field to record key/value parameters that aid in understanding user behavior. This field comprises a list of JSON objects, where each key/value pair represents a specific property and its corresponding value. Refer to the example below for guidance on accurate properties reporting:

    In the example provided, three parameters were established. The first two parameters consist of both a name and a value, while the third parameter only includes a name.

    These events will be reported independently

    Please refer to the following Python code snippet demonstrating how to generate a request to our servers:

    For technical assistance and troubleshooting, contact us at support@addressable.io

    Request Structure

    https://tag.adrsbl.io/events/prod_standard_stage/p.png
    "properties": [{"name": "customer", "value": "mycustomer"},
                   {"name": "username", "value": "Billy Bob"},
                   {"name": "free_plan"}]
    import json
    import base64
    import requests
    
    data = json.dumps({"tid": "<your tid goes here>",
                       "event_name": "example_event",
                       "page_url": "https://app.example.com/test-tomer?a=1&b=2&c=3",
                       "referrer": "https://app.example.com/",
                       "timestamp": 1730538892,
                       "timezone_name": "America/New_York",
                       "timezone_offset": 240,
                       "extension_provider":"MetaMask",
                       "address": "0x000cD27F10dFFAC73201258EAA3925c0452051A0",
                       "chain_id": "0xa4b1",
                       "properties": [{"name": "user_id", "value": "uuid-value-goes-here"},
                                      {"name": "param2", "value": "value2"},
                                      {"name": "param3_no_value"}]}
    
    params = {"data": base64.b64encode(data.encode())}
    
    headers = {
        "Content-Type": "application/json",
        "Accept-Language": "en-US,en;q=0.9",
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36",
        "X-Forwarded-For": “1.1.1.1”,
        "X-Requested-With": "io.metamask"}
    
    url = 'https://tag.adrsbl.io/events/prod_standard_stage/p.png?is_conversion=false'
    res = requests.get(url, params=params, headers=headers)
    Typical Request Example

    https://tag.adrsbl.io/events/prod_standard_stage/p.png?is_conversion=false&data=eyJ0aWQiOiAiPHlvdXIgdGlkIGdvZXMgaGVyZT4iLCAiZXZlbnRfbmFtZSI6ICJleGFtcGxlX2V2ZW50IiwgInBhZ2VfdXJsIjogInRlbGVncmFtIiwgInJlZmVycmVyIjogImh0dHBzOi8vdC5tZSIsICJ0aW1lc3RhbXAiOiAxNzIzMzQ0NjQ4LCAidGltZXpvbmVfbmFtZSI6ICJBbWVyaWNhL05ld19Zb3JrIiwgInRpbWV6b25lX29mZnNldCI6IDI0MCwgImV4dGVuc2lvbl9wcm92aWRlciI6Ik1ldGFNYXNrIiwgImFkZHJlc3MiOiAiMHgwMDBjRDI3RjEwZEZGQUM3MzIwMTI1OEVBQTM5MjVjMDQ1MjA1MUEwIiwgImNoYWluX2lkIjogIjB4YTRiMSIsICJleHRlbnNpb25fcHJvdmlkZXIiOiAiTWV0YU1hc2siLCAicHJvcGVydGllcyI6IFt7Im5hbWUiOiAidXNlcl9pZCIsICJ2YWx1ZSI6ICJ1dWlkLXZhbHVlLWdvZXMtaGVyZSJ9LCB7Im5hbWUiOiAicGFyYW0yIiwgInZhbHVlIjogInZhbHVlMiJ9LCB7Im5hbWUiOiAicGFyYW0zX25vX3ZhbHVlIn1dfQ%3D%3D

    Requests sent to our servers must be URL-encoded. Refer to for more detailed information.

    Include"Content-Type": "application/json" header in the request when sending it.

    Event Properties

    Proper Attribution

    Code Example

    Creating a Display Campaign

    Overview

    The Programmatic Display campaign creation process is streamlined on the Addressable platform, and includes 2 simple steps:

    1. Configuring the campaign parameters and targeting features (audience, objective, budget, schedule, location)

    2. Uploading creatives to the Media Library, and attaching them to the campaign.

    Once launched, your creatives are distributed across our global DSP partners' inventory and the campaign is dynamically optimized by the Addressable+ engine.

    Running Programmatic Display campaigns requires an Addressable credit line with dedicated funds. Contact your customer success manger to set one up.

    Display Campaign Creation Process

    1. Select your target group. Pick one of your pre-defined audience groups.

    2. Select your campaign objective. Addressable campaigns are objective based, meaning they are optimized towards a particular goal. When you set 'Website Traffic and Actions' as your objective, you can select a particular event as your campaign's goal and optimization metric.

    3. Set your budget. Cap the max spend for the campaign. Make sure you have enough funds in your Programmatic Display credit line.

    4. Schedule the campaign duration.

    5. Select geolocations.

    6. Name your Ad.

    7. Select the media type you would like to upload (only Banner Ads are supported at this time).

    8. Upload the campaign's media (Creatives). You can upload multiple creatives, types & sizes to cover all platforms and real-estates.

    1. Provide the banner's destination URL.

    2. Launch campaign. Once your campaign goes live, you can to track the .

    Managing Campaigns

    All campaigns are created and managed on a single screen. You can search and filter your campaigns by type, status, objective, and all other relevant campaign attributes. Custom columns can be added by clicking the Columns dropdown. Your last column layout is always saved for future sessions.

    Campaign Manager

    Click on a campaign to drill down to its performance report. Learn more about Campaign Performance.

    Click on the additional actions iconto quickly take the following actions directly from your campaign management table:

    • Open this campaign on Twitter (X) in new tab.

    • Pause campaign - this will stop the corresponding network from serving your campaign.

    • Start campaign - this will re-initiate a paused campaign.

    • Duplicate - allows you to copy the configuration of an existing campaign onto a new one. This however does not duplicate the campaign's optimization history.

    • Delete - you can completely delete a draft campaign or campaigns that have been served by the Ads network. Deleting a campaign on the Addressable platform will deleted it from the integrated Ads network's dashboards as well.

    The following is a list of the campaign table attributes and their description:

    Column
    Description
    Notes

    Campaign Performance

    The Campaign Performance Dashboard offers a detailed overview of each Addressable campaign. This dashboard is designed to simplify your campaign analysis process, providing a clear, aggregated view of all crucial performance metrics. The Dashboard is composed of different analytic representations to cover high level, in depth and over-time views of your campaign results:

    1. - A visualization of your significant conversion metrics and KPIs over time, providing you with trend analysis in a comparative view.

    2. - A deep dive into the performance of each targeting parameter (geolocation, gender, creative, etc.) across your conversion metrics, identifying high performing segments to keep and low performing ones to exclude.

    page_url

    Mandatory

    String

    The page URL that generated the event can also be represented simply as a string.

    For tracking users as they move between different pages of your website / funnel.

    event_name

    Mandatory

    String

    The name of the event as you’d like it to be displayed on our platform

    For identifying user events that lead to actions

    timestamp

    Mandatory

    Int

    Timestamp of the event in UTC

    Ability to filter by time

    timezone_name

    Mandatory

    String

    User reported timezone for time offset calculation. E.g America/New_York

    Ability to filter by the user's time

    timezone_offset

    Mandatory

    Int

    The number of seconds in which the user timezone is offset from UTC time.

    Ability to filter by the user's time

    referrer

    Optional

    String

    The page URL which referred to the page that generated the event. It may be an empty string.

    For makreting channel drilldown, to understand where the traffic is coming from

    address

    Optional

    String

    The wallet address of the tracked user if known to you on the page where the event was triggered.

    A wallet address is one of the identifiers used to track user events within your system. Addressable also enriches wallets with on-chain data, offering a comprehensive view of your users.

    chain_id

    Optional

    String

    If the blockchain ID is known to you on the page where the event was triggered, please specify it here. For example, for the Ethereum chain, send "0x1".

    Ability to filter by blockchain and track user actions on various blockchains

    extension_provider

    Optional

    String

    Name of wallet provider if known to you when the event is triggered. E.g “MetaMask”.

    The ability to filter by wallet provider is available on our interface.

    properties

    Optional

    List of Jsons

    See below for instructions on how to utilize the properties field.

    Use the original user's Accept-Language header and not your server's header

    For drilldown and filtering based on user attributes: i.e languages

    User-Agent

    Optional

    Use the original user's User-Agent header and not your server's header

    For drilldown and filtering on user's OS type, Browser Type, Platform etc.

    X-Forwarded-For

    Mandatory

    User original IP address

    extract country information for each session. In compliance with GDPR and SOC2 regulations, IP addresses are retained for no more than one week. Country data, once extracted, is stored per user_id for your breakdown use.

    X-Requested-With

    Optional

    User mobile referrer app

    For drilldown and filtering - identification of the user orgin app before landed on your app (mobile referrer)

    how URL encoding works

    Pending - processing the configuration on the corresponding network. Pending Approval (Twitter (X)) - Awaiting network's content approval Draft - The campaign is configured but has not been 'launched' yet Expired - The campaign has reached its 'End Date' Exhausted - The campaign has depleted its budget Halted (Twitter (X)) - The campaign has been stopped by the network Deleted - The campaign has been removed Scheduled - The campaign is set to launch at a future date

    Audience

    The campaign's target group

    You can only set one audience per campaign

    Creation time

    Date and time of the campaign creation on the Addressable platform

    Start time

    Date and time of the campaign launch on the ads network

    End time

    Date and time of the campaign end (Exhausted or Halted)

    Performance metrics

    Impressions, Clicks, CTR, Budget etc. as reported from the ads network

    Name

    A descriptive title for your campaign

    'AddressableAI' is added as a prefix to the Twitter (X) campaign name (e.g. AddressableAI_USA_Gamers)

    Network

    Twitter (X), Reddit, Display

    Addressable campaigns are not editable after launch. Once we initiate the campaign on the corresponding network, any configuration changes require a new campaign creation.

    Campaign Management Table

    Status

    USD (Recommended)

    • Payments

    • Trading

    • Unique Transaction Identifier

    • Transaction Amount

    Foreign Currency Exchange

    • Converting EUR to USD

    • Unique Transaction Identifier

    • Transaction Amount

    • USD Exchange Rate (at time of transaction)

    Native Token

    • Value transfer between wallets

    • Staking

    • Unique Transaction Identifier

    • Transaction Amount

    • Network/Chain ID

    Contract Token

    • Stablecoin payments

    • DeFi interactions

    • Unique Transaction Identifier

    • Transaction Amount

    • Network/Chain ID

    • Token Contract Address

    configure our domains
    window.__adrsbl.run('purchase', true, [
      { "name": "transaction_id", "value": "VAC123D432" },
      { "name": "transaction_amount", "value": 50 }
    ]);
    window.__adrsbl.run('exchange', true, [
      { "name": "transaction_id", "value": "VAC123D432" },
      { "name": "transaction_amount", "value": 150 },
      { "name": "exchange_rate", "value": "0.870132" }
    ]);
    window.__adrsbl.run('transfer', true, [
      { "name": "transaction_id", "value": "VAC123D432" },
      { "name": "transaction_amount", "value": 150 },
      {" name": "network_id", "value": "8453" }
    ]);
    window.__adrsbl.run('payment', true, [
      { "name": "transaction_id", "value": "VAC123D432" },
      { "name": "transaction_amount", "value": 100 },
      { "name": "network_id", "value": "8453" },
      { "name": "token_address": "0x0000000000000000000000000000000000000000" }
    ]);

    Funnel Analysis - A visualized sequence of events detailing the user's experience on the path to conversion, and revealing "leaks" causing user loss before they reach the conversion destination.

    In addition to the campaign’s performance, the dashboard also provides a bird's-eye view of the campaign configuration (targeted audience, budget, geolocation, etc.) and a log of Addressable+ optimization activities available under the Campaign Summary tab.

    The Performance Over Time graph provides a visualization of your KPIs in a comparative view and it is a great tool for trend comparison in order to:

    • Track the percentage of change for any metric from the previous date range. By default the dashboard is set to a last 7 days view, and so the percentage of change is in comparison to the week before last. If you were to change the date range, the percentages will recalculate in accordance with the selected date range.

    • Compare the trend of multiple metrics. While each metric may be on a different scale (impressions in the thousands, conversions in the hundreds etc.), the trend comparison helps reveal patterns of change. For example, what happens when you increase the daily budget, or when you remove an underperforming creative.

    You may select up to 5 different metrics for trend comparison. The list of available metrics depends on the data integrations you have set up with with Addressable and the corresponding Ad networks. Learn more about our data sources and integrations.

    The segment breakdown allows you to deep dive into how your targeting parameters are performing across KPIs. For instance, a segment (e.g a particular country) leading in CTR might be lagging in Engagement. This is especially useful in pinpointing segments that can be removed, and those we may want to keep and double-down on.​

    Funnel analysis is used to visualize, measure, and understand key user behavior throughout the customer journey. Funnel analysis visually alerts you when something isn’t right, so you can make the necessary adjustments to keep your users on their path to conversion.

    Although every business has unique goals, funnel analysis is usually implemented to:

    • Improve conversion. Funnel analysis enables you to find out what’s preventing users from reaching your goal. Each stage of the funnel poses opportunities for a smoother, more personalized journey to the end of the funnel. If there is a significant drop in users between specific funnel stages, you’ll know where to focus your efforts and further analysis.

    • Align marketing and product goals. Marketing teams typically aim to convert new users and re-engage old ones, while product teams focus on user retention. The campaign funnel analysis allows to both share insights on the full user journey, and to create a cohesive user experience starting from the Ad and continuing to the product. If users respond well to a part of the marketing funnel, they’re more likely to stay on-board when the product funnel offers a similar value.

    Funnel Analysis

    You can configure your funnel analysis stages by adding and arranging up to 7 metrics. The list of available metrics depends on the data integrations you have set up with Addressable and the corresponding Ad networks. Learn more about our data sources and integrations.

    The campaign summary tab provides a high-level view of the campaign set up and optimization activities divided into:

    1. Addressable+ activity log - Here you can track the cadence and actions of our automatic optimization engine.

    2. Configuration details - Here you can quickly review the campaign settings (budget, audience, geolocations, schedule, etc.)

    Keep in mind that Addressable campaigns are not editable once launched. Once we initiate a campaign, any configuration changes would require creating a new campaign, or in some cases a direct edit on the corresponding network (you may reach out to your Customer Success Manager for further details and best practices).

    Over-time Performance Graph
    Segment Breakdown Table

    Performance Over Time

    Segment Breakdown

    Funnel Analysis

    Campaign Summary

    campaign's performance
    Supported Sized & Formats for Programatic Display Media

    Event API Attribution

    In order to have proper attribution after setting up the Events API, you need to do additional steps. There's a start-to-finish walkthrough that can be , otherwise continue to understand only the steps required to set up attribution after the Event API has been configured.

    • Use this if you can install the Addressable Pixel on your site.

    • This is the recommended setup for campaign attribution and is the easiest to maintain.

    Next steps: Follow the guide

    • Only use this if you do not have a pixel set up on your Addressable account.

    • Some organizations have compliance policies that restrict tracking pixels.

    • If you have a true “no pixel” policy, follow the S2S-only setup.

    • Next steps:

    Path to Attribution Set up

    (1) Recommended: Addressable Pixel + Postback API

    found here

    (2) Fallback: Postback API only (No Pixel)

    Follow the guide

    Audience Dashboard

    The Audience Dashboard is where you explore the characteristics of any audience. These include on-chain attributes such as wallet balance distribution, last on-chain activity and assets held by this group of users. The dashboard also includes off-chain characteristics, such as Twitter (X) influencers the users in this group are following, and fields of interest they exhibit on social networks.

    Audience Dashboard

    The Audience dashboard is generated for each saved Audience and updates every time you reload the dashboard page.

    Dashboard Chart Breakdown

    Element
    Description
    Notes/Clarifications

    You can upload any audience group created on Addressable as a Custom Audiences to your Twitter (X) ads account. This allows you to create specific user groups that can be used for retargeting, exclusion, and/or expansion of paid-ads campaigns.

    When you upload a Custom Audience, there's an initial processing period (that can take up to 48 hours), where Twitter (X) validate internal parameters for every user in this group (such as when they were last active on Twitter (X) and wether or not they opted in/out of ads on the platform). This allows Twitter (X) to then serve your ads to the validated accounts.

    It is possible that not all of the users in your Custom Audience will pass the internal validation process. That is why you may notice that the final Custom Audience size is smaller than your originally uploaded list. If there are less than 100 users that pass the validation process, the audience will receive an "Audience too small" status. In these cases, Twitter (X) makes the Custom Audience unavailable for targeting to align with the user privacy policy.

    To target or exclude the users in your Custom Audience, navigate to the Audiences module within the Targeting section of the campaign form on Twitter (X). After selecting include/exclude, search or browse the List dropdown to find the specific audience that you need. As a reminder, only audiences with the 'Ready' status in the Audiences Manager will be available here.

    Once you’ve done adding your Custom Audiences, complete the remaining campaign setup steps and launch!

    To review your audience configuration or check the status of an audience upload to Twitter (X), switch over the the Summary tab. Here you will find your selected categories, smart contracts and/or any filter conditions that were set for this segment. You will also see the history and status of this audience upload to Twitter (X).

    Audience Builder

    The Audience builder provides the tools and context to identify a group of users sharing common on-chain and off-chain attributes. The builder is composed of two parts:

    The audience definition widget - Allowing you to create a segment group by selecting a set of conditions:

    • Smart contracts they interacted with, and/or

    • Out-of-the-box proprietary categories they belong to, and/or

    Wallets

    Number of wallets that have interacted with the selected smart contracts comprising the audience group

    Social Accounts

    The number of Twitter (X) handles that were 'matched' to the wallets in this audience group

    Balance

    The current aggregated value of holdings for this group of wallets

    Top Locations

    The geo-distribution of 'matched' social accounts across the world

    Wallet last Activity

    Distribution of the last time these wallets were active on-chain

    Wallet Balance distribution

    A pie chart distribution of wallets according to the value of assets they hold at the time of audience creation

    Top Tokens/Top NFTs

    A distribution of tokens and NFTs that these users are currently holding in their wallets

    Top followed influencers & businesses

    Popular Twitter (X) influencers followed by the users in this audience

    Based on the wallets that were 'matched' to social profiles

    Topics & interests

    Identified interests and/or self attestations of users from this audience on Twitter (X)

    Based on the wallets that were 'matched' to social profiles

    Uploading an Audience to Twitter (X)

    Using a Custom Audience on Twitter (X)

    Audience Summary

    Using Custom Audiences

    A set of behavioral and situational filters to further optimize the audience.

    Targeting insights (right hand) panel - calculated in real time, the audience's reach potential when targeted on the ad network, their overall buying power, and geo-distribution.

    1. Name your audience (mandatory) - Give your audience group a descriptive name that will help you recognize it later.

    2. Define the audience group - Select the smart contract(s) they interact with, or an Addressable pre-built category reflecting a common behavior or user characteristic (e.g. power traders, strategy gamers).

    3. Optimize your audience group - Further define your audience by adding conditions to include:

      • Specific blockchains

      • Last blockchain activity - use this to create a cut-off date to only include users who have been active on-chain after a certain date.

      • Balance - you can chose to filter out users based on the value of assets they hold in their wallets at the time of audience creation.

      • Coin - you can further refine your audience by defining specific token/s they should be holding (at the time of the audience creation).

      • NFT assets - use this to filter users who have a particular asset and number of units.

    4. Save. Once saved, you can select this audience for targeting when you create a campaign, visit the audience dashboard for insights and analytics, track the audience’s impact on your business and industry within your dashboards.

    During the audience creation process, Addressable offers similarity based recommendations for each selected contract. Unlike simple similarity recommendations such as “users who bought X, also bought Y”, Addressable’s algorithm considers similarities between contracts as well as similarities between users (wallets) to identify corresponding behavioral patterns. Therefore, users of your selected contract, are not necessarily users of the offered contract, but their on-chain behavior is similar in pattern and purpose.

    Contract Recommendations

    Each time you select a particular contract, Addressable’s recommendation engine, calculates its similarity to all other on-chain addresses and offers the top most similar contracts as recommendations.

    Overview

    Audience Creation Process

    Targeting Recommendations

    Creating a Twitter Campaign

    The Twitter (X) campaign creation process is divided between Addressable and Twitter (X); On Addressable, you configure the campaign and save it as a 'Draft'. You are then redirected to your Twitter (X) Ads account, where you select/build the creative ad content within the draft campaign, and launch.

    1. Select your target group. Pick one of your pre-defined audience groups.

    2. Select your campaign objective. Addressable campaigns are objective based, meaning they are optimized towards a particular goal. You can set a general goal such as maximizing your Ads reach or getting people to engage with your post. You can also select a particular event, such as website signup or app install, as your campaign goal and optimization metric. The list of available metrics for optimization depends on the data integrations you have set up with Addressable and the corresponding Ads networks. Learn more about our

    .
    Campaign Objective
    1. Select your funding source & define the campaign budget. You can set multiple payment means on Twitter (X) and/or with Addressable, and specify a payment method at the campaign level. You can also limit the daily and total spend of your campaign.

    1. Schedule the campaign timeframe.

    2. Select geolocations. Note, crypto ads are subject to country/state policy and will not run in locations for which you are not pre-approved by Twitter (X).

    3. Name your campaign. Addressable will automatically add the prefix 'AddressableAI' to the campaign name. You will see this prefix on your Twitter (X) Ads account so you can easily identify Addressable managed campaigns among your other campaigns.

    4. Save as draft. Initially, your campaign will receive a 'Pending' status while it is being generated on Twitter (X). This takes a few moments, after which the status changes to 'Draft'.

    5. Switch to X-Ads to finalize your campaign. Once the campaign status turns to 'Draft', head over to the campaign on your Twitter (X)-Ads account. Click on additional actions ( ) and click on 'Go To Twitter' ( ) . This will open your campaign on X-Ads in configuration mode.

    1. Create your Ad. The campaign is pre-configured for best practice settings by Addressable. All that is left to do is to follow the X wizard steps to attach creatives to the 'Draft' campaign.

    2. Launch campaign. Once your campaign is launched, you can return to Addressable to track your campaign's performance.

    Overview

    Running Addressable campaigns on Twitter (X) requires an authorized X-Ads account and completing the X integration.

    Twitter (X) Campaign Creation Process

    Stage 1: On the Addressable Platform

    The Addressable+ optimization engine requires a minimum of $150 daily budget in order for the campaign to generate enough data for optimal operation.

    Stage 2: On X-Ads

    data sources and integrations

    How Attribution Works

    The Addressable Attribution Engine is designed to determine the most relevant marketing channel for each tracked user interaction. It processes data from multiple sources, resolves identities across platforms, and classifies traffic into predefined channels using structured rules and prioritization.

    This document outlines the logic of the engine and explain how it works.

    Identity Resolution

    Addressable employs various tracking methods to monitor user sessions and the events they perform on your website. If individual user tracking is not permitted due to cookie policies or similar restrictions, Addressable calculates a user fingerprint using technical attributes and assigns it to an individual user or group.

    The engine resolves user identities across multiple platforms and sessions by using unique identifiers and clustering them to create an AddressableID for the user or group. This process ensures accurate attribution of user interactions, even when they span multiple sessions or devices.

    Identity data is carefully mapped to maintain consistent tracking of users. Parameters such as session duration and bounce rate are constructed, enabling the interface to display all events at a distinct user level.

    Note: In case tracking is prohibited by your organization policy, please contact your account manager for adjusting the above behavior.

    The engine classifies each interaction into one of the predefined marketing channels based on UTM parameters, referrer information, and campaign data ()

    • Direct Traffic: Identified when no UTM parameters or referrer data is present.

    • Display Advertising: Recognized through specific UTM parameters or using internal mapping in case Addressable Display campaign was used.

    • Paid Social: Includes traffic from social platforms like X and Reddit, identified via UTM parameters and platform-specific identifiers.

    Custom logic ensures that traffic misclassified initially (e.g., due to missing UTM parameters) is reassigned to appropriate channels based on referrer data and context.

    Note: Customers are responsible for ensuring the correct setup of UTM parameters for accurate tracking and channel mapping. Misclassifications may occur if UTM parameters are used incorrectly.

    Note: To accurately map X campaigns created through the system to the Paid Social category, customers must use the correct UTM parameters as recommended by the system during campaign generation.

    The engine applies a first-touch attribution model with prioritization rules to determine the most impactful channel for each interaction:

    • Channels are ranked by relevance (e.g., Paid Social, Display, Paid Search prior to Direct Traffic).

    • For each user session, the first interaction from a high-priority channel is selected as the attributed channel.

    • If multiple channels are eligible in a single session, the first channel in selected resolve ties.

    In a typical scenario, a user will have multiple sessions, with each session potentially attributed to a different channel. For example, the user journey begins with encountering the brand's landing page during an Organic Social campaign or Organic Search. This often prompts the user to visit the website to learn more about the brand.

    However, purchases rarely occur during the first session. Instead, users are likely to return directly to the website in a subsequent session or through another interaction, such as a Display brand awareness campaign or an affiliate referral, before completing their purchase.

    Multiple touch-points play a critical role in guiding users down the funnel, and our attribution engine accounts for this behavior. The engine uses a first-touch attribution approach within a 30-day window, classifying the channel through which Addressable first tracked the user.

    For example, if a user views a Display Ad as part of a brand awareness campaign, visits the website Directly without taking any action, and then re-engages a week later by clicking on an Organic Social tweet on X, connecting their wallet, and completing a purchase, our attribution engine attributes the conversion to the Display channel.

    This approach ensures that the initial point of contact, which plays a crucial role in driving user awareness and engagement, is recognized in the attribution model.

    The final output of the engine includes detailed attribution metrics for each user interaction:

    • Attributed Channel: The primary marketing channel responsible for driving the interaction.

    • UTM Parameters: Campaign, source, medium, and term details associated with the session.

    • Referrer: The external site or platform that directed the user to the interaction.

    These outputs enable marketers to analyze performance and optimize their campaigns effectively.

    Organic Search: Traffic from search engines without paid advertising.
  • Paid Search: Traffic from search engines that is a part of a paid campaign with a UTM Term parameter.

  • Referrals: Traffic from external domains that act as referrers.

  • Email Marketing: Traffic originating from email campaigns.

  • Other Campaigns: Captures traffic not fitting the above categories but containing UTM parameters.

  • Campaign Details: Specific information about the campaigns, including platform and creative identifiers.

    Traffic Classification

    Prioritization and Attribution Logic

    Attribution Outputs

    See how classification works

    Postback Event API Setup Guide

    Track events with Addressable's server-to-server postback

    Addressable’s Events API is a modern server-to-server postback: your backend reports key funnel events (page_views, signups, wallet connects, purchases, etc.) so they can be attributed to campaigns and used for optimization.

    Choose Setup Path

    Path A (Recommended): Addressable Pixel + Postback API

    • Use this if you can install the Addressable Pixel on your site.

    • This is the recommended setup for campaign attribution and is the easiest to maintain.

    Path B (No Pixel At All): Postback API only

    • Only use this if you do not have a pixel set up on your Addressable account.

    • Some organizations have compliance policies that restrict tracking pixels.

    • If you have a true “no pixel” policy, follow the S2S-only setup.

    Important: Only use Path B if the Pixel is not installed at all and cannot be installed.


    If you’re using both the Pixel and the Events API, follow this path.

    Process Overview

    1. Install the Addressable Pixel (Page View is automatic)

    2. Capture the browser id ___adrsbl_nonce and store it with your user record

    3. Send Events API postbacks with properties.user_id = ___adrsbl_nonce for attribution

    Install the Addressable Pixel

    First you must install the Pixel (via GTM or JS) on your website or platform, using . Once installed, the Pixel manages sessions and user IDs on-site.

    Capture Addressable's ID for Users

    The Addressable Pixel creates a browser-side identifier stored in local storage:

    • Key: ___adrsbl_nonce

    Read it on page load (or early in the session):

    Debug: If adrsblNonce is null, confirm the Pixel is loading and firing on that page.

    Store the nonce with your user record (backend)

    When you know who the user is (login, signup, wallet connect, etc.), persist:

    • your internal identifier (user id / wallet / etc.)

    • the latest adrsblNonce you saw for them

    Example flow: (frontend → backend)

    Send postbacks via the Events API (Server-to-Server)

    • Endpoint: https://tag.adrsbl.io/events/prod_standard_stage/p.png

    • Query params:

      • is_conversion=true|false

    In your data JSON, include:

    This “join key” allows Addressable to attribute server-side events to the same user sessions the Pixel observed. ()

    Include these headers:

    • Content-Type: application/json (mandatory) ()

    • X-Forwarded-For: <user original IP> (mandatory) ()

    • Accept-Language / User-Agent

    The Events API docs include a ready-to-use code example showing the correct encoding and request format. The only “Pixel + API” requirement is that your properties includes user_id with the stored nonce value.

    While this is optional, it is recommended. Include revenue parameters for ROAS and deduplication.

    If you want ROAS + deduplication support, include revenue-related parameters such as:

    • transaction_amount_usd

    • transaction_unique_id

    Next Step: .


    This is for organizations with a true “no pixel” policy.

    Process Overview

    1. Generate/choose a persistent unique user identifier (user_id)

    2. Send a server-side page_view event that includes UTMs and ViewID

    3. Send funnel + conversion events using the same user_id

    Overview Callout

    In this setup, you must provide what the Pixel would normally provide:

    • a persistent user_id

    • a page_view (site visit) event

    • tracking parameters (UTMs + ViewID) so Addressable can attribute post-click and post-view

    Use a persistent unique user id

    Each user must have a unique identifier that persists for at least ~30 days so Addressable can correlate multiple events to the same user.

    Examples:

    • internal user id

    • wallet address

    • anonymous user id stored in your system

    In Path B, user_id is your identifier. (In Path A, user_id is reserved for the nonce join.)

    Send page_view via S2S and include tracking parameters

    When a user clicks an ad, UTMs like utm_campaign, utm_source, utm_medium, utm_content, and clickID should be captured from the page URL and reported with the page_view event. ()

    When a user views (but doesn’t click) an ad, a unique ViewID is provided. When the user later visits/acts, include:

    • user_id

    • the original ViewID ()

    The Events API provides a properties array for key/value parameters. () In “no pixel” mode, include your tracking params in properties (examples):

    You don’t need every field every time — but whatever tracking params exist for that session should be included on the page_view. ()

    Send funnel events + conversions via S2S

    Report funnel events via the S2S API (examples include): page_view, button_click, sign_up, wallet_connect, conversion.

    Use:

    • is_conversion=true for conversion events

    • is_conversion=false for everything else

    While this is optional, it is recommended. Include revenue parameters for ROAS and deduplication

    If you want ROAS + deduplication support, include revenue-related parameters such as:

    • transaction_amount_usd

    • transaction_unique_id

    Next Step: .


    Enabling Revenue Reporting unlocks ROI tracking, user-level revenue, ROAS for campaigns, and more in your Addressable dashboard. Revenue reporting applies to both Path A and Path B. Regardless of your setup, include revenue properties on any conversion event where a financial transaction occurs.

    Revenue must be reported using one of the four transaction types below. Choose the one that matches your transaction model — USD is recommended for most use cases.

    These properties are included in the data JSON payload alongside your other event fields — no separate request needed.


    • Path A: confirm properties includes { "name":"user_id", "value":"<___adrsbl_nonce>" } exactly.

    • Path B: confirm your page_view includes user_id + UTMs and/or ViewID when present.

    • If the Pixel is installed and you can read ___adrsbl_nonce, you’re on Path A.

    • If Pixel cannot be installed due to policy, you’re on Path B.

    data = base64-wrapped JSON payload

    (optional but recommended: pass the user’s original values) (
    )
  • (Optional) Include revenue parameters for ROAS + deduplication

  • const adrsblNonce = window.localStorage.getItem("___adrsbl_nonce");
    await fetch("/api/identify-addressable", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        userId: "<your-internal-user-id-or-wallet>",
        addressableUserId: adrsblNonce
      })
    });
    "properties": [
      { "name": "user_id", "value": "<___adrsbl_nonce value>" }
    ]
    "properties": [
      { "name": "user_id", "value": "<your persistent user id>" },
      { "name": "utm_campaign", "value": "<value>" },
      { "name": "utm_source", "value": "<value>" },
      { "name": "utm_medium", "value": "<value>" },
      { "name": "utm_content", "value": "<value>" },
      { "name": "clickID", "value": "<value>" },
      { "name": "ViewID", "value": "<value>" }
    ]

    Path A (Recommended):

    Step-by-Step

    — Step 1 —

    — Step 2 —

    — Step 3 —

    — Step 4 —

    A. Endpoint + parameters

    NOTE: Requests must be URL-encoded.

    B. Required attribution field (Pixel + API join)

    C. Required headers

    D. Use the Events API Example – Recommended

    — Step 5 —

    When possible send the revenue events over the Pixel, if that's not possible, this will help you set it up using an API event call.

    Path B (No Pixel At All):

    Step-by-Step

    — Step 1 —

    — Step 2 —

    Without the Pixel, it is this page_view server-side event that enables attribution calculations.

    Post-click attribution (UTMs)

    Post-view attribution (ViewID)

    Where do these go in the Events API payload?

    — Step 3 —

    Always include the same persistent user_id so events chain together.

    — Step 4 —

    Revenue Reporting

    Revenue events are usually sent as conversions. Therefore it's generally recommended to set is_conversion=true on any event that includes revenue properties.

    Supported Transaction Types

    After setting up revenue tracking, contact your Addressable Customer Service representative to ensure your revenue events are properly configured on our end.

    Troubleshooting

    Events are received, but attribution is missing

    You’re not sure which path you’re on

    Transaction Type

    USD (Recommended)

    Example Use Case
    • Payments

    • Trading

    Required Properties
    • Unique Transaction Identifier

    • Transaction Amount

    Code Example
    Transaction Type

    Foreign Currency Exchange

    Example Use Case
    • Converting EUR to USD

    Required Properties
    • Unique Transaction Identifier

    • Transaction Amount

    • USD Exchange Rate (at time of transaction)

    Code Example
    Transaction Type

    Native Token

    Example Use Case
    • Value transfer between wallets

    • Staking

    Required Properties
    • Unique Transaction Identifier

    • Transaction Amount

    • Network/Chain ID

    Code Example
    Transaction Type

    Contract Token

    Example Use Case
    • Stablecoin payments

    • DeFi interactions

    Required Properties
    • Unique Transaction Identifier

    • Transaction Amount

    • Network/Chain ID

    Code Example
    this guide
    Addressable
    Addressable
    Addressable
    Follow the guide by scroll down to Revenue Reporting
    Addressable
    Addressable
    Addressable
    Addressable
    Follow the guide by scroll down to Revenue Reporting
    Addressable

    Audience Anywhere API

    This API retrieves user audience information for your social logins, enabling you to offer enhanced personalized experiences to your customers across touch points.

    Here are some of the main benefits of using Audience Anywhere:

    • Fine tune your landing pages with personalized messaging: Use audience data (e.g. user belongs to 'Degens') to customize your content with a particular message.

    • Offer personalized incentives and rewards: Use audience data (e.g. user is in a 'Tier One' audience) to customize rewards based on user's LTV.

    Currently, the Audience Anywhere API only supports Twitters social login. To receive a key and direct the API calls to a particular audience, contact our customer success team.

    This API queries whether an individual twitter [hashed] ID belongs to a particular Addressable audience.

    Each query returns an empty or populated 'audience_ids' list. This list provides the IDs of your selected target audience that the user belongs to (at the time of the query).


    https://api.adrsbl.io/v1

    • x-api-key: your_api_Key (required): Your API key for authentication.

    Request

    • Method: GET

    • Endpoint: /audience_anywhere

    • Query Parameters:

    Response

    The API responds with a JSON object containing a list of one or more audience IDs for which your user belongs to. When the list is returned populated, it means that the queried user was found as belonging to your pre-determined target audience group (among others). When the list is returned empty, it means that the queried user does not belong to your target audience group.

    Example:

    • 401 Authorization Error

    • 403 Forbidden: Invalid API key or authentication failure

    • 404 Not Found: The requested resource was not found

    • 500 Internal Server Error: An unexpected error occurred on the server

    This API has rate limiting of 10 calls per second.

    Audience Manager

    This is an overview of all the audience groups you have created within a single screen. You can search, filter and sort your audiences by name, status and even the contracts the audiences are based on.

    Click on any audience to dive into the Audience Dashboard, where you can explore the audience’s specific on/off-chain characteristics.

    Hover over any row to reveal the additional actions menu directly on your audience management page:

    • Dashboard - redirecting you to the audience dashboard, which contains a full characteristics breakdown.

    social_login (required): The social login for which you want to retrieve audience information. Currently supports Twitter (X) only.
  • hashed_user_id (required): The social login's hashed user ID for which you want to fetch audience information. In the Twitter (X) case, use SHA256 of the Twitter ID (not the handle).

  • How does it work?

    Base URL

    Authentication header

    Endpoints

    Get Audience Information

    Error Responses

    Rate Limiting

    Token Contract Address
    curl -X 'GET' \
      'https://api.adrsbl.io/v1/audience_anywhere?social_login=twitter&hashed_user_id=xxxxx' \
      -H 'accept: application/json' \
      -H 'x-api-key: YOUR_API_KEY'
    {
      "audience_ids": [
        // Empty audience id list
      ]
    }
    {
      "audience_ids": [
        // "622ac0dc9efdd9f9fca6c01a"
      ]
    }
    "properties": [
        { "name": "transaction_id", "value": "VAC123D432" },
        { "name": "transaction_amount", "value": 50 }
    ]
    "properties": [
        { "name": "transaction_id", "value": "VAC123D432" },
        { "name": "transaction_amount", "value": 150 },
        { "name": "exchange_rate", "value": "0.870132" }
    ]
    "properties": [
        { "name": "transaction_id", "value": "VAC123D432" },
        { "name": "transaction_amount", "value": 150 },
        { "name": "network_id", "value": "8453" }
    ]
    "properties": [
        { "name": "transaction_id", "value": "VAC123D432" },
        { "name": "transaction_amount", "value": 100 },
        { "name": "network_id", "value": "8453" },
        { "name": "token_address", "value": "0x0000000000000000000000000000000000000000" }
    ]
    Edit - to edit your audience parameters.
  • Duplicate - allows you to copy the parameters of an existing audience into a new one, continuing to fine tune from that point.

  • Rename - you can change the name of an audience at any point, including audiences that are currently used in live campaigns.

  • Delete - delete an audience and remove it from the list.

  • Column
    Description
    Notes

    Name

    A descriptive title for your audience

    An audience does not require a unique name

    Size

    The number of wallets that met the parameters set when the audience was created

    Audience Manger

    Audience Manager Table

    Ads Specifications

    To be approved on X Ads, Programmatic Display Ads and Reddit Ads, ads must follow specific creative guidelines to ensure quality and compliance.

    These guidelines include technical creative specifications such as high-resolution images or videos that are clear, without excessive text or pixelation. Text should be concise and relevant to the audience, with any legal disclosures clearly visible.

    Additionally, landing pages must align with ad content and load quickly for a seamless user experience.

    By adhering to these standards, advertisers enhance the likelihood of approval and maximize audience engagement.

    Twitter (X) Creative specifications

    Text Ad

    A simple text ad, with all the elements of a standard Tweet, including likes, replies, favorites and Retweets. Tweet copy: 280 characters.

    each link used reduces character count by 23 characters, leaving 257 characters for Twitter copy.

    Image Ad

    Showcase your brand, product, or service with a single photo. Easy to create and can support multiple objectives. They can be Retweeted, replied to, and liked, and they’re marked as “Promoted”.

    Tweet copy: 280 characters.

    File types: PNG and JPEG are recommended. BMP or TIFF files are not supported. GIFs uploaded will render as a static image. File size: Max 5MB

    Image size: 800 x 418 pixels is recommended for 1.91:1 aspect ratio. 800 x 800 pixels is recommended for 1:1 aspect ratio.

    Aspect ratio: 1.91:1 or 1:1

    App title: Truncated at 200 characters. Included from app store; not customizable.

    Call to Action: Install, Open, Play, Shop, Book, Connect, and Order

    Image size: 800 x 418 pixels is recommended for 1.91:1 aspect ratio.

    Aspect ratio: 1.91:1

    Conversation Card 
(original Tweet in timeline)

    Tweet copy: 280 characters (same as above)

    Hashtag: 21 characters, including the hashtag character

    Pre-populated user Tweet 
(once user clicks on the CTA)

    Tweet copy: 256 characters

    Headline: 23 characters

    Thank You Tweet 
(after user has Tweeted out the Tweet)

    Thank you text: 23 characters

    Thank you URL (optional): 23 characters

    Image size: 800 x 418 pixels is recommended for 1.91:1 aspect ratio. 800 x 800 pixels is recommended for 1:1 aspect ratio.

    Aspect ratio: 1.91:1 or 1:1. However, 1:1 will crop to 1.91:1 in mobile timeline.

    GIFs are not supported at this time.

    Tweet copy: Polls can include up to 280 characters of Tweet copy that appear above the image.

    Poll options: 2-4 custom poll options Once you’ve written your copy and added an image, you can add two to four custom poll responses to create your poll.

    Poll copy: 25 characters each Each poll option can include up to a maximum of 25 characters of text (which do not count against the 280 you can include in Tweet copy).

    Image size: 800 x 418 pixels is recommended for 1.91:1 aspect ratio. 800 x 800 pixels is recommended for 1:1 aspect ratio.

    Aspect ratio: 1.91:1 or 1:1

    Website title length: 70 characters. Please note — depending on device and app settings this description may truncate. Up to two lines of text are rendered on the card title; any text beyond that is truncated with an ellipsis. Although not guaranteed, limiting the description to 50 characters should ensure that truncation won’t occur across most devices.

    URL: must begin with http:// or https://

    Image size: 1200 x 1200 pixels is recommended for 1:1 aspect ratio. 1200 x 628 pixels is recommended for 1.91:1 aspect ratio. Larger images will be better optimized for when users click to expand images.

    Aspect ratio: 1.91:1 or 1:1. Please note that the legacy composer supports any aspect ratio between 2:1 and 1:1.

    Capture attention and tell a strong story with a visually engaging video ad. Video Ads allow you to showcase your brand, product or service and bring them to life through video.

    Tweet copy: 280 characters.

    Note: each link used reduces character count by 23 characters, leaving 257 characters for Twitter copy)

    File types: MP4 or MOV

    File size: 1 GB max. For optimal performance we strongly recommend to keep files under 30 MB. Video length: 15 seconds or less is recommended. Up to 2:20 is supported. (Select advertisers are eligible to request an increase up to 10 minutes; however, we advise videos to be 9:55 to account for a range of video files). Branding: Highly recommended throughout; if using a logo, it should be persistent in the upper left hand corner. Prominent product placement is highly recommended for driving product consideration. Captions: Closed captioning or text overlays are strongly recommended. Video bitrate: 6,000 - 10,000k (recommended 6,000k) for 1080p. 5,000k - 8,000k (recommended 5,000k) for 720p. Frame rate: 29.97FPS or 30FPS. Higher is acceptable (support up to 60FPS). If the available video has a lower frame rate don’t try to “upsample” it. Audio codec: AAC LC (low complexity) Video codec recommendation: H264, Baseline, Main, or High Profile with a 4:2:0 color space. Thumbnail: - Supported files: PNG or JPEG - Aspect ratio: recommend matching sizing of the video - Max size: 5MB Looping: Videos will loop if the video length is under 60 seconds.

    Video size: 1200 x 1200 pixels is recommended for 1:1 aspect ratio. 1920 x 1080 pixels is recommended for 16:9 aspect ratio. Larger videos will be better optimized for when users click to expand videos. Aspect ratio: 16:9 or 1:1. Please note that the legacy composer supports any aspect ratio between 2:1 and 1:1.

    Video size: 800 x 450 pixels is recommended for 16:9 aspect ratio. 800 x 800 pixels is recommended for 1:1 aspect ratio.

    Aspect ratio: 16:9 or 1:1

    Website title length: 70 characters. Please note — depending on device and app settings this description may truncate. Up to two lines of text are rendered on the card title; any text beyond that is truncated with an ellipsis. Although not guaranteed, limiting the description to 50 characters should ensure that truncation won’t occur across most devices.

    URL: must begin with http:// or https://

    Video size: 800 x 450 pixels is recommended for 16:9 aspect ratio. 800 x 800 pixels is recommended for 1:1 aspect ratio.

    Aspect ratio: 16:9 or 1:1

    App title: Truncated at 200 characters. Included from app store; not customizable.

    Call to Action: Install, Open, Play, Shop, Book, Connect, and Order

    Video size: 800 x 450 pixels is recommended for 16:9 aspect ratio.

    Aspect ratio: 16:9

    Conversation Card 
(original Tweet in timeline)

    Tweet copy: 280 characters (same as above)

    Hashtag: 21 characters, including the hashtag character

    Pre-populated user Tweet 
(once user clicks on the CTA)

    Tweet copy: 256 characters

    Headline: 23 characters

    Thank You Tweet 
(after user has Tweeted out the Tweet)

    Thank you text: 23 characters

    Thank you URL (optional): 23 characters

    Video size: 800 x 450 pixels is recommended for 16:9 aspect ratio. 800 x 800 pixels is recommended for 1:1 aspect ratio.

    Aspect ratio: 16:9 or 1:1. However, 1:1 will crop to 16:9 in mobile timeline. GIFs are not supported at this time.

    Tweet copy: Polls can include up to 280 characters of Tweet copy that appear above the video.

    Poll options: 2-4 custom poll options Once you’ve written your copy and added your video, you can add two to four custom poll responses to create your poll.

    Poll copy: 25 characters each Each poll option can include up to a maximum of 25 characters of text (which do not count against the 280 you can include in Tweet copy).

    Poll duration: Select a time between a minimum of 5 minutes and a maximum of 7 days.

    Carousels give marketers up to 6 horizontally swipeable images or videos to showcase multiple products or promotions, advance a narrative across several visuals, and highlight the most exciting features of a product.

    Number of slides: 2-6 (Images or Videos)

    Media size

    • Image Carousels: 800 x 418 pixels is recommended for 1.91:1 aspect ratio. 800 x 800 pixels is recommended for 1:1 aspect ratio.

    • Video Carousels: 800 x 450 pixels is recommended for 16:9 aspect ratio. 800 x 800 pixels is recommended for 1:1 aspect ratio.

    Aspect ratio

    • Image Carousels: 1.91:1 or 1:1 image assets using a single aspect ratio within one carousel.

    • Video Carousels: 16:9 or 1:1 video assets using a single aspect ratio within one carousel.

    • For Carousels using mixed media, aspect ratios should remain consistent (1:1 image asset with 1:1 video asset).

    Link: One web or app destination for single-destination Carousels. Up to six unique web destinations for multi-destination Carousels.


    We are able to run a variety of Display, Video and wider channel formats upon request. We generally advise the below steps for best practice:

    • Localized language creative where possible

    • Including a clear call to action

    • Do not overload the creatives with information - this needs to be restricted to keep the messaging clear

    • Keep the amount of creative variant to a minimum. Several variants can help creative testing, going overboard might dilute delivery and hurt the significance of learnings/insights

    Desktop creative sizes: 300x250, 336x280, 728x90, 300x600, 160x600, 970x250, 336x280, 970x90, 120x600, 468x60

    Mobile creative sizes: 300x250, 320x100, 320x50, 320x180, 300x50, 320x480, 480x320, 250x250

    Tablet creative sizes: 768x1024, 1024x768, 1280x800

    File types: .jpeg (jpg), .png, .gif or 3rd party adserved creatives File size: Initial load - 5kb. Max - 200kb Animation: Max 30 sec Other: Tablet creatives to be MRAID v1 and v2 supported

    We accept raw and ad served creatives from select ad servers (AdForm, DCM, Sizmek, Flashtalking). All HTML5 creatives need to be ad served.

    File types: .mp4, .mpg, .mov, .webm, .ogv, .mpeg, .m4v, .mkv

    Max size: 100mb

    Sampling rate: 40,000 Hz (Standard) or 96,000 Hz (Professional)

    Bitrate: (Low 240P) 300-2000 kbps (1080P Full HD)

    Resolution: 1080P (Full HD) recommended

    Video Codec: When using teh MP4 video format - H.264 recommended

    Aspect Ratio: 16:9 recommended, 4:3

    Recommended size: 1920x1080px, 640x480px

    Minimum size: 640x360px, 480x360px



    The technical ads specifications are downloadable as PDF here:

    Social Accounts

    The number of Twitter (X) handles that were 'matched' to the wallets in this audience group

    Status (custom audience only)

    Processing - Custom audience is being uploaded to Twitter. Failed - Custom audience upload failed. Too Small - Custom audience is too small to target on Twitter. Ready - Custom audience is ready for targeting on Twitter.

    Contracts

    The smart contracts that were used to build the audience

    Last modified

    Date and time of the most recent audience edit

    In Campaign

    Indication that an audience that has been used for a targeted ads campaign (regardless of the campaign's status)

    Twitter Expiration (custom audience only)

    The date of expiration of a custom audience on Twitter (X)

  • For multi product campaigns consider the use of a DCO provider - allowing for a scalable product feed and dynamic creative features

  • each link used reduces character count by 23 characters, leaving 257 characters for Twitter copy.

    Image Ad with App Button

    Image Ad with Conversation Button

    Image Ad with Poll

    Image Ad with Website Button

    Standalone Image Ad

    Video Ad

    Standalone Video Ad

    Video Ad with Website Button

    Video Ad with App Button

    Video Ad with Conversation Button

    Video Ad with Poll

    Carousel Ad

    Programmatic Display Creative Specs

    Banners

    Please Note: For Crypto aware websites such as blockchain.com, solscan.io, polyscan.io etc make sure to provide the 320x100 banner!

    Video

    Reddit Ads

    See Reddit Ads Specifications
    8MB
    Creative Specs Twitter - NOV24.pdf
    PDF
    Open
    9MB
    Creative Specs Programmatic - NOV24.pdf
    PDF
    Open

    Engagement Data Tracking

    This document outlines the different methods we utilize to collect, process, and store website and application engagement data.

    While we support a range of ingestion methods, we strongly recommend you install the Addressable pixel or Server to Server API for both efficiency and ease of integration.

    Website Tracking Methods

    Installing the Addressable pixel

    The Addressable pixel allows you to track Web 2 activity, such as page views, signups, wallet connect events etc. and to associate these with blockchain actions such as conversions. Simply put, it enables a full Web2 › Web3 user funnel view, to better understand the impact of your marketing efforts.

    • Addressable pixel installation via Google Tag Manager Ideal when you are already using GTM and have limited development resources

    • Addressable pixel installation using a website code Ideal when you prefer to manage and report your first party data directly

    Installing the Ad Network Pixel or API

    When you have an Ad network pixel or API installed (either Twitter (X) or Reddit) that report events back to the Ad network, Addressable will collect these events when they are attributed (by the network) to an Addressable campaign. Once collected, you will be able to leverage them within the Addressable platform.

    Keep in mind, that while such events can be leveraged for targeting and optimization purposes using the Addressable platform, unlike the Addressable pixel they cannot be used to provide a full attribution funnel since they are only received for campaigns you launch on the network using Addressable.


    If you are using one of our supported Mobile Measurement Partners, you can share with Addressable your installs as well as significant in-app events to build a full Web2-App-Web3 funnel view & maximize Addressable's targeting and optimization capabilities.

    • Singular Integration (ask your Customer Success Manager)

    When you have an Ad network mobile conversion tracking installed (either Twitter (X) or Reddit) and report events back to the network, Addressable will collect these events when they are attributed (by the network) to an Addressable campaign. Once collected, you will be able to leverage them within the Addressable platform.

    Keep in mind, that while such events can be leveraged for targeting and optimization purposes using the Addressable platform, unlike the Addressable pixel they cannot be used to provide a full attribution funnel since they are only received for campaigns you launch on the network using Addressable.


    Addressable’s Conversions API is a secure server-to-server solution that enable you to share your user engagement and conversion event data with the Addressable platform when you cannot implement a website code, and when your user funnel is fragmented across multiple platforms.

    • Use this when you have a complex customer journey that include user engagement across 3rd party platforms (e.g. Telegram/Discord chatbot, Mobile sandboxed WebApp, Telegram Game, Discord).

    User Profiles

    See user profiles that are enriched with on-chain and off-chain data, enabling precise retargeting and deeper wallet insights

    User Radar shows all known-wallet users that have visited your platform and either (a) their wallet is known by Addressable or (b) they connected to your platform. User Radar enables precise retargeting and re-engagement of your most valuable users.

    Each user profile is enriched by Addressable with both off-chain data captured from your platform (such as country, language, and campaign details) and on-chain data (including top holdings, blockchain type, and wallet age), providing deeper insight into wallet behaviors and characteristics across multiple channels.

    Each column has a definition that can be viewed by either hovering the the info icon (a circle with an i in it) on the table, under the Field name when selecting a filter, or by pressing the "Columns" button.

    Some columns are not in the table by default,

    Marketing Channels Classification

    Your website or app traffic can originate from various sources. Our Marketing Overview report can help you understand your website traffic sources. To better understand this, it is common to categorize these sources into eight marketing channels:

    Traffic that comes from users entering a website’s URL directly into their browser, accessing it via saved bookmarks, or clicking a direct link from outside the browser (e.g. Microsoft Word or an app). Direct traffic often indicates awareness or affinity for the website, making these visitors among the most loyal and engaged. Note: This metric helps assess a website’s brand strength in terms of awareness and demand.

    Traffic sent from one website to another via a direct link. This includes visits from affiliates, content partners, direct media buying, or news coverage. Websites receiving significant referral traffic often have strong affiliate strategies or substantial media exposure. Note: Use the referral drill-down in our product to identify which affiliates are driving traffic to your website.

    Traffic from unpaid (organic) search engine results, such as Google. Websites generating substantial organic search traffic are likely optimizing for high search rankings (SEO). These visits often come from high-intent users, with engagement rates significantly above average.

    User Overview

    Gain insights on the enriched user profiles to enable precise retargeting, deeper insights, and understand your highest value users.

    The User Overview in User Radar provides an aggregated view of your users, including who they are, how they are behaving, and how those behaviors change over time. This helps you identify patterns, monitor shifts, and make informed decisions without checking multiple reports.

    There are two major sections one called "All Users" and another called "Known-Wallet Users". As described on the page in the helpful little (i) icons, All Users is defined as any users that has visited your platform, no matter if they have a wallet or not, if they're known or anonymous. This is in contrast to the Known-Wallet Users, which is only users who have either (a) connected their wallet to your platform or (b) are known within the Addressable network and visited your website.

    You will see the concept of New, Current, Returning (and sometimes Inactive) spread throughout User Radar. It's helpful to remember the defintion can be slightly different depending it's location.

    Mobile Application Tracking Methods

    Integrating your MMP

    Installing the Ad Network mobile tracking

    Server to Server Tracking Methods

    Implementing Addressable's Events API (Server to Server)

    AppsFlyer Integration
    Addressable Event Tracking (Server-to-Server) API
    but can be made visible in one of two ways:
    1. Click on the Addressable ID for that row and a sidebar will open showing all the info for that user

    2. Click on Columns on the top right of the table, check what you're interest in, and add it into the table

    There are definitions for every column and most major components baked into the page. Therefore some columns excluded from this page.

    To see the definition: When you see a column name in the table or the column picker popup, there's an info icon (i with a circle around it) that you can hover on to see the full description.

    By default, the 'Group By' is set to Profile Stages — see definitions below. You can remove this behavior or change it to a different column by selecting the dropdown menu.

    The Profile Stage indicates how much is known about a profile and whether their wallet is known to you.

    Profile Stage
    Description

    Identified Profile

    The user’s wallet is know by Addressable, but they haven’t connected their wallet on your platform, so their wallet address is not shared with you.

    Connected Profile

    The user connected their wallet directly on your platform,

    so their wallet address is available to you.

    Where the user is as of Today in the active lifecycle of your platform.

    User Status (Table)
    Description

    New

    As of today, the user’s visit is their first-ever on your platform

    Returning

    As of today, the user recently came back after more than 30 days with no visits.

    Current

    As of today, the user’s last visit was within the last 30 days.

    Whether or not this User Profile was seen doing suspicious activities.

    Activity
    Description

    No Suspicious Activities

    The user profile has no activities that match any of the below and therefore is considered to be not suspicious.

    Suspicious Activities

    The user has been identified as a suspicious because (a) they have connect >=30 different wallets, (b) When a wallet is tagged as Phishing or Scam by Etherscan or (c) When a wallet is tagged by OFAC's Sanctions List (via Etherscan)

    If the wallet has a NFT domain associated with it, we will present it in the table under Wallet and in filters list under Wallet Domain. We support the following services:

    • ENS (Ethereum)

    • Base Name Service (Base)

    • SpaceID (Binance & Arbitrum)

    • Unstoppable Domains (Polygon)

    • Freenames (Polygon)

    Cohort tags highlight an wallet's average activity overtime. The tags are applied when averages meet established thresholds and could change with time. All of these must be true at least once in the last 30 days.

    Tag
    Description

    Swapper

    When a wallet has a high number of Swap-based transactions on a specific chain.

    Loan Taker or Borrower

    When a wallet has a high number of Loan-based transactions on a specific chain.

    Staker

    When a wallet has a high number of Staking-based transactions on a specific chain.

    If you have any additional questions, please let us know.

    Overview of Page

    Known-Wallet Users

    All Column & Profile Views

    Note on Columns Definitions

    Group By Function & Defaults

    Profile Stages Column

    User Status Column

    By default, the Activity Window is set to 30 days, but can be changed as needed.

    This setting should reflect how long you expect a user should be active for before becoming inactive. As well as at what point they're considered returning.

    You can edit it by selecting "Configure Window" at the top (or Configure in the tooltip)

    Suspicious Activities Column

    Wallet Domain Column

    Cohorts Column

    Traffic from search ads on platforms like Google or Bing. Websites with significant paid search traffic are investing in advertising to enhance brand awareness and reach relevant audiences. Paid search campaigns target high-intent users, often resulting in higher conversion rates. Note: Use the paid search drill-down in our product to see which keywords drive the most traffic to your website.

    Traffic originating from email clients (e.g., Gmail, Yahoo) when users click on links in emails. For instance, traffic from the referring domain "gmail.com" is categorized as email traffic. Websites with substantial email traffic likely maintain a loyal customer base engaged via mailing lists.

    Traffic generated from display or video ads served through known ad platforms like DoubleClick or AdForm. Websites with high display ad traffic are leveraging ad budgets to increase brand visibility and attract relevant users. Note: Use the display channel drill-down in our product to identify campaigns driving high-quality traffic to your site.

    Traffic from non-paid social media interactions, such as clicks on shared links or content posted on platforms like X or Reddit. Websites with consistent organic social traffic likely have a loyal and engaged community. This traffic is often driven by viral content, such as articles, memes, or images. Note: Use our Marketing Overview report to analyze which social networks drive the most traffic and what type of users engage with your organic social posts.

    Traffic from paid ads on social media platforms like X or Reddit. Note: Use our paid social drill-down to identify campaigns that drove relevant users to your site. Analyze audience performance and optimize campaigns for better results.

    Addressable classify marketing channels using the following technical attributes:

    UTM parameters are five types of URL parameters used by marketers to track the performance of online marketing campaigns across various traffic sources and publishing platforms.

    The parameters are:

    Parameter

    Purpose

    Example

    utm_source

    Identifies the source of the traffic (e.g., the site or platform) and is a required parameter.

    utm_source=google

    utm_medium

    Indicates the type of link used, such as cost-per-click (CPC) or email.

    utm_medium=cpc

    A referrer is the URL of the web page a user visited immediately before navigating to the current page. In simpler terms, it indicates the source or origin of the traffic that brought a visitor to a specific page.

    While UTM parameters must be defined manually by the user, the referrer is automatically populated by the browser and provides information about the originating website.

    For example, if you search for something on Google and click on one of the organic results, the referrer will be "Google," but there will be no UTM parameters included.

    What are marketing channels?

    Direct Traffic

    Referrals

    Organic Search

    Paid Search

    Email Marketing

    Display Advertising

    Organic Social

    Paid Social

    How does Addressable classify channels?

    Urchin Tracking Module (UTM) Parameters

    Referrer

    If you're looking at a the KPI Cards, then we are saying the user was New or Returning within the selected time period (the date selector). Where as on the graph, we are saying a user was New on that specific day (or week, month, etc).

    Additionally, all status are evaluated starting the day you set up your Addressable Pixel. Therefore no one who has visited your platform prior to the set up date can have any status other than 'New' on their first visit.

    Example Breakdown (for those who want to get nerdy):

    If you select a timeframe of the "Last 90 Days" in the date picker, you've only had Addressable set up for the last 75 day, then we'd consider every single user as 'New'. You can easily over come this by shortening the timeframe to 30 days or less.

    You might find some users are marked as returning in the chart, but there's no value in the KPI, this is a great example of how a user status changes every day and the KPI charts choose the first known status within the selected time period.

    User Status Definition

    User Status
    KPI Card
    Graph View

    New

    Unique users whose first visit in this period was their first-ever visit.

    Users visiting your site for the first time on this day/week/etc.

    Returning

    Unique users who visited during this period after more than 30 days with no visits.

    Users who visited on this day/week/etc. after more than 30 days with no visits.

    All Users means any users who is considered anonymous or has an identified or connected wallet. This means, if they have a wallet or not, and if that address is known or not. This is all users and visitors who the Addressable Pixel has seen on your platform.

    • Unique New Users

      • Unique users whose first visit in this period was their first-ever visit seen by the Addressable Pixel.

      • Remember, a user can visit multiple times, thus be multiple statuses in the Chart, but a single status here in the KPIs.

      • See into User Status for more info.

    • Unique Returning Users

      • Unique users who visited during this period after more than 30 days with no visits. This is based on the customizable Activity Window, see callout below.

      • See into User Status for more info.

    • Conversions / Revenue

      • Depending if you have , you will see the Total Revenue within the time period selected, otherwise we will show you the total number of conversions.

      • We also will show you the number of users who contributed to those conversion or revenue events.

    • Identified Buying Power

      • This is the total sum of the wallet balances in USD for all of the Known-Wallet Users who have visited within the time period selected.

      • We also show the average wallet balance based on that total.

    This is a chart that shows user who had an activity on a given day (or week, month, etc) and the User Status of that user. See deep dive into User Status for more info.

    • All Users

      • Count of any user who visited on a given day. This includes all users (and visitors): wallet, without wallet, known, and anonymous.

    • Revenue

      • Total revenue for a given day from any user (all users) who completed an event resulting in revenue. As you'd expect, you need to have .

      • While the user status are the same defintion, this graph shows dollar amounts from those groups.

    Known-Wallet Users means a user (a) who connected their wallet to your platform or (b) was identified by the Addressable’s Wallet Match. These are users who we know the wallet of and therefore can fully enrich across web2 and on-chain.

    This graph shows the percentage of wallet-known users by their primary country only. The primary country is the most frequented country we've seen this user connect from.

    This graph shows of all the Known-Wallet users that visited your platform, the percentage of wallet-known users that show activities considered suspicious.

    It will always show 100%. If you see select bars that are disabled (grayed out), this is due to a lower data point and avoids misleading visuals.

    In order to be considered a Suspicious Activities, the user has been identified as a suspicious because (a) they have connect >=30 different wallets, (b) When a wallet is tagged as Phishing or Scam by Etherscan or (c) When a wallet is tagged by OFAC's Sanctions List (via Etherscan)

    This graph shows the percentage of wallet-known users in each cohort by popularity. The full list of cohort tags and their definitions can be found on the User Profiles page.

    As a reminder, a single user can have multiple cohorts and therefore can be counted multiple times in the percentages.

    Percentage of wallet-known users by their wallet balance group

    • $0 (No Balance)

    • $0 - $1K

    • $1K - $10K

    • $10K - $100K

    • $100K - $1M

    • >$1M (Whale)

    List of the latest users (up to 10) who converted and is ordered by most recent conversion event. You can click any user to be brought to their full profile on the User Profile page.

    Leaderboard of the top converted users (up to 10) and is ordered by most conversion events. You can click any user to be brought to their full profile on the User Profile page.

    Leaderboard of the top revenue-generating users (up to 10) and is ordered by most conversion events. You can click any user to be brought to their full profile on the User Profile page.

    Understanding 'User Status'

    There are helpful (i) info icons spread throughout the page, that dynamically to explain to you exact what you're looking at.

    By default, the Activity Window is set to 30 days, but can be changed as needed.

    This setting should reflect how long you expect a user should be active for before becoming inactive. As well as at what point they're considered returning.

    You can edit it by selecting "Configure Window" at the top (or Configure in the tooltip)

    Dashboard Overview

    All Users Section

    KPI Cards

    Users By User Status Graph

    Known-Wallet Users Section

    Users by Primary Country

    Users with Suspicious Activities

    Users by Cohorts

    Users by Balance Distribution

    Note: Any icon or tag for Whale, is derived from the user's wallet balance being in the >$1M group..

    Recently Converted Users

    Top Converters

    Top Revenue Makers

    Inactive

    As of today, the user hasn’t visited in over 30 days.

    L2 Users

    When a wallet has a high number of transactions on Layer 2.

    Liquidity Provider

    When a wallet has a high number of Liquidity-based transactions on a specific chain.

    Bridge User

    When a wallet has a high number of Bridge-based transactions on a specific chain.

    Developer

    Holders of NFT associated with developers, such as ETH Denver, Developers Guild, etc.

    Airdrop Farmer Bots

    When the same user has connect at least 30 different wallets.

    DAO Voter

    When a wallet history show that they have voting transactions

    Frequent Conferences Attender

    When a wallet has minted at least 3 POAP NFTs

    Long Term Asset Holder

    When a wallet has a holding that's >50% of their ERC-20 tokens longer than the token's average (Stablecoin excluded)

    High Volume Trader

    When a wallet that exceeded $100,000 in weekly trading volume for at least 25% of weeks since first transaction till now for the last year.

    CEX Users

    When a wallet has received funds from CEX (Centralized Exchanges)

    Phishing/Scam

    When a wallet is tagged as Phishing or Scam by Etherscan

    Sanctioned/Blocked

    When a wallet is tagged by OFAC's Sanctions List (via Etherscan)

    Quester

    When a wallet has made >=5 quest events in the last 2 years with platforms such as Galxe, Layer3, QuestN, or Rabbithole

    Memecoin Early Adopter

    When a wallet has interacted with at least 5 memecoins within a week of a coin’s launch

    Gambler

    When a wallet has withdrawn funds from Stake, Shauufle, or Rollbit (on Ethereum) and sign bets on Polymarket (on Polygon)

    Gambling High Roller

    When a wallet has withdrawn >$50K USD from Stake, Shauufle, or Rollbit (on Ethereum) and sign bets on Polymarket (on Polygon)

    utm_campaign

    Specifies a product promotion or strategic campaign.

    utm_campaign=spring_sale

    utm_term

    Tracks search terms associated with the campaign.

    utm_term=running+shoes

    utm_content

    Identifies what was clicked to navigate to the site, such as a banner ad or text link.

    utm_content=logolink or utm_content=textlink

    Current

    n/a

    Users who visited on this day/week/etc. and also had a visit within the last 30 days.

    deep dive
    deep dive
    Revenue configured
    Revenue configured

    Import Wallet List

    A guide for uploading wallet lists to Addressable

    Overview

    Using Import Wallet List users can upload their own wallet lists directly through the interface. Uploaded lists will be immediately available in the Audience Builder for targeting.

    How to upload a file

    1. Navigate to the Wallet List Upload section.

    2. Click on Upload File and select your CSV, XLS, or XLSX file.

    3. The system will validate the file based on the above requirements.

    4. Upon successful upload, the wallet list will be available in Audience Builder for targeting.

    • CSV, XLS, or XLSX

    • Max File Size: 50MB

    • Max Wallets per File: 500K

    • Only EVM-compatible wallet addresses are supported (e.g., 0x000cD27F10dFFAC73201258EAA3925c0452051A0).

    • ENS addresses are not supported.

    • Smart contract addresses will be ignored.

    • The file must not contain headers.

    • Only the first column will be searched for wallet addresses.

    • If there are errors in the file, a warning icon (triangle) will appear.

    • Hover over the triangle to download the error log.

    • The error log will specify:


    To create a new audience out of an existing list, press the "create as audience" button

    • When saving an audience, only wallets from supported chains are stored.

    • This means you may see fewer addresses in Audience Builder than were originally uploaded.

    Wallet lists appear in the on-chain categories section in the Audience Builder:

    Performance Data Tracking

    Connecting your Ad network account with Addressable provides you with the ability to:

    • Configure and manage paid campaigns directly from your Addressable account.

    • Target your Addressable audiences within the Ad network.

    • Leverage Addressable's optimization engine to auto-optimize your campaigns in accordance with your objectives.

    • Gain insights and advanced analytics about your audiences and their user journeys.

    Addressable has quick and easy integrations for the following networks:

    Twitter (X) Ads Integration
    Reddit Ads Integration
    Addresses from unsupported chains will be ignored.
    Row number where the issue occurred
  • Input received

  • Reason for the error (error message)

  • If the file contains both valid and invalid addresses, the upload status will be marked as "Incomplete".

  • Download the error log to review and correct any issues.

  • sample_wallet_list.csv
    0x000cD27F10dFFAC73201258EAA3925c0452051A0
    0x1B3d2f8C345A1A67F8E2d5E4A3E905A2D1C2A71E
    0x2E59FF8c41E87B0FcD6A27eF3E1C5A1c3D02E42F
    0x3F5CE5FBFe3E9af3971dD833D26BA9b5C936f0bE
    0x4A5fF8bBA2f6D4E5C785e6c8D1A5E9A3F52bA0B6
    0x5b6E54fF28B5B6a9C8B3d2E6F8C7D4A3B6A1A8C2
    0x6C7A3F5bE8D3C2B6A1F4E5D8B3C2F8A7D4B6A5E9
    0x7D8B3C2F5E6A7D4B6A1F8C7A3F5E8D3C2B6A1F4
    0x8E9A3F5B6A7D4B6A1F8C7A3F5E8D3C2B6A1F4E5
    0x9F5E8D3C2B6A1F4E5D8B3C2F8A7D4B6A5E9A3F5

    File Requirements

    Refer to the bekow file template for correct formatting:

    Supported File Formats

    Supported Addresses

    File Structure

    Handling Errors

    Create Audiences

    Attribution with Addressable Pixel (Recommended)

    Some customers use both the Addressable Pixel (for on-site tracking) and the Events API (for off-chain ingestion, backend events, or events from 3rd-party apps). In that setup, you need to include a specific user identifier in your Events API payload so Addressable can correctly attribute those server-side events to the same user sessions the Pixel observed.

    If you're using both the Pixel and API, it is generally always recommended to follow this guide.

    When is this needed

    Use this guide if:

    • You already have the Addressable Pixel installed on your website (via GTM or JS).

    • You also send events through the .

    • You are running campaigns with Addressable.

    • You need like Campaign Attribution for the Event sent by the Events API.

    The Addressable Pixel creates a browser-side identifier stored in local storage at:

    • Key: ___adrsbl_nonce

    To connect Events API events to Pixel-tracked sessions, you will:

    1. Read ___adrsbl_nonce from local storage on the frontend.

    2. Store that value alongside your internal user identifier (user id, wallet address, etc.).

    3. Send it with every Events API call as an event property [see ]:

    That “join key” allows Addressable to attribute server-side events to users who visited your website from campaigns (post-view and post-click where supported).

    — Step 1 —

    Read ___adrsbl_nonce on page view (frontend)

    Add a small snippet that runs on page load (or at least before you plan to associate the user with your backend identity):

    âś… Tip: If adrsblNonce is null, confirm the Pixel is loading and firing on that page.

    — Step 2 —

    Store the nonce alongside your user record (backend)

    When you know who the user is (login, signup, wallet connect, etc.), persist:

    • your internal identifier (internal id / wallet)

    • the latest adrsblNonce you saw for them

    A common pattern is to send the nonce to your backend on logged-in pageview:

    — Step 3 —

    Include it in every Events API call (properties → user_id)

    The Events API supports an optional properties field that is a list of JSON objects. Each property uses name and value. ()

    Add this property to your Events API data payload:

    That’s it — once the same user_id is present on Events API events, Addressable can connect them back to Pixel sessions for campaign attribution. ()

    Below is an example data JSON (before base64 encoding) showing the properties format:

    For full request structure details (endpoint, headers, base64 encoding, etc.), refer to the .

    • properties is optional, but required for this attribution join.

    • If you’re also sending other properties, keep them in the same list (Addressable properties are simple name/value objects).

    • (Pixel JS SDK) properties are name/value objects, and there’s a practical cap on how many you should send per event (keep it tight).

    • ___adrsbl_nonce is missing

      • Confirm the Pixel is installed correctly and firing on that page.

    • Events show up, but still not attributed

    properties: [{ "name": "user_id", "value": "<___adrsbl_nonce value>" }]

    If you'd like to also send your internal user id, please send internal_user_id and reverse user_id for this usage.

  • Verify the Events API properties includes { "name": "user_id", "value": "<nonce>" } exactly.

  • Confirm you’re storing and reusing the same nonce value for that user (not generating your own replacement).

  • Overview of Needs

    Getting Started

    Example Payload

    Notes & constraints

    Troubleshooting

    Events API
    api docs
    addressable.gitbook.io
    addressable.gitbook.io
    Events API docs
    const adrsblNonce = window.localStorage.getItem("___adrsbl_nonce");
    // Store this somewhere safe for a given user in your backend flow (see Step 2)
    await fetch("/api/identify-addressable", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        userId: "<your-internal-user-id-or-wallet>",
        addressableUserId: adrsblNonce
      })
    });
    "properties": [
      { "name": "user_id", "value": "<addressableUserId from ___adrsbl_nonce>" }
    ]
    {
      "tid": "<your pixel id>",
      "event_name": "signup",
      "page_url": "https://example.com/signup",
      "referrer": "https://example.com/",
      "timestamp": 1730538892,
      "timezone_name": "America/New_York",
      "timezone_offset": 240,
      "properties": [
        { "name": "user_id", "value": "c96043..." },
        { "name": "another_example", "value": "yes_it_is" }
      ]
    }

    Attribution Without the Addressable Pixel

    Some organizations have compliance policies that restrict the use of tracking pixels. If your organization enforces a no-pixel policy - read the below.

    What If You Can't Install the Addressable Pixel?

    This guide outlines how to achieve attribution and campaign optimization without using the Addressable pixel.

    Goal

    To enable campaign performance tracking and wallet intelligence without installing the Addressable pixel, customers can leverage server-to-server (S2S) event reporting. This method allows Addressable to:

    • Attribute users to campaigns

    • Optimize performance based on funnel events

    • Maximize Return on Ad Spend (ROAS)

    To ensure accurate tracking and attribution, the customer should:

    1. Use a persistent unique user identifier Ensure each user has a unique ID that persists for at least 30 days. This allows Addressable to correlate multiple events to the same user.

    2. Report funnel events via the S2S API Events may include: page_view (or site visit), button_click , sign_up , wallet_connect , conversion


    Attribution is divided into two categories: post-click and post-view.

    Post-Click Attribution

    Triggered when a user clicks an ad.

    • UTM parameters such as utm_campaign, utm_source, utm_medium, utm_content, and clickID are generated.

    • These parameters should be captured in the page URL and reported back to Addressable via the S2S API on the page_view event.

    Post-View Attribution

    Triggered when a user views (but does not click) an ad.

    • The ad sends UTM parameters along with a unique ViewID.

    • When the user later engages with the website, the event should include both:

      • The user_id

    This enables Addressable to match the ad view to the user and attribute the action accordingly.


    Include tracking parameters in each event Send the following metadata alongside each event: user_id , URL parameters (e.g., UTMs, ViewID)

  • Include revenue-related parameters For ROAS calculation and deduplication: amount , transaction_hash , tokens_transferred or currency_exchanged

  • The original ViewID

    Requirements for S2S Attribution

    Attribution Overview

    spinner
    spinner
    spinner
    spinner
    spinner
    spinner