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
Go to 'Pixel Definitions' tab in the affiliate profile and click 'Create'
Write a Name for the pixel
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).
Choose the Action on which to trigger the pixel
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.
A typical server-side pixel might look similar to the following:
https://pixelserver.com?click_id={{afp}}&lead_id={{registration_id}}
Where:
{{registration_id}} - is part of TAP's internal parameters supported out of the box.
{{afp}} - is an example of a dynamic custom parameter used by the affiliate to fit dynamic data like click_id in a PPC campaign etc.
Additional Parameters
Available for S2S HTTPS pixels
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}}.
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.
As Instagram is a part of the Meta ecosystem, the setup for Facebook Ads Pixel will also apply to Instagram Ads. The same Pixel ID and configuration used for Facebook will track conversions and events on Instagram as well. Affiliate doesn't need a separate integration just for Instagram, as long as:
Affiliate's Instagram campaigns are running under the same Meta Business account (and linked to the same Pixel/Data Source)
Any server-side events sent via the Facebook Conversions API will automatically work for both Facebook and Instagram traffic.
How to set Facebook/Instagram API pixel
Follow the steps for creating a pixel and choose pixel type FB/Instagram API
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.
How to pass FBCLID to TAP on user visit: 1. Affiliate builds a tracking link from TAP: https://go.aff.theaffiliateplatform.com/1dshoj2 2. Meta appends FBCLID via auto-tagging upon user visit
Example: https://go.aff.theaffiliateplatform.com/1dshoj2k?fbclid=IwAR0EXAMPLE123abc456XYZ789
TikTok API
How to set TikTok API pixel
Follow the steps for creating a pixel and choose pixel type TikTok API
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.
How to pass TTCLID to TAP on user visit: 1. Affiliate builds a tracking link from TAP: https://go.aff.theaffiliateplatform.com/1dshoj2 2. TikTok appends TTCLID via auto-tagging upon user visit
Example: https://go.aff.theaffiliateplatform.com/1dshoj2k?ttclid=1a2b3c4d5e6f7g8h9i
Google Ads
How to set Google Ads API pixel
Follow the steps for creating a pixel and choose pixel type Google Ads
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.
How to pass GCLID to TAP on user visit: 1. Affiliate builds a tracking link from TAP: https://go.aff.theaffiliateplatform.com/1dshoj2 2. Google Ads appends GCLID via auto-tagging upon user visit
Example: https://go.aff.theaffiliateplatform.com/1dshoj2k?gclid=EAIaIQobChMI2MqR0P2h_gIVkZBoCR0HgEgIO
Last updated
Was this helpful?