iOS SKAdNetwork 支持

Read time 7 minutes

本指南将介绍 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 版开始,必须是 1100 之间的整数,以字符串表示。

"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