연동
이 페이지는 AppLovin MAX SDK를 다운로드, 업로드 및 구성하는 방법을 설명합니다.
최신 SDK 다운로드
Gradle을 통해 SDK를 종속성으로 다운로드할 수 있습니다. 수동으로 연동하는 것을 선호하신다면 여기의 지침을 따르십시오.
SDK는 minSdkVersion이 24 이상이어야 합니다.
릴리스 업데이트를 받으려면 AppLovin Android MAX SDK GitHub 리포지토리를 구독하십시오.
Gradle
앱 수준의 build.gradle 파일에 다음을 추가합니다:
repositories {
google()
mavenCentral()
⋮
}
dependencies {
implementation 'com.applovin:applovin-sdk:+'
⋮
}
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를 참조하십시오.
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를 초기화하기 전에 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 key는 AppLovin 대시보드의 Account > General > Keys 섹션에서 확인할 수 있습니다.
SDK 초기화
가능한 한 빨리(예: 시작 액티비티의 onCreate() 또는 Application 클래스에서) 초기화 구성 객체를 사용하여 AppLovin SDK를 초기화하십시오.
이렇게 하면 SDK가 mediation 네트워크의 광고를 캐싱할 수 있는 시간이 극대화되어 더 나은 사용자 경험을 제공할 수 있습니다.
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
}
