iOS SKAdNetwork 支持

本指南代表 Unity 目前针对 Unity Ads 竞价逻辑对我们程序化合作伙伴提出的变更建议。我们建议您定期查看此文档,以确保您拥有最新的指南。

Note: All fields and names are case-sensitive.

出价请求变更

BidRequest.imp.ext.skadn

如果 DSP 在发布者应用的 Info.plist 中至少有一个 SKAdNetworkItem,Unity 将在出价请求中包含此对象。这提供了创建签名所需的信息。

字段类型描述示例
sourceappstringApple App Store 中的发布者应用 ID。应与出价请求中的 app.bundle 值匹配。
"sourceapp":"123456789"
skadnetidsstring array发布者应用的 Info.plist 文件中显示的 DSP 特定 SKAdNetworkItem 条目的一个小写列表。
"skadnetids": ["dsp1.skadnetwork"]
versionsstring array包含支持的 skadnetwork 版本的字符串数组。依赖于操作系统版本和 SDK 版本。
"versions":["2.0","2.1","3.0"]

BidRequest.device.ext.atts

Unity 将在 BidRequest.device.ext.atts 字段中包含应用跟踪授权的状态。有关此字段的更多信息,请参阅 Apple 的 API 文档。

字段类型描述示例
attsint应用跟踪授权的状态值。可能的取值是
  • 0 = 未确定
  • 1 = 受限
  • 2 = 拒绝
  • 3 = 授权
"atts":2

出价响应变更

BidResponse.seatbid.bid.ext.skadn

如果出价请求包含 BidRequest.imp.ext.skadn,DSP 可以发送一个 BidResponse.seatbid.bid.ext.skadn 对象作为响应。如果存在,Unity 将使用此对象的签名进行归因。有关更多信息,请参阅 Apple 的 API 文档。

字段类型描述示例
signaturestringApple 指定的 SKAdNetwork 签名。
"signature": "WOBQQIRTnAcfYzF..."
networkstring签名中使用的广告网络标识符。这必须与请求中的 skadnetids 数组中的一个项目匹配。
"network":"5HUO92BLLQ.skadnetwork"
versionstring所需 SKAdNetwork 的版本。
"version":"2.0"
campaignstring与 Apple 规范兼容的广告系列 ID。从 2.0 版开始,这必须是一个介于 1 和 100 之间的整数,用字符串表示。
"campaign":"83"
itunesitemstringApple App Store 中的广告主应用 ID。这必须与出价响应中的 bid.bundle 匹配。
"itunesitem":"987654321"
noncestring对每个广告响应唯一的 ID。
"nonce":"385c9n44-a9ik-28fd-8247-gjk2efoa56a9"
sourceappstringApple App Store 中发布者应用的 ID。这必须与出价请求中的 imp.ext.skadn.sourceapp 匹配。
"sourceapp":"123456789"
timestampstring生成签名时的 Unix 时间(以毫秒为单位)。
"timestamp": "1225091839"
fidelitiesobject array支持 SKAdNetwork v2.2 中引入的多种保真度类型。
"fidelities": 
[ { 
	"fidelity": 0, 
	"signature": 
	"MEQCIEQlmZRNfYzK…", 
	"nonce": "473b1a16…", 
	"timestamp": "1603246928149" 
} ]
sourceidentifierstring

广告网络定义的用于表示广告系列的四位整数。在 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 campaign.

"sourceidentifier": "1234"

bid.ext.skadn.fidelities

如果出价请求包含 BidRequest.imp.ext.skadn,DSP 可以发送一个 BidResponse.seatbid.bid.ext.skadn 对象作为响应。如果存在,Unity 将使用此对象的签名进行归因。有关更多信息,请参阅 Apple 的 API 文档.

字段类型描述示例
fidelityint要跟踪的归因的保真度类型。
"fidelity": 0
noncestring对每个广告响应唯一的 ID。有关正确的 UUID 格式 要求,请参阅 Apple 的文档。
"nonce":"385c9n44-a9ik-28fd-8247-gjk2efoa56a9
timestampstring生成签名时的 Unix 时间(以毫秒为单位)。
"timestamp": "1225091839"
signaturestringApple 指定的 SKAdNetwork 签名。
"signature": "MEQCIEQlmZRNfYzK…"

设备 ID

Note: Unity will pass IDFA where present. Where IDFA is not present, IDFV will be passed.

Device.ifastring首选设备广告标识符 (IDFA)。当未授予跟踪权限时,它的值为 00000000-0000-0000-0000-000000000000
ABC123AB-1234-5678-A1B2-123ABCBCD789
Device.ext.ifvstring发布者设备的 IDFV。这是来自同一供应商的应用程序之间的唯一标识符。
ABCDEFGH-ABCD-1234-1234-ABCDEFGHABCD