新版 SDK 初始化 API

AppLovin iOS SDK 12.3.1 引入了一组新的 SDK 初始化 API， 原有的 SDK 初始化方法被弃用。 新 API 的 SDK 初始化方法简单明了、条理清晰， 还解决了旧 API 的问题。

注意

您必须在 ALSdkInitializationConfiguration 初始程序中设置 SDK Key。如果您的 Info.plist 包含 ALSdkKey 条目，请务必将其删除。

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

创建 SDK 初始化配置

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

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

注意

旧初始化 API 中的所有设置/配置也可以在新的 ALSdkInitializationConfiguration 对象中进行配置。

警告

如果您的 Info.plist 包含 AppLovinSdkKey 条目，请务必将其删除。

Objective-C

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

  builder.mediationProvider = ALMediationProviderMAX;

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

Swift

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

  builder.mediationProvider = ALMediationProviderMAX

  // Perform any additional configuration/setting changes
}

初始化 SDK

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

Objective-C

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

Swift

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
  }
  ⋮

示例

下方展示了调用新 API 的集成示例。 演示应用中展示了向新 API 的迁移，您也可以参考演示应用中的此提交。

Objective-C

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

Swift

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