企业官网建设流程全解析

简介：这是一份面向 Unity iOS 开发者的 AppLovin Max Native 广告接入示例包，聚焦原生广告在 iOS 端的落地实现，适合已有 Unity 基础、希望补齐原生广告视图与桥接细节的中高级开发者参考。压缩包共 58 个文件，约 367KB，以 21 个 png 广告素材图、15 个 meta 配置、8 个 json 配置及 h/m/mm 源码、nib 原生视图、MaxNativeAdFramework 框架文件为主，兼顾界面资源与代码接入；目录按原生视图、框架模块和图片资源分组，便于按模块取用。已有 106 人学习，说明该主题具备一定实践参考需求。内容围绕原生广告视图布局、Objective-C++ 桥接、Swift 缓冲管理与 Max 广告框架集成展开，可帮助读者对照示例梳理初始化、广告位配置、视图加载和事件回调等关键环节，减少接入时的试错成本，也便于排查视图层级、素材适配与工程配置问题。

1. 一条原生广告卡在 iOS 上三天：这份资源到底解决什么问题

Unity 项目接 AppLovin MAX 的激励视频，半小时能跑通；换成 Native 原生广告，在 iOS 上卡三天是常事。问题不在 SDK 本身，而在中间那层没人写：MAX 的原生广告要自己搭 UIView、自己绑字段、自己算安全区，unity ios 两边的坐标系和生命周期还得手动对齐。这份资源给的就是 iOS 这一侧的完整落地代码——从 MAX SDK 初始化、MANativeAdLoader 加载、MANativeAdViewBinder 绑字段，到把广告视图贴回 Unity 根视图并做坐标换算。适合已经跑通插屏和激励、准备上信息流样式广告的团队，也适合想弄清聚合平台原生桥接层该怎么写的开发者。照着走一遍，能省掉反复试错的那几天。

2. 工程分层与选型：MAX 原生广告在 Unity 里为什么必须落一层原生桥

2.1 三层结构：谁负责时机，谁负责像素

Unity 接原生广告，跟接插屏、激励有本质区别。插屏和激励是 SDK 自己弹一个全屏 UIViewController，Unity 侧只需要一句 Show；原生广告反过来——SDK 把素材和字段交给你，视图长什么样、摆在哪、多大尺寸，全归你管。而 Unity 的 UI 是渲染在 Metal/GL 表面上的，一个 uGUI 的 Image 没法直接嵌一个 UIView 进去。所以只要做原生广告，就一定会在 Unity 渲染层之上叠一个真实的 UIKit 视图。

真正合理的是把代码切成三层，每层只干一件事：

• C# 业务层：决定什么时候要广告（列表第 3 条、详情页底部）、放在屏幕哪个矩形里、加载失败怎么兜底、曝光和点击怎么埋点。这一层完全不碰 UIView，也不该碰。
• 桥接层（Objective-C++）：把 MAX 的 delegate 回调翻译成UnitySendMessage，把 C# 传过来的屏幕矩形翻译成 UIKit 的 frame，管理 loader 与 adView 的创建、复用、销毁。这一层是整份资源里最核心的部分。
• 渲染层（UIKit）：MANativeAdView + MANativeAdViewBinder + Auto Layout 约束，负责“长得像不像原生内容”。

三层拆开之后，后面换样式只动第三层，换广告位只动第一层，中间那层基本不用改。我见过太多项目把三层揉在一个MaxNativeAd.cs里，结果一改布局就崩，一崩就找不到是坐标问题还是 delegate 问题。

提示：桥接层的单例一定要由 Objective-C 侧强持有（static变量或单例），MAX 的adLoadDelegate属性是 weak 的，delegate 被提前释放会出现“加载成功但没有任何回调”的黑匣子现象。

2.2 资源目录与文件清单

资源按上面三层拆好了目录，把Plugins/iOS和Scripts/Ads两坨分别拖进工程就能用，不用改路径。

MaxNativePostProcessor.cs这个文件容易被忽略，但它是省事的：SKAdNetworkItems 有几十条，每次出包手动往 Xcode 里粘，早晚会漏一条。用PostProcessBuild在构建后统一写进 Info.plist，一次配好长期有效。

2.3 版本矩阵与依赖对齐

原生广告对版本比插屏敏感得多。字段绑定依赖MANativeAdViewBinder的属性名，不同大版本之间改过属性，代码抄错版本会直接编译不过。

关键原则：不要手动去 Podfile 里单独升 AppLovinSDK。Unity 插件自带一份 iOS 依赖描述，构建时会自动生成 Podfile 片段。手动升上去，插件里的 C# 桥接代码可能还在调旧 API，报一堆does not respond to selector。真需要升，就整体升插件版本，让 C# 和 OC 两侧一起动。

3. 从空工程跑通第一条原生广告：后台配置到 Xcode 收尾

3.1 MAX 后台三件套：SDK Key、Ad Unit、测试模式

后台要做的事只有三件，但顺序不能错。先拿 SDK Key（Account 级别，一整个 App 一个），再建 Ad Unit——Ad Unit 的 Format 必须选 Native，选成 Banner 或 MREC 拿到的 ID 在原生 loader 里加载会一直失败，报错信息还很含糊，只告诉你“no fill”。最后把测试机的 IDFA 加到 Test Devices 里，或者直接在后台开 Test Mode，避免开发期把真实账号的 eCPM 数据打花。

SDK Key 不要硬编码在场景里，放 ScriptableObject 或者远端配置，切包的时候改一处就够。Ad Unit ID 同理，测试环境和正式环境要分开两组，混用是线上事故的高发点。

3.2 Unity 侧导入、Player Settings 与构建

导入插件后，先在MaxNativeAdConfig这个 ScriptableObject 里填上 SDK Key 和 Ad Unit ID，然后在启动脚本里做一次初始化。初始化只做一次，放在DontDestroyOnLoad的引导对象里，别在场景切换时重复调。

// Assets/Scripts/Ads/MaxSdkBootstrap.cs using UnityEngine; public class MaxSdkBootstrap : MonoBehaviour { [SerializeField] private MaxNativeAdConfig config; void Awake() { DontDestroyOnLoad(gameObject); MaxSdk.SetSdkKey(config.sdkKey); // 首次冷启动时 SDK 初始化有耗时，开日志方便定位 MaxSdk.SetVerboseLogging(config.enableVerboseLog); MaxSdk.InitializeSdk(); } void OnEnable() { MaxSdkCallbacks.OnSdkInitializedEvent += OnSdkInitialized; } void OnDisable() { MaxSdkCallbacks.OnSdkInitializedEvent -= OnSdkInitialized; } private void OnSdkInitialized(MaxSdkBase.SdkConfiguration cfg) { // 初始化完成后才能加载广告，提前调会拿到空回调 Debug.Log($"[MAX] initialized, consentFlowUserLocated={cfg.ConsentFlowUserGeography}"); } }

SetVerboseLogging只在开发期打开，正式包关掉，否则 Xcode 控制台会被刷爆。OnSdkInitialized这个事件是加载广告的前置条件——很多人把Load写在Start里，结果偶尔第一条加载失败，偶尔正常，本质就是抢跑。

Player Settings 里需要改的地方：Bundle Identifier 必须和后台登记的 App 一致；Target minimum iOS Version 按上一节的矩阵填；Scripting Backend 选 IL2CPP，Architecture 勾 ARM64。另外把Camera Usage Description这类无关的描述清掉，省得审核来回问。

3.3 Xcode 收尾：Info.plist、ATT、链接参数

Unity 导出的 Xcode 工程有三处必改，漏任何一个都会在真机上出问题。

第一处是 Info.plist 里的追踪授权描述和 SKAdNetwork 列表：

<key>NSUserTrackingUsageDescription</key> <string>用于向你展示更相关的广告内容</string> <key>SKAdNetworkItems</key> <array> <dict> <key>SKAdNetworkIdentifier</key> <!-- 占位，实际值从后台开启的各家网络文档里逐条复制 --> <string>network-id.skadnetwork</string> </dict> </array>

NSUserTrackingUsageDescription的文案不要写“提升广告体验”这种，审核容易打回，写清楚用途就行。SKAdNetwork 列表每一家聚合网络都有一条，MAX 后台的网络列表里能查到对应的 identifier，缺一条就少一份归因。

第二处是 ATT 弹窗的时机。iOS 15 之后，应用还在applicationDidFinishLaunching阶段调requestTrackingAuthorization是不弹的，得等 window 可见。桥接层里包一层延迟：

// MaxNativeBridge.mm 中的授权请求片段 #import <AppTrackingTransparency/AppTrackingTransparency.h> - (void)requestTrackingIfNeeded { if (@available(iOS 14, *)) { // 检查当前状态，避免重复弹窗 if (ATTrackingManager.trackingAuthorizationStatus != ATTrackingManagerAuthorizationStatusNotDetermined) return; dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.5 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{ [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) { // 授权结果只影响 IDFA 可用性，广告本身仍会加载 }]; }); } }

授权结果影响的是 IDFA，不影响广告能不能加载，这一点要跟产品说清楚，避免“没弹授权所以广告不显示”的误判。

第三处是链接参数。桥接层用了 Objective-C 的 Category 和extern "C"，一定要在Other Linker Flags里加-ObjC，否则 MAX SDK 内部的 category 方法会被裁掉，运行时表现为unrecognized selector。

3.4 首次加载验证：日志、断点与 Mediation Debugger

验证顺序建议是：先在编辑器里确认 C# 逻辑走到了_MAXNativeLoad，再出真机包看 Xcode 控制台。真机上最有用的两个手段，一是在didLoadNativeAd:forAd:上打断点，看nativeAdView是不是 nil；二是调一次MaxSdk.ShowMediationDebugger()，弹出的面板会列出所有网络的测试状态和填充情况，哪个网络没配好一眼就能看出来。

如果 Mediation Debugger 里只显示一两个网络，说明 adapter 没打进包——大概率是 Podfile 里没加对应 adapter，或者加了但-ObjC没配导致类没注册上。这一步过了，再谈样式。

4. 核心链路拆解：一次 Native 广告从 load 到 attach 的完整过程

4.1 Objective-C++ 桥接层的入口函数

桥接层对外只暴露五个 C 函数，C# 通过DllImport("__Internal")调。函数签名尽量简单，字符串用const char*，几何信息用 float 传，避免跨语言传结构体。

// Assets/Plugins/iOS/MaxNativeBridge.mm #import <UIKit/UIKit.h> #import <AppLovinSDK/AppLovinSDK.h> #import "UnityInterface.h" static NSString *const kBridgeObject = @"MaxNativeAdBridge"; // 必须与 C# 侧 GameObject 同名 extern "C" { void _MAXNativeInit(const char *adUnitId); void _MAXNativeLoad(void); void _MAXNativeAttach(float x, float y, float w, float h); void _MAXNativeDetach(void); void _MAXNativeDestroy(void); } static MaxNativeBridge *_bridge = nil; void _MAXNativeInit(const char *adUnitId) { if (_bridge) return; // 幂等，重复初始化直接忽略 _bridge = [MaxNativeBridge new]; _bridge.adUnitId = [NSString stringWithUTF8String:adUnitId]; [_bridge requestTrackingIfNeeded]; }

这几个函数的分工：Init只负责建单例和请求授权，Load触发一次加载，Attach把加载好的视图贴到指定矩形，Detach从父视图移除但保留对象以便复用，Destroy彻底释放。分开的意义在于，列表滚动时你只想 Detach/Attach，不想每次重新 Load——重新加载要重新走网络，延迟会直接体现在用户看到的空白上。

4.2 MANativeAdLoader 加载与 delegate 回调

加载器建议带配置初始化，明确告诉 SDK 要不要预加载图片、缓存几条。

- (void)loadAd { if (self.isLoading) return; // 防止列表快速滑动时重复触发 self.isLoading = YES; MANativeAdLoaderConfiguration *cfg = [[MANativeAdLoaderConfiguration alloc] initWithAdUnitIdentifier:self.adUnitId loadImageResources:YES numberOfAdsToPrecache:1]; self.loader = [[MANativeAdLoader alloc] initWithConfiguration:cfg]; self.loader.adLoadDelegate = self; // weak 属性，self 由 static 变量持有 [self.loader loadAd]; } - (void)didLoadNativeAd:(MANativeAdView *)nativeAdView forAd:(MAAd *)ad { self.isLoading = NO; self.adView = nativeAdView; // 字段已经由 binder 绑好，直接可用 [self send:@"OnNativeAdLoaded" body:@"1"]; } - (void)didFailToLoadNativeAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error { self.isLoading = NO; [self send:@"OnNativeAdLoaded" body:[NSString stringWithFormat:@"0|%@|%ld", error.message, (long)error.code]]; } - (void)didClickNativeAd:(MAAd *)ad { [self send:@"OnNativeAdClicked" body:ad.adUnitIdentifier]; }

loadImageResources:YES表示 SDK 自己把主图和图标下好再回调，省掉你手动异步加载图片的麻烦；如果你们的模板里主图是视频，把这个改成 NO 反而更稳。numberOfAdsToPrecache设 1 就够，设多了内存涨得快，而且原生广告素材体积比插屏大不少。

失败回调里把error.code一起回传很重要。MAX 的错误码区分“无填充”“网络未初始化”“Ad Unit 无效”，C# 侧可以根据错误码决定是重试还是换兜底内容，比只回一个 bool 强太多。

4.3 MANativeAdViewBinder 字段绑定与布局

视图这部分是原生广告真正的功夫所在。MAX 要求你把具体的 UI 控件实例交给它，它来填内容，而不是你自己去 setText。

- (MANativeAdView *)buildAdViewWithWidth:(CGFloat)w height:(CGFloat)h { UIView *root = [[UIView alloc] initWithFrame:CGRectMake(0, 0, w, h)]; root.backgroundColor = UIColor.clearColor; UIImageView *icon = [[UIImageView alloc] initWithFrame:CGRectMake(12, 12, 44, 44)]; icon.layer.cornerRadius = 8; icon.clipsToBounds = YES; UILabel *title = [[UILabel alloc] initWithFrame:CGRectMake(68, 12, w - 80, 20)]; title.font = [UIFont boldSystemFontOfSize:15]; UILabel *body = [[UILabel alloc] initWithFrame:CGRectMake(68, 36, w - 80, 34)]; body.font = [UIFont systemFontOfSize:12]; body.numberOfLines = 2; UIView *media = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 0, 0)]; // 小图文模板不放大图 UIButton *cta = [UIButton buttonWithType:UIButtonTypeSystem]; cta.frame = CGRectMake(w - 96, h - 44, 84, 32); MANativeAdViewBinder *binder = [[MANativeAdViewBinder alloc] initWithBuilderBlock:^(MANativeAdViewBinder *b) { b.iconImageView = icon; b.titleLabel = title; b.bodyLabel = body; b.callToActionButton = cta; b.mediaContentView = media; b.optionsContentView = nil; // 由 SDK 自动补 AdChoices 角标 }]; MANativeAdView *adView = [[MANativeAdView alloc] initWithAdViewBinder:binder]; adView.frame = root.frame; [adView addSubview:root]; return adView; }

几个必须遵守的点：titleLabel、bodyLabel、callToActionButton这几个属性只接受对应类型的控件，传错类型直接崩；mediaContentView传 UIView 而不是 UIImageView，因为 MAX 可能往里塞视频；optionsContentView留 nil 让 SDK 自己加 AdChoices 图标，自己覆盖或隐藏它是审核被拒的头号原因。

尺寸上有个硬性要求，原生视图给得太小（尤其是高度不足）会被判为无效展示，既不计曝光也不计收益。小图文模板高度至少给到 96pt 以上比较稳。

4.4 C# 侧调用与坐标换算

Unity 的屏幕坐标原点是左下、单位是像素；UIKit 的原点是左上、单位是 point。这中间的换算必须做，而且要在原生侧做，别在 C# 里除 scale——UIScreen.mainScreen.scale在 C# 里拿不到准确值。

// Assets/Scripts/Ads/MaxNativeAdSlot.cs public class MaxNativeAdSlot : MonoBehaviour { [SerializeField] private RectTransform slot; // 广告要占的那个矩形 public void Attach() { var corners = new Vector3[4]; slot.GetWorldCorners(corners); // 顺序：左下、左上、右上、右下 Vector2 bl = RectTransformUtility.WorldToScreenPoint(null, corners[0]); Vector2 tr = RectTransformUtility.WorldToScreenPoint(null, corners[2]); // 传左下角坐标 + 宽高，Y 轴的翻转交给原生侧 _MAXNativeAttach(bl.x, bl.y, tr.x - bl.x, tr.y - bl.y); } #if UNITY_IOS && !UNITY_EDITOR [DllImport("__Internal")] private static extern void _MAXNativeAttach(float x, float y, float w, float h); #endif }

原生侧接收并转换：

- (CGRect)convertFromUnityRect:(CGRect)r { CGFloat scale = [UIScreen mainScreen].scale; UIView *host = UnityGetGLViewController().view; CGFloat x = r.origin.x / scale; CGFloat w = r.size.width / scale; CGFloat h = r.size.height / scale; // Unity Y 从底部算，UIKit 从顶部算 CGFloat y = host.bounds.size.height - (r.origin.y / scale) - h; // 避开安全区，防止贴在刘海或 Home 指示条下面 if (@available(iOS 11, *)) { UIEdgeInsets insets = host.safeAreaInsets; y = MAX(y, insets.top); } return CGRectMake(x, y, w, h); }

这里容易翻车的地方是UnityGetGLViewController().view的bounds和 Unity 报告的Screen.height不一定完全相等（尤其带安全区、分屏、横屏旋转时）。稳妥做法是在viewDidLayoutSubviews之后重新 Attach 一次，或者监听屏幕旋转事件重算。

4.5 销毁、复用与缓存策略

广告视图是 NSObject 和 UIView 的混合体，不释放会一直挂在根视图上，切场景后变成看不见但吃内存的幽灵。

void _MAXNativeDestroy(void) { if (!_bridge) return; _bridge.loader.adLoadDelegate = nil; // 先断回调，避免销毁过程中还在回调 [_bridge.adView removeFromSuperview]; _bridge.adView = nil; _bridge.loader = nil; _bridge = nil; }

顺序很重要：先清 delegate，再移除视图，最后释放 loader。反过来做，可能在removeFromSuperview触发 layout 时回调进已释放对象，直接EXC_BAD_ACCESS。

缓存策略上我一般这样定：维护 1 条已加载未展示的广告，展示后立即触发下一条预加载；连续三次加载失败就退避 30 秒，避免弱网下疯狂请求把账号打上异常标记。

5. 避坑与排查：iOS 原生广告上线前最容易翻车的 5 个点

5.1 加载成功但屏幕一片空白

现象：Xcode 日志里didLoadNativeAd正常回调，C# 也收到了成功消息，但屏幕上什么都没有。

原因：九成是坐标算错了。要么 Y 轴没翻转，视图被放到了屏幕外的负坐标区；要么没除UIScreen.mainScreen.scale，一个 300pt 的框变成了 900pt，直接超出屏幕；还有一种情况是 Attach 的宿主视图选错了，加到了某个即将被 dismiss 的 VC 上。

解决：在convertFromUnityRect:里打印host.bounds、scale和最终 frame，和 Unity 里slot的屏幕矩形逐项对一遍。先固定传一个(20, 20, 300, 120)的硬编码 frame 验证视图能出来，再换成动态计算。

5.2 广告看得见，点了没反应

现象：素材显示正常，点击 CTA 按钮或任意区域都没有跳转，埋点里点击事件永远是 0。

原因：原生视图上面盖了一层透明的 Unity UI（常见于全屏的遮罩或 Loading 层），触摸事件被拦在下面。或者你给 adView 加了自己的UITapGestureRecognizer，把 MAX 的手势吞了。

解决：检查 adView 的superview层级，确保它是最上层的子视图；去掉所有自己加的手势识别器；如果确实需要在广告上盖东西，把遮罩层的userInteractionEnabled设成 NO。

5.3 审核被拒：广告遮挡内容或缺少隐私说明

现象：提审被打回，理由集中在广告遮挡、AdChoices 不可见，或者缺少追踪用途说明。

原因：optionsContentView自己传了一个空 UIView 或者设了hidden，AdChoices 角标没地方显示；或者 Info.plist 里NSUserTrackingUsageDescription缺失、文案含糊。

解决：optionsContentView留 nil，让 SDK 自己放；广告视图不要贴边到把内容盖住；隐私描述写清“用于展示更相关的广告内容”，别写营销话术。

5.4 切场景后偶发崩溃 EXC_BAD_ACCESS

现象：从广告列表页切到详情页，有概率崩，堆栈停在 MAX SDK 内部的回调里。

原因：delegate 是 weak 的，但广告视图还在，SDK 异步回来找 delegate 时对象已经没了；或者销毁时没先清adLoadDelegate。

解决：所有销毁入口统一走_MAXNativeDestroy，顺序固定为“断 delegate → 移出父视图 → 置 nil”；如果用了多个 Ad Unit，每个 loader 单独持有 delegate，别共用一个。

5.5 真机调试正常，TestFlight 版本不加载

现象：Xcode 直接跑没问题，TestFlight 或线上包里原生广告一直空着。

原因：Ad Unit ID 用了测试环境的；或者 Bundle Identifier 和后台登记的不一致；或者SKAdNetworkItems在正式包里没配全，虽然不是加载失败的直接原因，但配合后台的 App 状态校验会表现为无填充。

解决：出包前用MaxSdk.ShowMediationDebugger()在 TestFlight 包里再看一次，确认 SDK Key 和 Ad Unit 都是正式环境的值；把MaxNativePostProcessor的 plist 写入逻辑跑一遍，对比构建产物里的 Info.plist 是否真的写进去了。

6. 二次开发：把桥接层收敛成一个可复用的原生广告组件

资源里的桥接层可以直接用，但要接到业务里跑得久，得再往上包一层状态机。我一般的做法是给 C# 门面定义四个状态：Idle、Loading、Ready、Shown，所有外部调用都先过状态判断，非法迁移直接打日志丢弃。这样列表快速滑动、页面秒开秒关这种极端场景，也不会出现重复加载或重复 Attach。

// 状态迁移：只允许这四条路径，其余一律忽略 // Idle -> Loading : Load() // Loading -> Ready : OnNativeAdLoaded(成功) // Loading -> Idle : OnNativeAdLoaded(失败) // Ready -> Shown : Attach() 之后首次曝光回调 public bool TryLoad() { if (state != State.Idle) return false; state = State.Loading; _MAXNativeLoad(); return true; }

接口层面建议只暴露Load()、AttachTo(RectTransform)、Detach()、Dispose()四个方法，回调只留OnLoaded(bool ok, string err)、OnImpression()、OnClicked()、OnRevenue(double ecpm)四个。方法越少，业务侧越不容易用错。收益回调尤其别省，revenueDelegate拿到的是每条广告的真实 eCPM，接进自己的埋点系统之后，哪个版位的原生广告在赚钱一目了然。

布局模板上，把圆角、字号、内外边距、主图比例抽成MaxNativeTemplate.json，运行时读进桥接层，改样式就不用重新编译原生代码。这一招在做 A/B 测试时特别管用——同一个包，不同用户下发不同模板参数，两版素材的点击率差异一周就能跑出来。

上线前我会固定过一遍这张自测表：

这份资源的价值不在那几百行代码本身，而在于它把“哪一步该放哪一层”这件事定死了。从那以后我每次接新平台的原生广告，都会先把加载、展示、销毁三条链路的回调日志打全，再谈样式和动效——顺序反了，后面全是靠猜。希望帮到你。

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