Traffic source postback
Some traffic sources optimize campaigns internally which requires you to pass information about conversions.
How it works
Generally, here is how conversions get passed to the traffic source:
- — A traffic source uses a special token to pass their own click ID to Binom.
- — If a conversion gets registered for that click, Binom will send out a postback (S2S).
- — The postback to be sent will contain the ID that Binom had received from the traffic source.
S2S Postback setup
Binom has two places where the S2S postback could be set up:
- In Postback URL when editing the Traffic Source;
- In Advanced Settings > S2S Postback when editing the campaign.
Please note that the campaign and traffic source settings related to postbacks will be taken into account. In case there is a contradiction, the value set in the campaign will be used.
The traffic source ID is passed using {externalid}. You can also pass other parameters in the postback link, such as {cnv_status} for conversion status.
-
Available tokens
-
Token Description {clickid} ID of the click {affiliate_network_id} ID of the Aff. network {affiliate_network_name} Name of the Aff. network {browser_name} Browser name {browser_version} Browser version {campaign_group_id} Campaign group ID {campaign_group_name} Campaign group name {campaign_id}, {campaign} Campaign ID {campaign_key} Campaign key {campaign_name} Campaign name {city} City {clickcost} Cost of the click {continent} Continent {continent_code} Continent code {country} Country {country_code} Country code {date} Date of click {device_brand} Device brand {device_model} Device model {device_name} Device name {device_type} Device type {campaign_domain}, {domain} The domain in the campaign settings {cnv_status}, {status} Conversions status {cnv_status2}, {status2} Conversion status2 {cnv_currecny} Payour currency {event1}, {event2} ... {event30} Number of event {externalid} Traffic source token External ID {ip} IP of the click {isp} Internet provider {landing_id}, {lander} Landing ID {landing_name} Landing name {landing_number} Number of landing in Path {language} Browser language {lp_key} LP key {offer_id} Offer ID {offer_link} Link to offer {offer_name} Offer name {offer_number} Number of offer in Path {os_name} OS {os_version} OS version {path_name} Name of Path in campaign {path_number} Number of Path in campaign {payout} Overall payout sum {postback_payout} Payout included in the latest postback {redirect_time} Redirect time {referer} Referer {ref_domain} Domain of the referer {real_domain} Domain that was used in the campaign link {region} Region {region_code} Region code {revenue} Counts the reveune with formula: payout - cost. {rule_name} Name of the Rule in Campaign {resolution} Device resolution {state} State\Province {state_code} State\Province code {t1}, {t2}, {t3} ... {t30} Tokens of the Traffic source {traffic_source_id}, {trafficsource} Traffic source ID {traffic_source_name}, {trafficsource_name} Traffic source name {uclick} Identifier of a unique visitor {unixtime}, {time} Current time in Unix format {unixconversiontime} Date of the conversion creation in Unix format {user_agent} User-agent {week} Number of the week when click was created {owner_id}, {user_id} Campaign owner ID {owner_name}, {user_name} Campaign offer name
-
Detailed information on postbacks can be found in Binom's conversion log.
ExoClick example
Let us take a look at ExoClick for a setup example:
- Specify the relevant token as External ID in the traffic source in Binom. For ExoClick, it's
{conversions_tracking}.
- Specify
{externalid}in the Postback URL of that same traffic source and use your ExoClick API key in API_ID.
Status-postback relation
Some traffic sources might require different postback links depending on the conversion status.
In that case you can enable Status-postback relation:
Specify the required conversion status in Conversion status, and put the corresponding postback link into Postback link. This setup will have Binom sending out different postbacks according to the conversion status received.
+Add will add another status-postback pair to the list.