集成

在本页面中，您将了解到如何下载、导入和配置 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 Key

将下列 <meta-data> 元素添加至您的 AndroidManifest.xml，并将它放置在 <application> 元素中：

<meta-data android:name="applovin.sdk.key" android:value="«sdk-key»"/>

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

集成自定义 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 初始化 API，了解如何在 12.4.0 以及更高版本中初始化 SDK。

调用 initializeSdk() 方法，初始化 SDK， 向该方法传递一个 context。 请在应用启动后尽快执行此操作，例如在启动 Activity 的 onCreate() 方法中。

完全缓存的广告素材能带来更好的用户体验。 因此，请务必在应用启动时初始化 AppLovin SDK。 这样，聚合平台就有最充裕的时间来缓存广告。 这一点对于视频广告尤为重要。

Java

public class MainActivity extends Activity
{
  protected void onCreate(Bundle savedInstanceState)
  {
    // Make sure to set the mediation provider value to "max" to ensure proper functionality
    AppLovinSdk.getInstance( context ).setMediationProvider( "max" );
    AppLovinSdk.initializeSdk( context, new AppLovinSdk.SdkInitializationListener() {
      @Override
      public void onSdkInitialized(final AppLovinSdkConfiguration configuration)
      {
        // AppLovin SDK is initialized, start loading ads
      }
    } );
  }
}

Kotlin

class MainActivity : Activity()
{
  override fun onCreate(savedInstanceState: Bundle?)
  {
    // Make sure to set the mediation provider value to "max" to ensure proper functionality
    AppLovinSdk.getInstance( context ).setMediationProvider( "max" )
    AppLovinSdk.getInstance( context ).initializeSdk({ configuration: AppLovinSdkConfiguration ->
      // AppLovin SDK is initialized, start loading ads
    })
  }
}