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。这是来自同一供应商的应用程序之间的唯一标识符。 |
|