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

Zaimplementuj moduł obsługi płatnych zdarzeń

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

Poniżej znajdziesz kod, który pokazuje, jak obsługiwać płatne zdarzenia w przypadku reklamy z nagrodą:

RewardedAd rewardedAd;

private void RequestRewardedAd()
{
   rewardedAd = new RewardedAd("AD_UNIT_ID");
   
   rewardedAd.OnPaidEvent += this.HandleAdPaidEvent;
   
   AdRequest adRequest = new AdRequest();
   rewardedAd.LoadAd(adRequest);
}


public void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    AdValue adValue = args.AdValue;
    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&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary&ltstring, 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 programem 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. Dzięki temu nie pominiesz żadnego wywołania zwrotnego 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 Ad Manager próbuje podać wartość ESTIMATED w przypadku źródeł reklam, w których przypadku włączone jest automatyczne zbieranie danych. Więcej informacji znajdziesz w artykule Automatyczne zbieranie danych. W przypadku źródeł reklam, w których nie jest włączone automatyczne zbieranie danych, lub gdy nie ma wystarczającej ilości danych zbiorczych, aby przedstawić wiarygodne oszacowanie, zwracana jest wartość PUBLISHER_PROVIDED.

Testowanie wyświetleń z Otwartego ustalania stawek

Gdy zdarzenie przychodów z reklam na poziomie wyświetlenia wystąpi w źródle reklam z Otwartym ustalaniem stawek, po wysłaniu żą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.