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

Session Duration

The total duration of time a user has spent so far in a specific app session expressed in seconds.

ext.sessionduration

integer

45

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"
    ]
}