연동

이 페이지에서는 AppLovin MAX AIR Extension을 다운로드, 설정 및 초기화하는 방법을 설명합니다.

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 파일에 적절한 권한, 액티비티, 프로바이더 및 서비스를 추가합니다. 이는 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>

액티비티, 프로바이더 및 서비스

<application> 엘리먼트 내부에 다음 프로바이더, 액티비티 및 서비스를 추가합니다. 이 엘리먼트는 애플리케이션 디스크립터 XML 파일의 Android Manifest에서 찾을 수 있습니다.

<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 섹션에서 확인할 수 있습니다.