集成

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

下载最新 SDK

您可以通过 Gradle 作为依赖下载 SDK。如果您想手动集成，请按照此处的说明操作。

SDK 需要不低于 16 的 minSdkVersion。

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

Gradle

将下列行添加至您的应用层级 build.gradle 文件：

Groovy

repositories {
  google()
  mavenCentral()
  ⋮
}
dependencies {
  implementation 'com.applovin:applovin-sdk:+'
  ⋮
}

Kotlin

repositories {
  google()
  mavenCentral()
  ⋮
}
dependencies {
  implementation("com.applovin:applovin-sdk:+")
  ⋮
}

ProGuard 规则

如果您使用 ProGuard，请注意 AAR 中的必要 ProGuard 规则已捆绑 AppLovin MAX SDK 和适配器，您无需向项目添加任何额外的 ProGuard 规则。

注意

SDK 会收集 Google 广告 ID。 为此，需要安卓广告 ID (AAID) 模块 (com.google.android.gms:play-services-ads-identifier)。 请参阅 Google Play 服务依赖了解更多信息。

集成自定义 SDK 适配器

AppLovin Exchange (ALX) 支持针对 LinkedIn 的自定义适配器，请在下方查看集成说明。要了解更多信息，请参阅此处。

要安装适配器，请将下列行添加至您的应用层级 build.gradle 文件：

Groovy

dependencies {
  implementation 'com.applovin.dsp:linkedin-adapter:+'
}

Kotlin

dependencies {
  implementation ("com.applovin.dsp:linkedin-adapter:+")
}

启用 Ad Review

更多信息

欢迎参阅 AppLovin 博客中的文章：How to Build Superior User Experience with MAX’s Ad Review (如何使用 Max Ad Review 打造卓越用户体验)。

要启用 MAX Ad Review 服务，请将下列行添加至您的 build.gradle 文件：

针对根层级 build.gradle 文件的补充行

Groovy

buildscript {
  repositories {
    maven { url 'https://artifacts.applovin.com/android' }
  }
  dependencies {
    classpath "com.applovin.quality:AppLovinQualityServiceGradlePlugin:+"
  }
}

Kotlin

buildscript {
  repositories {
    maven { url = uri("https://artifacts.applovin.com/android") }
  }
  dependencies {
    classpath ("com.applovin.quality:AppLovinQualityServiceGradlePlugin:+")
  }
}

针对应用层级 build.gradle 文件的补充行

Groovy

apply plugin: 'applovin-quality-service'
applovin {
  apiKey "«ad-review-key»"
}

Kotlin

plugins {
  id("applovin-quality-service")
}
applovin {
  apiKey = "«ad-review-key»"
}

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

初始化 SDK

创建 SDK 初始化配置

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

Java

// Create the initialization configuration
AppLovinSdkInitializationConfiguration initConfig = AppLovinSdkInitializationConfiguration.builder( "«SDK-key»", this )
                 .setMediationProvider( AppLovinMediationProvider.MAX )
// Perform any additional configuration/setting changes
                 .build();

Kotlin

// Create the initialization configuration
val initConfig = AppLovinSdkInitializationConfiguration.builder("«SDK-key»", this)
                 .setMediationProvider(AppLovinMediationProvider.MAX)
// Perform any additional configuration/setting changes
                 .build()

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

初始化 SDK

请尽早使用初始化配置对象来初始化 AppLovin SDK，例如在启动活动或应用程序类的 onCreate() 中。这样可为 SDK 提供更多广告缓存时间，从而改善用户体验。

Java

public class MainActivity extends Activity
{
  protected void onCreate(Bundle savedInstanceState)
  {
    // Create the initialization configuration
    AppLovinSdkInitializationConfiguration initConfig = AppLovinSdkInitializationConfiguration.builder( "«SDK-key»", this )
                     .setMediationProvider( AppLovinMediationProvider.MAX )
                     .build();

    // Initialize the SDK with the configuration
    AppLovinSdk.getInstance( this ).initialize( initConfig, new AppLovinSdk.SdkInitializationListener()
    {
      @Override
      public void onSdkInitialized(final AppLovinSdkConfiguration sdkConfig)
      {
        // Start loading ads
      }
    } );
  }
}

Kotlin

class MainActivity : Activity()
{
  override fun onCreate(savedInstanceState: Bundle?)
  {
    // Create the initialization configuration
    val initConfig = AppLovinSdkInitializationConfiguration.builder("«SDK-key»", this)
                     .setMediationProvider(AppLovinMediationProvider.MAX)
                     .build()

    // Initialize the SDK with the configuration
    AppLovinSdk.getInstance(this).initialize(initConfig) { sdkConfig ->
      // Start loading ads
    }
  }
}

示例

下方展示了集成示例：

Java

// Create the initialization configuration
AppLovinSdkInitializationConfiguration initConfig = AppLovinSdkInitializationConfiguration.builder( "«SDK-key»", this )
    .setMediationProvider( AppLovinMediationProvider.MAX )
    .setSegmentCollection( MaxSegmentCollection.builder()
                             .addSegment( new MaxSegment( 849, Arrays.asList( 1, 3 ) ) )
                             .build() )
    .build();

// Configure the SDK settings if needed before or after SDK initialization.
val settings = AppLovinSdk.getInstance( this ).getSettings();
settings.setUserIdentifier( "«user-ID»" );
settings.setExtraParameter( "uid2_token", "«token-value»" );
settings.getTermsAndPrivacyPolicyFlowSettings().setEnabled( true );
settings.getTermsAndPrivacyPolicyFlowSettings().setPrivacyPolicyUri( Uri.parse( "«https://your-company-name.com/privacy-policy»" ) );
settings.getTermsAndPrivacyPolicyFlowSettings().setTermsOfServiceUri( Uri.parse( "«https://your-company-name.com/terms-of-service»" ) );

// Initialize the SDK with the configuration
AppLovinSdk.getInstance( this ).initialize( initConfig, new AppLovinSdk.SdkInitializationListener()
{
  @Override
  public void onSdkInitialized(final AppLovinSdkConfiguration sdkConfig)
  {
    // Start loading ads
  }
} );

Kotlin

// Create the initialization configuration
val initConfig = AppLovinSdkInitializationConfiguration.builder("«SDK-key»", this)
    .setMediationProvider(AppLovinMediationProvider.MAX)
    .setSegmentCollection(MaxSegmentCollection.builder()
                            .addSegment(MaxSegment(849, listOf(1, 3)))
                            .build()
    )
    .build()

// Configure the SDK settings if needed before or after SDK initialization.
val settings = AppLovinSdk.getInstance(this).settings
settings.userIdentifier = "«user-ID»"
settings.setExtraParameter("uid2_token", "«token-value»")
settings.termsAndPrivacyPolicyFlowSettings.apply {
  isEnabled = true
  privacyPolicyUri = Uri.parse("«https://your-company-name.com/privacy-policy»")
  termsOfServiceUri = Uri.parse("«https://your-company-name.com/terms-of-service»")
}

// Initialize the SDK with the configuration
AppLovinSdk.getInstance(this).initialize(initConfig) { sdkConfig ->
  // Start loading ads
}