Przychody z reklam na poziomie wyświetleń

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

Gdy nastąpi wyświetlenie, Google Mobile Ads SDK wywołuje moduł obsługi płatnych zdarzeń z powiązanymi danymi o przychodach. Dzięki zaimplementowaniu tego modułu obsługi 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 zaimplementować rejestrowanie danych o wartości użytkownika od początku śledzenia w aplikacji na iOS.

Wymagania wstępne

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

Każdy format reklamy ma właściwość paidEventHandler typu GADPaidEventHandler. W trakcie cyklu życia zdarzenia reklamowego Google Mobile Ads SDK monitoruje zdarzenia wyświetleń i wywołuje moduł obsługi z uzyskaną wartością.

Poniższy przykład pokazuje obsługę płatnych zdarzeń w przypadku reklamy z nagrodą:

Swift

rewardedAd?.paidEventHandler = { adValue in
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  let value = adValue.value
  let currencyCode = adValue.currencyCode
  let precision = adValue.precision

  print(
    "Ad paid event. Value: \(value) \(currencyCode), with precision: \(precision)."
  )
}

Objective-C

rewardedAd.paidEventHandler = ^(GADAdValue *_Nonnull adValue) {
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  NSDecimalNumber *value = adValue.value;
  NSString *currencyCode = adValue.currencyCode;
  GADAdValuePrecision precision = adValue.precision;

  NSLog(@"Ad paid event. Value: %@ %@, with precision: %ld.", value, currencyCode,
        (long)precision);
};

Określanie nazwy źródła reklam ze zdarzeniem niestandardowym

W przypadku źródeł reklam ze zdarzeniem niestandardowym adSourceName właściwość podaje nazwę źródła reklam Custom event. Jeśli używasz wielu zdarzeń niestandardowych, nazwa źródła reklam nie jest wystarczająco szczegółowa, aby odróżnić od siebie poszczególne zdarzenia niestandardowe. Aby znaleźć konkretne zdarzenie niestandardowe:

  1. Pobierz właściwość adNetworkClassName.
  2. Ustaw unikalną nazwę źródła reklam.

Poniższy przykład pokazuje, jak ustawić unikalną nazwę źródła reklam ze zdarzeniem niestandardowym:

Swift

func uniqueAdSourceName(for loadedAdNetworkResponseInfo: AdNetworkResponseInfo) -> String {
  var adSourceName: String = loadedAdNetworkResponseInfo.adSourceName ?? ""
  if adSourceName == "Custom Event" {
    if loadedAdNetworkResponseInfo.adNetworkClassName
      == "MediationExample.SampleCustomEventSwift"
    {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}

Objective-C

- (NSString *)uniqueAdSourceNameForAdNetworkResponseInfo:
    (GADAdNetworkResponseInfo *)loadedAdNetworkResponseInfo {
  NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
  if ([adSourceName isEqualToString:@"Custom Event"]) {
    if ([loadedAdNetworkResponseInfo.adNetworkClassName isEqualToString:@"SampleCustomEvent"]) {
      adSourceName = @"Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}

Więcej informacji o źródle reklam, które wygrało aukcję, znajdziesz w artykule Pobieranie informacji o odpowiedzi na żądanie reklamy.

Sprawdzone metody wdrażania

  • Ustaw moduł obsługi od razu 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 płatnych zdarzeń.
  • Wyślij informacje o płatnym zdarzeniu na preferowany serwer analityczny od razu po wywołaniu metody paidEventHandler. Dzięki temu unikniesz przypadkowego pominięcia wywołań zwrotnych i rozbieżności w danych.

GADAdValue

GADAdValue to klasa reprezentująca wartość pieniężną uzyskaną za reklamę, w tym kod waluty i typ precyzji zakodowany w następujący sposób.

GADAdValuePrecision Opis
GADAdValuePrecisionUnknown Nieznana wartość reklamy. Jest zwracana, gdy włączono pingback wartości użytkownika od początku śledzenia, ale nie ma wystarczającej ilości danych.
GADAdValuePrecisionEstimated Wartość reklamy została oszacowana na podstawie danych zbiorczych.
GADAdValuePrecisionPublisherProvided Wartość reklamy została podana przez wydawcę, np. na podstawie CPM ustawionego ręcznie w grupie zapośredniczenia.
GADAdValuePrecisionPrecise Dokładna kwota zapłacona za tę reklamę.

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:

  • GADAdValuePrecisionUnknown: wskazuje typ dokładności.
  • 0: wskazuje wartość reklamy.

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

Więcej informacji o wysyłaniu testowego żądania reklamy znajdziesz w artykule Włączanie urządzeń testowych.