이 페이지는 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.3.0")
}

Groovy

dependencies {
  implementation 'com.google.android.gms:play-services-ads:23.3.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) {}
    }
  }
}