Przychody z reklam na poziomie wyświetleń

Gdy nastąpi wyświetlenie, pakiet SDK do reklam mobilnych Google dostarczy dane o przychodach z reklam powiązane z tym wyświetleniem. Możesz używać tych danych do obliczania wartości użytkownika w całym okresie jego aktywności 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 płatnych zdarzeń

Każdy format reklamy ma OnPaidEvent zdarzenie. Podczas cyklu życia zdarzenia związanego z reklamą pakiet SDK do reklam mobilnych Google monitoruje zdarzenia wyświetlenia i wywołuje procedurę obsługi z wartością uzyskaną.

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 wygrywającym ź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 na platformy analityczne 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 połączeń zwrotnych.
  • W OnPaidEvent natychmiast wyślij informacje o przychodach z reklam na poziomie wyświetleń na wybrany serwer analityczny. Dzięki temu nie pominiesz żadnych wywołań zwrotnych i unikniesz rozbieżności danych.

AdValue

AdValue to klasa reprezentująca wartość pieniężną zarobioną na reklamie, w tym kod waluty i typ precyzji zakodowany w sposób podany poniżej.

AdValue.PrecisionType Opis
Unknown Nieznana wartość reklamy. Ten kod jest zwracany, gdy pingback LTV 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 w przypadku źródeł reklam, w których włączone jest automatyczne zbieranie danych. Więcej informacji znajdziesz w sekcji Automatyczne zbieranie danych. W przypadku źródeł reklam, w których nie jest włączone automatyczne zbieranie danych, lub w sytuacjach, gdy nie ma wystarczającej ilości zagregowanych danych, aby podać sensowne oszacowanie, zwracana jest wartość PUBLISHER_PROVIDED.

Testowanie wyświetleń 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 ramach żądania testowego, otrzymasz tylko te wartości:

  • Unknown: wskazuje typ precyzji.
  • 0: wskazuje wartość reklamy.

Wcześniej typ precyzji 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.