> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kontext.so/llms.txt
> Use this file to discover all available pages before exploring further.

# SKAdNetwork

> 在 iOS 上配置 SKAdNetwork 标识符，让广告主能够对来自你视频广告的安装进行归因。

[SKAdNetwork](https://developer.apple.com/documentation/storekit/skadnetwork)（SKAN）是 Apple 提供的隐私友好的安装归因框架。每个在 iOS 上投放应用安装广告的广告主都有自己的 SKAdNetwork 标识符。只有当广告主的标识符出现在你应用的 `Info.plist` 中，它才能把来自你广告的安装归因回去。

> [!NOTE]
>
> SKAdNetwork 仅适用于 iOS。Android 不需要等效配置。

## 需要在 `Info.plist` 中添加什么

### Kontext 自有标识符（始终必填）

Kontext 也会直接投放广告活动，并通过自己注册的广告网络进行安装归因。无论哪些广告主在投放，都请添加 Kontext 的标识符：

```xml theme={null}
<key>SKAdNetworkItems</key>
<array>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mp7rpxwdrx.adattributionkit</string>
  </dict>
</array>
```

缺少此条目时，广告仍会正常投放和展示，但直接投放的广告活动带来的安装将静默地无法归因。不会有任何错误或警告。

### 广告主标识符

入驻期间我们会提供网络中所有活跃需求方的 SKAdNetwork 标识符列表。把它们追加到 `SKAdNetworkItems`：

```xml theme={null}
<key>SKAdNetworkItems</key>
<array>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>XXX.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>YYY.skadnetwork</string>
  </dict>
  <!-- 在此添加我们提供的全部标识符 -->
</array>
```

> [!WARNING]
>
> 如果你的应用已经有来自其他广告 SDK 的 `SKAdNetworkItems` 数组，请把我们的标识符**追加**进去。不要替换原数组，否则会破坏其他广告网络的归因。Apple 会自动去重，同一个标识符添加两次是无害的。

> [!WARNING]
>
> 少一个标识符意味着归因到对应广告主的安装会被静默丢弃：损失收入却看不到任何报错。请添加我们提供的**全部**标识符，不能只加一部分。

## SDK 如何使用它

SDK 在启动时从 `Info.plist` 读取 `SKAdNetworkItems`，并随请求转发给我们的广告服务器。它从不修改这个数组。服务器告诉每个广告主能否对来自你应用的安装做归因。

当我们新增需求方时，你会收到更新后的列表。添加新标识符并发布构建；标识符是打包进二进制的，无法远程更改。

## 广告期间的归因

标识符列出之后，其余工作由 Apple 的 `SKAdNetwork` API 和广告主的度量完成。SDK 在展示广告时向 Apple 注册广告曝光；你的代码无需调用任何东西。

## 排查问题

* **某个广告主报告安装数为零，但它的广告确实投放过。** 它的标识符可能没有出现在 `Info.plist` 中，或者带有更新列表的构建尚未发布。
* **需要当前列表？** 请联系 [support@kontext.so](mailto:support@kontext.so)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.