Przychody z reklam na poziomie wyświetleń

Gdy nastąpi wyświetlenie, pakiet SDK do reklam mobilnych Google wywołuje procedurę obsługi zdarzenia płatnego z powiązanymi z nim danymi o przychodach. Dzięki wdrożeniu tego modułu obsługi możesz używać 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ć w aplikacji na iOS rejestrowanie danych o wartości klienta w całym okresie jego aktywności.

Wymagania wstępne

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

Każdy format reklamy ma paidEventHandler właściwość typu GADPaidEventHandler. 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ą zarobioną.

W tym przykładzie obsługiwane są 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)."
  )
}
ImpressionLevelAdRevenueSnippets.swift

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);
};
ImpressionLevelAdRevenueSnippets.m

Identyfikowanie nazwy źródła reklamy zdarzenia niestandardowego

W przypadku źródeł reklam zdarzeń niestandardowych właściwość adSourceName zwraca 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, wykonaj te czynności:

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

W tym przykładzie ustawiamy niepowtarzalną nazwę źródła reklam dla zdarzenia niestandardowego:

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
}
ResponseInfoSnippets.swift

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;
}
ResponseInfoSnippets.m

Więcej informacji o źródle wygrywającej reklamy znajdziesz w artykule Pobieranie informacji o odpowiedzi reklamy.

Sprawdzone metody wdrażania

  • Ustaw moduł obsługi natychmiast po utworzeniu obiektu reklamy lub uzyskaniu do niego dostępu i zdecydowanie przed wyświetleniem reklamy. Dzięki temu nie przegapisz żadnych wywołań zwrotnych dotyczących płatnych wydarzeń.
  • Wysyłaj informacje o płatnym wydarzeniu na wybrany serwer analityczny natychmiast po wywołaniu metody paidEventHandler. Dzięki temu nie utracisz żadnych wywołań zwrotnych i unikniesz rozbieżności w danych.

GADAdValue

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

GADAdValuePrecision Opis
GADAdValuePrecisionUnknown Nieznana wartość reklamy. Ten kod jest zwracany, gdy pingback LTV jest włączony, ale nie ma wystarczającej ilości danych.
GADAdValuePrecisionEstimated Wartość reklamy została oszacowana na podstawie danych zbiorczych.
GADAdValuePrecisionPublisherProvided Wartość reklamy podana przez wydawcę, np. CPM ustawiony ręcznie w grupie zapośredniczenia.
GADAdValuePrecisionPrecise Dokładna kwota zapłacona za tę reklamę.

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:

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

Wcześniej typ precyzji mógł mieć wartość inną niż GADAdValuePrecisionUnknown, 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.