Dzielenie danych reklam na segmenty według miejsc docelowych

Aby podzielić dane w raportach skuteczności reklam na segmenty, użyj funkcji miejsc docelowych reklam. Miejsca docelowe umożliwiają segmentowanie danych o wyświetleniach w raporcie bez konieczności stosowania dodatkowych jednostek reklamowych. Aby korzystać z funkcji miejsc docelowych, musisz mieć identyfikator miejsca docelowego. Więcej informacji o miejscach docelowych znajdziesz w artykule Miejsca docelowe.

Z tego przewodnika dowiesz się, jak ustawić identyfikator miejsca docelowego w GMA Next-Gen SDK i wyświetlić raport skuteczności reklam.

Wymagania wstępne

Zanim przejdziesz dalej, wykonaj te czynności:

  • Skonfiguruj GMA Next-Gen SDK.
  • Zainstaluj pakiet w wersji GMA Next-Gen SDK lub nowszej.
  • Uzyskaj dostęp do funkcji identyfikatora miejsca docelowego. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.
  • Utwórz identyfikator miejsca docelowego dla swojej aplikacji.

Ustawianie identyfikatora miejsca docelowego

Aby podzielić dane o skuteczności reklamy na segmenty, ustaw identyfikator miejsca docelowego w jeden z tych sposobów:

  • Podczas wczytywania reklamy.
  • Przed wyświetleniem reklamy.

W razie potrzeby możesz zaktualizować identyfikator miejsca docelowego. Gdy GMA Next-Gen SDK rejestruje wyświetlenie reklamy, używa najnowszego ustawionego identyfikatora miejsca docelowego.

Ustawianie identyfikatora miejsca docelowego podczas wczytywania

W tej sekcji opisujemy, jak ustawić identyfikator miejsca docelowego podczas wczytywania. Ten proces dotyczy wszystkich formatów reklam.

Poniższy przykład pokazuje, jak ustawić identyfikator miejsca docelowego dla reklamy pełnoekranowej podczas wczytywania:

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)
      }
    },
  )
}

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

Zastąp te wartości:

  • AD_UNIT_ID identyfikatorem jednostki reklamowej.
  • PLACEMENT_ID identyfikatorem miejsca docelowego.

Ustawianie identyfikatora miejsca docelowego podczas wyświetlania

W tej sekcji opisujemy, jak ustawić identyfikator miejsca docelowego podczas wyświetlania w przypadku wszystkich formatów reklam. Wybierz preferowane formaty reklam w tych sekcjach:

W przypadku banerów reklamowych identyfikator miejsca docelowego ustawia się przed umieszczeniem widoku reklamy w hierarchii widoków. Poniższy przykład pokazuje, jak ustawić identyfikator miejsca docelowego dla baneru reklamowego podczas wyświetlania:

Kotlin

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

Java

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

Reklamy pełnoekranowe

W przypadku formatów reklam pełnoekranowych identyfikator miejsca docelowego ustawia się przed wyświetleniem reklamy. Ten proces dotyczy tych formatów:

Poniższy przykład pokazuje, jak ustawić identyfikator miejsca docelowego dla reklamy pełnoekranowej podczas wyświetlania:

Kotlin

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

Java

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

Reklamy natywne

W przypadku reklam natywnych, identyfikator miejsca docelowego ustawia się po wczytaniu reklamy natywnej i przed zarejestrowaniem reklamy w widoku reklamy.

Poniższy przykład pokazuje, jak ustawić identyfikator miejsca docelowego dla reklamy natywnej podczas wyświetlania:

Kotlin

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

Java

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

Wyświetlanie raportu o miejscach docelowych

Po ustawieniu identyfikatora miejsca docelowego zobaczysz raport z wymiarem Identyfikator miejsca docelowego w interfejsie AdMob. Aby wyświetlić raport, postępuj zgodnie z instrukcjami w artykule Wyświetlanie miejsc docelowych.