Ta strona została przetłumaczona przez Cloud Translation API.

Przychody z reklam na poziomie wyświetleń

W momencie wyświetlenia reklamy pakiet SDK do reklam mobilnych Google dostarcza powiązane z nim dane o przychodach z reklam. Dzięki nim możesz obliczyć wartość użytkownika od początku śledzenia lub przekazać te dane do innych odpowiednich systemów.

Ten przewodnik pomoże Ci wdrożyć w projekcie Unity dane o przychodach z reklam na poziomie wyświetlenia.

Wymagania wstępne

Upewnij się, że w interfejsie AdMob masz włączoną funkcję przychodów z reklam na poziomie wyświetlenia.
Wtyczka Unity w wersji 5.0.0 lub nowszej.
Wykonaj te pierwsze kroki. Twoja aplikacja na Unity powinna już mieć zaimportowaną wtyczkę do reklam mobilnych Google w środowisku Unity.
Aby otrzymywać dane o przychodach z reklam na poziomie wyświetleń, musisz zaimplementować co najmniej 1 format reklamy:

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

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

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

Integracja z programem App Attribution Partners (AAP)

Szczegółowe informacje o przekazywaniu danych o przychodach z reklam na platformy analityczne znajdziesz w przewodniku partnera:

Pakiet SDK partnera
Dostosuj
AppsFlyer
Singular
Tenjin

Sprawdzone metody wdrażania

Ustaw zdarzenie OnPaidEvent od razu po utworzeniu obiektu reklamowego lub uzyskaniu do niego dostępu, a na pewno przed wyświetleniem reklamy. Dzięki temu nie przegapisz żadnych wywołań zwrotnych.
Wysyłaj bezpośrednio informacje o przychodach z reklam na poziomie wyświetlenia do preferowanego serwera analitycznego w module obsługi OnPaidEvent. Dzięki temu nie stracisz żadnych wywołań zwrotnych i unikniesz rozbieżności w danych.

AdValue

AdValue to klasa reprezentująca wartość pieniężną zarobioną na reklamie, z uwzględnieniem kodu waluty wartości i typu precyzji zakodowanego poniżej.

`AdValue.PrecisionType`	Opis
`Unknown`	Nieznana wartość reklamy. Ta wartość jest zwracana, gdy pingback wartości od początku śledzenia jest włączony, ale nie ma wystarczającej ilości danych.
`Estimated`	Wartość reklamy oszacowana na podstawie danych zbiorczych.
`PublisherProvided`	Wydawca podał wartość reklamy w grupie zapośredniczenia, np. samodzielnie ustalany CPM.
`Precise`	Dokładna wartość danej reklamy.

W przypadku zapośredniczenia AdMob próbuje podać ESTIMATEDwartość dla źródeł reklam, które są zoptymalizowane. W przypadku niezoptymalizowanych źródeł reklam oraz przypadków, gdy nie ma wystarczającej ilości danych zbiorczych, by podać wiarygodne oszacowanie, zwracana jest wartość PUBLISHER_PROVIDED.