▪️Pixel tool (Postbacks / Callbacks)

Types of pixels

TAP offers different types of Pixels (also called Postbacks or Callbacks):

  • S2S HTTPS - Server to Server pixel call with GET method

  • Facebook/Instagram API - Server-Side Conversion Tracking

  • TikTok API - Server-Side Conversion Tracking

  • Google Ads - Server-Side Conversion Tracking

S2S HTTPS Pixel is calling any specified URL with a set of dynamically appended parameters based on the affiliate request. FB/Instagram API, TikTok API and Google Ads API pixels are sending events to the social media platforms using Conversions API.

Pixel triggering events/actions

Each of the pixels can be triggered on the following events/actions (considering the necessary data was reported to TAP). Affiliates can set more than one pixel definition (triggered on same or different events).

  • Lead - will be triggered when a new registration is reported to the affiliate platform;

  • Qualified Lead - will be triggered when a new registration has passed the deal qualifications (only for CPL deals);

  • FTD - will be triggered when a new FTD (First-Time Deposit) is reported to the affiliate platform;

  • QFTD - will be triggered when a new FTD passes all qualifications (only for CPA deals)

How to create pixel defintion

  1. Go to 'Pixel Definitions' tab in the affiliate profile and click 'Create'

  2. Write a Name for the pixel

  3. Choose the Deal you want to relate the pixel to. You can choose Global for any deal, or a specific deal among the different deals configured for the affiliate. Pixels will be fired only for players that are assigned to a deal (any deal or a specific deal, according to the pixel definition).

  4. Choose the Action on which to trigger the pixel

  5. Choose the Type of Pixel and fill in the necessary information.

Server-to-server pixels (S2S)

Server-to-server pixels are defined as URLs that link to the server location with a set of dynamically appended parameters based on the affiliate request.

Additional Parameters

Pixel URLs can include Default supported parametrs or Custom parameters. TAP will collect any additional parameters the affiliate is sending, so later they can passed back in the pixel.

For Default parameters supported by TAP, explanations can be found in 'List of Default parameters' below or when hovering over the parameter in the Pixel Definition modal. Parameters without any explanations will be those collected by TAP from all clicks ever made on the affiliate's tracing links. From the example below, custom parameter is for {{click_id}}.

List of Default parameters

{{deal_id}} - ID of the deal that is matched to the customer brand, country, source id, campaign id {{deal_group_id}} - ID of the deal group that was set in the original link used by customer {{deal_group_name}} - Name of the deal group {{campaign_id}} - Campaign ID if it was specified in the original link used by customer {{campaign_name}} - Campaign name that corresponds to campaign_id {{brand_id}} - ID of the brand {{brand_name}} - Name of the brand {{link_id}} - ID of the destination link to which customer was redirected {{link_name}} - Link name that corresponds to link_id {{asset_id}} - ID of the media asset if it was specified in the original link used by customer {{asset_name}} - Media asset name that corresponds to asset_id {{asset_type}} - Media asset type that corresponds to asset_id (e.g. email, banner etc.) {{country_code}} - 2 symbol country code of the customer used in registration {{source_id}} - Optional source_id if it was specified in the original link used by customer {{registration_id}} - Unique ID of registration in Affiliation system {{customer_id}} - ID of the customer as it's known in the destination platform {{payout}} - Payout amount for CPA or CPL deals {{payout_currency}} - 3 symbols currency code of the payout amount {{utm_source}} - Additional parameter passed by affiliate {{utm_medium}} - Additional parameter passed by affiliate {{utm_campaign}} - Additional parameter passed by affiliate {{afp}} - Additional parameter passed by affiliate {{afp1}} - Additional parameter passed by affiliate {{afp2}} - Additional parameter passed by affiliate {{afp3}} - Additional parameter passed by affiliate {{afp4}} - Additional parameter passed by affiliate {{afp5}} - Additional parameter passed by affiliate {{afp6}} - Additional parameter passed by affiliate {{afp7}} - Additional parameter passed by affiliate {{afp8}} - Additional parameter passed by affiliate {{afp9}} - Additional parameter passed by affiliate {{deposit}} - Total deposits known to affiliate system at the moment of sending pixel {{registration_date}} - User registration date in unix epoch format {{first_deposit_amount}} - User first deposit amount {{first_deposit_date}} - User first deposit date in unix epoch format

If you are an affiliate, go to "Pixels" and click "Create". A creation model will open for you to fill the necessary information.

Facebook/Instagram API

This feature allows the affiliate platform to send conversion events directly to Facebook or Instagram (via the Conversions API). By sharing this data, you help Facebook Ads or/and Instagram Ads systems optimize campaigns more accurately, resulting in better performance and reporting.

How to set Facebook/Instagram API pixel

  1. Follow the steps for creating a pixel and choose pixel type FB/Instagram API

  2. Set the following details:

  • Facebook Pixel ID: Your unique Pixel (Data Source) ID in Facebook (e.g., 1234567890).

  • Facebook Access Token: A valid token granting permission to send conversion events on your behalf. Access token is obtainable via your Facebook Business Manager or Events Manager setting

If you are an affiliate, go to "Pixels" and click "Create". A creation model will open for you to fill the necessary information.

What is FBCLID?

The FBCLID (Facebook Click Identifier) is a unique ID, appended to URLs when an user clicks on a Facebook/Instagram ad. It is used to identify the specific ad click. Adding FBCLID is usually not a manual process, but is handled by Meta. The affiliate is responsible for passing FBCLID upon user's visit (via their tracking link). TAP will store the FBCLID and will return it in the postback.

TikTok API

How to set TikTok API pixel

  1. Follow the steps for creating a pixel and choose pixel type TikTok API

  2. Set the following details:

  • Pixel code : Your unique Pixel code/ID in TikTok (e.g. 1234567890).

  • Access token: A valid token granting permission to send conversion events on your behalf. Access token can be generated in TikTok Business Center (Events Manager or Developer Tools)

If you are an affiliate, go to "Pixels" and click "Create". A creation model will open for you to fill the necessary information.

What is TTCLID?

The TTCLID (TikTok Click Identifier) is a unique ID, appended to URLs when an user clicks on a TikTok ad. It is used to identify the specific ad click. Adding TTCLID is usually not a manual process, but is handled by TikTok. The affiliate is responsible for passing TTCLID upon user's visit (via their tracking link). TAP will store the TTCLID and will return it in the postback.

Google Ads

How to set Google Ads API pixel

  1. Follow the steps for creating a pixel and choose pixel type Google Ads

  2. Set the following details:

  • Conversion ID: Your unique unique identifier assigned to your Google Ads account (e.g. AW-123456789).

  • Conversion Label: Unique identifier for a specific conversion action within your Google Ads account.

If you are an affiliate, go to "Pixels" and click "Create". A creation model will open for you to fill the necessary information.

What is GCLID?

The GCLID (Google Click Identifier) is a unique ID, appended to URLs when an user clicks on a Google ad. It is used to identify the specific ad click. Adding GCLID is usually not a manual process, but is handled by Google Ads. The affiliate is responsible for passing GCLID upon user's visit (via their tracking link). TAP will store the GCLID and will return it in the postback.

Last updated

Was this helpful?