Tracking & Postback

This book covers tracking setup, postback integration, conversion attribution, and troubleshooting on the DAO.AD platform.

Concepts

Concepts

How tracking works

Summary

This guide explains how click tracking and postback tracking work in DAO.AD. You will learn how to track conversions, pass click identifiers, and configure postbacks with or without a third-party tracking platform.

What is Tracking?

Tracking allows advertisers to identify which clicks, sources, campaigns, and creatives generate conversions.

Without tracking, DAO.AD can only report clicks and impressions. With tracking configured, advertisers can measure leads, sales, ROI, and optimize traffic sources.

What is a Postback?

A postback is a server-to-server notification sent after a conversion occurs.

When a user completes a target action (registration, purchase, lead, install, etc.), the advertiser's system or affiliate network sends a conversion notification containing the original click identifier.

This allows DAO.AD to match the conversion with the original click.

How click tracking works

Step 1
User clicks a DAO.AD advertisement.

Step 2
DAO.AD generates a unique click identifier: {click_id}

Step 3
DAO.AD sends the user to the destination URL while passing the click identifier.
Example:
https://tracker.com/?clickid={click_id}

Step 4
The click identifier is stored by the tracking system or CPA network.

Step 5
When the conversion happens, the stored click identifier is sent back through a postback URL.

Why postbacks are important

Postbacks allow DAO.AD to:

Without a postback, DAO.AD can track clicks and impressions only.

    Concepts

    Tracking Configuration Models

    Summary

    Tracking Configuration Models describes three common tracking setup models and how data flows between DAO.AD, tracking systems, and conversion sources.

    Standard tracking configuration

    Model 1: Direct CPA Integration

    1_tracking_models_daoad.png

    Steps:

    1. User clicks to the DAO.AD advertisement (your creative).
    2. DAO.AD generates a unique click ID and sends the user to the CPA network.
    3. The CPA network stores DAO.AD's click ID and redirects the user to the landing page.
    4. The user completes the target action (conversion), and the CPA network receives the conversion status from the landing page.
    5. The CPA network sends a postback to DAO.AD containing the click ID and conversion data.

    Model 2: Tracker Integration

    2_tracking_models_daoad.png

    Steps:

    1. User clicks to the DAO.AD advertisement (your creative).
    2. DAO.AD generates a unique click ID and sends the user to the tracking system (e.g., Binom or Keitaro).
    3. The tracking system passes DAO.AD's click ID to the CPA network using its own parameter name. The parameter name may differ, but the value always contains DAO.AD's original click ID.
    4. The CPA network stores the tracking system click ID and redirects the user to the landing page.
    5. The user completes the target action (conversion), and the CPA network reports the conversion to the tracking system.
    6. The tracking system sends a postback to DAO.AD with the click ID and conversion data.

    Model 3: Own Landing Page

    3_tracking_models_daoad.png

    Steps:

    1. User clicks to the DAO.AD advertisement (your creative).
    2. DAO.AD generates a unique click ID and sends the user directly to the advertiser's landing page.
    3. The user completes the target action (conversion), and the advertiser's system sends a postback directly to DAO.AD.

    Concepts

    Tracking Parameters

    Summary

    This page lists all URL macros available in DAO.AD and explains how to pass campaign data to CPA networks and tracking platforms.

    Macro Value Description
    {click_id} numeric Unique Click ID
    {campaign_id} numeric Campaign ID
    {creative_id} numeric Creative ID
    {source_id} numeric Publisher Source ID
    {sub_id} text Publisher Sub-Source ID
    {price} numeric Campaign bid price (per 1000 clicks)
    {country} text, ISO code User country (ISO code)
    {subs_age} constant, text The age of subscription in days: 1-3, 4-7, 8-15, 16+
    {model_price} constant, text Campaign pricing model (CPC or CPM)
    {cpc} numeric Actual cost per click (CPC)
    {quality} constant, text Traffic quality: low, regular, high, premium
    {category} constant, text Campaign category: adult, racy, or mainstream
    {category_src} constant, text Traffic source category: adult, racy, or mainstream
    {city} text User city
    {region} text User region
    {ref} text Referring page full URL
    {ip} IP User IP address
    {os} text User operating system
    {browser} text User browser

    These macros can be added to your destination URL and passed to a CPA network or tracking platform for reporting and optimization purposes.

    Example URL

    https://tracker.com/click?
    clickid={click_id}
    &source={source_id}
    &campaign={campaign_id}
    &country={country}

    where:

    tracker.com - example CPA network or tracking platform URL
    clickid, source, campaign, country, etc. - are example parameters used by a CPA network or tracking platform. DAO.AD replaces the macros with actual values before redirecting the user. Parameter names may differ depending on the CPA network or tracker.

    How macro replacement works

    DAO.AD URL:
    https://tracker.com/click?clickid={click_id}&country={country}

    After click:
    https://tracker.com/click?clickid=123456789&country=US

    Concepts

    Postback Parameters

    Summary

    This page describes the parameters available for sending postback requests from a CPA network or tracking platform to DAO.AD.

    URL Parameter Value Description
    DAO.AD API Server constant DAO.AD postback endpoint URL
    key text Unique API key used to authenticate server-to-server (S2S) postback requests.
    sum numeric Conversion value or lead payout amount
    click-id numeric Unique Click ID received from DAO.AD URL macros
    type text The postback type (default is main). Common values include: main (e.g., registration), dep (e.g., deposit), or any custom types you define
    ttl numeric Time in secounds. The postback request time-to-live (TTL). During this period, any postback containing the same Click ID will be treated as a duplicate and ignored. The default value is 24 hours. Minimum value 5 seconds

    Important: The API key can be found on your DAO.AD Profile page.

    Example URL

    http://api.daopush-api.info/api/postback/campaign?key=XXXXXXXXXXXXX&sum={sum}&click-id={click-Id}&type={type}&ttl={ttl}

    where:

    XXXXXXXXXXXXX - your DAO.AD API key
    {sum}, {click-Id}, {type}, {ttl} - example macro names used by a CPA network or tracking platform.


    How macro replacement works

    DAO.AD URL:
    http://api.daopush-api.info/api/postback/campaign?key=XXXXXXXXXXXXX&sum={sum}&click-id={click-Id}&type={type}&ttl={ttl}

    After CPA/Tracker request:
    http://api.daopush-api.info/api/postback/campaign?key=XXXXXXXXXXXXX&sum=10&click-id=61721111&type=dep&ttl=50

    Important: These macro names are examples only and may differ depending on the CPA network or tracking platform. Always refer to the documentation of your CPA network or tracker.


    Why is it needed?

    After a user completes a conversion, the CPA network or tracking platform sends conversion information back to DAO.AD. This data is used for reporting, optimization, automated rules, micro-bidding, and campaign analytics.

    Benefits of postback tracking:

    Trackers and Examples

    This chapter contains examples of integrations with common known trackers with DAO.AD

    Trackers and Examples

    Keitaro

    Summary

    This guide explains how to integrate Keitaro with DAO.AD for click tracking and conversion tracking.

    Before You Begin
    Keitaro Tracking Flow

    flow_Keitaro_DAOAD_integration_flow.png

    Steps
    1. Sign in to Keitaro tracker.
    2. Open the "Traffic Sources" menu.
      4_keitaro_tracking_schema.png
    3. Click the "Create" button and select the "DAO.AD" template.
      keitaro_2_tracking_schema.png
    4. Locate the "S2S Postback" section and click the Edit button.keitaro_3_tracking_schema.png 
    5. Configure the postback URL using the URL constructor.keitaro_4_tracking_schema.png
    6. Replace the API key placeholder with your DAO.AD API key from DAO.AD Profile page and click Apply.
    7. Verify that all parameters are configured correctly.keitaro_6.1_tracking_schema.png
    8. Save the created traffic source.
    9. Go to "Campaigns" menu in Keitaro tracker.
    10. Create a campaign connected to your CPA network or landing page.
    11. Select the previously created "DAO.AD" traffic source and save the campaign.key_3_tracking_schema.png
    12. Copy the campaign URL by clicking the Link icon.5_keitaro_tracking_schema.png
    13. Paste the campaign URL into the Creative URL field in DAO.AD.6_keitaro_tracking_schema.png
    14. Save the creative and campaign settings in DAO.AD.
    How it works

    This allows DAO.AD to attribute conversions to the correct traffic source and optimize campaign performance.
    Trackers and Examples

    Voluum

    Summary

    This guide explains how to integrate Voluum with DAO.AD for click tracking and conversion tracking.

    Before You Begin
    Voluum Tracking Flow

    flow_Voluum_Tracking_FLOW.png

    Steps
    1. Sign in to Voluum tracker.
    2. Open the "Traffic sources" menu and click "Create".

      vol-1-tracking-schema.png



    3. Locate the "DAO.AD" template.

      vol_2_tracking_schema.png

    4. Scroll down to the "Passing conversion info to traffic source" section.
    5. Replace the API key placeholder with your DAO.AD API key from the DAO.AD Profile page and click Save.

      vol_3_tracking_schema.png
    6. Go to "Campaigns" menu in Voluum tracker.
    7. Create a campaign connected to your CPA network or landing page.
    8. Select the previously created "DAO.AD" traffic source and choose a traffic type (optional).

      vol_4_tracking_schema.png
    9. Add a previously created Offer in Voluum (for example, a CPA offer or landing page).

      vol-5-tracking_schema.png

    10. Open the Tracking & Automizer tab and copy the Voluum Campaign URL.

      vol-6-tracking-schema.png

    11. Paste the Voluum Campaign URL into the DAO.AD Creative URL field and click Save.
    How It Works

    This allows DAO.AD to attribute conversions to the correct traffic source and optimize campaign performance.

    Trackers and Examples

    Binom

    Summary

    This guide explains how to integrate Binom with DAO.AD for click tracking and conversion tracking.

    Before You Begin
    Binom Tracking Flow

    binom_tracking_flow (1).png

    Steps
    1. Sign in to Binom.
    2. Open the "Traffic sources" menu and click "Create".

      binom_1_tracking_schema.png


    3. Click "Load from template"

      binom_2_tracking_schema.png

    4. Find "DAO.AD" in the list of predefined templates.

      binom_3_tracking_schema.png

    5. Replace the placeholder API key with your DAO.AD API key from the DAO.AD Profile page and click Save.

      binom_4_tracking_schema.png

    6. Go to "Campaigns" menu in Binom.
    7. Create a campaign connected to your CPA network or landing page.
    8. Select the previously created "DAO.AD" traffic source.
    9. Copy the campaign URL by clicking the link icon next to the campaign name.

      binom_5_tracking_schema.png

    10. Paste the Binom Campaign URL into the DAO.AD Creative URL field and click Save.
    How It Works

    This allows DAO.AD to attribute conversions to the correct traffic source and optimize campaign performance.

    Trackers and Examples

    Bemob

    Summary

    This guide explains how to integrate Bemob with DAO.AD for click tracking and conversion tracking.

    Before You Begin
    Bemob Tracking Flow

    bemob_tracking_flow (1).png


    Steps
    1. Sign in to Bemob.
    2. Open the "Traffic sources" menu and select "New from template".

      bemob_1_tracking_schema.png
    3. Find "DAO.AD" in the list of predefined templates.

      bemob_2_tracking_schema.png

    4. Replace the placeholder API key with your DAO.AD API key from your DAO.AD Profile page and click Save.

      bemob_3_tracking_schema.png

    5. Go to "Campaigns" menu in Bemob.
    6. Create a campaign connected to your offer or landing page.
    7. Select the previously created "DAO.AD" traffic source.bemob_4_tracking_schema.png
    8. Copy the Campaign URL by clicking the copy icon next to the Campaign URL field.

      bemob_5_tracking_schema.png

    9. Paste the Bemob Campaign URL into the DAO.AD Creative URL field and click Save.
    How It Works

    This allows DAO.AD to attribute conversions to the correct traffic source and optimize campaign performance.

    Trackers and Examples

    Test a Conversion (HTTP Examples)

    Summary

    This guide explains how to manually test a conversion postback using a web browser or HTTP request tools. It helps verify that your tracking configuration is working correctly before launching a campaign.

    When should you use this?

    Use conversion testing when:

    test_conv_flow (1).png

    Example DAO.AD Postback URL
    http://api.daopush-api.info/api/postback/campaign?
    key=YOUR_API_KEY
    &sum=1
    &click-id=123456789
    &type=main

    Parameter explanation:

    Parameter Example Description
    key YOUR_API_KEY DAO.AD API key
    sum 1 Conversion payout
    click-id 123456789 Original click ID
    type main Conversion type

    Method 1: Browser Test

    Simply open the URL in your browser:

    http://api.daopush-api.info/api/postback/campaign?key=YOUR_API_KEY&sum=1&click-id=123456789&type=main

    Expected result:

    {"status":"success"}

    or similar success response.

    Method 2: cURL Example

    Linux / macOS / Windows Terminal

    curl "http://api.daopush-api.info/api/postback/campaign?key=YOUR_API_KEY&sum=1&click-id=123456789&type=main"

    Expected result:

    {"status":"success"}
    Method 3: Keitaro Test
    1. Open the campaign.
    2. Find a real Click ID.
    3. Replace {external_id} with that Click ID.
    4. Send the postback manually.
    5. Verify that the conversion appears in DAO.AD statistics.
    Method 4: Binom Test
    1. Open Click Log.
    2. Copy a valid Click ID.
    3. Execute the postback URL manually.
    4. Check DAO.AD Reports.
    Common Errors

    Invalid API Key

    {"status":"error","message":"invalid key"}

    Solution:
    Verify the API key from your DAO.AD Profile page.

    Missing Click ID

    {"status":"error","message":"click-id not found"}

    Solution:
    Use a valid Click ID generated by DAO.AD.

    Duplicate Conversion

    {"status":"error","message":"duplicate conversion"}

    Solution:
    Check the TTL parameter or use a new Click ID.