该API可以帮助广告主获取关于其广告的所有来自苹果SKAdNetwork的回调记录。该API面向广告主，且可以分享给MMP合作伙伴，以便用来整合报表。
关键词：
- Data availability: SKAdNetwork 回调数据在Vungle从Apple收到之后即可使用。
- SKAdNetwork campaign mapping: 请求的Campaign ID必须要与AdNetwork campaign IDs 与Vungle campaign IDs意义对应，以便在Vungle Dashboard和MMP Dashbaord的数据保持一致。
- Parameters in postbacks: API response的返回信息包含以下参数。该参数与苹果规定的参数相同。Vungle API对这些参数进行了透传。
SKAdNetwork Reporting Method
Endpoint
https://postbacks.api.vungle.com/v1/sk-ad-network/installs
Request示例
所有的参数都是必须的：
curl --compressed -H 'Accept-Encoding: deflate, gzip' -H 'Accept: application/json' -H 'Authorization: Bearer a_valid_api_token' 'https://postbacks.api.vungle.com/v1/sk-ad-network/installs?start=2020-08-23&end=2020-08-23&app_id=525463029'
Response格式示例
[
{
"version": "2",
"transaction-id": "4e4b0c3f-9479-455d-9bec-4bcdd10002ba",
"app-id": 525463029,
"campaign-id": 44,
"ad-network-id": "com.example",
"source-app-id": 1234567891,
"redownload": true,
"conversion-value": 20,
"attribution-signature": "MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
"vungle_app_id": "5727cbb4630ae51d400000cf",
"vungle_campaign_id": "5c6e163797dc95000149cffb",
"vungle_creative_id": "5c6e1637f2f3de0001a8212f"
},
// ...
]
Response参数定义
| 参数名 | 格式 | 定义 |
|---|---|---|
ad-network-id |
字符串 | Vungle的SKAdNetwork ad network ID. |
app-id |
字符串 | 下载安装应用的store ID。 |
attribution-signature |
字符串 | 用来验证的Apple归因签名证书 |
campaign-id |
字符串 | SKAdNetwork campaign ID (0-100) 以对应Vungle campaign ID。 |
conversion-value |
字符串 | A string representing advertiser configured post install conversion event values sent to Apple. |
country |
字符串 | 2个字母的ISO国家名称代码。该值根据发送请求的IP地址来判断。 |
device_ip |
字符串 | 设备的IP地址。 |
received_timestamp |
字符串 | 接收SKAdNetwork回调的时间（示例，'2020-07-23T01:59:08.000Z'）。 |
redownload |
boolean | Boolean类型，表示是否为重复下载该应用。true或false。true为重复下载。 |
source-app-id |
字符串 | 展示广告的应用商店ID。 |
transaction-id |
字符串 | 防止重复的唯一ID，以来去重安装信息。 |
version |
integer | SKAdNetwork版本 |
Filters
Response数据可通过以下参数来筛选：
app_id-
start(required) -
end(required)
Refer to the request example above for syntax.
更多信息：