--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://ads.yandex.com/helpcenter/en/dev/unity/quick-start.md - https://ads.yandex.com/helpcenter/pt/dev/unity/quick-start.md - https://ads.yandex.com/helpcenter/ru/dev/unity/quick-start.md - https://ads.yandex.com/helpcenter/zh/dev/unity/quick-start.md - href: zh/dev/unity/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 Unity 插件 > _系统：YAN、Adfox_ Unity 是由 Unity Technologies 开发的跨平台游戏开发环境。 Mobile Ads Unity 是 Unity3D 游戏平台的插件，支持 Yandex Mobile Ads SDK。 ## 应用要求 {#requirements} - 要使用此 SDK，您的应用的目标 API 级别必须设置为 31 或更高。 - 要加载任意类型的广告，iOS 版本需为 13 或更高版本。 - 使用 Xcode 16.4 或更高版本。 ## 前提条件 {#prolog} ### 在 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) 您的应用。 ### 安装 Unity {#unity-setup} 1. 从 [官方网站](https://unity.com/download) 下载 UnityHub 并进行安装。 1. 打开 UnityHub，转到 **Installs**，然后点击右上角的 **Add**。 1. 选择一个 Unity 版本。我们建议从最新的 LTS（长期支持）版本中进行选择。点击所选版本旁边的 **Install**。 1. 选择以下选项： - **Android Build Support**，包括 **OpenJDK** 和 **Android SDK & NDK Tools**。 - **iOS Build Support**。禁用 **Documentation** 选项。完成安装。 1. 打开 UnityHub 并转到 **Projects**。 1. 选择 **New project**，然后选择 **2D-core**。点击 **Create project**。您已经下载了 Unity 并创建了一个项目。 ## 应用配置 {#app} 1. 下载 [yandex-ads-unity-plugin](https://github.com/yandexmobile/yandex-ads-unity-plugin) 目录并添加包 `yandex-mobileads-lite-8.3.0.unitypackage`。系统还会提示您安装 Google 解析器。如果您已经将 Google 解析器添加到项目中，请取消选中该框。 {% cut "如何添加包" %} 选择所需的插件 (**Assets** → **Import Package** → **Custom Package**)，然后单击 **Import**。 {% endcut %} 1. 使用 Google 解析器安装依赖项：启用 "auto-resolve" 或者选择菜单项 **Assets** → **External Dependency Manager** → **Android Resolver** → **Resolve**。 1. 为了确保正常运行，请启用为生成的项目定制的模板。为此，在构建 (**Build Settings** → **Player Settings** → **Publishing Settings** → **Build**) 设置中，选择 **Custom Main Gradle Template**。我们建议您在构建 Unity 应用时始终启用 **Custom Main Gradle Template** 和 **Custom Gradle Properties Template**，以避免其他潜在错误。

1. 要测试 Mobile Ads Unity 插件，请使用 [yandex-ads-unity-plugin](https://github.com/yandexmobile/yandex-ads-unity-plugin) 存储库中的 **samples** 目录中的演示脚本。将脚本复制到项目目录并将其作为**Component** 添加到主摄像头。 ## 平台特定设置 {% list tabs %} - Android **降级目标 API 级别** 要将目标 API 级别降级到版本 30，请将显式降级添加到 `mainTemplate.gradle` 和 `launcherTemplate.gradle`（如果您在项目中使用 launcherTemplate）： ``` configurations.all { resolutionStrategy { force 'androidx.core:core:1.6.0' force 'androidx.core:core-ktx:1.6.0' } } ``` 但是，我们建议升级到目标 API 级别版本 31，因为 Google 对使用过时目标 API 级别版本发布更新的应用施加了限制。详情请参阅 [本文](https://developer.android.com/google/play/requirements/target-sdk)。 - iOS **SKAdNetwork 支持** ## 什么是 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 或更高版本 {% endlist %} ## 测试 SDK 集成 {% list tabs %} - Android 您可以使用 SDK 的内置集成测试工具验证库集成是否成功。为此，在添加依赖项并初始化 SDK 后，请重新构建项目。打开 Logcat 并搜索“Yandex Ads”关键词。该命令将输出集成状态日志。您将会看到一条消息，显示集成是否成功。如果存在问题，您将会看到详细描述以及解决步骤。示例命令输出： ```bash mobileads$ adb logcat | grep 'Yandex Ads' -i [Yandex Ads] I Yandex Mobile Ads 8.2.0 integrated successfully [Yandex Ads] I Yandex Mobile Ads 8.2.0 initialized successfully ``` 日志显示两个单独的事件： - “集成成功”：集成检查（SDK 尚未初始化）。 - “初始化成功”：SDK 初始化成功。 - iOS 您可以检查日志以确保 SDK 集成正确。要查看日志，请前往控制台工具并设置 `Subsystem = com.mobile.ads.ads.sdk`。您可以按类别过滤日志，仅保留与广告 SDK 集成相关的日志。设置 `Category = Integration`。保存查询，并在需要调试时从过滤行中选择它。您将看到有关成功集成的消息：启用 `YandexMobileAdsBundle.bundle`、初始化 SDK 以及连接 SKAdNetwork 和移动聚合适配器（如果您在项目中使用了它们）。如果 SDK 集成过程中出现任何问题，您将看到详细的问题报告。

{% endlist %} ## 下一步 {#next} 您已成功集成 Mobile Ads Unity 插件，现在可以实施您的广告格式。选择以下最适合您的应用的广告类型之一： #| || **广告格式** | **YAN** | **Adfox** | **描述** || || [自适应内联横幅](https://ads.yandex.com/helpcenter/zh/dev/unity/adaptive-inline-banner.md) |

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

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

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

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

| 应用开屏广告是一种用于通过应用加载界面实现变现的特殊广告格式。此类广告可随时关闭，并设计用于在以下场景中展示： * 应用启动时。 * 应用被调至前台时。 * 从后台返回应用时。 || |# ## 详细了解 * [插件集成错误](https://ads.yandex.com/helpcenter/zh/dev/unity/unity-errors.md#integration)