統合

このページでは、AppLovin MAX AIR Extensionのダウンロード、設定、および初期化の方法について説明します。

拡張機能のインポート

AppLovinMAX-«version».aneファイルをプロジェクトのライブラリフォルダ（通常はlib/）に追加します。

アプリケーション記述子XMLファイルのextensions要素に、com.applovin.airのextensionIDを追加します。（このファイルの名前は通常«app-name»-app.xmlです。）以下のコードは、このextensionIDを追加する方法を示しています。

<extensions>
  <extensionID>com.applovin.air</extensionID>
</extensions>

Android manifest

このセクションでは、Android Manifestの調整方法について説明します。アプリケーション記述子XMLファイルのmanifestAdditions要素内に、適切なパーミッション、アクティビティ、プロバイダー、およびサービスを追加します。これは、AppLovin MAX SDKを適切に初期化するために必要です。 AppLovin MAXを初期化した後、広告を表示できるようになります。

パーミッション

アプリケーション記述子XMLファイルのmanifestAdditions要素内に、特定のuses-permission要素を追加します。要素とその属性は、以下の例のようになります。

<manifestAdditions>
  <![CDATA[
    <manifest android:installLocation="auto">
      ⋮
      <uses-permission android:name="android.permission.INTERNET"/>
      <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
      ⋮
      <application>
      ⋮
      </application>
    </manifest>
  ]]>
</manifestAdditions>

アクティビティ、プロバイダー、およびサービス

アプリケーション記述子XMLファイルのAndroid Manifestにある<application>要素内に、以下のプロバイダー、アクティビティ、およびサービスを追加します。

<manifestAdditions>
  <![CDATA[
    <manifest android:installLocation="auto">
      ⋮
      <application>
        ⋮
        <provider
          android:name="com.applovin.sdk.AppLovinInitProvider"
          android:authorities="«your-application-package-name».applovininitprovider"
          android:exported="false"
          android:initOrder="101" />

        <activity
          android:name="com.applovin.adview.AppLovinInterstitialActivity"
          android:configChanges="orientation|screenSize|smallestScreenSize|screenLayout|uiMode"
          android:hardwareAccelerated="true"
          android:screenOrientation="behind" />
        <activity
          android:name="com.applovin.adview.AppLovinFullscreenActivity"
          android:configChanges="keyboard|keyboardHidden|locale|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
          android:exported="false"
          android:hardwareAccelerated="true"
          android:launchMode="singleTop"
          android:screenOrientation="behind" />
        <activity
          android:name="com.applovin.sdk.AppLovinWebViewActivity"
          android:configChanges="keyboardHidden|orientation|screenSize|uiMode" />
        <activity
          android:name="com.applovin.mediation.MaxDebuggerActivity"
          android:configChanges="keyboardHidden|orientation|screenSize" />
        <activity
          android:name="com.applovin.mediation.MaxDebuggerDetailActivity"
          android:configChanges="keyboardHidden|orientation|screenSize" />
        <activity
          android:name="com.applovin.mediation.MaxDebuggerMultiAdActivity"
          android:configChanges="keyboardHidden|orientation|screenSize" />
        <activity
          android:name="com.applovin.mediation.MaxDebuggerAdUnitsListActivity"
          android:configChanges="keyboardHidden|orientation|screenSize" />
        <activity
          android:name="com.applovin.mediation.MaxDebuggerAdUnitDetailActivity"
          android:configChanges="keyboardHidden|orientation|screenSize" />
        <activity
          android:name="com.applovin.mediation.MaxDebuggerTestLiveNetworkActivity"
          android:configChanges="keyboardHidden|orientation|screenSize" />

        <service
          android:name="com.applovin.impl.sdk.utils.AppKilledService"
          android:exported="false"
          android:stopWithTask="false" />
        <service
          android:name="com.applovin.impl.adview.activity.FullscreenAdService"
          android:exported="false"
          android:stopWithTask="false" />
                ⋮
      </application>
    </manifest>
  ]]>
</manifestAdditions>

SDKの初期化

SdkInitializedEventイベントハンドラーをアタッチします。その後、アプリが起動したらすぐにSDKを初期化します。以下のコードサンプルは、この一連の流れを示しています。

メディエーションネットワークが広告アセットをキャッシュすると、ユーザーエクスペリエンスが向上します。このため、起動時には常にAppLovin SDKを初期化してください。これにより、メディエーションネットワークが広告をキャッシュする時間を確保できます。これは、特に動画広告において重要です。

AppLovinMAXEvents.setSdkInitializedEvent(function (sdkConfiguration:SdkConfiguration):void
{
  // Start loading ads
});

AppLovinMAX.initialize("«your-SDK-key»");

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