文档

支持

iOS SKAdNetwork 支持

Support Apple’s iOS 14 privacy requirements, including SKAdNetwork integration and guidance on handling user consent.
阅读时间3 分钟最后更新于 7 天前

本指南将介绍 Unity 目前针对程序化合作伙伴提出的关于 Unity Ads 广告竞价逻辑的更改。我们鼓励您定期重新访问本文档,以确保您获得最新的指导信息。

广告请求更改

BidRequest.imp.ext.skadn

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

字段

类型

描述

示例

sourceapp
字符串Apple App Store 中的发布者 App ID。应与广告请求中的 app.bundle 值匹配。
"sourceapp":"123456789"
skadnetids
字符串数组在发布者应用 Info.plist_ 文件中出现的 DSP 特有
SKAdNetworkItem
条目的小写列表。
"skadnetids": ["dsp1.skadnetwork"]
versions
字符串数组包含支持的 skadnetwork 版本的字符串数组。取决于操作系统版本和 SDK 版本。
"versions":["2.0","2.1","3.0"]

BidRequest.device.ext.atts

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

字段

类型

描述

示例

atts
整型应用追踪授权状态值。可能的值有:
  • 0
    = 未定
  • 1
    = 受限
  • 2
    = 被拒
  • 3
    = 已授权
"atts":2

广告返回更改

BidResponse.seatbid.bid.ext.skadn

如果广告请求中包含
BidRequest.imp.ext.skadn
,DSP 可以在响应中发送
BidResponse.seatbid.bid.ext.skadn
对象。如果存在,Unity 将使用此对象的签名进行归因。如需了解更多信息,请参阅 Apple 的 API 文档

字段

类型

描述

示例

signature
字符串Apple 指定的
SKAdNetwork
签名。
"signature":"WOBQQIRTnAcfYzF..."
network
字符串签名中使用的广告网络标识符。必须与请求中
skadnetids
数组的一项匹配。
"network":"5HUO92BLLQ.skadnetwork"
version
字符串所需的 SKAdNetwork 版本。
"version":"2.0"
campaign
字符串与 Apple 规范兼容的广告系列 ID。从 2.0 版开始,必须是
1
100
之间的整数,以字符串表示。
"campaign":"83"
itunesitem
字符串Apple App Store 中的广告主 App ID。必须与广告返回中的 bid.bundle 匹配。
"itunesitem":"987654321"
nonce
字符串每个广告返回的唯一 ID。
"nonce":"385c9n44-a9ik-28fd-8247-gjk2efoa56a9"
sourceapp
字符串Apple App Store 中发布者应用的 ID。必须与广告请求中的
imp.ext.skadn.sourceapp
匹配。
"sourceapp":"123456789"
timestamp
字符串生成签名时的 Unix 时间(以毫秒为单位)。
"timestamp":"1225091839"
fidelities
对象数组支持 SKAdNetwork v2.2 中引入的多种保真度类型。
"fidelities": [{ "fidelity":0, "signature": "MEQCIEQlmZRNfYzK…", "nonce":"473b1a16…", "timestamp":"1603246928149" }]
sourceidentifier
字符串广告网络定义的代表广告系列的四位整数。在 SKAdNetwork 4.0 和更高版本中使用,取代了
BidResponse.imp.ext.skad.
字段。
"sourceidentifier":"1234"

bid.ext.skadn.fidelities

如果广告请求中包含
BidRequest.imp.ext.skadn
,DSP 可以在响应中发送
BidResponse.seatbid.bid.ext.skadn
对象。如果存在,Unity 将使用此对象的签名进行归因。如需了解更多信息,请参阅 Apple 的 API 文档

字段

类型

描述

示例

fidelity
整型要追踪的归因的保真度类型。
"fidelity":0
nonce
字符串每个广告返回的唯一 ID。请参阅 Apple 的文档以了解正确的 UUID 格式要求。
"nonce":"385c9n44-a9ik-28fd-8247-gjk2efoa56a9
timestamp
字符串生成签名时的 Unix 时间(以毫秒为单位)。
"timestamp":"1225091839"
signature
字符串Apple 指定的 SKAdNetwork 签名。
"signature":"MEQCIEQlmZRNfYzK..."

设备 ID

Device.ifa
字符串首选的设备广告标识符 (IDFA)。当未授予追踪权限时,其值为
00000000-0000-0000-0000-000000000000
ABC123AB-1234-5678-A1B2-123ABCBCD789
Device.ext.ifv
字符串发布者的设备的 IDFV。这是来自同一供应商并在多个应用之间具有唯一性的标识符。
ABCDEFGH-ABCD-1234-1234-ABCDEFGHABCD