{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Contextual App Targeting","type":"basic","slug":"contextual-app-targeting","excerpt":"","body":"[block:api-header]\n{\n  \"title\": \"Contextual Parameters in our audience builder SDK\"\n}\n[/block]\nWith 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. \n\nAs 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. \n\nPlease note that this is a draft and we will add more parameters as we progress with our product.\n[block:api-header]\n{\n  \"title\": \"OpenRTB Attributes for Contextual App Targeting\"\n}\n[/block]\nPublishers can include the following parameters for Contextual App Targeting.\nThese attribute structure is based on OpenRTB 2.3 specifications.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"- All attributes are optional\\n- This is a list that is updated periodically\",\n  \"title\": \"Note\"\n}\n[/block]\n**User**\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Attribute Name\",\n    \"h-1\": \"Description\",\n    \"h-2\": \"Attribute\",\n    \"h-3\": \"Type\",\n    \"h-4\": \"Example\",\n    \"h-5\": \"\",\n    \"0-0\": \"Session Duration\",\n    \"1-0\": \"Age Rating\",\n    \"0-1\": \"The total duration of time a user has spent so far in a specific app session expressed in seconds.\",\n    \"1-1\": \"App or screen content rating\",\n    \"0-2\": \"ext.sessionduration\",\n    \"1-2\": \"ext.agerating\",\n    \"0-3\": \"integer\",\n    \"1-3\": \"string\",\n    \"0-4\": \"45\",\n    \"1-4\": \"\\\"pg13\\\"\",\n    \"0-5\": \"\",\n    \"1-5\": \"\"\n  },\n  \"cols\": 5,\n  \"rows\": 2\n}\n[/block]\n**Device**\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Attribute Name\",\n    \"h-1\": \"Description\",\n    \"h-2\": \"Attribute\",\n    \"h-3\": \"Type\",\n    \"h-4\": \"Example\",\n    \"h-5\": \"\",\n    \"0-2\": \"ext.atts\",\n    \"1-2\": \"ext.ifv\",\n    \"0-3\": \"integer\",\n    \"1-3\": \"string\",\n    \"0-4\": \"\\\"atts\\\":2\",\n    \"1-4\": \"\\\"60A06FF5-3755-4077-AXXX-4520CCC9CFXX\\\"\",\n    \"0-5\": \"\",\n    \"1-5\": \"\",\n    \"0-1\": \"(iOS Only) passed to represent the app's app tracking authorization status. Possible values:\\n\\n0 = not determined\\n1 = restricted\\n2 = denied\\n3 = authorized\",\n    \"0-0\": \"ATTrackingManager AuthorizationStatus\",\n    \"1-0\": \"IDFV\",\n    \"1-1\": \"(iOS Only) An alphanumeric string that uniquely identifies a device to the app’s vendor.\",\n    \"2-1\": \"A string array containing the languages setup on the user's device keyboard.\",\n    \"2-2\": \"ext.inputlanguage\",\n    \"2-3\": \"string array\",\n    \"2-4\": \"[\\\"en\\\",\\\"ko\\\"]\",\n    \"2-0\": \"Device Keyboard Languages\",\n    \"2-5\": \"\",\n    \"3-0\": \"Battery\",\n    \"3-1\": \"Remaining battery percentage\",\n    \"3-2\": \"ext.battery\",\n    \"3-3\": \"Integer\",\n    \"3-4\": \"91\",\n    \"3-5\": \"\",\n    \"4-0\": \"IPv6\",\n    \"4-1\": \"IP address closest to device as IPv6 (128-bit value)\",\n    \"4-2\": \"ipv6\",\n    \"4-3\": \"string\",\n    \"4-4\": \"\\\"2001:0db8:85a3:0000:0000:8a2e:0370:7334\\\"\",\n    \"4-5\": \"\"\n  },\n  \"cols\": 5,\n  \"rows\": 5\n}\n[/block]\n**App**\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Attribute Name\",\n    \"h-1\": \"Description\",\n    \"h-2\": \"Attribute\",\n    \"h-3\": \"Type\",\n    \"h-4\": \"Example\",\n    \"h-5\": \"\",\n    \"0-0\": \"App Version\",\n    \"0-2\": \"ver\",\n    \"0-1\": \"The version of the application.\",\n    \"0-3\": \"string\",\n    \"0-4\": \"\\\"14.16.0\\\"\",\n    \"0-5\": \"\"\n  },\n  \"cols\": 5,\n  \"rows\": 1\n}\n[/block]\n**Publisher**\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Attribute Name\",\n    \"h-1\": \"Description\",\n    \"h-2\": \"Attribute\",\n    \"h-3\": \"Type\",\n    \"h-4\": \"Example\",\n    \"h-5\": \"\",\n    \"0-0\": \"Developer Domain\",\n    \"0-1\": \"The developer domain used for app-ads.txt\",\n    \"0-2\": \"domain\",\n    \"0-5\": \"\",\n    \"0-4\": \"\\\"developer.com\\\"\",\n    \"0-3\": \"string\"\n  },\n  \"cols\": 5,\n  \"rows\": 1\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"id\\\": \\\"92d6421e44a44dff9f05b29be0ca5bef\\\",\\n    \\\"imp\\\": [\\n        {\\n            \\\"id\\\": \\\"94628ee5-fe99-436d-94b5-f3270ad06529\\\",\\n            \\\"banner\\\": {\\n                \\\"w\\\": 300,\\n                \\\"h\\\": 250\\n            },\\n            \\\"tagid\\\": \\\"1-abc-xyz\\\",\\n            \\\"bidfloor\\\": 0.01,\\n            \\\"bidfloorcurdan\\\": \\\"USD\\\",\\n            \\\"secure\\\": 1\\n        }\\n    ],\\n    \\\"publisher\\\": {\\n        \\\"domain\\\": \\\"developer.com\\\"\\n    },\\n    \\\"app\\\": {\\n        \\\"id\\\": \\\"1008118\\\",\\n        \\\"name\\\": \\\"Test_Android\\\",\\n        \\\"bundle\\\": \\\"com.android.test\\\",\\n        \\\"ver\\\": \\\"14.16.0\\\",\\n        \\\"cat\\\": [\\n            \\\"IAB2-1\\\",\\n            \\\"IAB2-2\\\"\\n        ],\\n        \\\"storeurl\\\": \\\"https://play.google.com/store/apps/details?id=com.android.test\\\",\\n        \\\"keywords\\\": \\\"test, android\\\",\\n        \\\"privacypolicy\\\": 1,\\n        \\\"publisher\\\": {\\n            \\\"id\\\": \\\"pub12345\\\",\\n            \\\"name\\\": \\\"Publisher A\\\"\\n        }\\n    },\\n    \\\"device\\\": {\\n        \\\"ua\\\": \\\"Dalvik/2.1.0 (Linux; U; Android 6.0; MotoG3 Build/MPI24.65-25)\\\",\\n        \\\"ip\\\": \\\"107.219.186.28\\\",\\n        \\\"ipv6\\\": \\\"2001:0db8:85a3:0000:0000:8a2e:0370:7334\\\",\\n        \\\"geo\\\": {\\n            \\\"lat\\\": 33.9775,\\n            \\\"lon\\\": -118.2133,\\n            \\\"country\\\": \\\"USA\\\",\\n            \\\"region\\\": \\\"CA\\\",\\n            \\\"city\\\": \\\"los angeles\\\",\\n            \\\"zip\\\": \\\"90001\\\",\\n            \\\"type\\\": 1\\n        },\\n        \\\"carrier\\\": \\\"att internet services\\\",\\n        \\\"language\\\": \\\"en\\\",\\n        \\\"model\\\": \\\"Moto G3\\\",\\n        \\\"os\\\": \\\"Android\\\",\\n        \\\"osv\\\": \\\"6.0\\\",\\n        \\\"connectiontype\\\": 2,\\n        \\\"devicetype\\\": 1,\\n        \\\"ifa\\\": \\\"03F9F0E4-937D-4F85-9275-F530E0107B2F\\\",\\n        \\\"ext\\\": {\\n            \\\"atts\\\": 2,\\n            \\\"ifv\\\": \\\"60A06FF5-3755-4077-AXXX-4520CCC9CFXX\\\",\\n            \\\"inputlanguage\\\": [\\n                \\\"en\\\",\\n                \\\"ko\\\"\\n            ],\\n            \\\"battery\\\": 91\\n        }\\n    },\\n    \\\"user\\\": {\\n        \\\"id\\\": \\\"50cf7979-18a7-51dd-9645-091009ad842f\\\",\\n        \\\"ext\\\": {\\n            \\\"sessionduration\\\": 45,\\n            \\\"agerating\\\": \\\"pg13\\\"\\n        }\\n    },\\n    \\\"at\\\": 1,\\n    \\\"tmax\\\": 1500,\\n    \\\"allimps\\\": 0,\\n    \\\"cur\\\": [\\n        \\\"USD\\\"\\n    ],\\n    \\\"bcat\\\": [\\n        \\\"IAB24\\\",\\n        \\\"IAB25\\\",\\n        \\\"IAB26\\\"\\n    ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Sample Bid Request with Contextual Parameters\"\n    }\n  ]\n}\n[/block]","updates":[],"order":20,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5f48c0a59021ff003f80a4f6","createdAt":"2020-08-28T08:30:29.717Z","user":"59aebb87fde5ab002740a01c","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"[PUBLISHER] API Documentation","slug":"api-documentation","order":1,"from_sync":false,"reference":true,"_id":"5774fe18605b770e0037be8a","__v":0,"project":"574ff4bd3fa1870e00889ba6","version":"574ff4bd3fa1870e00889ba9","createdAt":"2016-06-30T11:10:16.206Z"},"version":{"version":"3.0","version_clean":"3.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["574ff4bd3fa1870e00889baa","577278ecdceb570e003a9001","577279865617b117009e643f","577279985617b117009e6440","577279bc8c48e00e00503504","5774fe18605b770e0037be8a","577ce3ad87acf617003c4187","577f8476a77c700e006a6c52","57b486ae0d2b640e00e9d3f5","57b722133d3e620e004ec74b","57bd95f00fe3a00e003e2cc5","57c8349359cd4b0e00b888ef","57c8349b5754fa1700b12242","57cedb0bad483e0e00890239","57cedbe807d7ea0e00e438cc","57d82967156ef72b007ffcd8","58ee353ad1ee2f0f0034a13d","596623221738df00298622a5","59a51730192dba000fc9ca38","59a8129f1e7b26000fa0fb1a","5a0322bf044b6f001c236e36","5a79897c5b6e430030746df6","5a79898c2b2d5f0012cbab63","5ab3b5e3d2d1e2006252a8f2","5b1a43bd678eab0003aa54a4","5b6d95e29d346300038baff3","5c77d3a1e0794000451bced2","5e902519bb65b200466e7957","5f228f5bd6a1cc0024afda30"],"_id":"574ff4bd3fa1870e00889ba9","createdAt":"2016-06-02T08:56:29.492Z","project":"574ff4bd3fa1870e00889ba6","releaseDate":"2016-06-02T08:56:29.492Z","__v":29},"project":"574ff4bd3fa1870e00889ba6","__v":0,"parentDoc":null}

Contextual App Targeting


[block:api-header] { "title": "Contextual Parameters in our audience builder SDK" } [/block] 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. [block:api-header] { "title": "OpenRTB Attributes for Contextual App Targeting" } [/block] Publishers can include the following parameters for Contextual App Targeting. These attribute structure is based on OpenRTB 2.3 specifications. [block:callout] { "type": "info", "body": "- All attributes are optional\n- This is a list that is updated periodically", "title": "Note" } [/block] **User** [block:parameters] { "data": { "h-0": "Attribute Name", "h-1": "Description", "h-2": "Attribute", "h-3": "Type", "h-4": "Example", "h-5": "", "0-0": "Session Duration", "1-0": "Age Rating", "0-1": "The total duration of time a user has spent so far in a specific app session expressed in seconds.", "1-1": "App or screen content rating", "0-2": "ext.sessionduration", "1-2": "ext.agerating", "0-3": "integer", "1-3": "string", "0-4": "45", "1-4": "\"pg13\"", "0-5": "", "1-5": "" }, "cols": 5, "rows": 2 } [/block] **Device** [block:parameters] { "data": { "h-0": "Attribute Name", "h-1": "Description", "h-2": "Attribute", "h-3": "Type", "h-4": "Example", "h-5": "", "0-2": "ext.atts", "1-2": "ext.ifv", "0-3": "integer", "1-3": "string", "0-4": "\"atts\":2", "1-4": "\"60A06FF5-3755-4077-AXXX-4520CCC9CFXX\"", "0-5": "", "1-5": "", "0-1": "(iOS Only) passed to represent the app's app tracking authorization status. Possible values:\n\n0 = not determined\n1 = restricted\n2 = denied\n3 = authorized", "0-0": "ATTrackingManager AuthorizationStatus", "1-0": "IDFV", "1-1": "(iOS Only) An alphanumeric string that uniquely identifies a device to the app’s vendor.", "2-1": "A string array containing the languages setup on the user's device keyboard.", "2-2": "ext.inputlanguage", "2-3": "string array", "2-4": "[\"en\",\"ko\"]", "2-0": "Device Keyboard Languages", "2-5": "", "3-0": "Battery", "3-1": "Remaining battery percentage", "3-2": "ext.battery", "3-3": "Integer", "3-4": "91", "3-5": "", "4-0": "IPv6", "4-1": "IP address closest to device as IPv6 (128-bit value)", "4-2": "ipv6", "4-3": "string", "4-4": "\"2001:0db8:85a3:0000:0000:8a2e:0370:7334\"", "4-5": "" }, "cols": 5, "rows": 5 } [/block] **App** [block:parameters] { "data": { "h-0": "Attribute Name", "h-1": "Description", "h-2": "Attribute", "h-3": "Type", "h-4": "Example", "h-5": "", "0-0": "App Version", "0-2": "ver", "0-1": "The version of the application.", "0-3": "string", "0-4": "\"14.16.0\"", "0-5": "" }, "cols": 5, "rows": 1 } [/block] **Publisher** [block:parameters] { "data": { "h-0": "Attribute Name", "h-1": "Description", "h-2": "Attribute", "h-3": "Type", "h-4": "Example", "h-5": "", "0-0": "Developer Domain", "0-1": "The developer domain used for app-ads.txt", "0-2": "domain", "0-5": "", "0-4": "\"developer.com\"", "0-3": "string" }, "cols": 5, "rows": 1 } [/block] [block:code] { "codes": [ { "code": "{\n \"id\": \"92d6421e44a44dff9f05b29be0ca5bef\",\n \"imp\": [\n {\n \"id\": \"94628ee5-fe99-436d-94b5-f3270ad06529\",\n \"banner\": {\n \"w\": 300,\n \"h\": 250\n },\n \"tagid\": \"1-abc-xyz\",\n \"bidfloor\": 0.01,\n \"bidfloorcurdan\": \"USD\",\n \"secure\": 1\n }\n ],\n \"publisher\": {\n \"domain\": \"developer.com\"\n },\n \"app\": {\n \"id\": \"1008118\",\n \"name\": \"Test_Android\",\n \"bundle\": \"com.android.test\",\n \"ver\": \"14.16.0\",\n \"cat\": [\n \"IAB2-1\",\n \"IAB2-2\"\n ],\n \"storeurl\": \"https://play.google.com/store/apps/details?id=com.android.test\",\n \"keywords\": \"test, android\",\n \"privacypolicy\": 1,\n \"publisher\": {\n \"id\": \"pub12345\",\n \"name\": \"Publisher A\"\n }\n },\n \"device\": {\n \"ua\": \"Dalvik/2.1.0 (Linux; U; Android 6.0; MotoG3 Build/MPI24.65-25)\",\n \"ip\": \"107.219.186.28\",\n \"ipv6\": \"2001:0db8:85a3:0000:0000:8a2e:0370:7334\",\n \"geo\": {\n \"lat\": 33.9775,\n \"lon\": -118.2133,\n \"country\": \"USA\",\n \"region\": \"CA\",\n \"city\": \"los angeles\",\n \"zip\": \"90001\",\n \"type\": 1\n },\n \"carrier\": \"att internet services\",\n \"language\": \"en\",\n \"model\": \"Moto G3\",\n \"os\": \"Android\",\n \"osv\": \"6.0\",\n \"connectiontype\": 2,\n \"devicetype\": 1,\n \"ifa\": \"03F9F0E4-937D-4F85-9275-F530E0107B2F\",\n \"ext\": {\n \"atts\": 2,\n \"ifv\": \"60A06FF5-3755-4077-AXXX-4520CCC9CFXX\",\n \"inputlanguage\": [\n \"en\",\n \"ko\"\n ],\n \"battery\": 91\n }\n },\n \"user\": {\n \"id\": \"50cf7979-18a7-51dd-9645-091009ad842f\",\n \"ext\": {\n \"sessionduration\": 45,\n \"agerating\": \"pg13\"\n }\n },\n \"at\": 1,\n \"tmax\": 1500,\n \"allimps\": 0,\n \"cur\": [\n \"USD\"\n ],\n \"bcat\": [\n \"IAB24\",\n \"IAB25\",\n \"IAB26\"\n ]\n}", "language": "json", "name": "Sample Bid Request with Contextual Parameters" } ] } [/block]