Advertiser integration
From wiki.taptica.com
(Difference between revisions)
(→Advertiser Tracking) |
|||
| (36 intermediate revisions by one user not shown) | |||
| Line 1: | Line 1: | ||
=== Advertiser Tracking === | === Advertiser Tracking === | ||
| − | Taptica works as a mediation layer between advertisers and publishers. We need to be | + | Taptica works as a mediation layer between advertisers and publishers. We need to be prompted by the advertiser whenever a conversion takes place and notified the publisher that conversion was close. |
| − | this section | + | this section includes the postback Taptica expects to receive from the advertiser in order to close conversion. |
| − | + | === Conversion (Install) PostBack === | |
| − | |||
| − | + | There are many tracking solution in the industry, such as TUNE, Appsflyer, Kochava Adjust...and many more systems Taptica has already been integrated with. | |
| + | Taptica expects to receive S2S postback upon conversion and post-install events (goals). | ||
| − | |||
| − | |||
| − | + | http://tracking.taptica.com/aff_lsr?tt_cid={tt_cid}&tt_adv_id=XYZ&tt_adv_sub={tt_adv_sub}&tt_time={unix_time}&tt_idfa={user_idfa}&tt_advertising_id={user_GAID}&tt_appid={store_appid}&vta_install=0 | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
'''Taptica Keys''' | '''Taptica Keys''' | ||
| Line 46: | Line 25: | ||
|'''Description''' | |'''Description''' | ||
|'''Example''' | |'''Example''' | ||
| − | |''' | + | |'''Dynamic''' |
|- | |- | ||
| Line 129: | Line 108: | ||
|tt_advertising_id_sha1 | |tt_advertising_id_sha1 | ||
|Use for send Taptica Android advertising ID in SHA1 format | |Use for send Taptica Android advertising ID in SHA1 format | ||
| − | | | + | |tt_advertising_id_sha1=32f2e52e8157fcb729d799d1ca69160df2edf8974 |
|Yes | |Yes | ||
|- | |- | ||
| Line 136: | Line 115: | ||
|tt_advertising_id_md5 | |tt_advertising_id_md5 | ||
|Use for send Taptica Android advertising ID in MD5 format | |Use for send Taptica Android advertising ID in MD5 format | ||
| − | | | + | |tt_advertising_id_md5=2315w52e8157fcb729d799d1ca691608speofd2 |
|Yes | |Yes | ||
|- | |- | ||
| Line 182: | Line 161: | ||
|- | |- | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | + | VTA Install | |
| − | | | + | |vta install |
| − | |Use for send Taptica | + | |Use for send Taptica the VTA conversion indication |
| − | | | + | |vta_install=1/0 or vta_install=true/false |
| − | | | + | |NO |
|- | |- | ||
| − | |||
|} | |} | ||
'''[[For example]]''' | '''[[For example]]''' | ||
| − | This post back link | + | This post back link contains plain IDFA and Mac Address in md5. |
| − | http://tracking.taptica.com/aff_lsr?tt_cid= | + | http://tracking.taptica.com/aff_lsr?tt_cid=2ab818fe8e574f41838780cb2f6230da&tt_adv_id=123456&tt_adv_sub=dc1816eac806878e8d1d5a8ee9406a3f71407895&tt_time= 1503224984&tt_idfa=771468523E3346ABAA04E207BBAF094B&tt_mac_md5=80efe2256d548c85ca2f2d18de241a80&vta_install=0 |
| − | == | + | ===Post-Install Event Post back === |
| + | In addition to the conversion tracking Taptica supports events notifications such as Facebook connect and Purchase.<br> Those events should be fired from the advertiser / third party tracking system upon user action. | ||
| − | + | http://tracking.taptica.com/aff_goal?tt_cid={tt_cid}&tt_adv_id=XYZ&tt_goal={1-4}&tt_adv_sub={tt_adv_sub}&tt_time={Unix_time}&amount={Purchase_amount}&tt_idfa={IDFA}&tt_advertising_id={GAID} | |
| − | + | ||
| − | |||
| − | |||
| − | |||
'''Taptica Keys''' | '''Taptica Keys''' | ||
| Line 228: | Line 192: | ||
|'''Description''' | |'''Description''' | ||
|'''Example''' | |'''Example''' | ||
| − | |''' | + | |'''Dynamic''' |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
|- | |- | ||
| Line 446: | Line 225: | ||
|Event Time | |Event Time | ||
|tt_time | |tt_time | ||
| − | |Event Time | + | |Event Time 1503224984, unix time-stamp. |
| − | |tt_time= | + | |tt_time=1503224984 |
|Yes | |Yes | ||
|- | |- | ||
| Line 456: | Line 235: | ||
'''[[For Example]]''' | '''[[For Example]]''' | ||
| − | http://tracking.taptica.com/aff_goal?tt_cid= | + | http://tracking.taptica.com/aff_goal?tt_cid=2ab818fe8e574f41838780cb2f6230da&tt_adv_id=22322&tt_goal=4&tt_adv_sub=dc1816eac806878e8d1d5a8ee9406a3f71407895&tt_time=1503224984&amount=3&tt_idfa=&tt_advertising_id= |
| − | == Additional parameters == | + | == Additional parameters to the advertiser tracking link == |
| − | + | Advertisers are encouraged to provide feedbacks on our traffic quality. | |
| + | <br>By adding to the tracking link the below parameters, our account managers will be able to better optimize the traffic sources | ||
| Line 471: | Line 251: | ||
|'''Description''' | |'''Description''' | ||
|'''Example''' | |'''Example''' | ||
| − | |''' | + | |'''Dynamic''' |
|- | |- | ||
| Line 491: | Line 271: | ||
'''[[For example]]''' | '''[[For example]]''' | ||
| − | |||
| − | http:// | + | http://tune.com/serve?action=click&publisher_id=123456&site_id=303030&offer_id=404040&ref_id={tt_cid}&aff_id={aff_id}&tt_sub_aff={tt_sub_aff} |
| + | |||
| + | == Taptica Advertiser API integration == | ||
| + | Taptica is integrated with Axonite as our campaign automation platform. | ||
| + | |||
| + | provided your api solution has been integrated with Axonite - Taptica we'll need only the api credentials, otherwise, please provided your api documentations and credentials. | ||
Latest revision as of 09:24, 16 June 2019
Contents |
[edit] Advertiser Tracking
Taptica works as a mediation layer between advertisers and publishers. We need to be prompted by the advertiser whenever a conversion takes place and notified the publisher that conversion was close. this section includes the postback Taptica expects to receive from the advertiser in order to close conversion.
[edit] Conversion (Install) PostBack
There are many tracking solution in the industry, such as TUNE, Appsflyer, Kochava Adjust...and many more systems Taptica has already been integrated with. Taptica expects to receive S2S postback upon conversion and post-install events (goals).
Taptica Keys
| Parameter | Name In Request | Description | Example | Dynamic |
| Click ID | tt_cid | Taptica Internal unique click ID which was sent on the click URL | tt_cid=2ab818fe8e574f41838780cb2f6230da | Yes |
| Advertiser ID | tt_adv_id | Taptica internal unique advertiser id. will be provided to the advertiser in the integration process. | tt_adv_id=123456 | No |
| Advertiser Click ID | tt_adv_sub | The advertiser unique conversion ID | tt_adv_sub=dc1816eac806878e8d1d5a8ee9406a3f71407895 | Yes |
| Conversion Time | tt_time | The conversion time, format "yyyy-MM-dd HH:mm:ss.fff" encoded as UTF-8 | tt_time=2013-03-27 23:30:35.356 | Yes |
| IMEI | tt_imei | Use for send Taptica Plain IMEI or when you don’t know what is the format of IMEI you have. | tt_imei=86453214567892 | Yes |
| IMEI SHA1 | tt_imei_sha1 | Use for send Taptica IMEI in SHA1 format | tt_imei_sha1=35eb6d1fc48b502e239b6449e9df534e415cad95 | Yes |
| IMEI MD5 | tt_imei_md5 | Use for send Taptica IMEI in MD5 format | tt_imei_md5=946cc1baf8bcaec827bb1828cc6d9a94 | Yes |
| Android ID | tt_android_id | Use for send Taptica Plain Android ID or when you don’t know what is the format of Android ID you have. | tt_android_id=3ee0149b4ccef71b | Yes |
| Android ID SHA1 | tt_android_id_sha1 | Use for send Taptica Android ID in SHA1 format | tt_android_id_sha1=4f2e52e8157fcb729d799d1ca69160df2edf0cd4 | Yes |
| Android ID MD5 | tt_android_id_md5 | Use for send Taptica Android ID in MD5 format | tt_android_id_md5=155551c45efa667f9b470629ae9c0365 | Yes |
| Android Advertising ID | tt_advertising_id | Use for send Taptica Android advertising plain ID | tt_advertising_id=3ee0149b4ccef71bs85d24derg | Yes |
| Android Advertising ID SHA1 | tt_advertising_id_sha1 | Use for send Taptica Android advertising ID in SHA1 format | tt_advertising_id_sha1=32f2e52e8157fcb729d799d1ca69160df2edf8974 | Yes |
| Android Advertising ID MD5 | tt_advertising_id_md5 | Use for send Taptica Android advertising ID in MD5 format | tt_advertising_id_md5=2315w52e8157fcb729d799d1ca691608speofd2 | Yes |
| Mac Address | tt_mac | Use for send Taptica Plain Mac Address or when you don’t know what is the format of the Mac Address you have. (upper case with colon) | tt_mac=44:2A:60:G5:GE:G5 | Yes |
| Mac Address SHA1 | tt_imei_sha1 | Use for send Taptica Mac Address in SHA1 format (upper case with colon) | tt_mac_sha1=fa6bb084ae52461328eb9f06039be222ef287246 | Yes |
| Mac Address MD5 | tt_mac_md5 | Use for send Taptica Mac Address in MD5 format (upper case with colon) | tt_mac_md5=80efe2256d548c85ca2f2d18de241a80 | Yes |
| IDFA | tt_idfa | Use for send Taptica Plain IDFA or when you don’t know what is the format of IDFA you have. | tt_idfa=4A9B0CAB-FFA5-4190-8CC0-D974D98FC7D7 | Yes |
| IDFA SHA1 | tt_idfa_sha1 | Use for send Taptica IDFA in SHA1 format | tt_idfa_sha1=4a3b645d5f44565d7e913c612ddb7fee32a03d6d | Yes |
| IDFA MD5 | tt_idfa_md5 | Use for send Taptica IDFA in MD5 format | tt_idfa_md5=DEF179E9B89E822C3F838F3F18EB9F43 | Yes |
| vta install | Use for send Taptica the VTA conversion indication | vta_install=1/0 or vta_install=true/false | NO |
For example This post back link contains plain IDFA and Mac Address in md5.
http://tracking.taptica.com/aff_lsr?tt_cid=2ab818fe8e574f41838780cb2f6230da&tt_adv_id=123456&tt_adv_sub=dc1816eac806878e8d1d5a8ee9406a3f71407895&tt_time= 1503224984&tt_idfa=771468523E3346ABAA04E207BBAF094B&tt_mac_md5=80efe2256d548c85ca2f2d18de241a80&vta_install=0
[edit] Post-Install Event Post back
In addition to the conversion tracking Taptica supports events notifications such as Facebook connect and Purchase.
Those events should be fired from the advertiser / third party tracking system upon user action.
Taptica Keys
| Parameter | Name In Request | Description | Example | Dynamic |
| Click ID | tt_cid | Taptica Internal unique click ID which was sent on the click URL | tt_cid=2ab818fe8e574f41838780cb2f6230da | Yes |
| Advertiser ID | tt_adv_id | Taptica internal unique advertiser id. | tt_adv_id=123456 | No |
| Advertiser Click ID | tt_adv_sub | The advertiser unique conversion ID | tt_adv_sub=dc1816eac806878e8d1d5a8ee9406a3f71407895 | Yes |
| Event ID (Goal id) | tt_goal | Taptica unique identifier will be provided by Taptica in the integration process. | tt_goal=7895 | NO |
| Event Time | tt_time | Event Time 1503224984, unix time-stamp. | tt_time=1503224984 | Yes |
[edit] Additional parameters to the advertiser tracking link
Advertisers are encouraged to provide feedbacks on our traffic quality.
By adding to the tracking link the below parameters, our account managers will be able to better optimize the traffic sources
Additional Keys
| Parameter | Name In Request | Description | Example | Dynamic |
| Affiliate ID | aff_id | Taptica Internal unique affiliate ID | aff_id=3123432 | Yes |
| Sub affiliate ID | tt_sub_aff | indicate the sub affiliate id as it at the affiliate system. | tt_sub_aff=1876287ans | Yes |
[edit] Taptica Advertiser API integration
Taptica is integrated with Axonite as our campaign automation platform.
provided your api solution has been integrated with Axonite - Taptica we'll need only the api credentials, otherwise, please provided your api documentations and credentials.
