Przychody z reklam na poziomie wyświetleń

Gdy użytkownik wyświetli reklamę, pakiet SDK do reklam mobilnych Google dostarcza powiązanych z nim danych o przychodach z reklam. Możesz na podstawie tych danych obliczyć wartość użytkownika od początku śledzenia lub przekazać dane do innych odpowiednich systemów.

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

Wymagania wstępne

Każdy format reklamy ma OnPaidEventListener. W trakcie cyklu życia zdarzenia reklamowego pakiet SDK do reklam mobilnych Google monitoruje zdarzenia wyświetlenia i wywołuje moduł obsługi z wypracowaną wartością.

Poniższy kod pokazuje, jak obsługiwać płatne zdarzenia w przypadku reklamy z nagrodą:

Java

import com.google.android.gms.ads.rewarded.RewardedAd;

public class MainActivity extends Activity {
  private RewardedAd rewardedAd;
  private final String TAG = "MainActivity";

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    AdRequest adRequest = new AdRequest.Builder().build();

    RewardedAd.load(this, "AD_UNIT_ID",
      adRequest, new RewardedAdLoadCallback(){
        @Override
        public void onAdLoaded(@NonNull RewardedAd ad) {
          rewardedAd = ad;
          // Set paid event listener
          rewardedAd.setOnPaidEventListener(new OnPaidEventListener() {
            @Override
            public void onPaidEvent(AdValue adValue) {
              // TODO: 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 = adValue.getValueMicros();
              String currencyCode = adValue.getCurrencyCode();
              int precision = adValue.getPrecisionType();

              // Get the ad unit ID.
              String adUnitId = rewardedAd.getAdUnitId();
              
              AdapterResponseInfo loadedAdapterResponseInfo = rewardedAd.getResponseInfo().
                  getLoadedAdapterResponseInfo();
              String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
              String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
              String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
              String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();

              Bundle extras = rewardedAd.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");
            }
          });
        }
    });
  }
}

Kotlin

import com.google.android.gms.ads.rewarded.RewardedAd

class MainActivity : AppCompatActivity() {
  private var rewardedAd: RewardedAd? = null
  private final var TAG = "MainActivity"

  override fun onCreate(savedInstanceState: Bundle?) {
    AdRequest adRequest = new AdRequest.Builder().build()

    RewardedAd.load(this, "AD_UNIT_ID",
      adRequest, object: RewardedAdLoadCallback() {
        override fun onAdLoaded(ad: RewardedAd) {
          rewardedAd = ad
          // Set paid event listener
          rewardedAd.onPaidEventListener = OnPaidEventListener { adValue ->
            // TODO: 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 precision = adValue.precisionType

            // Get the ad unit ID.
            val adUnitId = rewardedAd.adUnitId

            val loadedAdapterResponseInfo = rewardedAd.responseInfo.loadedAdapterResponse
            val adSourceName = loadedAdapterResponseInfo.adSourceName
            val adSourceId = loadedAdapterResponseInfo.adSourceId
            val adSourceInstanceName = loadedAdapterResponseInfo.adSourceInstanceName
            val adSourceInstanceId = loadedAdapterResponseInfo.adSourceInstanceId
            val extras = rewardedAd.responseInfo.responseExtras
            val mediationGroupName = extras.getString("mediation_group_name")
            val mediationABTestName = extras.getString("mediation_ab_test_name")
            val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
          }
        }
    })
  }
}

Więcej informacji o zwycięskim źródle reklam znajdziesz w artykule Pobieranie informacji o odpowiedzi na żądanie reklamy.

Integracja z programem App Attribution Partners (AAP)

Szczegółowe informacje o przekazywaniu danych o przychodach z reklam na platformy analityczne znajdziesz w przewodniku partnera:

Pakiet SDK partnera
Adjust
AppsFlyer
Singular
Tenjin

Sprawdzone metody wdrażania

  • Ustaw odbiornik od razu 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 płatnych zdarzeń.
  • Wysyłaj informacje o przychodach z reklam na poziomie wyświetleń do preferowanego serwera analitycznego natychmiast po wywołaniu metody onPaidEvent(). Dzięki temu nie stracisz ż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 tej wartości i jej typ precyzji zakodowane w następujący sposób.

PrecisionType Opis
UNKNOWN Nieznana wartość reklamy. Ta wartość jest zwracana, gdy pingback wartości od początku śledzenia jest włączony, ale nie ma wystarczającej ilości danych.
ESTIMATED Wartość reklamy oszacowana na podstawie danych zbiorczych.
PUBLISHER_PROVIDED Wydawca podał wartość reklamy, np. samodzielnie ustalany CPM w grupie zapośredniczenia.
PRECISE Dokładna wartość zapłacona za tę reklamę.

W przypadku zapośredniczenia AdMob próbuje podać wartość ESTIMATED dla źródeł reklam,któresą zoptymalizowane. W przypadku niezoptymalizowanych źródeł reklam oraz gdy nie ma wystarczająco dużo danych zbiorczych, aby podać sensowne oszacowanie, zwracana jest wartość PUBLISHER_PROVIDED.