Advertiser integration
Line 25: | Line 25: | ||
|'''Description''' | |'''Description''' | ||
|'''Example''' | |'''Example''' | ||
− | |''' | + | |'''Mandatory''' |
|- | |- | ||
Revision as of 19:05, 3 August 2018
Contents |
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.
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 | Mandatory |
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=32f2e52e8157fcb729d799d1ca69160df2edf8974 | Yes |
Android Advertising ID MD5 | tt_advertising_id_md5 | Use for send Taptica Android advertising ID in MD5 format | tt_advertising_id=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 |
UDID | tt_udid | Use for send Taptica Plain UDID or when you don’t know what is the format of UDID you have. | tt_udid=dc1816eac806878e8d1d5a8ee9406a3f71452c80 | Yes |
UDID SHA1 | tt_udid_sha1 | Use for send Taptica UDID in SHA1 format | tt_udid_sha1=1ddfad5e4377b8694b5fea2a4c4556e2add9605b | Yes |
UDID MD5 | tt_udid_md5 | Use for send Taptica IMEI in MD5 format | tt_udid_md5=20fbe500c99939adabb4d06600eb4ee7 | Yes |
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
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 | Daynamic? |
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 |
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 | Daynamic? |
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 |
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.