Partner postback macros

Introduction

To receive notification of attributions from TrafficGuard you can use the following macros

Unique identifier parameters

Macro Description
{idfa} iOS Only - iOS unique identifier
{idfa_sha1} iOS Only - iOS unique identifier in SHA1 format
{idfa_md5} iOS Only - iOS unique identifier in MD5 format
{aaid} Android only. Android advertiser unique identifier
{aaid_sha1} Android only. Android advertiser unique identifier in SHA1 format
{aaid_md5} Android only. Android advertiser unique identifier in MD5 format

Example values

aaid=4c30c866-30d6-4418-a6dc-0f702737bf59

idfa=6D92078A-8246-4BA4-AE5B-76104861E7DC

Event metadata parameters

Macro Description
{event_name} Name of the event triggered from the app
{event_param} Additional meta information related to the event parameter/s
{event_revenue_usd} Event revenue in USD


Example values

event_name=open

event_param={"level":"2","level_name":"big battle","score":"10000"}

event_revenue_usd=1.25

Device parameters

Macro Description
{user_agent} The device User-Agent
{user_ip} The user's IP address
{is_wifi} The connection type of the user
{country_code}

Two-character abbreviated country code that user is located in (on conversion)

  ISO 3166-1 alpha-2

Example values

user_agent=Mozilla/5.0 (Linux; Android 8.0; Pixel 2 Build/OPD3.170816.012) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3359.181 Mobile Safari/537.36

user_ip=154.674.111.34

is_wifi=TRUE

country_code=AU

App parameters

Macro Description
{app_id} App ID - App package name or app id in the store
{app_version} The version of the app defined by the app developer in the app’s code

Example values 

app_version=12.2.1

// iOS
app_id=id123456789

//Android
app_id=com.appenture.awesomeapp

Reference ID parameters

Macro Description
{tg_transaction_id} TrafficGuard unique transaction identifier
{partner_click_id} Partners unique click identifier

Example values

tg_transaction_id=09010041-9abf-47d5-9f00-11405b1dd331

partner_click_id=

Additional parameters

Macro Description
{sub_param_1} Custom Parameter 1
{sub_param_2} Custom Parameter 2
{sub_param_3} Custom Parameter 3
{sub_param_4} Custom Parameter 4
{sub_param_5} Custom Parameter 5

Example values

sub_param_1=

sub_param_2=

sub_param_3=

sub_param_4=

sub_param_5=

Timing parameters

Macro Description
{click_time_seconds} The time of the click (Seconds since the Unix Epoch)
{click_time_milliseconds} The time of the click (Milliseconds since the Unix Epoch)
{event_time} The time of the in-app event ISO 8601
{event_time_seconds} The time of the in-app event (Seconds since the Unix Epoch)
{event_time_milliseconds} The time of the in-app event (Milliseconds since the Unix Epoch)

 

Example values

click_time_seconds=1538109117

click_time_milliseconds=1528876031

event_time=2018-06-13T15:52:12+08:00

event_time_seconds=1538109117

event_time_milliseconds=1528876031

MMP metadata parameters

Macro Description
{mmp_attribution_method} The method of attribution used by the MMP