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 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. Podczas 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 obsługuje 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 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 ustawia 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
}
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 reklam, które wygrało aukcję, znajdziesz w artykule Pobieranie informacji o odpowiedzi na żądanie reklamy.

Integracja z firmami uczestniczącymi w programie App Attribution Partner (AAP)

Szczegółowe informacje o przekazywaniu danych o przychodach z reklam do platform analitycznych znajdziesz w przewodniku partnera:

Pakiet SDK partnera
Adjust
AppsFlyer
Singular
Tenjin

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 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łączony jest 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ę.

Testowanie wyświetleń ze źródeł reklam z ustalaniem stawek

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