> ## 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.

# 安装

> 把 Swift SDK 加入你的 iOS 项目，并完成 ATT 与 SKAdNetwork 配置。

> [!NOTE]
>
> 你需要一个 [发布方账号](https://docs.kontext.so/publishers.md#getting-started-is-easy) 来获取 `publisherToken` 与 placement code。

## 1. 添加 SDK

> [tab] Swift Package Manager
>
> 将 SDK 作为包依赖添加：
>
> ```swift theme={null}
> dependencies: [
>     .package(url: "https://github.com/kontextso/sdk-swift", .upToNextMajor(from: "4.0.0")) // 拉取最新的 4.x 版本
> ]
> ```
>
> 然后把 `KontextSwiftSDK` 产物加入你的 target。

> [tab] CocoaPods
>
> 在 `Podfile` 中加入：
>
> ```ruby theme={null}
> pod 'KontextSwiftSDK', '~> 4.0' # 拉取最新的 4.x 版本
> ```
>
> 然后运行 `pod install`。

## 2. 配置 IDFA（App Tracking Transparency）

请把 `NSUserTrackingUsageDescription` 加入到 `Info.plist`。SDK 会在首次创建 session 时自动触发 ATT 弹窗，并据此读取 IDFA 与 IDFV。

完整设置见 [IFA 与 ATT](https://docs.kontext.so/guides/ifa.md)——必填 key、弹窗时机的坑，以及如何自己管理弹窗。

## 3. 配置 SKAdNetwork

请把 Kontext 自有的广告网络标识符，以及 onboarding 时提供的 DSP 标识符，一并追加到 `Info.plist` 中。SDK 会在启动时读取，并在每次 `/init` 时一并转发。

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

缺少 Kontext 的标识符时，直接投放的广告活动带来的安装将静默地无法归因。完整指南见 [SKAdNetwork](https://docs.kontext.so/guides/skadnetwork.md)。


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