Przychody z reklam na poziomie wyświetleń

Po wyświetleniu reklamy pakiet SDK do reklam mobilnych Google wywołuje moduł obsługi płatnych zdarzeń z powiązanymi danymi o przychodach. Dzięki wdrożeniu tego modułu możesz obliczyć wartość użytkownika od początku śledzenia na podstawie zawartych w nim danych lub przekazać je do innych odpowiednich systemów.

Ten przewodnik pomoże Ci wdrożyć w aplikacjach na iOS rejestrowanie danych o wartości od początku śledzenia.

Wymagania wstępne

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

Każdy format reklamy ma właściwość paidEventHandler typu GADPaidEventHandler. W trakcie cyklu życia zdarzenia reklamowego pakiet SDK do reklam mobilnych Google monitoruje zdarzenia wyświetlenia i wywołuje moduł obsługi z wygenerowaną wartością.

Swift

class ViewController: UIViewController, GADFullScreenContentDelegate {
  var rewardedAd: GADRewardedAd?
  func requestRewardedAd() {
    GADRewardedAd.load(
      withAdUnitID: "AD_UNIT_ID", request: GADRequest()
    ) { (ad, error) in
      if let error = error {
        print("Rewarded ad failed to load with error: \(error.localizedDescription)")
        return
      }
      if let ad = ad {
        self.rewardedAd = ad
        self.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 precision = adValue.precision
          let currencyCode = adValue.currencyCode

          // Get the ad unit ID.
          let adUnitId = ad.adUnitID

          let responseInfo = ad.responseInfo
          let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo
          let adSourceId = loadedAdNetworkResponseInfo?.adSourceID
          let adSourceInstanceId = loadedAdNetworkResponseInfo?.adSourceInstanceID
          let adSourceInstanceName = loadedAdNetworkResponseInfo?.adSourceInstanceName
          let adSourceName = loadedAdNetworkResponseInfo?.adSourceName
          let mediationGroupName = responseInfo?.extrasDictionary["mediation_group_name"]
          let mediationABTestName = responseInfo?.extrasDictionary["mediation_ab_test_name"]
          let mediationABTestVariant = responseInfo?.extrasDictionary["mediation_ab_test_variant"]
        }
      }
    }
  }
}

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()
@property(nonatomic, strong) GADRewardedAd *rewardedAd;
@end

@implementation ViewController
- (void)requestRewardedAd {
  __weak ViewController *weakSelf = self;

  GADRequest *request = [GADRequest request];
  [GADRewardedAd
   loadWithAdUnitID:@"AD_UNIT_ID"
   request:request
   completionHandler:^(GADRewardedAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
      return;
    }
    self.rewardedAd = ad;
    self.rewardedAd.paidEventHandler = ^void(GADAdValue *_Nonnull value){
      ViewController *strongSelf = weakSelf;
      // 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; = value.value;
      NSString *currencyCode = value.currencyCode;
      GADAdValuePrecision precision = value.precision;

      // Get the ad unit ID.
      NSString *adUnitId = strongSelf.rewardedAd.adUnitID;

      GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo =
          strongSelf.rewardedAd.responseInfo.loadedAdNetworkResponseInfo;
      NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
      NSString *adSourceID = loadedAdNetworkResponseInfo.adSourceID;
      NSString *adSourceInstanceName = loadedAdNetworkResponseInfo.adSourceInstanceName;
      NSString *adSourceInstanceID = loadedAdNetworkResponseInfo.adSourceInstanceID;
      NSDictionary<NSString *, id> *extras = strongSelf.rewardedAd.responseInfo.extrasDictionary;
      NSString *mediationGroupName = extras["mediation_group_name"];
      NSString *mediationABTestName = extras["mediation_ab_test_name"];
      NSString *mediationABTestVariant = extras["mediation_ab_test_variant"];
    };
  ]};
}

Więcej informacji o zwycięskim źródle reklam znajdziesz w artykule Pobieranie informacji o odpowiedzi na reklamę.

Integracja z programem App Attribution Partners (AAP)

Szczegółowe informacje o przekazywaniu danych o przychodach z reklam na platformy analityczne znajdziesz w przewodniku partnera:

Pakiet SDK partnera
Dostosuj
AppsFlyer
Singular
Tenjin

Sprawdzone metody wdrażania

  • Ustaw moduł obsługi od razu po utworzeniu obiektu reklamowego 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ń.
  • Wysyłaj informacje o płatnych zdarzeniach do preferowanego serwera analityki natychmiast po wywołaniu metody paidEventHandler. Dzięki temu nie dojdzie do przypadkowego odrzucenia żadnych wywołań zwrotnych i unikniesz rozbieżności w danych.

GADAdValue

GADAdValue to klasa reprezentująca wartość pieniężną zarobioną na reklamie, z uwzględnieniem kodu waluty wartości i typu precyzji zakodowanego poniżej.

GADAdValuePrecision Opis
GADAdValuePrecisionUnknown 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.
GADAdValuePrecisionEstimated Wartość reklamy oszacowana na podstawie danych zbiorczych.
GADAdValuePrecisionPublisherProvided Wydawca podał wartość reklamy w grupie zapośredniczenia, np. samodzielnie ustalany CPM.
GADAdValuePrecisionPrecise Dokładna wartość zapłacona za reklamę.