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

시작하기

광고를 게재하고 수익을 올리려면 먼저 Google 모바일 광고 SDK를 앱에 통합해야 합니다. SDK를 통합한 후 광고 형식 (예: 네이티브 또는 보상형 동영상)을 선택하고 구현 단계를 따르면 됩니다.

시작하기 전에

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

앱 기본 요건

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

앱 구성

프로젝트 수준의 build.gradle 파일에서 Google의 Maven 저장소와 Maven 중앙 저장소를 buildscript 및 allprojects 섹션에 포함합니다.

buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

모듈의 앱 수준 Gradle 파일(일반적으로 app/build.gradle)에 Google 모바일 광고 SDK의 종속 항목을 추가합니다.
```
dependencies {
  implementation 'com.google.android.gms:play-services-ads:23.0.0'
}
```
Ad Manager웹 인터페이스에서 식별된 Ad Manager 앱 ID를 앱의 AndroidManifest.xml 파일에 추가합니다. 이렇게 하려면 android:name="com.google.android.gms.ads.APPLICATION_ID"가 포함된 <meta-data> 태그를 추가합니다. 앱 ID는 Ad Manager 웹 인터페이스에서 확인할 수 있습니다. android:value의 경우 자체 Ad Manager 앱 ID를 따옴표로 묶어 삽입합니다.
```
<manifest>
  <application>
    
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>
```
실제 앱에서 샘플 앱 ID를 실제 Ad Manager 앱 ID로 바꿉니다. Hello World 앱에서 SDK를 간단히 실험해 보는 경우 샘플 ID를 사용할 수 있습니다.

또한 표시된 대로 <meta-data> 태그를 정확하게 추가하지 않으면 메시지가 표시되면서 비정상 종료됩니다.
```
Missing application ID.
```
(선택사항) 이전 버전이 Android 13에서 작동하도록 AD_ID 권한을 선언합니다.

앱에서 Google 모바일 광고 SDK 20.4.0 이상을 사용하는 경우 SDK가 com.google.android.gms.permission.AD_ID 권한을 자동으로 선언하고 가능할 때마다 광고 ID에 액세스할 수 있으므로 이 단계를 건너뛰어도 됩니다.

앱에서 Google 모바일 광고 SDK 20.3.0 이하를 사용하고 Android 13을 타겟팅하는 경우 AndroidManifest.xml 파일에 com.google.android.gms.permission.AD_ID 권한을 추가해야 Google 모바일 광고 SDK가 광고 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 Console 도움말을 참고하세요.

Google 모바일 광고 SDK 초기화

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

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

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

다음은 활동에서 initialize() 메서드를 호출하는 방법의 예입니다.

Java

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);

    MobileAds.initialize(this, new OnInitializationCompleteListener() {
        @Override
        public void onInitializationComplete(InitializationStatus initializationStatus) {
        }
    });
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds

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

    MobileAds.initialize(this) {}
  }
}

광고 형식 선택

이제 Google 모바일 광고 SDK를 가져와서 광고를 구현할 수 있습니다. Ad Manager 에서 다양한 광고 형식을 제공하므로 앱의 사용자 환경에 가장 적합한 형식을 선택할 수 있습니다.

배너 광고 단위에는 앱 레이아웃의 일부를 차지하는 직사각형 광고가 게재됩니다. 일정 시간이 지나면 자동으로 새로고침될 수 있습니다. 즉, 사용자는 앱에서 같은 화면에 머물러 있더라도 일정한 간격으로 새 광고를 볼 수 있습니다. 이 광고 형식은 구현하기에 가장 간단한 광고 형식이기도 합니다.

배너 광고 구현