インテグレーション

このページでは、AppLovin MAX SDKのダウンロード、インポート、および設定方法について説明します。

最新のSDKをダウンロードする

SDKはGradle経由で依存関係としてダウンロードできます。 手動でのインテグレーションをご希望の場合は、こちらの手順に従ってください。

SDKにはminSdkVersionとして24以上が必要です。

リリースの更新情報を受け取るには、AppLovin Android MAX SDK GitHubリポジトリを購読してください。

Gradle

アプリレベルのbuild.gradleファイルに以下を追加します。

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

ProGuardルール

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を参照してください。

Ad Reviewを有効にする

MAX Ad Reviewサービスを有効にするには、build.gradleファイルに以下を追加します。

ルートレベルのbuild.gradleファイルへの追加

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

アプリレベルのbuild.gradleファイルへの追加

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

Ad Review Keyは、AppLovinダッシュボードのAccount > General > Keysセクションで確認できます。

SDKを初期化する

SDK初期化設定の作成

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();

SDKキーは、AppLovinダッシュボードのAccount > General > Keysセクションで確認できます。

SDKを初期化する

できるだけ早い段階(例えば、起動アクティビティの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
      }
    } );
  }
}

実装例

以下はインテグレーションのサンプルです。

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

search