In order to optimize your campaigns a traffic source can use S2S (server-to-server) postback which is aimed to pass the conversions data from BeMob to the side of traffic source.
¶ Postback URL
The postback request is forwarded to the traffic source when a conversion is successfully registered in BeMob.
If a traffic source supports the postback tracking, the dedictaed postback URL will be available in your traffic source panel.
If you are struggling with finding the postback URL, we recommend to contact the support team of traffic source.
Not all the traffic sources are supporting the postback tracking. In this case the postback settings can be ignored.
Always refer to the documentation or address the support team of traffic source.
As usual the postback URL contains:
- unique parameter for click ID;
- additional parameters which are used to identify your postback URL. These can be account ID, advertizer ID, campaign ID or any other value.
- payout parameter to forward the amount received for a successful conversion.
¶ Unique Parameter for External ID
External ID is a unique value generated by a traffic source to track the incoming and outgoing traffic data.
This unique value is forwarded from traffic source to BeMob each time your campaign URL is clicked.
This value is recorded in BeMob reports as external ID.
To receive the external ID value from your traffic source it is required to complete correctly the External ID field with dedicated parameter and token in the traffic source settings on the side of BeMob.
For instance, PropellerAds is using visitor_id parameter and ${SUBID} token to pass the external ID to BeMob.
Each traffic source has its own dedicated parameter and token to pass the click ID. Make sure you introduce the correct values, otherwise the external ID will not be passed to the tracker.
When a conversion is registered in BeMob, it will be passed to your traffic source via postback URL.
The postback URL on the side of BeMob should contain the {externalId} token.
{externalId} is BeMob dedicated token to pass the click ID of conversion via postback to the side of your traffic source.
The {externalId} token should be added next to the corresponding external ID parameter of your traffic source.
For instance, PropellerAds is using visitor_id parameter in postback URL, which means that {externalId} token should be added along with this parameter.
¶ Payout
Some traffic sources are requesting to pass the payout value within postback.
It means that along with the click ID your traffic source will receive the revenue value associated with the conversion.
{payout} token should be added to the corresponding parameter in the postback URL to pass the revenue value.
Payout value is always passed to traffic source in account currency selected as default in your BeMob settings.
If it is required to pass this value in different currency, you should use {payout.CURRENCY} token in the postback URL.
For instance, if your account currency is EUR, but the conversion payout value should be passed to the traffic source in USD, it is required to add {payout.USD} in postback URL in traffic source settings.
This action will allow to convert the payout value from the account currency into the currency preferred with your traffic source.
Otherwise the conversion payout will be passed in the account currency which will cause the discrepancy between report of traffic source and tracker.
If you are working with RevShare cost model, it is required to use {campaignCpa} token instead of {payout} to pass revenue data.
Also note that {campaignCpa} token will be passing the revenue value in account currency.
To pass the revenue value in required currency it is required to use {campaignCpa.CURRENCY} token.
For instance, if your account currency is EUR, but the revenue value should be passed to the traffic source in USD, it is required to add {campaignCpa.USD} in postback URL in traffic source settings.
This action will allow to convert the payout value from the account currency into the currency preferred with your traffic source.
¶ Available URL Tokens
The list of tokens below the postback URL field is required to pass the additional data on conversion in postback to the side of traffic source.
Tokens should be included in the postback URL only if you traffic source can accept them.
Do not add the tokens randomly.
BeMob tokens can be divided into several groups according to the type of data they pass to the traffic source.
If it is required to pass the geo of conversion to the traffic source, you should add &geo={country} or &geo={region} or &geo={city} in the postback URL.
Make sure you specify the parameter name which is used with your the traffic source to accept the conversion data.
You can add any amount of required tokens to the postback URL, but make sure that your traffic source can accept and receive all of them.
Check these guides for other settings:
➡️ How to Track Zone IDs, Campaign IDs etc
➡️ Why the Postback Is Required
If you have any questions or need the assistance with the settings, contact our support team through the live chat or at support@bemob.com