Przychody z reklam na poziomie wyświetleń

Wybierz platformę: Android iOS Unity Android (starsza wersja)

Gdy nastąpi wyświetlenie, Google Mobile Ads Unity Plugin dostarcza dane o przychodach z reklam powiązane z tym wyświetleniem. Możesz używać tych danych do obliczania wartości użytkownika od początku śledzenia lub przekazywać je do innych odpowiednich systemów.

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

Wymagania wstępne

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

Każdy format reklamy ma zdarzenie OnPaidEvent. Podczas cyklu życia zdarzenia reklamy Google Mobile Ads Unity Plugin monitoruje zdarzenia wyświetlenia i wywołuje moduł obsługi z zarobioną wartością.

Poniższy kod pokazuje, jak obsługiwać zdarzenia płatne 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 zwycięskim źródle reklam znajdziesz w artykule Pobieranie informacji o odpowiedzi na reklamę.

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

  • Zdarzenie OnPaidEvent ustaw natychmiast po utworzeniu obiektu reklamy lub uzyskaniu do niego dostępu, a na pewno przed wyświetleniem reklamy. Dzięki temu nie przegapisz żadnych oddzwonień.
  • Natychmiast wyślij informacje o przychodach z reklam na poziomie wyświetleń do preferowanego serwera analitycznego w module obsługi OnPaidEvent. 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 i typ dokładności zakodowane w sposób opisany poniżej.

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

W przypadku zapośredniczenia Ad Manager próbuje podać wartość ESTIMATED dla źródeł reklam, które mają włączone automatyczne zbieranie danych. Więcej informacji znajdziesz w artykule Automatyczne zbieranie danych. W przypadku źródeł reklam, które nie mają włączonego automatycznego zbierania danych, lub gdy nie ma wystarczającej ilości danych zbiorczych, aby podać wiarygodne szacunki, zwracana jest wartość PUBLISHER_PROVIDED.

Wyświetlenia testowe z Otwartego ustalania stawek

Gdy w przypadku źródła reklam z Otwartym ustalaniem stawek wystąpi zdarzenie przychodów z reklam na poziomie wyświetleń, 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, 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.