集成

在本页面中，您将了解到如何下载、导入和配置 AppLovin MAX SDK。

下载最新版本 SDK

您可以通过 CocoaPods 将 SDK 作为依赖项下载。如果您想手动集成，请按照此处的说明操作。如果您希望使用 Swift Package Manager 进行集成，请按照此处的说明操作。

SDK 要求 iOS 最低部署目标为 iOS 12.0 或更高版本。此外，Xcode 需要为 15 或更高版本。

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

Swift 兼容性

要确保您的构建与包含 Swift 的构建文件兼容，请将 Build Settings > Always Embed Swift Standard Libraries 设置为 YES。

如果您使用的是 Swift，且构建目标为 iOS 12.2.0 或更早版本，请将 /usr/lib/swift 添加至 Build Settings > Runpath Search Paths，避免 libswiftCore.dylib 发生问题。

CocoaPods

要通过 CocoaPods 集成 AppLovin SDK，请按照下列步骤操作：

将以下行添加至您的 Podfile：
```
pod 'AppLovinSDK'
```
在指令行中运行以下指令：
Terminal window
```
pod install --repo-update
```

启用 Ad Review

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

ruby AppLovinQualityServiceSetup-ios.rb

初始化 SDK

创建 SDK 初始化配置

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

This configuration object allows you to configure the properties that the SDK will initialize with. These initialization properties are immutable, except ALSdkSettings which contains mutable properties that can change during the lifetime of the app.

Objective-C
Swift

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

  builder.mediationProvider = ALMediationProviderMAX;

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

// Create the initialization configuration
let initConfig = ALSdkInitializationConfiguration(sdkKey: "«SDK-key»") { builder in

  builder.mediationProvider = ALMediationProviderMAX

  // Perform any additional configuration/setting changes
}

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

初始化 SDK

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

Objective-C
Swift

- (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
  }];
  ⋮

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool
{
  let initConfig = ALSdkInitializationConfiguration(sdkKey: "«SDK-key»") { builder in
    builder.mediationProvider = ALMediationProviderMAX
  }

  // Initialize the SDK with the configuration
  ALSdk.shared().initialize(with: initConfig) { sdkConfig in
    // Start loading ads
  }
  ⋮

示例

下方展示了集成示例：

Objective-C
Swift

// 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
}];

// Create the initialization configuration
let initConfig = ALSdkInitializationConfiguration(sdkKey: "«SDK-key»") { builder in
  builder.mediationProvider = ALMediationProviderMAX
  builder.segmentCollection = MASegmentCollection { segmentCollectionBuilder in
    segmentCollectionBuilder.add(MASegment(key: 849, values: [1, 3]))
  }
}

// Configure the SDK settings if needed before or after SDK initialization.
let 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.isEnabled = true
settings.termsAndPrivacyPolicyFlowSettings.termsOfServiceURL = URL(string: "«https://your-company-name.com/terms-of-service»")
settings.termsAndPrivacyPolicyFlowSettings.privacyPolicyURL = URL(string: "«https://your-company-name.com/privacy-policy»")

// Initialize the SDK with the configuration
ALSdk.shared().initialize(with: initConfig) { sdkConfig in
  // Start loading ads
}

iOS 14 支持

在 iOS 14 中，Apple 对全局隐私政策进行了调整。 Apple 要求应用遵守这些新政策。否则，您可能会损失收入。本节将介绍如何遵守新政策。

SKAdNetwork

使用特定于平台的标识符更新应用的 Info.plist。请参阅 SKAdNetwork documentation 中的说明。

许可和数据 API

在某些司法管辖区，您必须代表 AppLovin 的变现合作伙伴获得用户的许可，还必须向 AppLovin 正确发送许可值。要了解操作方法，请查看 Privacy–Consent, Age-Related Flags, and Data APIs 文档。

条款 | 隐私 | EULA | DMCA | Cookie 设置