このページでは、AppLovin MAX SDKのダウンロード、インポート、および設定方法について説明します。
SDKはGradle経由で依存関係としてダウンロードできます。 手動でのインテグレーションをご希望の場合は、こちらの手順に従ってください。
SDKにはminSdkVersionとして24以上が必要です。
リリースの更新情報を受け取るには、AppLovin Android MAX SDK GitHubリポジトリを購読してください。
アプリレベルのbuild.gradleファイルに以下を追加します。
repositories {
google()
mavenCentral()
⋮
}
dependencies {
implementation 'com.applovin:applovin-sdk:+'
⋮
}
repositories {
google()
mavenCentral()
⋮
}
dependencies {
implementation("com.applovin:applovin-sdk:+")
⋮
}
ProGuardを使用する場合、AppLovin MAX SDKおよびアダプターには必要なProGuardルールがAARにバンドルされています。 プロジェクトにこれ以上のProGuardルールを追加する必要はありません。
SDKはGoogle Advertising IDを収集します。
これには、Android Advertising ID (AAID) モジュール (com.google.android.gms:play-services-ads-identifier) が必要です。
Google Play services dependenciesを参照してください。
buildscript {
repositories {
maven { url 'https://artifacts.applovin.com/android' }
}
dependencies {
classpath "com.applovin.quality:AppLovinQualityServiceGradlePlugin:+"
}
}
buildscript {
repositories {
maven { url = uri("https://artifacts.applovin.com/android") }
}
dependencies {
classpath ("com.applovin.quality:AppLovinQualityServiceGradlePlugin:+")
}
}
build.gradleファイルへの追加apply plugin: 'applovin-quality-service'
applovin {
apiKey "«ad-review-key»"
}
plugins {
id("applovin-quality-service")
}
applovin {
apiKey = "«ad-review-key»"
}
Ad Review Keyは、AppLovinダッシュボードのAccount > General > Keysセクションで確認できます。
SDKを初期化する前に、SDKの初期化設定オブジェクトを作成します。
このオブジェクトを使用すると、SDKが初期化時に使用するプロパティを設定できます。
これらの初期化プロパティは不変(immutable)ですが、アプリのライフタイム中に変更可能なプロパティを含むAppLovinSdkSettingsは例外です。
// Create the initialization configuration
AppLovinSdkInitializationConfiguration initConfig = AppLovinSdkInitializationConfiguration.builder( "«SDK-key»" )
.setMediationProvider( AppLovinMediationProvider.MAX )
// Perform any additional configuration/setting changes
.build();
// Create the initialization configuration
val initConfig = AppLovinSdkInitializationConfiguration.builder("«SDK-key»")
.setMediationProvider(AppLovinMediationProvider.MAX)
// Perform any additional configuration/setting changes
.build()
SDKキーは、AppLovinダッシュボードのAccount > General > Keysセクションで確認できます。
できるだけ早い段階(例えば、起動アクティビティのonCreate()やApplicationクラスなど)で、初期化設定オブジェクトを使用してAppLovin SDKを初期化してください。
これにより、SDKがメディエーションネットワークの広告をキャッシュする時間を最大化でき、ユーザーエクスペリエンスの向上につながります。
public class MainActivity extends Activity
{
protected void onCreate(Bundle savedInstanceState)
{
// Create the initialization configuration
AppLovinSdkInitializationConfiguration initConfig = AppLovinSdkInitializationConfiguration.builder( "«SDK-key»" )
.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
}
} );
}
}
class MainActivity : Activity()
{
override fun onCreate(savedInstanceState: Bundle?)
{
// Create the initialization configuration
val initConfig = AppLovinSdkInitializationConfiguration.builder("«SDK-key»")
.setMediationProvider(AppLovinMediationProvider.MAX)
.build()
// Initialize the SDK with the configuration
AppLovinSdk.getInstance(this).initialize(initConfig) { sdkConfig ->
// Start loading ads
}
}
}
以下はインテグレーションのサンプルです。
// Create the initialization configuration
AppLovinSdkInitializationConfiguration initConfig = AppLovinSdkInitializationConfiguration.builder( "«SDK-key»" )
.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
}
} );
// Create the initialization configuration
val initConfig = AppLovinSdkInitializationConfiguration.builder("«SDK-key»")
.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
}