集成 Mintegral SDK 的关键步骤是什么?2025年最新指南
一、集成前的准备工作
集成Mintegral SDK前,确保完成以下步骤,以保证顺利接入:
- 注册并验证账号:
- 访问Mintegral官网(https://www.mintegral.com/),注册Publisher账号,提供有效邮箱、应用链接(Google Play/App Store)和开发者信息。
- 提交应用进行审核,通常1-3个工作日。确保应用符合Mintegral政策(如无儿童内容、恶意软件)。
- 审核通过后,在仪表盘创建App和Ad Unit,获取App ID、App Key和Ad Unit ID,用于SDK初始化。
- 技术环境准备:
- Android:API Level 21+,Android Studio最新版,Gradle 7.0+。
- iOS:iOS 10.0+,Xcode 14+,CocoaPods。
- 隐私合规:准备CMP工具支持GDPR/CCPA,中国开发者遵守《个人信息保护法》。iOS需实现ATT(App Tracking Transparency)弹窗。
- 下载SDK:
- 从官方Wiki下载最新版本:Android v16.4.81+,iOS v7.4.1+(2025年6月更新,支持聚合货币化数据回传)。<grok:render card_id=”4d95b0″ card_type=”citation_card” type=”render_inline_citation”>
5
二、Android集成关键步骤
Mintegral SDK支持6种广告格式,集成重点包括依赖添加、权限配置和初始化。
- 添加SDK依赖:
- 在
app/build.gradle添加:dependencies { implementation 'com.mintegral.msdk:mtgads:16.4.81' // 最新版本 } - 在项目级
build.gradle添加仓库:repositories { maven { url 'https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea' } // 海外版 } - 同步项目。
- 在
- 配置权限:
- 在
AndroidManifest.xml添加必要权限:<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <!-- 中国区必需 --> <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
- 在
- 初始化SDK:
- 在主Activity的
onCreate中初始化:import com.mintegral.msdk.MIntegralSDK; import com.mintegral.msdk.out.MIntegralSDKFactory; public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); MIntegralSDK sdk = MIntegralSDKFactory.getMIntegralSDK(); Map<String, String> configMap = sdk.getForApps(); configMap.put(MIntegralConstans.PROPERTIES_APP_ID, "YOUR_APP_ID"); configMap.put(MIntegralConstans.PROPERTIES_APP_KEY, "YOUR_APP_KEY"); sdk.init(configMap, this); } }
- 在主Activity的
- 实现广告格式:
- 以激励视频为例,加载和展示:
import com.mintegral.msdk.out.MTGRewardVideoHandler; import com.mintegral.msdk.out.RewardVideoListener; private MTGRewardVideoHandler rewardVideoHandler; private void loadRewardVideo() { rewardVideoHandler = new MTGRewardVideoHandler(this, "YOUR_UNIT_ID"); rewardVideoHandler.setRewardVideoListener(new RewardVideoListener() { @Override public void onLoadSuccess(String unitId) { rewardVideoHandler.show(); } @Override public void onLoadFail(String unitId, String error) {} @Override public void onShowFail(String unitId, String error) {} @Override public void onAdShow(String unitId) {} @Override public void onAdClose(String unitId, boolean isCompleteView) {} @Override public void onVideoAdClicked(String unitId) {} @Override public void onEndcardShow(String unitId) {} }); rewardVideoHandler.load(); }
- 以激励视频为例,加载和展示:
三、iOS集成关键步骤
Mintegral SDK支持8种广告格式,集成支持CocoaPods。
- 安装SDK:
- 在
Podfile添加:pod 'MintegralAdSDK', '~> 7.4.1' // 最新版本 - 运行
pod install,打开.xcworkspace。
- 在
- 配置Info.plist:
- 添加隐私描述:
<key>NSUserTrackingUsageDescription</key> <string>允许此应用展示个性化广告,提升用户体验。</string>
- 添加隐私描述:
- 初始化SDK:
- 在
AppDelegate中初始化:import MintegralAdSDK @UIApplicationMain class AppDelegate: UIResponder, UIApplicationDelegate { func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { MTGSDK.sharedInstance().setAppID("YOUR_APP_ID", apiKey: "YOUR_APP_KEY") return true } }
- 在
- 实现广告格式:
- 以激励视频为例:
import MintegralAdSDK class ViewController: UIViewController, MTGRewardAdDelegate { var rewardAd: MTGRewardAdManager! override func viewDidLoad() { super.viewDidLoad() rewardAd = MTGRewardAdManager.sharedInstance() rewardAd.delegate = self rewardAd.load(withUnitID: "YOUR_UNIT_ID") } func onAdLoadSuccess(_ unitId: String) { rewardAd.show(with: self) } func onAdLoadFail(_ unitId: String, error: Error) {} func onAdShowSuccess(_ unitId: String) {} func onAdShowFail(_ unitId: String, error: Error) {} func onAdClick(_ unitId: String) {} func onAdClose(_ unitId: String, isReward: Bool) {} }
- 以激励视频为例:
四、测试与上线关键步骤
- 测试广告:
- 在仪表盘添加测试设备ID(GAID/IDFA),启用测试模式。
- 加载广告,验证“Test Ad”标识和日志(如onLoadSuccess)。
- 隐私合规:
- iOS:实现ATT框架,请求用户授权。
- 所有平台:集成CMP工具,确保GDPR/CCPA合规。
- 上线检查:
- 监控填充率和eCPM,优化广告频率(如激励视频每5分钟)。
- 更新SDK版本,避免无效流量。
五、常见问题与注意事项
- Q:集成失败怎么办?
- A:检查App ID/Key、权限和网络。查看官方Wiki日志排查。
- Q:中国开发者注意事项?
- A:使用海外版仓库,避免本地权限问题,遵守隐私法规。
- 注意事项:
- 版本更新:2025年v7.4.1 iOS支持聚合数据回传。<grok:render card_id=”985f06″ card_type=”citation_card” type=”render_inline_citation”>
5
- 合规:加强数据透明,避免SEC调查类似风险。
- 支付:参考支付指南,起付额$50。
六、结语:掌握关键步骤,高效集成Mintegral SDK
集成Mintegral SDK的关键在于账号准备、依赖配置、初始化和广告实现。通过以上步骤,你可以快速接入2025年最新版本,实现高eCPM变现。立即访问Mintegral官网(https://www.mintegral.com/)下载SDK,启动集成!如需帮助,参考官方Wiki(https://dev.mintegral.com/docs/en/sdk-integration)或联系support@mintegral.com。



