Przychody z reklam na poziomie wyświetleń

Gdy nastąpi wyświetlenie reklamy, pakiet SDK do reklam mobilnych Google prześle dane o przychodach z reklam powiązane z tym wyświetleniem. Możesz użyć tych danych do obliczenia wartości dożywotnej użytkownika lub przekazać je do innych odpowiednich systemów.

Ten przewodnik ma Ci pomóc w wdrożeniu rejestrowania danych o przychodach z reklam na poziomie wyświetleń w projekcie Unity.

Wymagania wstępne

Implementacja modułu obsługi płatnych zdarzeń

Każdy format reklamy ma zdarzenie OnAdPaid. W trakcie cyklu życia zdarzenia reklamy pakiet SDK do reklam mobilnych Google monitoruje zdarzenia wyświetleń i wywołuje element obsługi z wartością AdValue reprezentującą zarobioną wartość.

W tym przykładzie omawiamy zdarzenia płatne w reklamach z nagrodą:

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    long valueMicros = adValue.Value;
    string currencyCode = adValue.CurrencyCode;
    PrecisionType precision = adValue.Precision;

    ResponseInfo responseInfo = rewardedAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();

    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
    Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary<string, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

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

Integracja z usługami firm uczestniczących w programie App Attribution Partner (AAP)

Szczegółowe informacje o przesyłaniu danych o przychodach z reklam do platform analitycznych znajdziesz w instrukcji partnera:

Pakiet SDK partnera
Adjust
AppsFlyer
Singular
Tenjin

Sprawdzone metody wdrażania

  • Zdarzenie OnPaidEvent ustaw natychmiast po utworzeniu obiektu reklamy lub uzyskaniu do niego dostępu, ale na pewno przed wyświetleniem reklamy. Dzięki temu nie przegapisz żadnych wywołań zwrotnych.
  • Prześlij informacje o przychodach z reklam na poziomie wyświetleń do preferowanego serwera analityki za pomocą elementu OnPaidEvent w Twoim kodzie. Dzięki temu nie utracisz przypadkowo żadnych wywołań zwrotnych i unikniesz rozbieżności danych.

AdValue

AdValue to klasa, która reprezentuje wartość pieniężną uzyskaną z reklamy, w tym kod waluty wartości i jej dokładność, zakodowane jak poniżej.

AdValue.PrecisionType Opis
Unknown Nieznana wartość reklamy. Zwracana jest, gdy pingback LTV jest włączony, ale nie ma wystarczającej ilości danych.
Estimated Wartość reklamy oszacowana na podstawie danych zbiorczych.
PublisherProvided Wartość reklamy została podana przez wydawcę, np. na podstawie CPM ustawionego ręcznie w grupie zapośredniczenia.
Precise Dokładna wartość tej reklamy.

W przypadku zapośredniczenia AdMob próbuje podać wartość Estimated dla zoptymalizowanych źródeł reklam. W przypadku źródeł reklam, które nie są zoptymalizowane, lub gdy nie ma wystarczającej ilości danych zbiorczych, aby podać wiarygodne oszacowanie, zwracana jest wartość PublisherProvided.

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

Gdy zdarzenie przychodów z reklam na poziomie wyświetleń wystąpi w źródle reklam z ustawioną stawką w ramach żądania testowego, otrzymasz tylko te wartości:

  • Unknown: wskazuje typ dokładności.
  • 0: wskazuje wartość reklamy.

Wcześniej typ dokładności mógł mieć wartość inną niż Unknown oraz wartość reklamy większą niż 0.

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