跳转到内容
Axon by AppLovin | Support Center

手动下载 MAX 的广告平台

要接收版本更新,请订阅 AppLovin-MAX-SDK-iOS GitHub 库。

下载最新 iOS SDK

集成 AppLovin SDK

已下载的 ZIP 文件包含 AppLovinSDK.xcframework 文件。 要将 SDK 添加到您的应用程序，请将 AppLovinSDK.xcframework 文件拖拽至您的 Xcode 项目中，并确保 Xcode 项目目标设置里的 Frameworks, Libraries, and Embedded Content 部分中包含 AppLovinSDK.xcframework。

启用 Xcode 标记

您必须添加 -ObjC 标记才能编译 AppLovin SDK。 要启用 -ObjC 标记，请选择 File > Project Settings，前往 Build Settings，搜索 Other Linker Flags，然后点击 + 符号以添加 -ObjC。

添加框架

请在您的项目中关联下列框架：

  • AdSupport
  • AppTrackingTransparency
  • AudioToolbox
  • AVFoundation
  • CoreGraphics
  • CoreMedia
  • CoreMotion
  • CoreTelephony
  • Foundation
  • MessageUI
  • libz
  • SafariServices
  • StoreKit
  • SystemConfiguration
  • UIKit
  • WebKit

启用 Ad Review

要启用 MAX Ad Review 服务，再下载AppLovinQualityServiceSetup-ios.rb并将它移入您的项目文件夹中。 打开终端窗口，将 cd 进入到您的项目目录中，然后运行：

Terminal window
ruby AppLovinQualityServiceSetup-ios.rb

添加 SDK Key

选择 File > Project Settings > Info。 点击 Custom iOS Properties 中的一行，然后点击 + 符号以添加新的行。 将新一行的键设置为 AppLovinSdkKey，并将值设为您的 SDK Key。

您可以在 AppLovin 控制面板的 Account > General > Keys 部分找到 SDK Key。

初始化 SDK

创建 SDK 初始化配置

在初始化 SDK 之前，请在应用委托的 application:applicationDidFinishLaunching: 方法中为 SDK 创建初始化配置对象。

借助此配置对象，您可以配置 SDK 初始化时使用的属性。这些初始化属性均不可改变，但 ALSdkSettings 除外，它包含可在应用生命周期中改变的可变属性。

// Create the initialization configuration
ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey: @"«SDK-key»" builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {


  builder.mediationProvider = ALMediationProviderMAX;


  // Perform any additional configuration/setting changes
}];

您可以在 AppLovin 控制面板的 Account > General > Keys 部分找到 SDK Key。

初始化 SDK

请在应用启动时，使用初始化配置对象来初始化 AppLovin SDK。这样可为 SDK 提供更多广告缓存时间，从而改善用户体验。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  // Create the initialization configuration
  ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey: @"«SDK-key»" builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {
    builder.mediationProvider = ALMediationProviderMAX;
  }];


  // Initialize the SDK with the configuration
  [[ALSdk shared] initializeWithConfiguration: initConfig completionHandler:^(ALSdkConfiguration *sdkConfig) {
    // Start loading ads
  }];
  ⋮

示例

下方展示了集成示例：

// Create the initialization configuration
ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey: @"«SDK-key»" builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {
  builder.mediationProvider = ALMediationProviderMAX;
  builder.segmentCollection = [MASegmentCollection segmentCollectionWithBuilderBlock:^(MASegmentCollectionBuilder *builder) {
      [builder addSegment: [[MASegment alloc] initWithKey: @(849) values: @[@(1), @(3)]]];
  }];
}];


// Configure the SDK settings if needed before or after SDK initialization.
ALSdkSettings *settings = [ALSdk shared].settings;
settings.userIdentifier = @"«user-ID»";
[settings setExtraParameterForKey: @"uid2_token" value: @"«token-value»"];


// Note: you may also set these values in your Info.plist
settings.termsAndPrivacyPolicyFlowSettings.enabled = YES;
settings.termsAndPrivacyPolicyFlowSettings.termsOfServiceURL = [NSURL URLWithString: @"«https://your-company-name.com/terms-of-service»"];
settings.termsAndPrivacyPolicyFlowSettings.privacyPolicyURL = [NSURL URLWithString: @"«https://your-company-name.com/privacy-policy»"];


// Initialize the SDK with the configuration
[[ALSdk shared] initializeWithConfiguration: initConfig completionHandler:^(ALSdkConfiguration *sdkConfig) {
  // Start loading ads
}];

SKAdNetwork

请参阅 SKAdNetwork 文档，查看集成说明。

插屏广告

加载插屏广告

要加载插屏广告，请使用您的广告单元创建一个 MAInterstitialAd 对象，并调用 loadAd()。实现 MAAdDelegate，以便在广告准备就绪以及发生其他广告事件时收到通知。

#import "ExampleViewController.h"
#import <AppLovinSDK/AppLovinSDK.h>


@interface ExampleViewController()<MAAdDelegate>
@property (nonatomic, strong) MAInterstitialAd *interstitialAd;
@property (nonatomic, assign) NSInteger retryAttempt;
@end


@implementation ExampleViewController


- (void)createInterstitialAd
{
  self.interstitialAd = [[MAInterstitialAd alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»"];
  self.interstitialAd.delegate = self;


  // Load the first ad
  [self.interstitialAd loadAd];
}


#pragma mark - MAAdDelegate Protocol


- (void)didLoadAd:(MAAd *)ad
{
  // Interstitial ad is ready to be shown. '[self.interstitialAd isReady]' will now return 'YES'


  // Reset retry attempt
  self.retryAttempt = 0;
}


- (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error
{
  // Interstitial ad failed to load
  // AppLovin recommends that you retry with exponentially higher delays up to a maximum delay (in this case 64 seconds)


  self.retryAttempt++;
  NSInteger delaySec = pow(2, MIN(6, self.retryAttempt));


  dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delaySec * NSEC_PER_SEC), dispatch_get_main_queue(), ^{
    [self.interstitialAd loadAd];
  });
}


- (void)didDisplayAd:(MAAd *)ad {}


- (void)didClickAd:(MAAd *)ad {}


- (void)didHideAd:(MAAd *)ad
{
  // Interstitial ad is hidden. Pre-load the next ad
  [self.interstitialAd loadAd];
}


- (void)didFailToDisplayAd:(MAAd *)ad withError:(MAError *)error
{
  // Interstitial ad failed to display. AppLovin recommends that you load the next ad
  [self.interstitialAd loadAd];
}


@end

显示插屏广告

要展示插屏广告，请在刚才创建的 MAInterstitialAd 实例对象上调用 showAd()

if ( [self.interstitialAd isReady] )
{
  [self.interstitialAd showAd];
}

激励广告

加载激励广告

要加载激励广告，请使用您的激励广告单元调取一个 MARewardedAd 对象，并对其调用 loadAd()。 安装 MARewardedAdDelegate，以便在广告准备就绪以及发生其他广告事件时收到通知。

#import "ExampleViewController.h"
#import <AppLovinSDK/AppLovinSDK.h>


@interface ExampleViewController()<MARewardedAdDelegate>
@property (nonatomic, strong) MARewardedAd *rewardedAd;
@property (nonatomic, assign) NSInteger retryAttempt;
@end


@implementation ExampleViewController


- (void)createRewardedAd
{
  self.rewardedAd = [MARewardedAd sharedWithAdUnitIdentifier: @"«ad-unit-ID»"];
  self.rewardedAd.delegate = self;


  // Load the first ad
  [self.rewardedAd loadAd];
}


#pragma mark - MAAdDelegate Protocol


- (void)didLoadAd:(MAAd *)ad
{
  // Rewarded ad is ready to be shown. '[self.rewardedAd isReady]' will now return 'YES'


  // Reset retry attempt
  self.retryAttempt = 0;
}


- (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error
{
  // Rewarded ad failed to load
  // AppLovin recommends that you retry with exponentially higher delays up to a maximum delay (in this case 64 seconds)


  self.retryAttempt++;
  NSInteger delaySec = pow(2, MIN(6, self.retryAttempt));


  dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delaySec * NSEC_PER_SEC), dispatch_get_main_queue(), ^{
    [self.rewardedAd loadAd];
  });
}


- (void)didDisplayAd:(MAAd *)ad {}


- (void)didClickAd:(MAAd *)ad {}


- (void)didHideAd:(MAAd *)ad
{
  // Rewarded ad is hidden. Pre-load the next ad
  [self.rewardedAd loadAd];
}


- (void)didFailToDisplayAd:(MAAd *)ad withError:(MAError *)error
{
  // Rewarded ad failed to display. AppLovin recommends that you load the next ad
  [self.rewardedAd loadAd];
}


#pragma mark - MARewardedAdDelegate Protocol


- (void)didRewardUserForAd:(MAAd *)ad withReward:(MAReward *)reward
{
  // Rewarded ad was displayed and user should receive the reward
}


@end

显示激励广告

要展示激励广告，请在刚才创建的 MARewardedAd 实例对象上调用 showAd()

if ( [self.rewardedAd isReady] )
{
  [self.rewardedAd showAd];
}

横幅和MREC

加载和展示横幅和 MREC

要加载广告，请使用您的广告单元创建一个 MAAdView 对象，并调用 loadAd()。要展示广告，请将 MAAdView 对象添加为视图层级的子视图。安装 MAAdViewAdDelegate，以便在广告准备就绪以及发生其他广告事件时收到通知。

#import "ExampleViewController.h"
#import <AppLovinSDK/AppLovinSDK.h>


@interface ExampleViewController()<MAAdViewAdDelegate>
@property (nonatomic, strong) MAAdView *adView;
@end


@implementation ExampleViewController


- (void)createBannerAd
{
  self.adView = [[MAAdView alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»"];
  self.adView.delegate = self;


  // Banner height on iPhone and iPad is 50 and 90, respectively
  CGFloat height = (UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPad) ? 90 : 50;


  // Stretch to the width of the screen for banners to be fully functional
  CGFloat width = CGRectGetWidth(UIScreen.mainScreen.bounds);


  self.adView.frame = CGRectMake(x, y, width, height);


  // Set background or background color for banner ads to be fully functional
  self.adView.backgroundColor = BACKGROUND_COLOR;


  [self.view addSubview: self.adView];


  // Load the ad
  [self.adView loadAd];
}


#pragma mark - MAAdDelegate Protocol


- (void)didLoadAd:(MAAd *)ad {}


- (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error {}


- (void)didClickAd:(MAAd *)ad {}


- (void)didFailToDisplayAd:(MAAd *)ad withError:(MAError *)error {}


#pragma mark - MAAdViewAdDelegate Protocol


- (void)didExpandAd:(MAAd *)ad {}


- (void)didCollapseAd:(MAAd *)ad {}


#pragma mark - Deprecated Callbacks


- (void)didDisplayAd:(MAAd *)ad { /* use this for impression tracking */ }
- (void)didHideAd:(MAAd *)ad { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }


@end

要隐藏横幅或 MREC，请进行如下调用：

adView.hidden = YES;
[adView stopAutoRefresh];

要显示横幅或 MREC，请进行如下调用：

adView.hidden = NO;
[adView startAutoRefresh];

选择要集成的广告平台

选择要集成的广告平台， 然后按照以下说明操作。

手动下载 MAX 的广告平台
政策中心 使用条款 发行商政策 需求合作伙伴政策 平台管控 隐私 隐私选项 Cookie 设置
© 2025 AppLovin. All rights reserved.