Opera Ads SDK 的 AppLovin MAX 聚合平台自定义适配器。
English | 简体中文
ALMAXOperaSDKAdapter 是一个自定义聚合适配器，使 Opera Advertising SDK (OpAdxSdk) 能够与 AppLovin MAX 聚合平台无缝集成。该适配器将 Opera Ads SDK 的回调桥接到 AppLovin MAX 的聚合回调，实现通过 AppLovin MAX 平台进行广告投放。
- ✅ Banner 广告（标准、中矩形、排行榜）
- ✅ 插屏广告（Interstitial）
- ✅ 激励广告（Rewarded）
- ✅ 原生广告（Native）
- iOS 13.0+
- AppLovin SDK 12.0.0+
- OpAdxSdk 2.8.2
- Xcode 13.0+
在您的 Podfile 中添加：
# AppLovin SDK
pod 'AppLovinSDK'
# Opera Ads SDK
pod 'OpAdxSdk', '2.8.2'
# Opera Ads AppLovin MAX 适配器
pod 'ALMAXOperaSDKAdapter', '2.8.2.0'然后运行：
pod install#import <AppLovinSDK/AppLovinSDK.h>
// 在 AppDelegate 中初始化
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 获取 AppLovin SDK 实例
ALSdk *sdk = [ALSdk sharedWithKey:@"your_applovin_sdk_key"];
// 初始化 SDK
[sdk initializeSdkWithCompletionHandler:^(ALSdkConfiguration *configuration) {
NSLog(@"AppLovin SDK initialized");
}];
return YES;
}在 AppLovin MAX 后台配置广告单元时：
- 选择"Manage" → "Networks"
- 点击"Click here to add a Custom Network"
- 配置自定义网络参数：
网络类型（Network Type）：SDK
自定义网络名称（Custom Network Name）：Opera Ads
iOS 适配器类名（iOS Adapter Class Name）：
- Banner:
OpAdxAppLovinAdViewAdapter - Interstitial:
OpAdxAppLovinInterstitialAdapter - Rewarded:
OpAdxAppLovinRewardedAdapter - Native:
OpAdxAppLovinNativeAdapter
App ID：您的 Opera App ID 例如: pub134xxxxxxxxxxx/ep13xxxxxxxxxxxx/app14xxxxxxxxxxxx
自定义参数（Custom Parameters） - JSON格式：
{"bundleId": "your_bundle_id"}使用 AppLovin MAX 标准 API 加载和展示广告：
#import <AppLovinSDK/AppLovinSDK.h>
@interface BannerViewController () <MAAdViewAdDelegate>
@property (nonatomic, strong) MAAdView *adView;
@end
@implementation BannerViewController
- (void)loadBanner {
self.adView = [[MAAdView alloc] initWithAdUnitIdentifier:@"your_ad_unit_id"];
self.adView.delegate = self;
// 设置 banner 尺寸
self.adView.frame = CGRectMake(0, 0,
UIScreen.mainScreen.bounds.size.width,
50);
// 加载广告
[self.adView loadAd];
// 添加到视图
[self.view addSubview:self.adView];
}
#pragma mark - MAAdViewAdDelegate
- (void)didLoadAd:(MAAd *)ad {
NSLog(@"Banner 加载成功");
}
- (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier
withError:(MAError *)error {
NSLog(@"Banner 加载失败: %@", error.message);
}
- (void)didDisplayAd:(MAAd *)ad {
NSLog(@"Banner 展示");
}
- (void)didClickAd:(MAAd *)ad {
NSLog(@"Banner 点击");
}
- (void)didExpandAd:(MAAd *)ad {
NSLog(@"Banner 展开");
}
- (void)didCollapseAd:(MAAd *)ad {
NSLog(@"Banner 收起");
}
@end#import <AppLovinSDK/AppLovinSDK.h>
@interface InterstitialViewController () <MAAdDelegate>
@property (nonatomic, strong) MAInterstitialAd *interstitialAd;
@end
@implementation InterstitialViewController
- (void)viewDidLoad {
[super viewDidLoad];
self.interstitialAd = [[MAInterstitialAd alloc]
initWithAdUnitIdentifier:@"your_ad_unit_id"];
self.interstitialAd.delegate = self;
}
- (void)loadInterstitial {
[self.interstitialAd loadAd];
}
- (void)showInterstitial {
if ([self.interstitialAd isReady]) {
[self.interstitialAd showAd];
}
}
#pragma mark - MAAdDelegate
- (void)didLoadAd:(MAAd *)ad {
NSLog(@"插屏广告加载成功");
}
- (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier
withError:(MAError *)error {
NSLog(@"插屏广告加载失败: %@", error.message);
}
- (void)didDisplayAd:(MAAd *)ad {
NSLog(@"插屏广告展示");
}
- (void)didClickAd:(MAAd *)ad {
NSLog(@"插屏广告点击");
}
- (void)didHideAd:(MAAd *)ad {
NSLog(@"插屏广告关闭");
// 加载下一个广告
[self.interstitialAd loadAd];
}
- (void)didFailToDisplayAd:(MAAd *)ad withError:(MAError *)error {
NSLog(@"插屏广告展示失败: %@", error.message);
// 加载下一个广告
[self.interstitialAd loadAd];
}
@end#import <AppLovinSDK/AppLovinSDK.h>
@interface RewardedViewController () <MARewardedAdDelegate>
@property (nonatomic, strong) MARewardedAd *rewardedAd;
@end
@implementation RewardedViewController
- (void)viewDidLoad {
[super viewDidLoad];
self.rewardedAd = [MARewardedAd sharedWithAdUnitIdentifier:@"your_ad_unit_id"];
self.rewardedAd.delegate = self;
}
- (void)loadRewardedAd {
[self.rewardedAd loadAd];
}
- (void)showRewardedAd {
if ([self.rewardedAd isReady]) {
[self.rewardedAd showAd];
}
}
#pragma mark - MARewardedAdDelegate
- (void)didLoadAd:(MAAd *)ad {
NSLog(@"激励广告加载成功");
}
- (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier
withError:(MAError *)error {
NSLog(@"激励广告加载失败: %@", error.message);
}
- (void)didDisplayAd:(MAAd *)ad {
NSLog(@"激励广告展示");
}
- (void)didClickAd:(MAAd *)ad {
NSLog(@"激励广告点击");
}
- (void)didHideAd:(MAAd *)ad {
NSLog(@"激励广告关闭");
// 加载下一个广告
[self.rewardedAd loadAd];
}
- (void)didFailToDisplayAd:(MAAd *)ad withError:(MAError *)error {
NSLog(@"激励广告展示失败: %@", error.message);
// 加载下一个广告
[self.rewardedAd loadAd];
}
- (void)didRewardUserForAd:(MAAd *)ad withReward:(MAReward *)reward {
NSLog(@"用户获得奖励: %ld %@", (long)reward.amount, reward.label);
}
@end#import <AppLovinSDK/AppLovinSDK.h>
@interface NativeViewController () <MANativeAdDelegate>
@property (nonatomic, strong) MANativeAdLoader *nativeAdLoader;
@property (nonatomic, strong) MAAd *nativeAd;
@end
@implementation NativeViewController
- (void)viewDidLoad {
[super viewDidLoad];
self.nativeAdLoader = [[MANativeAdLoader alloc]
initWithAdUnitIdentifier:@"your_ad_unit_id"];
self.nativeAdLoader.nativeAdDelegate = self;
}
- (void)loadNativeAd {
[self.nativeAdLoader loadAd];
}
#pragma mark - MANativeAdDelegate
- (void)didLoadNativeAd:(MANativeAdView *)nativeAdView forAd:(MAAd *)ad {
NSLog(@"原生广告加载成功");
// 如果已有广告，先清理
if (self.nativeAd) {
[self.nativeAdLoader destroyAd:self.nativeAd];
}
self.nativeAd = ad;
// 添加到视图
[self.view addSubview:nativeAdView];
// 设置约束或 frame
nativeAdView.frame = CGRectMake(0, 100,
UIScreen.mainScreen.bounds.size.width,
300);
}
- (void)didFailToLoadNativeAdForAdUnitIdentifier:(NSString *)adUnitIdentifier
withError:(MAError *)error {
NSLog(@"原生广告加载失败: %@", error.message);
}
- (void)didClickNativeAd:(MAAd *)ad {
NSLog(@"原生广告点击");
}
@end适配器使用 OpAdxNativeAdView 来呈现原生广告，包含以下组件：
- 标题（Title）
- 描述（Body）
- 图标（Icon）
- 媒体视图（Media View）
- 行动号召按钮（Call to Action）
- 广告选择图标（Ad Choices）
- ✅ 支持 AppLovin SDK 12.0+
- ✅ 修复原生广告 MediaView 类型保留问题
- ✅ 修复激励广告奖励回调使用实际奖励数据
- ✅ 添加 Banner 广告生命周期回调
- ✅ 优化错误处理和日志
- ✅ 支持所有主流广告格式
- 初始版本
- 支持 Banner、Interstitial、Rewarded、Native 广告格式
AppLovin SDK 必须在加载广告之前初始化完成。
适配器严格遵循 AppLovin MAX 文档推荐的回调顺序：
插屏广告和激励广告展示：
didDisplayAd:- 广告展示didClickAd:- 广告点击（如果发生）- 对于激励广告：
didRewardUserForAd:withReward:- 用户获得奖励
插屏广告和激励广告关闭：
didHideAd:- 广告关闭
原生广告使用 AppLovin 的 MANativeAdView 进行渲染，适配器会自动处理 Opera Ads 原生广告组件到 AppLovin 格式的转换。
所有错误都会通过 AppLovin MAX 的标准错误回调返回，包含详细的错误信息。
// AppLovin MAX 日志
[[ALSdk shared] getSettings].isVerboseLoggingEnabled = YES;
// Opera Ads SDK 日志（在 SDK 初始化前设置）
// 详见 OpAdxSdk 文档AppLovin MAX 提供测试模式：
// 在初始化后启用测试模式
[[ALSdk shared] showMediationDebugger];Q: 广告无法加载？ A: 检查以下项：
- AppLovin MAX 后台自定义网络配置是否正确,尤其是bundleId
- 适配器类名是否正确设置
- Opera Ads SDK 是否成功初始化
- 查看日志中的详细错误信息
Q: 适配器类名找不到？ A: 确保：
ALMAXOperaSDKAdapterPod 已正确安装- 使用完整类名，例如
OpAdxAppLovinAdViewAdapter - 清理并重新构建项目
Q: 原生广告显示不正确？
A: 确保正确配置了 MANativeAdView 的所有视图元素。
完整的示例项目请参考：
- 📧 Email: [email protected]
- 📖 文档: [Opera Ads iOS SDK 文档]
- 🐛 问题反馈: GitHub Issues
本项目采用 MIT 许可证。详见 LICENSE 文件。