All Collections
Agencies & Partners
Partner postback macros
Partner postback macros
TrafficGuard Support avatar
Written by TrafficGuard Support
Updated over a week ago

Become a TrafficGuard integrated partner.

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


Campaign metadata parameters

Macro

Description

{site_id}

ID of the site or mobile app where the user was engaged

{campaign_id}

Campaign name or ID

{creative_id}

Identifier of the ad creative

{placement_id}

Identifier of the ad placement

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

{device_type}

The user's device type

{platform}

{platform_version}

{device_brand}

{brand_model}

{browser_language}

The platform of user's device

The platform version / os version of user's device

The brand of the user's device

Model number of the user's device

The device browser language

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

device_type=smartphone, desktop, phablet, etc

platform=android, ios, windows, etc

platform_version=10.

device_brand=Apple, samsung, oppo, etc

brand_model=iphone, GALAXY A71, etc

browser_language=en-AU, id-ID, etc


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}

The time of the click ISO 8601

{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

{mmp_attribution_type}

The MMP's attribution type

{mmp_impression_based}

The MMP's based Impression

{mmp_event_time}

The MMP's event time

{mmp_transaction_id}

The MMP's transaction id

Example values

Note - The values received from the MMP depends on the MMP the customer is using and whether the MMP is passing them to TrafficGuard consistently.

mmp_attribution_method=id_matching, google_ads, gp_referrer, probabilistic, etc

mmp_attribution_type=impression or click

mmp_impression_based=1, 0

mmp_event_time=

mmp_transaction_id=


Rejected Postbacks

Macro

Description

{is_rejected}

Rejection status of an install or an event. 0 = no, 1 = yes.

{rejection_reason}

Reason why the install or an event was rejected

Example values

is_rejected=1, 0 

rejection_reason=known_malware_appid
Did this answer your question?