iOS SKAdNetwork 支持
本指南代表 Unity 目前针对 Unity Ads 竞价逻辑对我们程序化合作伙伴提出的变更建议。我们建议您定期查看此文档,以确保您拥有最新的指南。
Note: All fields and names are case-sensitive.
出价请求变更
BidRequest.imp.ext.skadn
如果 DSP 在发布者应用的 Info.plist 中至少有一个 SKAdNetworkItem,Unity 将在出价请求中包含此对象。这提供了创建签名所需的信息。
| 字段 | 类型 | 描述 | 示例 |
|---|---|---|---|
sourceapp | string | Apple App Store 中的发布者应用 ID。应与出价请求中的 app.bundle 值匹配。 | |
skadnetids | string array | 发布者应用的 Info.plist 文件中显示的 DSP 特定 SKAdNetworkItem 条目的一个小写列表。 | |
versions | string array | 包含支持的 skadnetwork 版本的字符串数组。依赖于操作系统版本和 SDK 版本。 | |
BidRequest.device.ext.atts
Unity 将在 BidRequest.device.ext.atts 字段中包含应用跟踪授权的状态。有关此字段的更多信息,请参阅 Apple 的 API 文档。
| 字段 | 类型 | 描述 | 示例 |
|---|---|---|---|
atts | int | 应用跟踪授权的状态值。可能的取值是
| |
出价响应变更
BidResponse.seatbid.bid.ext.skadn
如果出价请求包含 BidRequest.imp.ext.skadn,DSP 可以发送一个 BidResponse.seatbid.bid.ext.skadn 对象作为响应。如果存在,Unity 将使用此对象的签名进行归因。有关更多信息,请参阅 Apple 的 API 文档。
| 字段 | 类型 | 描述 | 示例 |
|---|---|---|---|
signature | string | Apple 指定的 SKAdNetwork 签名。 | |
network | string | 签名中使用的广告网络标识符。这必须与请求中的 skadnetids 数组中的一个项目匹配。 | |
version | string | 所需 SKAdNetwork 的版本。 | |
campaign | string | 与 Apple 规范兼容的广告系列 ID。从 2.0 版开始,这必须是一个介于 1 和 100 之间的整数,用字符串表示。 | |
itunesitem | string | Apple App Store 中的广告主应用 ID。这必须与出价响应中的 bid.bundle 匹配。 | |
nonce | string | 对每个广告响应唯一的 ID。 | |
sourceapp | string | Apple App Store 中发布者应用的 ID。这必须与出价请求中的 imp.ext.skadn.sourceapp 匹配。 | |
timestamp | string | 生成签名时的 Unix 时间(以毫秒为单位)。 | |
fidelities | object array | 支持 SKAdNetwork v2.2 中引入的多种保真度类型。 | |
sourceidentifier | string | 广告网络定义的用于表示广告系列的四位整数。在 SKAdNetwork 4.0 及更高版本中使用,并取代了 BidResponse.imp.ext.skad. 字段。 Note: DSPs must generate signatures in versions 4.0 and later by using the Source Identifier. For versions 3.0 and earlier, continue to use | |
bid.ext.skadn.fidelities
如果出价请求包含 BidRequest.imp.ext.skadn,DSP 可以发送一个 BidResponse.seatbid.bid.ext.skadn 对象作为响应。如果存在,Unity 将使用此对象的签名进行归因。有关更多信息,请参阅 Apple 的 API 文档.
| 字段 | 类型 | 描述 | 示例 |
|---|---|---|---|
fidelity | int | 要跟踪的归因的保真度类型。 | |
nonce | string | 对每个广告响应唯一的 ID。有关正确的 UUID 格式 要求,请参阅 Apple 的文档。 | |
timestamp | string | 生成签名时的 Unix 时间(以毫秒为单位)。 | |
signature | string | Apple 指定的 SKAdNetwork 签名。 | |
设备 ID
Note: Unity will pass IDFA where present. Where IDFA is not present, IDFV will be passed.
Device.ifa | string | 首选设备广告标识符 (IDFA)。当未授予跟踪权限时,它的值为 00000000-0000-0000-0000-000000000000。 | |
Device.ext.ifv | string | 发布者设备的 IDFV。这是来自同一供应商的应用程序之间的唯一标识符。 | |