企业官网建设流程全解析

简介：本资源面向使用 Unity 引擎开发 iOS 应用的开发者，聚焦 AppLovin Max 平台 Native 原生广告的接入实践，适合已具备一定 Unity 与 iOS 基础、希望提升广告变现能力的中级开发者。内容围绕 SDK 导入、广告位配置、原生广告视图搭建、事件回调处理及收益优化策略展开，帮助读者在合规前提下将原生广告自然融入应用界面。资源包共 58 个文件，约 367KB，包含 21 个 png 图片资源、15 个 meta 配置、8 个 json 数据文件，以及 h、mm、swift 等源码文件与 MaxNativeAdFramework 框架、nib 视图、plist 配置等，覆盖原生广告展示所需的素材、脚本与工程配置。目前已有 106 人学习下载。通过该资源，读者可获取一套可直接参考的 Native 广告接入工程结构，理解原生广告视图与业务逻辑的衔接方式，并借鉴广告事件回调与智能填充等优化思路，减少自行摸索成本。

1. 从一次 iOS 构建失败说起：Unity 接入 AppLovin MAX 原生广告到底难在哪

第一次在 Unity 里给 iOS 接 AppLovin MAX 的原生广告，我卡了整整一个下午。Xcode 报错指向AppLovinSDK符号找不到，Unity 控制台里却只丢出一句含糊的DllNotFoundException，两边信息对不上，典型的黑匣子现场。后来才发现，问题根本不在代码，而是 CocoaPods 没跑通、Podfile里的平台版本和 Unity 导出的 iOS 工程对不上。这套环境在休闲游戏和工具类 App 里非常常见，装不好轻则广告不展示、收益归零，重则直接构建失败、上不了架。这篇笔记面向的是正在 Unity 里接 iOS 原生广告、被 Xcode 和 Pod 折腾到怀疑人生的开发者，从版本选择一路写到装完怎么验证，照着走能少踩几个我踩过的坑。

2. 环境准备：Unity、Xcode、CocoaPods 的版本怎么选

2.1 Unity 版本与 iOS 模块的取舍

Unity 这边我一般会锁在 LTS 版本上，2021.3 或 2022.3 都行，关键是别用太新的 Tech Stream 去接广告 SDK，版本差异带来的 API 变动会让你在 Xcode 里多花一倍时间排查。安装 Unity 时，iOS Build Support 模块必须勾上，很多人图省事只装了默认模块，结果导出工程时发现UnityFramework根本没生成，后面 Pod 装到一半就报错。

安装路径建议全英文、无空格，Windows 上尤其注意，C:\Program Files\Unity这种带空格的路径在部分 Pod 脚本里会被截断。macOS 上我习惯放在/Applications/Unity/Hub/Editor/2022.3.x，Hub 管理多版本也方便。

导出 iOS 工程前，Player Settings 里这几项要提前确认：

• Bundle Identifier 必须和你在 AppLovin 后台填的一致，不一致广告请求会返回空
• Target minimum iOS Version 建议 12.0 起步，低于这个值部分广告网络 SDK 会直接拒绝编译
• Scripting Backend 选 IL2CPP，iOS 不支持 Mono
• Architecture 选 ARM64，模拟器调试可以临时加 ARM64 + x86_64，但出包必须只留 ARM64

2.2 Xcode 与 CocoaPods 的版本匹配

Xcode 版本跟着 macOS 走，但要注意 AppLovin SDK 对 Xcode 有最低要求。我一般用 Xcode 14.x 或 15.x，太老的 Xcode 12 在编译最新 SDK 时会报 Swift 版本不兼容。装完 Xcode 后别忘了跑一次：

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer sudo xcodebuild -runFirstLaunch

第一行是把命令行工具指向当前 Xcode，第二行是安装额外组件，不跑的话pod install可能报xcodebuild找不到。

CocoaPods 用 Ruby 装，macOS 自带 Ruby 版本往往太老，我一般用 rbenv 或直接brew install cocoapods。装完确认版本：

pod --version # 建议 1.12 以上，低于 1.10 在处理 XCFramework 时会出问题

提示：如果你之前装过多个 CocoaPods 版本，pod install时可能调用了旧版本，用which pod确认路径，必要时gem uninstall cocoapods清掉旧的。

2.3 AppLovin MAX SDK 的获取方式

AppLovin MAX 的 Unity 插件包从官方后台下载.unitypackage，导入 Unity 后菜单栏会出现AppLovin选项。导入前建议先备份Assets目录，插件会覆盖部分AndroidManifest和 iOS 相关文件。导入后检查Assets/AppLovin/下是否有Editor、Scripts、Plugins三个目录，缺一个都说明导入不完整。

iOS 侧的 SDK 依赖是通过 CocoaPods 拉取的，Unity 导出工程后会自动生成Podfile，但里面的源和版本号需要你手动确认。常见做法是在导出前于 AppLovin 设置面板里勾选需要的广告网络，这样生成的Podfile才会包含对应的 adapter。

3. 安装落地：从 Unity 导出到 Pod 安装的完整链路

3.1 Unity 侧配置与导出 iOS 工程

先在 Unity 里打开 AppLovin 的设置面板，填入 SDK Key。这个 Key 在 AppLovin 后台的 Account 页面能找到，填错的话初始化会静默失败，日志里只有一行Initialization failed，不告诉你原因。

设置面板里几个关键项：

• Mediation Debugger建议开启，调试阶段能看到各广告网络的填充情况
• Ad Networks里勾选你要接的网络，每勾一个，导出的Podfile就多一条 pod 依赖
• iOS Settings里填SKAdNetworkIdentifier，不填的话 iOS 14+ 归因基本废掉

配置完执行导出：

# Unity 菜单 File > Build Settings > iOS > Build # 导出到一个空目录，不要覆盖旧工程，避免残留文件干扰

导出完成后目录结构大致是：

iOSBuild/ ├── Unity-iPhone.xcodeproj ├── UnityFramework/ ├── Podfile └── MainApp/

Podfile是自动生成的，但别急着pod install，先打开看一眼。

3.2 Podfile 关键参数逐行说明

一个典型的Podfile长这样：

# Podfile source 'https://cdn.cocoapods.org/' # 平台版本必须和 Unity 里设置的最低版本一致 platform :ios, '12.0' # 关闭 use_frameworks! 的动态链接，AppLovin 推荐静态库 use_frameworks! :linkage => :static target 'UnityFramework' do # AppLovin SDK 核心 pod 'AppLovinSDK', '~> 11.0' # 各广告网络 adapter，按需添加 pod 'AppLovinMediationGoogleAdManagerAdapter' pod 'AppLovinMediationFacebookAdapter' pod 'AppLovinMediationUnityAdsAdapter' end target 'Unity-iPhone' do # 主工程一般不需要额外 pod，但有些网络要求在这里也声明 end

逐项说：

• source用官方 CDN 源，别用私有源，否则 adapter 版本可能对不上
• platform :ios, '12.0'必须和 Unity Player Settings 里的值一致，不一致会导致pod install报平台冲突
• use_frameworks! :linkage => :static是 AppLovin 官方推荐，动态链接在 iOS 上容易和 UnityFramework 冲突
• AppLovinSDK版本号用~>锁定大版本，避免自动升级到不兼容的新版
• adapter 的 pod 名必须和 AppLovin 后台勾选的网络一一对应，多一个少一个都会在运行时报警告

改完Podfile后执行：

cd iOSBuild pod install --repo-update

--repo-update会强制更新本地 spec 仓库，第一次装或换网络时建议加上，不加可能拉不到最新 adapter。

3.3 Xcode 工程配置与签名

pod install成功后，打开的是.xcworkspace而不是.xcodeproj，这点新手很容易搞错。打开 workspace 后，检查以下几项：

• UnityFrameworktarget 的Build Settings里，Other Linker Flags应包含-ObjC
• MainApptarget 的Signing & Capabilities里选好 Team，Bundle Identifier 和 Unity 里一致
• Info.plist里加上NSUserTrackingUsageDescription，否则 iOS 14+ 弹不出 ATT 授权框

如果编译报Undefined symbol: _OBJC_CLASS_$_AppLovinSDK，八成是-ObjC没加，或者pod install没跑成功。检查Pods目录下有没有AppLovinSDK文件夹，没有就说明 Pod 没装进去。

4. 避坑与排查：五个我真实踩过的坑

4.1 现象：pod install 卡在 Analyzing dependencies

原因：本地 CocoaPods spec 仓库太大或网络问题导致拉取超时。

解决：先pod repo remove trunk清掉旧仓库，再pod setup重新拉。如果还是卡，用pod install --verbose看具体卡在哪一步，通常是某个 adapter 的 spec 拉不下来，可以临时在Podfile里注释掉那个 adapter 先跑通。

4.2 现象：Xcode 编译报 Swift 版本不兼容

原因：AppLovin 部分 adapter 是用 Swift 写的，Xcode 的 Swift 版本和 adapter 要求的版本对不上。

解决：在Podfile末尾加：

post_install do |installer| installer.pods_project.targets.each do |target| target.build_configurations.each do |config| config.build_settings['SWIFT_VERSION'] = '5.0' end end end

然后重新pod install。Swift 版本统一到 5.0 能解决大部分兼容问题。

4.3 现象：广告初始化成功但一直不展示

原因：ATT 授权没弹，或者SKAdNetworkIdentifier没填全。

解决：确认Info.plist里有NSUserTrackingUsageDescription，并且在 App 启动后主动调用 ATT 请求。SKAdNetworkIdentifier从 AppLovin 后台复制，一个都不能少，少一个就少一个归因渠道。

4.4 现象：Unity 导出后 Podfile 里没有广告网络

原因：AppLovin 设置面板里没勾选对应网络，或者勾了但没点 Apply。

解决：回到 Unity，打开 AppLovin 设置面板，重新勾选网络后点 Apply，再重新导出 iOS 工程。注意每次改网络配置都要重新导出，不能只改 Podfile，因为 Unity 侧还有对应的 C# 桥接代码。

4.5 现象：真机运行崩溃，日志指向 AppLovinSDK

原因：静态库和动态库混用，或者Other Linker Flags里同时有-ObjC和-all_load导致符号冲突。

解决：只保留-ObjC，去掉-all_load。如果还崩，检查Podfile里use_frameworks!的 linkage 是不是 static，改成 static 后重新pod install。

5. 装完怎么验证：从日志到后台的完整确认链路

装完不代表跑通，我一般会走一遍完整的验证链路，确认广告真的能请求、能展示、能回调。

第一步，在 Unity 里加一段初始化回调日志：

using AppLovinMax; public class AdInitializer : MonoBehaviour { void Start() { MaxSdkCallbacks.OnSdkInitializedEvent += (MaxSdkBase.SdkConfiguration config) => { // 初始化成功后会打印当前用户是否同意 ATT Debug.Log($"MAX init: consent={config.ConsentDialogState}, " + $"ageRestricted={config.IsAgeRestrictedUser}"); }; MaxSdk.InitializeSdk(); } }

ConsentDialogState有三个值：Unknown、Applies、DoesNotApply。如果是Unknown，说明 ATT 没弹或用户没选，广告填充率会很低。

第二步，真机跑起来后看 Xcode 控制台，搜AppLovin关键字，正常初始化会输出类似：

[AppLovin] SDK initialized with version 11.x.x [AppLovin] Mediation adapter loaded: GoogleAdManager

如果只看到第一行没有 adapter 加载日志，说明 Podfile 里的 adapter 没生效，回第 3 章检查。

第三步，用 Mediation Debugger 验证。在 App 里调用MaxSdk.ShowMediationDebugger()，会弹出一个面板，列出所有已配置的广告网络和它们的填充状态。这个面板是验证环境是否装好的最直接方式，能看到每个网络的 SDK 版本、是否初始化成功、最近一次请求的填充结果。

第四步，去 AppLovin 后台看数据。初始化成功后几分钟内，后台的Mediation页面会有设备活跃记录。如果后台看不到设备，说明 SDK Key 填错了或者 Bundle Identifier 不匹配。

注意：验证阶段建议用测试设备，AppLovin 后台可以添加测试设备 ID，避免产生无效展示影响账号。

我自己的习惯是，每次换 Unity 版本或升级 AppLovin SDK 后，都强制走一遍这四步，尤其是第三步的 Mediation Debugger，它能提前暴露 90% 的配置问题。有一次我偷懒跳过，结果上线后发现某个广告网络根本没加载，白白损失了两天收益。从那以后，不管多赶，验证链路一步都不省。希望帮到你。

本文还有配套的精品资源，点击获取