Contextual Parameters in our audience builder SDK
With the upcoming changes on IDFA settings in iOS 14 updates, we want to support our partners by providing this draft of the contextual parameters which will be available in our SDK product we are currently working on.
As the whole advertising ecosystem is affected by these changes, we are taking this opportunity to innovate with our audience builder SDK, which doesn’t rely on IDFA and personal identifiers, but rather uses contextual data on edge to create audiences which can not be linked to a specific person. We have been advocates for more privacy centered advertising for a while (we are a member of Prebid Committee and taking part in IAB initiatives) and we are very much looking forward to help realize more privacy centered as well as future-oriented practices in the ecosystem.
Please note that this is a draft and we will add more parameters as we progress with our product.
OpenRTB Attributes for Contextual App Targeting
Publishers can include the following parameters for Contextual App Targeting.
These attribute structure is based on OpenRTB 2.3 specifications.
Note
- All attributes are optional
- This is a list that is updated periodically
User
Attribute Name | Description | Attribute | Type | Example |
---|---|---|---|---|
Sessionduration | The total duration of time a user has spent so far in a specific app session expressed in seconds. | ext.sessionduration | integer/string | 45 |
Impdepth | The count of impressions for a specific placement type in a given app session. The impression depth is reset once the session ends. | ext.impdepth | integer/string | 3 |
Age Rating | App or screen content rating. | ext.agerating | string | "pg13" |
Device
Attribute Name | Description | Attribute | Type | Example |
---|---|---|---|---|
ATTrackingManager AuthorizationStatus | (iOS Only) passed to represent the app's app tracking authorization status. Possible values: 0 = not determined 1 = restricted 2 = denied 3 = authorized | ext.atts | integer | "atts":2 |
IDFV | (iOS Only) An alphanumeric string that uniquely identifies a device to the app’s vendor. | ext.ifv | string | "60A06FF5-3755-4077-AXXX-4520CCC9CFXX" |
Device Keyboard Languages | A string array containing the languages setup on the user's device keyboard. | ext.inputlanguage | string array | ["en","ko"] |
Battery | Remaining battery percentage | ext.battery | Integer | 91 |
IPv6 | IP address closest to device as IPv6 (128-bit value) | ipv6 | string | "2001:0db8:85a3:0000:0000:8a2e:0370:7334" |
App
Attribute Name | Description | Attribute | Type | Example |
---|---|---|---|---|
App Version | The version of the application. | ver | string | "14.16.0" |
Publisher
Attribute Name | Description | Attribute | Type | Example |
---|---|---|---|---|
Developer Domain | The developer domain used for app-ads.txt | domain | string | "developer.com" |
{
"id": "92d6421e44a44dff9f05b29be0ca5bef",
"imp": [
{
"id": "94628ee5-fe99-436d-94b5-f3270ad06529",
"banner": {
"w": 300,
"h": 250
},
"tagid": "1-abc-xyz",
"bidfloor": 0.01,
"bidfloorcur": "USD",
"secure": 1
}
],
"publisher": {
"domain": "developer.com"
},
"app": {
"id": "1008118",
"name": "Test_Android",
"bundle": "com.android.test",
"ver": "14.16.0",
"cat": [
"IAB2-1",
"IAB2-2"
],
"storeurl": "https://play.google.com/store/apps/details?id=com.android.test",
"keywords": "test, android",
"privacypolicy": 1,
"publisher": {
"id": "pub12345",
"name": "Publisher A"
}
},
"device": {
"ua": "Dalvik/2.1.0 (Linux; U; Android 6.0; MotoG3 Build/MPI24.65-25)",
"ip": "107.219.186.28",
"ipv6": "2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"geo": {
"lat": 33.9775,
"lon": -118.2133,
"country": "USA",
"region": "CA",
"city": "los angeles",
"zip": "90001",
"type": 1
},
"carrier": "att internet services",
"language": "en",
"model": "Moto G3",
"os": "Android",
"osv": "6.0",
"connectiontype": 2,
"devicetype": 1,
"ifa": "03F9F0E4-937D-4F85-9275-F530E0107B2F",
"ext": {
"atts": 2,
"ifv": "60A06FF5-3755-4077-AXXX-4520CCC9CFXX",
"inputlanguage": [
"en",
"ko"
],
"battery": 91
}
},
"user": {
"id": "50cf7979-18a7-51dd-9645-091009ad842f",
"ext": {
"sessionduration": 45,
"agerating": "pg13"
}
},
"at": 1,
"tmax": 1500,
"allimps": 0,
"cur": [
"USD"
],
"bcat": [
"IAB24",
"IAB25",
"IAB26"
]
}