--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://ads.yandex.com/helpcenter/en/dev/ios/quick-start.md - https://ads.yandex.com/helpcenter/ru/dev/ios/quick-start.md - https://ads.yandex.com/helpcenter/zh/dev/ios/quick-start.md - href: zh/dev/ios/quick-start.md type: text/markdown title: Markdown version - href: llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/zh/llms.txt # Mobile Ads SDK 集成 > _系统：YAN、Adfox_ 将 Yandex Mobile Ads SDK 集成到您的应用中是投放广告和创收的第一步。集成 SDK 后，您可以为应用变现选择一种广告格式（例如横幅广告或激励广告）并进行设置。 ## 前提条件 {#prolog} 要准备您的应用，请按照接下来的章节中描述的步骤进行操作。 ### 应用要求 {#requirements} - 使用 iOS 13 或更高版本。 - 使用 Xcode 16.4 或更高版本。 ### 在您的 Yandex Advertising Network 账户中设置应用 {#yan} 以下是在 Yandex Advertising Network 中注册您的应用的方法： 1. 在 Yandex Advertising Network 中 [登录](https://partner.yandex.ru/) 或 [登录](https://passport.yandex.com/auth/list?origin=rsy_ligth_out&retpath=https%3A%2F%2Fpartner.yandex.com%2Fform%2F?roles%5B%5D=27) 您的账户。 2. 在 Yandex Advertising Network 中 [注册](https://passport.yandex.com/auth/list?origin=rsy_ligth_out&retpath=https%3A%2F%2Fpartner.yandex.com%2Fform%2F?roles%5B%5D=27) 您的应用。 ## 集成集成 Yandex Mobile Ads SDK 涉及以下步骤： 1. 集成 Yandex Mobile Ads SDK。 2. SKAdNetwork 支持。 3. 初始化库。 4. 测试集成。 ### 集成 Yandex Mobile Ads SDK 有两种方法可以将 Yandex Mobile Ads SDK 集成到您的项目中： * **CocoaPods（推荐）**：更轻松地集成并支持移动聚合。 * **Swift Package Manager**：对于仅使用 SPM 的项目。也支持移动聚合。 {% list tabs %} - CocoaPods 将 `YandexMobileAds` 库添加到 Podfile。如果您使用视频插播广告，还请务必添加 `YandexMobileAdsInstream` pod。 ``` pod 'YandexMobileAds', '8.3.0' pod 'YandexMobileAdsInstream', '0.74.0' ``` - Swift Package Manager 1. 在您的 Xcode 项目中，使用 **File** → **Add Packages dependencies** 添加依赖项。 2. 指定包含 Swift 包的存储库的网址：`https://github.com/yandexmobile/yandex-ads-sdk-ios`。

3. 前往 **Build Settings**，并在 **Linking** 下添加参数值 `Other Linker Flags = -ObjC`。

4. 确保目标已链接到 YandexMobileAdsPackage。如果尚未链接，请前往 **Link Binary With Libraries**，然后点击 **+** 添加库链接。

5. 选择适配器或聚合版本。核心版本仅包含 SPM 中可用的适配器。

{% endlist %} ### SKAdNetwork 支持 {#skad} ## 什么是 SKAdNetwork？随着 iOS 14 的发布，Apple 限制了对 IDFA 的访问权限，而此前该标识符被用于将应用安装与广告活动进行匹配。广告网络在广告活动中进行转化归因时，不再能仅依赖 IDFA。[SKAdNetwork](https://developer.apple.com/documentation/storekit/skadnetwork) 通过提供聚合的归因数据（且不共享用户的个人信息）来解决这一问题。 Mobile Ads SDK 已集成 SKAdNetwork，即使在无法获取 IDFA 的情况下，也能实现跨设备的安装追踪。如需了解更多信息，请参阅 Apple 文档中的[配置来源应用](https://developer.apple.com/documentation/storekit/skadnetwork/configuring_a_source_app)。 ## 为什么要实施 SKAdNetwork？为了确保在投放应用广告时能准确追踪所有转化，请在 `Info.plist` 中声明 SKAdNetwork ID。否则，部分转化数据将会丢失，这可能会影响您的广告收入。 ## 实施 SKAdNetwork ### 手动添加列表请手动将此 ID 列表添加到 `Info.plist` 中： {% cut "SKAdNetwork ID 列表" %} ```xml SKAdNetworkItems SKAdNetworkIdentifier zq492l623r.skadnetwork SKAdNetworkIdentifier cstr6suwn9.skadnetwork SKAdNetworkIdentifier n9x2a789qt.skadnetwork SKAdNetworkIdentifier r26jy69rpl.skadnetwork SKAdNetworkIdentifier 5l3tpt7t6e.skadnetwork SKAdNetworkIdentifier gta9lk7p23.skadnetwork SKAdNetworkIdentifier 4dzt52r2t5.skadnetwork SKAdNetworkIdentifier su67r6k2v3.skadnetwork SKAdNetworkIdentifier ludvb6z3bs.skadnetwork SKAdNetworkIdentifier kbd757ywx3.skadnetwork SKAdNetworkIdentifier 633vhxswh4.skadnetwork SKAdNetworkIdentifier tmhh9296z4.skadnetwork SKAdNetworkIdentifier vcra2ehyfk.skadnetwork SKAdNetworkIdentifier zh3b7bxvad.skadnetwork SKAdNetworkIdentifier xmn954pzmp.skadnetwork SKAdNetworkIdentifier 79w64w269u.skadnetwork SKAdNetworkIdentifier 488r3q3dtq.skadnetwork SKAdNetworkIdentifier d7g9azk84q.skadnetwork SKAdNetworkIdentifier nzq8sh4pbs.skadnetwork SKAdNetworkIdentifier 866k9ut3g3.skadnetwork SKAdNetworkIdentifier 2q884k2j68.skadnetwork SKAdNetworkIdentifier x8jxxk4ff5.skadnetwork SKAdNetworkIdentifier gfat3222tu.skadnetwork SKAdNetworkIdentifier pd25vrrwzn.skadnetwork SKAdNetworkIdentifier lr83yxwka7.skadnetwork SKAdNetworkIdentifier cp8zw746q7.skadnetwork SKAdNetworkIdentifier pwdxu55a5a.skadnetwork SKAdNetworkIdentifier c6k4g5qg8m.skadnetwork SKAdNetworkIdentifier s39g8k73mm.skadnetwork SKAdNetworkIdentifier wg4vff78zm.skadnetwork SKAdNetworkIdentifier g28c52eehv.skadnetwork SKAdNetworkIdentifier 523jb4fst2.skadnetwork SKAdNetworkIdentifier 294l99pt4k.skadnetwork SKAdNetworkIdentifier 3qy4746246.skadnetwork SKAdNetworkIdentifier a8cz6cu7e5.skadnetwork SKAdNetworkIdentifier ggvn48r87g.skadnetwork SKAdNetworkIdentifier y755zyxw56.skadnetwork SKAdNetworkIdentifier qlbq5gtkt8.skadnetwork SKAdNetworkIdentifier mls7yz5dvl.skadnetwork SKAdNetworkIdentifier 67369282zy.skadnetwork SKAdNetworkIdentifier 899vrgt9g8.skadnetwork SKAdNetworkIdentifier mj797d8u6f.skadnetwork SKAdNetworkIdentifier 3sh42y64q3.skadnetwork SKAdNetworkIdentifier f38h382jlk.skadnetwork SKAdNetworkIdentifier 24t9a8vw3c.skadnetwork SKAdNetworkIdentifier mp6xlyr22a.skadnetwork SKAdNetworkIdentifier x44k69ngh6.skadnetwork SKAdNetworkIdentifier 88k8774x49.skadnetwork SKAdNetworkIdentifier hs6bdukanm.skadnetwork SKAdNetworkIdentifier t3b3f7n3x8.skadnetwork SKAdNetworkIdentifier prcb7njmu6.skadnetwork SKAdNetworkIdentifier c7g47wypnu.skadnetwork SKAdNetworkIdentifier 52fl2v3hgk.skadnetwork SKAdNetworkIdentifier 9vvzujtq5s.skadnetwork SKAdNetworkIdentifier m8dbw4sv7c.skadnetwork SKAdNetworkIdentifier 9g2aggbj52.skadnetwork SKAdNetworkIdentifier m5mvw97r93.skadnetwork SKAdNetworkIdentifier z5b3gh5ugf.skadnetwork SKAdNetworkIdentifier dd3a75yxkv.skadnetwork SKAdNetworkIdentifier 9nlqeag3gk.skadnetwork SKAdNetworkIdentifier cj5566h2ga.skadnetwork SKAdNetworkIdentifier h5jmj969g5.skadnetwork SKAdNetworkIdentifier dr774724x4.skadnetwork SKAdNetworkIdentifier t7ky8fmwkd.skadnetwork SKAdNetworkIdentifier fz2k2k5tej.skadnetwork SKAdNetworkIdentifier u679fj5vs4.skadnetwork SKAdNetworkIdentifier cs644xg564.skadnetwork SKAdNetworkIdentifier 9b89h5y424.skadnetwork SKAdNetworkIdentifier w28pnjg2k4.skadnetwork SKAdNetworkIdentifier 2rq3zucswp.skadnetwork SKAdNetworkIdentifier a7xqa6mtl2.skadnetwork SKAdNetworkIdentifier g2y4y55b64.skadnetwork SKAdNetworkIdentifier vc83br9sjg.skadnetwork SKAdNetworkIdentifier eqhxz8m8av.skadnetwork SKAdNetworkIdentifier 7k3cvf297u.skadnetwork SKAdNetworkIdentifier w9q455wk68.skadnetwork SKAdNetworkIdentifier nu4557a4je.skadnetwork SKAdNetworkIdentifier v4nxqhlyqp.skadnetwork SKAdNetworkIdentifier wzmmz9fp6w.skadnetwork SKAdNetworkIdentifier 7fmhfwg9en.skadnetwork SKAdNetworkIdentifier yclnxrl5pm.skadnetwork SKAdNetworkIdentifier 7tnzynbdc7.skadnetwork SKAdNetworkIdentifier l6nv3x923s.skadnetwork SKAdNetworkIdentifier h8vml93bkz.skadnetwork SKAdNetworkIdentifier uzqba5354d.skadnetwork SKAdNetworkIdentifier 8qiegk9qfv.skadnetwork SKAdNetworkIdentifier v79kvwwj4g.skadnetwork SKAdNetworkIdentifier xx9sdjej2w.skadnetwork SKAdNetworkIdentifier au67k4efj4.skadnetwork SKAdNetworkIdentifier t38b2kh725.skadnetwork SKAdNetworkIdentifier 7ug5zh24hu.skadnetwork SKAdNetworkIdentifier rx5hdcabgc.skadnetwork SKAdNetworkIdentifier 5lm9lj6jb7.skadnetwork SKAdNetworkIdentifier qqp299437r.skadnetwork SKAdNetworkIdentifier zmvfpc5aq8.skadnetwork SKAdNetworkIdentifier 9rd848q2bz.skadnetwork SKAdNetworkIdentifier 79pbpufp6p.skadnetwork SKAdNetworkIdentifier dmv22haz9p.skadnetwork SKAdNetworkIdentifier y5ghdn5j9k.skadnetwork SKAdNetworkIdentifier n6fk4nfna4.skadnetwork SKAdNetworkIdentifier 7rz58n8ntl.skadnetwork SKAdNetworkIdentifier v9wttpbfk9.skadnetwork SKAdNetworkIdentifier n38lu8286q.skadnetwork SKAdNetworkIdentifier feyaarzu9v.skadnetwork SKAdNetworkIdentifier 7fbxrn65az.skadnetwork SKAdNetworkIdentifier 47vhws6wlr.skadnetwork SKAdNetworkIdentifier ejvt5qm6ak.skadnetwork SKAdNetworkIdentifier b55w3d8y8z.skadnetwork SKAdNetworkIdentifier v7896pgt74.skadnetwork SKAdNetworkIdentifier 5ghnmfs3dh.skadnetwork SKAdNetworkIdentifier 275upjj5gd.skadnetwork SKAdNetworkIdentifier 627r9wr2y5.skadnetwork SKAdNetworkIdentifier sczv5946wb.skadnetwork SKAdNetworkIdentifier 8w3np9l82g.skadnetwork SKAdNetworkIdentifier hb56zgv37p.skadnetwork SKAdNetworkIdentifier 9t245vhmpl.skadnetwork SKAdNetworkIdentifier nrt9jy4kw9.skadnetwork SKAdNetworkIdentifier 7953jerfzd.skadnetwork SKAdNetworkIdentifier dn942472g5.skadnetwork SKAdNetworkIdentifier 6v7lgmsu45.skadnetwork SKAdNetworkIdentifier cad8qz2s3j.skadnetwork SKAdNetworkIdentifier eh6m2bh4zr.skadnetwork SKAdNetworkIdentifier jb7bn6koa5.skadnetwork SKAdNetworkIdentifier fkak3gfpt6.skadnetwork SKAdNetworkIdentifier a2p9lx4jpn.skadnetwork SKAdNetworkIdentifier 97r2b46745.skadnetwork SKAdNetworkIdentifier 22mmun2rn5.skadnetwork SKAdNetworkIdentifier 238da6jt44.skadnetwork SKAdNetworkIdentifier 44jx6755aq.skadnetwork SKAdNetworkIdentifier b9bk5wbcq9.skadnetwork SKAdNetworkIdentifier k674qkevps.skadnetwork SKAdNetworkIdentifier tl55sbb4fm.skadnetwork SKAdNetworkIdentifier 24zw6aqk47.skadnetwork SKAdNetworkIdentifier 4468km3ulz.skadnetwork SKAdNetworkIdentifier 2tdux39lx8.skadnetwork SKAdNetworkIdentifier 2u9pt9hc89.skadnetwork SKAdNetworkIdentifier 8s468mfl3y.skadnetwork SKAdNetworkIdentifier 3cgn6rq224.skadnetwork SKAdNetworkIdentifier glqzh8vgby.skadnetwork SKAdNetworkIdentifier av6w8kgt66.skadnetwork SKAdNetworkIdentifier klf5c3l5u5.skadnetwork SKAdNetworkIdentifier nfqy3847ph.skadnetwork SKAdNetworkIdentifier dticjx1a9i.skadnetwork SKAdNetworkIdentifier ppxm28t8ap.skadnetwork SKAdNetworkIdentifier 9wsyqb3ku7.skadnetwork SKAdNetworkIdentifier 74b6s63p6l.skadnetwork SKAdNetworkIdentifier xy9t38ct57.skadnetwork SKAdNetworkIdentifier 424m5254lk.skadnetwork SKAdNetworkIdentifier qu637u8glc.skadnetwork SKAdNetworkIdentifier f73kdq92p3.skadnetwork SKAdNetworkIdentifier 44n7hlldy6.skadnetwork SKAdNetworkIdentifier kbmxgpxpgc.skadnetwork SKAdNetworkIdentifier ecpz2srf59.skadnetwork SKAdNetworkIdentifier x5854y7y24.skadnetwork SKAdNetworkIdentifier f7s53z58qe.skadnetwork SKAdNetworkIdentifier x8uqf25wch.skadnetwork SKAdNetworkIdentifier uw77j35x4d.skadnetwork SKAdNetworkIdentifier 6964rsfnh4.skadnetwork SKAdNetworkIdentifier gvmwg8q7h5.skadnetwork SKAdNetworkIdentifier 6yxyv74ff7.skadnetwork SKAdNetworkIdentifier 84993kbrcf.skadnetwork SKAdNetworkIdentifier 54nzkqm89y.skadnetwork SKAdNetworkIdentifier pwa73g5rt2.skadnetwork SKAdNetworkIdentifier mlmmfzh3r3.skadnetwork SKAdNetworkIdentifier 9yg77x724h.skadnetwork SKAdNetworkIdentifier n66cz3y3bx.skadnetwork SKAdNetworkIdentifier 578prtvx9j.skadnetwork SKAdNetworkIdentifier bvpn9ufa9b.skadnetwork SKAdNetworkIdentifier 6qx585k4p6.skadnetwork SKAdNetworkIdentifier mtkv5xtk9e.skadnetwork SKAdNetworkIdentifier l93v5h6a4m.skadnetwork SKAdNetworkIdentifier rvh3l7un93.skadnetwork SKAdNetworkIdentifier 5tjdwbrq8w.skadnetwork SKAdNetworkIdentifier r45fhb6rf7.skadnetwork SKAdNetworkIdentifier 32z4fx6l9h.skadnetwork SKAdNetworkIdentifier e5fvkxwrpn.skadnetwork SKAdNetworkIdentifier 8c4e2ghe7u.skadnetwork SKAdNetworkIdentifier axh5283zss.skadnetwork SKAdNetworkIdentifier 3rd42ekr43.skadnetwork SKAdNetworkIdentifier 5mv394q32t.skadnetwork SKAdNetworkIdentifier 3qcr597p9d.skadnetwork SKAdNetworkIdentifier v72qych5uu.skadnetwork SKAdNetworkIdentifier ydx93a7ass.skadnetwork SKAdNetworkIdentifier 4pfyvq9l8r.skadnetwork SKAdNetworkIdentifier 5a6flpkh64.skadnetwork SKAdNetworkIdentifier 4fzdc2evr5.skadnetwork SKAdNetworkIdentifier 4w7y6s5ca2.skadnetwork SKAdNetworkIdentifier 252b5q8x7y.skadnetwork SKAdNetworkIdentifier 2fnua5tdw4.skadnetwork SKAdNetworkIdentifier 3l6bd9hu43.skadnetwork SKAdNetworkIdentifier 4mn522wn87.skadnetwork SKAdNetworkIdentifier 6g9af3uyq4.skadnetwork SKAdNetworkIdentifier 6p4ks3rnbw.skadnetwork SKAdNetworkIdentifier 6xzpu9s2p8.skadnetwork SKAdNetworkIdentifier 737z793b9f.skadnetwork SKAdNetworkIdentifier 89z7zv988g.skadnetwork SKAdNetworkIdentifier 8m87ys6875.skadnetwork SKAdNetworkIdentifier 8r8llnkz5a.skadnetwork SKAdNetworkIdentifier bxvub5ada5.skadnetwork SKAdNetworkIdentifier c3frkrj4fj.skadnetwork SKAdNetworkIdentifier cg4yq2srnc.skadnetwork SKAdNetworkIdentifier dbu4b84rxf.skadnetwork SKAdNetworkIdentifier dkc879ngq3.skadnetwork SKAdNetworkIdentifier dzg6xy7pwj.skadnetwork SKAdNetworkIdentifier gta8lk7p23.skadnetwork SKAdNetworkIdentifier hdw39hrw9y.skadnetwork SKAdNetworkIdentifier hjevpa356n.skadnetwork SKAdNetworkIdentifier krvm3zuq6h.skadnetwork SKAdNetworkIdentifier ln5gz23vtd.skadnetwork SKAdNetworkIdentifier m297p6643m.skadnetwork SKAdNetworkIdentifier p78axxw29g.skadnetwork SKAdNetworkIdentifier pu4na253f3.skadnetwork SKAdNetworkIdentifier s69wq72ugq.skadnetwork SKAdNetworkIdentifier t6d3zquu66.skadnetwork SKAdNetworkIdentifier vutu7akeur.skadnetwork SKAdNetworkIdentifier x2jnk7ly8j.skadnetwork SKAdNetworkIdentifier x5l83yy675.skadnetwork SKAdNetworkIdentifier y45688jllp.skadnetwork SKAdNetworkIdentifier yrqqpx2mcb.skadnetwork SKAdNetworkIdentifier z4gj7hsk7h.skadnetwork SKAdNetworkIdentifier 33r6p7g8nc.skadnetwork SKAdNetworkIdentifier g69uk9uh2b.skadnetwork ``` {% endcut %} ### 自动更新您可以通过软件更新 SKAdNetwork ID 列表：例如将其集成到您的 CI/CD 管道中。为此，请使用以下格式之一的最新 ID 列表： {% list tabs %} - JSON ```text https://yastatic.net/pcode-static/skadnetwork/skadids.json ``` - XML ```text https://yastatic.net/pcode-static/skadnetwork/skadids.xml ``` {% endlist %} ### 使用脚本您也可以使用以下脚本： {% cut "用于更新 SKAdNetwork ID 的脚本" %} ```bash #!/bin/bash # ============================================================ # Yandex Ads SDK — SKAdNetwork IDs Updater # # Fetches the latest SKAdNetwork IDs from Yandex # and merges them into Info.plist # ============================================================ set -o pipefail URLS=( "https://yastatic.net/pcode-static/skadnetwork/skadids.json" "https://yastatic.net/pcode-static/skadnetwork/skadids.xml" ) PLIST_BUDDY="/usr/libexec/PlistBuddy" TAG="[YandexAds]" # ---- Colors ---- if [ -t 1 ]; then RED='\033[0;31m' GREEN='\033[0;32m' YELLOW='\033[0;33m' NC='\033[0m' else RED='' GREEN='' YELLOW='' NC='' fi log_info() { printf "${NC}${TAG} %s${NC}\n" "$1"; } log_start() { printf "${YELLOW}${TAG} %s${NC}\n" "$1"; } log_success() { printf "${GREEN}${TAG} %s${NC}\n" "$1"; } log_warn() { if [ -t 1 ]; then # Terminal: colored, readable format printf "${RED}${TAG} Warning: %s${NC}\n" "$1" else # Xcode Build Phase: recognized as warning in Issue Navigator printf "warning: ${TAG} %s\n" "$1" fi } # ---- Start ---- log_start "Starting SKAdNetwork IDs update..." # ---- Resolve Info.plist path ---- resolve_plist() { # 1. Explicit argument if [ -n "${1:-}" ]; then echo "$1" return 0 fi # 2. Xcode environment if [ -n "${INFOPLIST_FILE:-}" ]; then if [[ "${INFOPLIST_FILE}" = /* ]]; then echo "${INFOPLIST_FILE}" else echo "${SRCROOT:-.}/${INFOPLIST_FILE}" fi return 0 fi # 3. Auto-search in current directory local found found=$(find . \ -name "Info.plist" \ -not -path "*/Pods/*" \ -not -path "*/Carthage/*" \ -not -path "*/DerivedData/*" \ -not -path "*/build/*" \ -not -path "*/.build/*" \ -not -path "*/Packages/*" \ -not -path "*Tests*" \ -not -path "*Extensions*" \ 2>/dev/null) local count count=$([ -n "$found" ] && echo "$found" | wc -l | tr -d ' ' || echo "0") if [ "$count" -eq 1 ]; then echo "$found" return 0 elif [ "$count" -gt 1 ]; then log_warn "Found multiple Info.plist files:" >&2 echo "$found" >&2 log_warn "Pass the correct path as argument." >&2 return 1 fi log_warn "Info.plist not found. Pass as argument or run from project root." >&2 return 1 } PLIST_PATH=$(resolve_plist "${1:-}") || exit 0 if [ ! -f "$PLIST_PATH" ]; then log_warn "File not found: $PLIST_PATH" exit 0 fi log_info "Plist: $PLIST_PATH" # ---- Fetch with fallback ---- RESPONSE="" for url in "${URLS[@]}"; do log_info "Trying: $url" RESPONSE=$(curl -sf --max-time 5 "$url" 2>/dev/null) && [ -n "$RESPONSE" ] && { log_info "Fetched: $url" break } RESPONSE="" done if [ -z "$RESPONSE" ]; then log_warn "All sources unavailable. Skipping." exit 0 fi # ---- Extract IDs (both JSON and XML) ---- REMOTE_IDS=$(echo "$RESPONSE" \ | grep -ioE '[a-z0-9]+\.skadnetwork' \ | tr '[:upper:]' '[:lower:]' \ | sort -u) if [ -z "$REMOTE_IDS" ]; then log_warn "No IDs parsed. Skipping." exit 0 fi REMOTE_COUNT=$(echo "$REMOTE_IDS" | wc -l | tr -d ' ') log_info "Remote IDs: $REMOTE_COUNT" # ---- Read existing IDs from plist ---- EXISTING_IDS=$("$PLIST_BUDDY" -c "Print :SKAdNetworkItems" "$PLIST_PATH" 2>/dev/null \ | grep -ioE '[a-z0-9]+\.skadnetwork' \ | tr '[:upper:]' '[:lower:]' \ | sort -u) EXISTING_COUNT=$([ -n "$EXISTING_IDS" ] && echo "$EXISTING_IDS" | wc -l | tr -d ' ' || echo "0") log_info "Existing IDs: $EXISTING_COUNT" # ---- Additive diff: only new IDs ---- if [ -n "$EXISTING_IDS" ]; then IDS_TO_ADD=$(comm -23 <(echo "$REMOTE_IDS") <(echo "$EXISTING_IDS")) else IDS_TO_ADD="$REMOTE_IDS" fi ADD_COUNT=$([ -n "$IDS_TO_ADD" ] && echo "$IDS_TO_ADD" | wc -l | tr -d ' ' || echo "0") if [ "$ADD_COUNT" -eq 0 ]; then log_success "Up to date." exit 0 fi log_start "Adding $ADD_COUNT new ID(s)..." # ---- Ensure SKAdNetworkItems array exists ---- "$PLIST_BUDDY" -c "Print :SKAdNetworkItems" "$PLIST_PATH" &>/dev/null \ || "$PLIST_BUDDY" -c "Add :SKAdNetworkItems array" "$PLIST_PATH" # ---- Append new entries ---- INDEX=$("$PLIST_BUDDY" -c "Print :SKAdNetworkItems" "$PLIST_PATH" 2>/dev/null \ | grep -c "Dict") while IFS= read -r skad_id; do [ -z "$skad_id" ] && continue "$PLIST_BUDDY" \ -c "Add :SKAdNetworkItems: dict" \ -c "Add :SKAdNetworkItems:${INDEX}:SKAdNetworkIdentifier string ${skad_id}" \ "$PLIST_PATH" 2>/dev/null || { log_warn "Failed to add: $skad_id" continue } INDEX=$((INDEX + 1)) done <<< "$IDS_TO_ADD" TOTAL=$((EXISTING_COUNT + ADD_COUNT)) log_success "Done. Total: $TOTAL (+$ADD_COUNT new)" ``` {% endcut %} 该脚本会从 Yandex 服务器获取最新的 SKAdNetwork ID 列表，并将缺失的条目添加到您的 `Info.plist` 中。脚本的工作原理： - **仅追加**。该脚本仅添加缺失的 ID，不会删除现有条目，即使这些条目在新列表中已不存在。 - **无状态执行**。该脚本不存储中间数据。每次执行都会重新请求最新列表，将其与您的 `Info.plist` 进行比对，并应用必要的更新。 - **容错构建**。若发生网络错误，脚本将以代码 0 终止，且不会中断构建过程。您的 `Info.plist` 路径将自动确定： | 优先级 | 来源 | 时间 | |-----------|----------|-------| | 1 | `./script.sh path` 参数 | 显式指定路径 | | 2 | `$INFOPLIST_FILE` | Xcode 构建阶段 | | 3 | 在当前目录中自动搜索 | 手动运行且未提供参数 | 自动搜索会排除 `Pods/`、`Carthage/`、`DerivedData/`、`build/`、`Packages/`、`*Tests*` 和 `*Extensions*`。 #### 作为 Xcode 构建阶段运行 1. 将 `update_skad_ids.sh` 文件复制到项目的根文件夹。 1. 赋予其可执行权限： ```bash chmod +x update_skad_ids.sh ``` 1. 前往 **Target** → **Build Phases** → **+** → **New Run Script Phase**。 1. 将名称更改为 `Update Yandex SKAdNetwork ID`。 1. 将以下内容粘贴到脚本主体中： ``` "${SRCROOT}/update_skad_ids.sh" ``` 1. 配置脚本启动设置。为此，请在您创建的 `Update Yandex SKAdNetwork ID` 阶段中启用以下参数： | 参数 | 值 | 作用 | |----------|----------|-------| | **For Install Builds Only** |

| 仅在归档操作期间运行 | | **Based on dependency analysis** |

| 始终在归档操作期间运行 | 采用此设置后，每次执行归档操作时脚本都会运行。若要在每次构建时运行脚本，请禁用**For Install Builds Only**选项。 1. 重新排列构建阶段。在**Build Phases**列表中，将您创建的`Update Yandex SKAdNetwork ID` 阶段移至`Copy Bundle Resources`之上。这可确保在将资源复制到 Bundle 之前更新 `Info.plist`。 #### 手动运行 1. 赋予其可执行权限： ```bash chmod +x update_skad_ids.sh ``` 1. 运行脚本： {% list tabs %} - 从项目的根文件夹运行路径将自动确定： ```bash ./update_skad_ids.sh ``` - 指定路径运行 ```bash ./update_skad_ids.sh MyApp/Info.plist ``` {% endlist %} #### 要求 - macOS 10.15 或更高版本 - Xcode 12 或更高版本 ### 初始化 {#init} 库成功初始化Yandex Mobile Ads SDK 是正确集成库的前提条件。默认情况下，SDK 会在广告显示之前自动初始化。然而，手动初始化可以加快首个广告的显示速度，从而增加您的变现收入。 #### 手动 SDK 初始化您可以使用 `YandexAds.initializeSDK()` 方法对库进行手动初始化。我们建议将初始化代码添加到 `AppDelegate` 类的 `func application(_ application: didFinishLaunchingWithOptions launchOptions:)` 方法中。 ```swift class AppDelegate: UIResponder, UIApplicationDelegate { var window: UIWindow? func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? ) -> Bool { YandexAds.initializeSDK(completionHandler: completionHandler) return true } } ``` ## 测试 SDK 集成您可以检查日志以确保 SDK 集成正确。要查看日志，请前往控制台工具并设置 `Subsystem = com.mobile.ads.ads.sdk`。您可以按类别过滤日志，仅保留与广告 SDK 集成相关的日志。设置 `Category = Integration`。保存查询，并在需要调试时从过滤行中选择它。您将看到有关成功集成的消息：启用 `YandexMobileAdsBundle.bundle`、初始化 SDK 以及连接 SKAdNetwork 和移动聚合适配器（如果您在项目中使用了它们）。如果 SDK 集成过程中出现任何问题，您将看到详细的问题报告。

## 下一步成功集成 Yandex Mobile Ads SDK 后，您就可以开始实施广告格式了。选择以下最适合您的应用的广告类型之一： #| || **广告格式** | **YAN** | **Adfox** | **描述** || || [自适应内联横幅](https://ads.yandex.com/helpcenter/zh/dev/ios/adaptive-inline-banner.md) |

| 自适应内嵌横幅广告是一种灵活的横幅广告格式，通过针对每台设备优化广告尺寸，确保投放效果达到最优。横幅高度是自动选择的，并且可以达到设备屏幕的高度。通常，这种格式用于基于信息流的应用或可以将用户注意力主要集中在广告上的上下文环境中。|| || [自适应粘性横幅](https://ads.yandex.com/helpcenter/zh/dev/ios/adaptive-sticky-banner.md) |

| 自适应固定横幅广告是一种小型广告，会自动更新，并显示在应用屏幕的顶部或底部。它不会遮挡主要内容，常用于游戏应用中。粘性横幅的高度是自动确定的，可根据设备屏幕尺寸调整，并且不超过屏幕高度的 15％。|| || [插屏广告](https://ads.yandex.com/helpcenter/zh/dev/ios/interstitial.md) |

| 插屏广告是一种全屏广告格式，嵌入在应用内容中，在自然暂停时显示，例如在游戏关卡之间过渡或完成目标操作时。当用户看到插屏广告时，他们的注意力完全集中在广告上，这导致此类展示的成本更高。过度使用这种格式可能会降低用户的互动体验。|| || [激励广告](https://ads.yandex.com/helpcenter/zh/dev/ios/rewarded.md) |

| 激励广告是一种受欢迎的全屏广告格式，用户观看广告后会获得奖励。广告展示采用主动选择机制：例如，用户可以主动触发广告以获取游戏奖励或额外生命值。强烈的用户动机使这种广告格式成为免费应用中最受欢迎且盈利能力最强的广告格式。 || || [原生广告](https://ads.yandex.com/helpcenter/zh/dev/ios/native.md) |

| 原生广告是一种布局可以在应用级别定义的广告类型。这一功能允许您根据应用设计的具体上下文更改广告的视觉风格以及投放位置。广告呈现通过本地平台工具执行，从而提高广告效果和质量。您可以使用模板或手动设置原生广告的布局。如果选择使用模板，广告布局将在SDK端设置。|| || [开屏广告](https://ads.yandex.com/helpcenter/zh/dev/ios/app-open-ad.md) |

| 应用开屏广告是一种用于通过应用加载界面实现变现的特殊广告格式。此类广告可随时关闭，并设计用于在以下场景中展示： * 应用启动时。 * 应用被调至前台时。 * 从后台返回应用时。 || || [视频插播广告](https://ads.yandex.com/helpcenter/zh/dev/ios/instream.md) |

| 视频插播广告可让您通过在播放视频内容时投放广告来实现应用变现。视频插播广告由具有多个视频块的场景组成。视频插播广告场景中视频单元的类型决定了视频广告相对于主视频内容的播放方式。 || |#