Mintegral SDK 集成指南：Android 与 iOS 接入、配置与常见问题解决

全面讲解 Mintegral SDK 在 Android 与 iOS 的集成步骤、广告位配置、支持的格式与版本要求，并附最佳实践与常见问题解决，帮助开发者快速完成接入与优化广告变现。

概述与支持的广告格式

Mintegral 提供开屏、横幅、插页、激励视频、激励插页与原生广告，并支持通过中介的瀑布流与出价（Header Bidding）两种集成方式。AdMob 中介对 Mintegral 的适配器提供上述广告格式支持，便于在同一变现框架下管理与优化变现策略 Google Developers。

• 支持的集成方式： 出价、瀑布流
• 广告格式： 开屏、横幅、插页、激励视频、激励插页、原生 Google Developers

集成前准备与要求

• 账号与配置： 注册并登录 Mintegral，创建应用与广告位，记录 App ID、App Key、应用密钥与广告位 ID。在 Mintegral 后台为每种广告格式创建展示位置（Placement），并记录对应 ID Google Developers。
• Android 要求： Android API 级别 23+；若启用出价，建议使用 Mintegral 适配器 16.5.91.1 或更高版本，以及最新版 Google Mobile Ads SDK Google Developers。
• 隐私与数据： 集成过程中涉及设备标识（例如 IDFA/GAID 等）与点击/转化回传，务必遵守相应隐私法规与平台政策 adv-new.mintegral.com。

Android 集成步骤（含出价与瀑布）

添加依赖与适配器版本

• 依赖建议： 使用 Mintegral 官方 SDK 组件与对应 AdMob 适配器的最新版本；启用出价时，适配器应为 16.5.91.1 或以上，以覆盖所有广告格式 Google Developers。

在 Mintegral 后台创建应用与广告位

• 步骤要点： 新建应用后，到“展示位置与广告单元”创建展示位置；为原生广告选择“原生（自定义呈现）”；记录应用 ID、应用密钥与展示位置 ID，后续在代码中使用 Google Developers。

初始化与加载示例

• SDK 初始化： 在 Application 或首屏尽早初始化，传入 App ID 与 App Key，并监听初始化结果。
• 广告调用： 使用对应的 Handler/View 加载与展示广告（激励视频、插页、横幅、原生等），并在回调中处理加载成功、失败与展示事件。
• 出价集成： 按 AdMob 中介配置将 Mintegral 设为出价来源，并确保启用并行竞价；必要时在中介中填写 Mintegral 的密钥与广告位映射 Google Developers。

重要提示：Android 出价需满足 API 级别与适配器版本要求；同时保持 Google Mobile Ads SDK 为最新版本，以确保兼容性与收益 Google Developers。

iOS 集成步骤（CocoaPods）

添加依赖与初始化

• 依赖管理： 通过 CocoaPods 引入 Mintegral iOS SDK 并保持为最新稳定版本。
• 初始化： 在 App 启动阶段设置 App ID 与 App Key，随后按广告类型使用对应的管理器或视图加载与展示（如激励视频、插页、横幅、原生）。

建议：与 Android 一样，在 iOS 侧的中介（例如 AdMob）中完成 Mintegral 的映射与参数配置，以启用瀑布或出价中介策略 Google Developers。

中介平台（AdMob）关键配置

• 网络配置： 在 AdMob 的“中介”页，将 Mintegral 添加到广告单元的中介链路，填写 Mintegral 的应用密钥与广告位 ID。
• 出价开关： 若启用出价，确保将 Mintegral 设置为“标头出价”类型，并使用支持出价的适配器版本；否则使用瀑布流规则并设置合适的 eCPM 或分层策略 Google Developers。
• 广告单元映射： 每个格式需在 AdMob 中与对应的 Mintegral 展示位置 ID正确映射，以保证加载链路无误 Google Developers。

隐私合规与数据处理注意事项

• 设备标识与回传： Mintegral 在广告跟踪链路可能处理 IMEI、IDFA、GAID、Android ID、IP、UA 等设备信息，用于与广告主的转化数据匹配；匹配成功后可能进行转化回传。开发者需确保遵循各市场隐私法与平台政策，提供必要的用户选择与披露 adv-new.mintegral.com。
• 平台政策： 同时遵守 Google Mobile Ads SDK 与 AdMob 中介政策要求，确保出价与瀑布配置、用户隐私设置、权限与合规文案完善 Google Developers adv-new.mintegral.com。

常见问题与最佳实践

• 初始化失败或广告不填充： 检查 App ID、App Key 与展示位置 ID 是否准确；确认网络权限与 SDK/适配器版本满足要求，尤其在出价场景需满足指定版本与 API 级别 Google Developers。
• 原生广告样式异常： 原生广告需选择“原生（自定义呈现）”，并在客户端正确渲染素材与交互元素；后端与前端的展示位置需一一对应 Google Developers。
• 收益优化： 在中介中开启出价、合理设置瀑布层级，结合不同地域的填充与 eCPM 数据动态调优；保持 SDK 与适配器为最新版本以获取兼容性与收益改进 Google Developers。
• 隐私与合规： 若面向含 GDPR/CCPA/中国境内合规要求的用户，确保提供合适的隐私弹窗、同意管理与数据最小化策略，并评估第三方数据处理链路 adv-new.mintegral.com。

结语与进一步参考

完成上述配置后，即可在 Android 与 iOS 上通过中介加载与展示 Mintegral 的多格式广告。建议上线前通过测试广告位与日志核验每种格式的加载与回调，并在中介后台观察填充与收益，持续迭代优化 Google Developers。隐私与数据处理需结合目标市场政策与平台规范进行合规审查与实现 adv-new.mintegral.com。 Google Developers adv-new.mintegral.com