게재위치를 기준으로 광고 데이터 분류

플랫폼 선택: Android (베타) New-selected Android iOS

광고 실적 보고 데이터를 분류하려면 광고 게재위치 기능을 사용하세요. 게재위치를 사용하면 추가 광고 단위 없이 보고서에서 노출 데이터를 분류할 수 있습니다. 게재위치 기능을 사용하려면 게재위치 ID가 필요합니다. 게재위치에 대한 자세한 내용은 게재위치에 대한 정보를 참고하세요.

이 가이드에서는 GMA Next-Gen SDK에서 게재위치 ID를 설정하고 광고 실적 보고서를 보는 방법을 설명합니다.

기본 요건

계속하기 전에 다음을 수행하세요.

  • GMA Next-Gen SDK 설정 완료
  • GMA Next-Gen SDK 버전 이상이어야 합니다.
  • 게재위치 ID 기능에 액세스하세요. 액세스 권한을 요청하려면 계정 관리자에게 문의하세요.
  • 앱의 게재위치 ID를 만드세요.

게재위치 ID 설정

광고의 실적 데이터를 분류하려면 다음 방법 중 하나로 게재위치 ID를 설정합니다.

  • 광고를 로드할 때
  • 광고를 표시하기 전에

필요에 따라 게재위치 ID를 업데이트할 수 있습니다. GMA Next-Gen SDK가 광고 노출을 기록할 때는 설정된 최신 게재위치 ID를 사용합니다.

광고 로드 시점에 게재위치 ID 설정

이 섹션에서는 광고 로드 시점에 게재위치 ID를 설정하는 방법을 설명합니다. 이 워크플로는 모든 광고 형식에 적용됩니다.

다음 예에서는 광고 로드 시점에 전면 광고의 게재위치 ID를 설정합니다.

Kotlin 

private fun loadInterstitial() {
  val adRequest = AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build()
  InterstitialAd.load(
    adRequest,
    object : AdLoadCallback<InterstitialAd> {
      override fun onAdLoaded(ad: InterstitialAd) {
        Log.d(TAG, "Placement ID: " + ad.placementId)
      }
    },
  )
}

AdPlacementsSnippets.kt

Java 

private void loadInterstitial() {
  AdRequest adRequest = new AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build();
  InterstitialAd.load(
      adRequest,
      new AdLoadCallback<>() {
        @Override
        public void onAdLoaded(InterstitialAd ad) {
          Log.d(TAG, "Placement ID: " + ad.getPlacementId());
        }
      });
}

AdPlacementsSnippets.java

다음 값을 바꿉니다.

  • AD_UNIT_ID를 광고 단위 ID로 바꿉니다.
  • PLACEMENT_ID를 게재위치 ID로 교체

광고 표시 시점에 게재위치 ID 설정

이 섹션에서는 모든 광고 형식의 표시 시점에 게재 위치 ID를 설정하는 방법을 설명합니다. 다음 섹션에서 원하는 광고 형식을 선택하세요.

배너 광고의 경우 뷰 계층 구조에 광고 뷰를 배치하기 전에 게재위치 ID를 설정합니다. 다음 예에서는 광고 표시 시점에 배너 광고의 게재위치 ID를 설정합니다.

Kotlin 

private fun showBannerView(ad: BannerAd, parentView: ViewGroup, activity: Activity) {
  ad.placementId = PLACEMENT_ID
  parentView.addView(ad.getView(activity))
}

AdPlacementsSnippets.kt

Java 

private void showBannerView(BannerAd ad, ViewGroup parentView, Activity activity) {
  ad.setPlacementId(PLACEMENT_ID);
  parentView.addView(ad.getView(activity));
}

AdPlacementsSnippets.java

전체 화면 광고

전체 화면 광고 형식의 경우 광고를 표시하기 전에 게재위치 ID를 설정합니다. 이 워크플로는 다음 형식에 적용됩니다.

다음 예에서는 광고 표시 시점에 전면 광고의 게재위치 ID를 설정합니다.

Kotlin 

private fun showAd(activity: Activity, ad: InterstitialAd) {
  ad.placementId = PLACEMENT_ID
  ad.show(activity)
}

AdPlacementsSnippets.kt

Java 

private void showAd(Activity activity, InterstitialAd ad) {
  ad.setPlacementId(PLACEMENT_ID);
  ad.show(activity);
}

AdPlacementsSnippets.java

네이티브 광고

네이티브 광고의 경우 네이티브 광고를 로드한 후 광고를 광고 뷰에 등록하기 전에 게재위치 ID를 설정합니다.

다음 예에서는 광고 표시 시점에 네이티브 광고의 게재위치 ID를 설정합니다.

Kotlin 

private fun showNativeAd(nativeAdView: NativeAdView, nativeAd: NativeAd, mediaView: MediaView) {
  nativeAd.placementId = PLACEMENT_ID
  nativeAdView.registerNativeAd(nativeAd, mediaView)
}

AdPlacementsSnippets.kt

Java 

private void showNativeAd(NativeAdView nativeAdView, NativeAd nativeAd, MediaView mediaView) {
  nativeAd.setPlacementId(PLACEMENT_ID);
  nativeAdView.registerNativeAd(nativeAd, mediaView);
}

AdPlacementsSnippets.java

게재위치 보고서 보기

게재위치 ID를 설정한 후 AdMob UI에 게재위치 ID 측정기준 보고서가 표시됩니다. 보고서를 보려면 게재위치 보기를 따르세요.