Przychody z reklam na poziomie wyświetleń

Gdy nastąpi wyświetlenie, pakiet SDK GMA nowej generacji dostarcza dane o przychodach z reklam powiązane z tym wyświetleniem. Możesz używać tych danych do obliczania wartości użytkownika w całym okresie jego aktywności lub przekazywać je do innych odpowiednich systemów.

Ten przewodnik pomoże Ci wdrożyć w aplikacji na Androida rejestrowanie danych o przychodach z reklam na poziomie wyświetleń.

Wymagania wstępne

Każdy format reklamy ma onAdPaidwywołanie zwrotne zdarzenia. Podczas cyklu życia zdarzenia związanego z reklamą pakiet SDK do reklam mobilnych Google nowej generacji monitoruje zdarzenia wyświetlenia i wywołuje procedurę obsługi z wartością zarobioną.

W tym przykładzie obsługiwane są płatne zdarzenia w przypadku reklamy z nagrodą:

Kotlin

ad.adEventCallback =
  object : RewardedAdEventCallback {
    override fun onAdPaid(adValue: AdValue) {
      // Send the impression-level ad revenue information to your
      // preferred analytics server directly within this callback.

      // Extract the impression-level ad revenue data.
      val valueMicros = adValue.valueMicros
      val currencyCode = adValue.currencyCode
      val precisionType = adValue.precisionType

      val loadedAdSourceResponseInfo = ad.getResponseInfo().loadedAdSourceResponseInfo
      val adSourceName = loadedAdSourceResponseInfo?.name
      val adSourceId = loadedAdSourceResponseInfo?.id
      val adSourceInstanceName = loadedAdSourceResponseInfo?.instanceName
      val adSourceInstanceId = loadedAdSourceResponseInfo?.instanceId
      val extras = ad.getResponseInfo().responseExtras
      val mediationGroupName = extras.getString("mediation_group_name")
      val mediationABTestName = extras.getString("mediation_ab_test_name")
      val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
    }
  }

Java

ad.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdPaid(@NonNull AdValue value) {
        // Send the impression-level ad revenue information to your preferred
        // analytics server directly within this callback.

        // Extract the impression-level ad revenue data.
        long valueMicros = value.getValueMicros();
        String currencyCode = value.getCurrencyCode();
        PrecisionType precisionType = value.getPrecisionType();

        AdSourceResponseInfo loadedAdSourceResponseInfo =
            ad.getResponseInfo().getLoadedAdSourceResponseInfo();
        String adSourceName = loadedAdSourceResponseInfo.getName();
        String adSourceId = loadedAdSourceResponseInfo.getId();
        String adSourceInstanceName = loadedAdSourceResponseInfo.getInstanceName();
        String adSourceInstanceId = loadedAdSourceResponseInfo.getInstanceId();

        Bundle extras = ad.getResponseInfo().getResponseExtras();
        String mediationGroupName = extras.getString("mediation_group_name");
        String mediationABTestName = extras.getString("mediation_ab_test_name");
        String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
      }
    });

Identyfikowanie nazwy źródła reklamy zdarzenia niestandardowego

W przypadku źródeł reklam zdarzeń niestandardowych właściwość AdSourceResponseInfo.name zwraca nazwę źródła reklam Custom event. Jeśli używasz wielu zdarzeń niestandardowych, nazwa źródła reklamy nie jest wystarczająco szczegółowa, aby odróżnić od siebie poszczególne zdarzenia niestandardowe. Aby znaleźć konkretne zdarzenie niestandardowe:

  1. Pobierz właściwość AdSourceResponseInfo.name.
  2. Ustaw niepowtarzalną nazwę źródła reklam.

W tym przykładzie ustawiamy niepowtarzalną nazwę źródła reklam dla zdarzenia niestandardowego:

Kotlin

private fun getUniqueAdSourceName(loadedAdapterResponseInfo: AdSourceResponseInfo): String {
  var adSourceName = loadedAdapterResponseInfo.name
  if (adSourceName == "Custom Event") {
    if (
      loadedAdapterResponseInfo.adapterClassName ==
        "com.google.ads.mediation.sample.customevent.SampleCustomEvent"
    ) {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}

Java

private String getUniqueAdSourceName(@NonNull AdSourceResponseInfo loadedAdapterResponseInfo) {
  String adSourceName = loadedAdapterResponseInfo.getName();
  if (adSourceName.equals("Custom Event")) {
    if (loadedAdapterResponseInfo
        .getAdapterClassName()
        .equals("com.google.ads.mediation.sample.customevent.SampleCustomEvent")) {
      adSourceName = "Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}

Więcej informacji o źródle wygrywającej reklamy znajdziesz w artykule Pobieranie informacji o odpowiedzi reklamy.

Integracja z firmami uczestniczącymi w programie App Attribution Partner (AAP)

Szczegółowe informacje o przekazywaniu danych o przychodach z reklam do platform analitycznych znajdziesz w przewodniku partnera:

Pakiet SDK partnera
Adjust
AppsFlyer
Singular
Tenjin

Sprawdzone metody wdrażania

  • Ustaw odbiornik natychmiast po utworzeniu obiektu reklamy lub uzyskaniu do niego dostępu i zdecydowanie przed wyświetleniem reklamy. Dzięki temu nie przegapisz żadnych wywołań zwrotnych dotyczących płatnych wydarzeń.
  • Wysyłaj informacje o przychodach z reklam na poziomie wyświetleń na wybrany serwer analityczny natychmiast po wywołaniu wywołania zwrotnego zdarzenia płatnego. Dzięki temu nie utracisz żadnych wywołań zwrotnych i unikniesz rozbieżności w danych.

AdValue

AdValue to klasa reprezentująca wartość pieniężną uzyskaną za reklamę, w tym kod waluty i typ precyzji wartości zakodowane w ten sposób.

PrecisionType Opis
UNKNOWN Nieznana wartość reklamy. Ten kod jest zwracany, gdy pingback LTV jest włączony, ale nie ma wystarczającej ilości danych.
ESTIMATED Wartość reklamy została oszacowana na podstawie danych zbiorczych.
PUBLISHER_PROVIDED Wartość reklamy podana przez wydawcę, np. CPM ustawiony ręcznie w grupie zapośredniczenia.
PRECISE Dokładna kwota zapłacona za tę reklamę.

W przypadku zapośredniczenia AdMob usiłuje podać wartość ESTIMATED dla źródeł reklam, które są zoptymalizowane. W przypadku nieoptymalizowanych źródeł reklam lub gdy nie ma wystarczającej ilości zagregowanych danych, aby podać wiarygodne oszacowanie, zwracana jest wartość PUBLISHER_PROVIDED.

Testowanie wyświetleń ze źródeł reklam z ustalaniem stawek

Gdy w przypadku źródła reklam korzystającego z licytowania na poziomie wyświetleń nastąpi zdarzenie przychodów z reklam na poziomie wyświetleń w ramach żądania testowego, otrzymasz tylko te wartości:

  • UNKNOWN: wskazuje typ precyzji.
  • 0: wskazuje wartość reklamy.

Wcześniej typ precyzji mógł mieć wartość inną niż UNKNOWN, a wartość reklamy mogła być większa niż 0.

Szczegółowe informacje o wysyłaniu żądania reklamy testowej znajdziesz w artykule Włączanie urządzeń testowych.