시작하기

Google 모바일 광고 SDK를 앱에 통합하는 것은 광고 게재 및 수익 창출 SDK를 통합한 다음 광고 형식(예: 네이티브 또는 보상형 동영상 광고)을 선택하고 구현 단계를 진행하세요.

시작하기 전에

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

앱 기본 요건

  • 앱의 빌드 파일이 다음 값을 사용하는지 확인합니다.

    • 최소 SDK 버전 </ph> 21 이상
    • 33 이상 버전의 컴파일 SDK

앱 구성

  1. 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'
  2. 앱 수준 빌드에 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'
    }
  3. 앱 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>
        <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
        <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"/>
    
       <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
       <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) {}
    }
  }
}

광고 형식 선택

이제 Google 모바일 광고 SDK 가져오기가 완료되어 광고를 구현할 준비가 되었습니다. Ad Manager 다양한 광고 형식을 제공하므로 앱의 사용자 환경에 가장 적합한 것을 선택할 수 있습니다.

배너 광고 단위에는 앱 화면의 일부분을 차지하는 있습니다. 일정 시간이 지나면 자동으로 새로고침될 수 있습니다. 다시 말해 사용자가 동일한 콘텐츠를 유지하더라도 일정한 간격으로 새 광고를 봅니다. 화면에 나타납니다. 또한 구현하기 가장 간단한 광고 형식이기도 합니다.

배너 광고 구현

전면 광고

전면 광고 단위는 앱에서 전체 페이지 광고를 게재합니다. 자연스러운 장소에 배치하세요. 앱 인터페이스에서 중단 및 전환(예: 레벨 완료 후) 50% 증가했습니다.

전면 광고 구현

네이티브

네이티브 광고는 광고 제목, 텍스트, 이미지 등 앱에 표시되는 것을 확인할 수 있습니다 광고 스타일을 직접 지정하여 풍부한 사용자의 관심을 유도할 수 있는 자연스럽고 눈에 거슬리지 않는 광고 프레젠테이션을 만듭니다. 경험해 볼 수 있습니다

Google Ad Manager에서는 두 가지 방법으로 네이티브 광고를 구현할 수 있습니다. 표준 네이티브 광고를 게재할 수 있습니다.

네이티브 스타일은 네이티브 광고의 구현을 간소화하기 위해 이 형식을 처음 접하는 경우 좋은 선택이 될 것입니다 맞춤 렌더링은 를 사용하면 프레젠테이션을 최대한 자유롭게 만들 수 있습니다.

네이티브 스타일 구현 네이티브 광고 구현 (맞춤 렌더링)

리워드 제공됨

보상형 광고 단위를 사용하면 사용자가 코인, 생명 추가 생명, 포인트 등의 인앱 리워드 적립 다음과 같이 설정할 수 있습니다. 광고 단위별로 보상을 다르게 하고, 보상 가치 및 사용자가 받은 상품

보상형 광고 구현

보상형 전면 광고

보상형 전면 광고는 새로운 유형의 인센티브형 광고 형식으로 자동으로 게재되는 광고에 코인이나 추가 생명과 같은 리워드를 제공하세요. 앱 전환 중에 발생합니다.

보상형 광고와 달리 사용자는 수신 동의하지 않고도 보상형 동영상 광고를 전면 광고에 사용됩니다.

보상형 전면 광고를 사용하려면 보상형 광고에서 선택 메시지 대신 리워드를 공지하고 다음 경우에 사용자에게 선택 해제할 수 있는 인트로 화면 그렇게 하기를 원합니다.

보상형 전면 광고 구현

앱 오프닝 광고

앱 오프닝 광고는 사용자가 앱을 열거나 앱으로 다시 전환할 때 표시되는 광고 형식입니다. 있습니다. 광고가 로드 화면 위에 오버레이됩니다.

앱 오프닝 광고 구현

추가 리소스

GitHub의 Google 모바일 광고 저장소는 이 API에서 제공하는 다양한 광고 형식을 사용하는 방법을 알아봅니다.