이 페이지는 Cloud Translation API를 통해 번역되었습니다.

시작하기

Google 모바일 광고 SDK를 앱에 통합하는 것은 광고 게재 및 수익 창출 SDK를 통합한 후에는 광고 형식 (예: 네이티브 또는 보상형 동영상)을 선택하고 구현할 수 있습니다

시작하기 전에

앱을 준비하려면 다음 섹션의 단계를 완료합니다.

앱 기본 요건

앱의 빌드 파일이 다음 값을 사용하는지 확인합니다.
- 최소 SDK 버전 </ph> 21 이상
- 다음의 SDK 버전을 컴파일합니다. </ph> 33 이상

앱 구성

Gradle 설정 파일에 Google Maven 저장소 및 Maven 중앙 저장소:

Kotlin

pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

Groovy

pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

앱 수준 빌드에 Google 모바일 광고 SDK의 종속 항목 추가 파일:

Kotlin

dependencies {
  implementation("com.google.android.gms:play-services-ads:23.2.0")
}

Groovy

dependencies {
  implementation 'com.google.android.gms:play-services-ads:23.2.0'
}

앱 ID를 Ad Manager 입력하세요. <ph type="x-smartling-placeholder">Ad Manager</ph> 웹 인터페이스를 앱의 AndroidManifest.xml 파일 이렇게 하려면 다음과 같이 <meta-data> 태그를 추가합니다. android:name="com.google.android.gms.ads.APPLICATION_ID" 다음에서 확인할 수 있습니다. 앱 ID를 Ad Manager 웹 인터페이스에 입력합니다. 대상 android:value, 자체 앱 ID를 Ad Manager 삽입하세요. 따옴표로 묶습니다.
```
<manifest>
  <application>
    
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>
```
실제 앱에서는 샘플 앱 ID를 실제 앱 ID로 Ad Manager 앱 ID입니다. 다음과 같은 경우에 샘플 ID를 사용할 수 있습니다. Hello World 앱에서 SDK를 사용해 보고 있습니다

또한 <meta-data> 태그를 표시된 결과와 동일하게 추가하지 못하면 다음과 같은 메시지가 표시됩니다.
```
Missing application ID.
```
(선택사항) 이전 버전이 Android에서 작동하기 위한 AD_ID 권한 13.

앱에서 Google 모바일 광고 SDK 버전 20.4.0을 사용하는 경우 높은 경우 SDK가 자동으로 com.google.android.gms.permission.AD_ID 권한이 있으며 광고 ID에 액세스할 수 있습니다.

Google 모바일 광고 SDK 버전 20.3.0을 사용하는 앱의 경우 Android 13을 타겟팅하는 경우 com.google.android.gms.permission.AD_ID 권한 Google 모바일 광고 SDK의 AndroidManifest.xml 파일 광고 ID에 액세스합니다.
```
<manifest>
 <application>
   <meta-data
       android:name="com.google.android.gms.ads.APPLICATION_ID"
       android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

   
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>
```
자세히 알아보려면 com.google.android.gms.permission.AD_ID 권한 선언, 자세한 내용은 이 Play 콘솔 도움말을 참조하세요.

Google 모바일 광고 SDK 초기화

</ph> 광고를 로드하기 전에 다음을 호출하여 Google 모바일 광고 SDK를 초기화합니다. MobileAds.initialize().

이 메서드는 SDK를 초기화하고 Google 모바일 광고 SDK 및 어댑터 초기화가 완료되거나 제한 시간은 30초입니다. 이 작업은 앱 실행 시 한 번만 처리하면 됩니다.

Google 모바일 광고 SDK 또는 미디에이션 파트너 SDK에서 광고를 미리 로드할 수 있음 . 유럽 사용자의 동의를 얻어야 하는 경우 경제 지역 (EEA)의 경우 요청별 플래그를 설정합니다. 예를 들면 다음과 같습니다. setTagForChildDirectedTreatment() 또는 setTagForUnderAgeOfConsent(), 또는 초기화하기 전에 조치를 취하세요. Google 모바일 광고 SDK에 대해 살펴보았습니다

다음은 백그라운드에서 initialize() 메서드를 호출하는 방법을 보여주는 예입니다. 할 수 있습니다.

자바

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}