Przychody z reklam na poziomie wyświetleń

Wybierz platformę: Android Nowy Android iOS Unity

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 implementacji 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 wdrożyć rejestrowanie danych o wartości 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, jak obsługiwać płatne zdarzenia 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);
};

Identyfikowanie 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 zwycięskim źródle reklam znajdziesz w artykule Pobieranie informacji o odpowiedzi na żądanie reklamy.

Sprawdzone metody wdrażania

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

GADAdValue

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

GADAdValuePrecision Opis
GADAdValuePrecisionUnknown Nieznana wartość reklamy. Jest zwracana, gdy włączony jest pingback wartości 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 precyzji.
  • 0 – wskazuje wartość reklamy.

Wcześniej typ precyzji 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 żądania reklamy testowej znajdziesz w artykule Włączanie urządzeń testowych.