Przychody z reklam na poziomie wyświetleń

Wybierz platformę: Android Android iOS Unity

Gdy nastąpi wyświetlenie, Google Mobile Ads Unity Plugin udostępnia dane o przychodach z reklam powiązane z tym wyświetleniem. Możesz użyć tych danych do obliczenia wartości użytkownika w całym okresie jego aktywności lub przekazać je do innych odpowiednich systemów.

Z tego przewodnika dowiesz się, jak zaimplementować w projekcie Unity rejestrowanie danych o przychodach z reklam na poziomie wyświetleń.

Wymagania wstępne

• Upewnij się, że w interfejsie Ad Managera masz włączoną funkcję przychodów z reklam na poziomie wyświetleń.
• Wtyczka Unity w wersji 5.0.0 lub nowszej.
• Wykonaj wszystkie czynności opisane w przewodniku Pierwsze kroki. W Twojej aplikacji Unity powinna być już zaimportowana Google Mobile Ads Unity Plugin.

• Aby otrzymywać dane o przychodach z reklam na poziomie wyświetleń, musisz zaimplementować co najmniej 1 format reklamy:

  • Baner
  • Interstitial
  • Reklama z nagrodą
  • Reklama pełnoekranowa z nagrodą
  • Reklama natywna

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

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

Poniższy kod 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 źródle reklamy, które wygrało aukcję, znajdziesz w artykule Pobieranie informacji o odpowiedzi na żądanie 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 zdarzenie OnPaidEvent natychmiast po utworzeniu obiektu reklamy lub uzyskaniu do niego dostępu, a na pewno przed wyświetleniem reklamy. Dzięki temu nie przegapisz żadnych wywołań zwrotnych.
• W module obsługi OnPaidEvent natychmiast wyślij informacje o przychodach z reklam na poziomie wyświetleń do preferowanego serwera analitycznego. Dzięki temu unikniesz przypadkowego pominięcia wywołań zwrotnych i rozbieżności danych.

AdValue

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

Ważne: wartość AdValue to wartość mikro, która reprezentuje wartość każdej reklamy. Na przykład wartość 5000 oznacza, że szacunkowa wartość tej reklamy wynosi 0,005 USD.

AdValue.PrecisionType	Opis
Unknown	Nieznana wartość reklamy. Jest zwracana, gdy włączone jest pingowanie LTV, ale nie ma wystarczającej ilości danych.
Estimated	Wartość reklamy została 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 dla źródeł reklam, w których włączone jest automatyczne zbieranie danych. Więcej informacji znajdziesz w artykule Automatyczne zbieranie danych. W przypadku źródeł reklam, w których automatyczne zbieranie danych jest wyłączone, lub gdy nie ma wystarczającej ilości danych zbiorczych, aby podać wiarygodne oszacowanie, zwracana jest wartość PUBLISHER_PROVIDED.

Wyświetlenia testowe z Otwartego ustalania stawek

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

• Unknown – oznacza typ precyzji.

• 0 – oznacza wartość reklamy.

Wcześniej typ precyzji mógł być wyświetlany jako wartość inna niż Unknown, a wartość reklamy mogła być większa niż 0.

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