Przychody z reklam na poziomie wyświetleń

Gdy nastąpi wyświetlenie, Google Mobile Ads SDK for React Native 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 (LTV) lub przekazywać je do platform analitycznych bądź zewnętrznych partnerów zajmujących się atrybucją.

Z tego przewodnika dowiesz się, jak wdrożyć w aplikacji React Native rejestrowanie danych o przychodach z reklam na poziomie wyświetleń.

Wymagania wstępne

Zanim przejdziesz dalej, wykonaj te czynności:

Każdy format reklamy obsługuje wywołanie zwrotne zdarzenia onAdPaid. W cyklu życia reklamy Google Mobile Ads SDK for React Native monitoruje zdarzenia wyświetlenia i wywołuje moduł obsługi z danymi AdValue.

W tym przykładzie rejestrujemy detektor zdarzeń płatnych w reklamie z nagrodą, rejestrujemy dane o uzyskanych przychodach z reklam i wyświetlamy reklamę:

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

Zalecamy wykonanie tych czynności:

  • W przypadku reklam pełnoekranowych ustaw obiekt nasłuchujący na obiekcie reklamy po jej wczytaniu i przed jej wyświetleniem. W przypadku banerów reklamowych i reklam natywnych przekaż wywołanie zwrotne onAdPaid jako właściwość do komponentu <BannerAdView /> lub <NativeAdView />. Dzięki temu nie przegapisz żadnych wywołań zwrotnych dotyczących płatnych zdarzeń.

  • Wyślij informacje o przychodach z reklam na poziomie wyświetleń do preferowanego serwera analitycznego, gdy Google Mobile Ads SDK for React Native wywoła wywołanie zwrotne onAdPaid. Dzięki temu nie przegapisz wywołań zwrotnych, a Twoje dane będą spójne.

Więcej informacji o integracji z AAP

Szczegółowe informacje o przekazywaniu danych o przychodach z reklam do platform analitycznych znajdziesz w tych przewodnikach dla partnerów uczestniczących w programie App Attribution Partner (AAP):

Obiekt AdValue

Obiekt AdValue reprezentuje wartość pieniężną uzyskaną z reklamy, w tym kod waluty i typ dokładności. W tabeli poniżej znajdziesz właściwości obiektu AdValue:

Właściwość Opis
amountMicros Przychody z reklam w mikrojednostkach, gdzie 1000000 mikrojednostek to 1 jednostka waluty, np. 1 USD lub 1 EUR.
currencyCode Kod waluty wartości reklamy według normy ISO 4217, np. USD lub EUR.
precision Poziom precyzji wartości reklamy. Poniżej znajdziesz listę poziomów dokładności:
  • 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.
  • PUBLISHER_PROVIDED: wartość reklamy podana przez wydawcę, np. wartości CPM ustawione ręcznie w grupie zapośredniczenia.
  • PRECISE: dokładna kwota zapłacona za reklamę.

W przypadku zapośredniczenia AdMob usługa AdMob próbuje podać wartość ESTIMATED dla źródeł reklam, które są zoptymalizowane. Szczegółowe informacje znajdziesz w artykule Optymalizacja kaskadowych źródeł reklam w zapośredniczeniu. Jeśli źródło reklam nie jest zoptymalizowane lub nie ma wystarczającej ilości danych zbiorczych do oszacowania, Google Mobile Ads SDK for React Native zwraca typ dokładności PUBLISHER_PROVIDED.

Wyświetlenia testowe ze źródeł reklam z ustalaniem stawek

Gdy w przypadku źródła reklam z 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.

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