S2S Conversion Postback
When a user clicks your ad which has set tracking code, MediaGo will provide your server with a tracking id.
(Visit How do I add URL Parameter tracking to my campaign to know how to get tracking id).
When a conversion is happened, you need to send back the conversion information by the postback url with the ${TRACKING_ID} value.
The format of the postback url:
https://sync.mediago.io/api/bidder/postback?trackingid=${TRACKING_ID}&adid=${AD_ID}&conversiontype=${CONVERSION_TYPE}&conversionprice=${CONVERSION_PRICE}&includeintotalconversion=${INCLUDE_INTOTAL}&accountname=${ACCOUNT_NAME}
1
For example:
https://sync.mediago.io/api/bidder/postback?trackingid=3990b3995f7070b7727c18e074c76701&adid=1000000&conversiontype=1&conversionprice=3.5&includeintotalconversion=1&accountname=my_account_name
1
| field | necessity | description | tracking code macro |
|---|---|---|---|
| trackingid | required | The tracking id of the ad. Place the value of the tracking macro ${TRACKING_ID} in the param trackingid of the postback url.It is vital to postback the tracking id, otherwise your Conversions will not be tracked. |
${TRACKING_ID} |
| adid | recommended | The id of your ad. Place the value of the tracking macro ${AD_ID} in the param adid of the postback url. |
${AD_ID} |
| conversiontype | recommended | A value of Conversion Type（See Table1.1 - Conversion Type Map ）. Default 1 - View Content. |
|
| conversionprice | recommended | A value of the revenue to caculate the ROAS. It can be any full or decimal number, with no commas. | |
| includeintotalconversion | recommended | A value to flag out the final important conversion. It can be 1 or 0, default 1. If the value is 1, the Conversion data is included in the convesion column of Dashboard. If the value is 0, this Conversion is an intermediate conversion process, which will not be included in the total conversion column, but will be included in the corresponding conversion type column. |
|
| accountname | recommended | Your account name to help us locate the problems in our system logs, if you have any questions with the conversion postback. |
Table 1.1 - Conversion Type Map
| type | value |
|---|---|
| View Content | 1 |
| App Install | 2 |
| Complete Registration | 3 |
| Add to Cart | 4 |
| Add Payment Info | 5 |
| Search | 6 |
| Start Checkout | 7 |
| Purchase | 8 |
| Add to Wishlist | 9 |
| Lead | 10 |
| Click Button | 12 |