Media Track Integration

Kiwi is able to receive media track information through it's callback endpoint. To use it, simply configure the external integrator (ApSalar, Adjust, HasOffers, etc...) to make a callback to the following URL:

https://tools.kwsdk.io/api/1.0/mediatrack/postback

Supported Parameters

Aplication parameters:

key	description
app_name	Application name on the external integrator
bundle_id	Application id on Apple, Google or Windows

Device parameters:

key	description
ip	The device's IP address
udid	(deprecated) The open UDID on the device
ifa	Apple's ID for advertisers
ifv	Apple's ID for vendors
odin	Apple's ODIN
android_id	Android ID
advertising_id	Android's ID for advertisers
os_version	Version of the OS on the device
platform	The application platform (iOS / Android / Windows)
user_id	The external user id provided by the integrator
dnt	Do not Track flag set by the user

Media parameters

key	description
campaign_id	The campaign ID on the external integrator
creative	The creative used on the campaign
click_id	The click ID generated by the external integrator
group_id	The campaign group
site	The campaign site
network	The AD Network of the campaign (i.e. Facebook, FBiz, Twitter, AppLovvin, etc.)

Facebook Tracking

key	description
fb_c_id	Facebook campaign id
fb_c_name	Facebook campaign name
fb_as_name	Facebook Ad Set name

Twitter Tracking

key	description
twtr_c_id	Twitter campaign id
twtr_c_name	Twitter campaign name
gid	Twitter line item id

Partner identification

key	description
partner	The external integrator name (ApSalar, Adjust, HasOffers)

Example configuration

https://tools.kwsdk.io/api/1.0/mediatrack/postback?app_name={APP_NAME}&bundle_id={LONGNAME}&campaign_id={CID}&click_id={CLID}&creative={CREATIVE}&group_id={GID}&site={SITE}&ip={IP}&udid={UDID}&ifa={IDFA}&odin={ODIN}&android_id={ANDI}&platform={PLATFORM}&user_id={USERID}&dnt={DNT}&network={NETWORK}&partner=Adjust&advertising_id={AIFA}&ifv={IDFV}

Kiwi Reports Fields

The following mapping is used to map the postback parameters to Kiwi database entries used to generate the reports. Please note that some fields may come from different sources and a priority is applied.

Report Field	Postback Parameter (in order of priority)
external_media_campaign_id	campaign_id / fb_c_id / twtr_c_id
external_media_campaign_name	creative / fb_c_name / twtr_c_name
external_media_click_id	click_id
external_media_group	group_id
external_media_site	site
external_media_network	network
external_media_partner	partner
external_media_ad	fb_as_name