Quality Events - S2S
Overview
Digital Turbine’s Quality Event Tracking API is a HTTP interface used to track in-app events such as second or more opens, registrations, in-app purchases, and other events from acquired users. This information is used by Digital Turbine in order to drive higher user quality for an advertisers campaigns running through Digital Turbine's distribution channels.
Guidelines
- The API is intended for post install data, not install events. See Conversion Tracking - S2S document for details on sending install events.
- All user events can be sent to Digital Turbine using the 'event' end point at http://data.appia.com/v2/user/event
Parameter | Description | Required |
referrer | The Digital Turbine Click ID passed in the click event URL. | Yes |
source | Used to track advertiser tracking platform. Common partners are
Direct Client integrations or Custom Partners should use "DC" | Yes |
event | Set to "open", "purchase", "registration", "level", "tutorial", "completion", "session", or "search". | Yes |
eventVar | eventVar is intended to accompany an event in order to add detail to the event. For example,
Events do not require an eventVar and some events may not make sense to pass this value, like open or registration. | No |
appId | Android Package Name or iOS Bundle ID | No |
timestamp | Unix time stamp of the event | No |
aaid | Android Advertising ID. More | No |
idfa | Apple IFA identifier | No |
openUdid | Raw Open UDID | No |
userId | Username of a registered user | No |
deviceIp | IP Address of users device | No |
deviceBrand | Device brand like Apple, Samsung, LG, Motorola | No |
deviceModel | Device model like iPad, iPhone, Nexus 7 | No |
deviceCarrier | Device carrier name like Verizon, Vodafone, ATT | No |
countryCode | Two character ISO country code like US, GB, AU | No |
language | Two character ISO language code like en, es, de | No |
age | Users age | No |
birthday | Users date of birth, eg: 1980-01-01 | No |
gender | Users gender, "M" or "F" | No |
lat | Users last known latitude | No |
lon | Users last known longitude | No |
Example
Example purchase event: http://data.appia.com/v2/user/event?referrer=APPIA1234879238793247&source=ATA&event=purchase&eventVar=1.99&appId=com.my.app