Доход от рекламы на уровне показа

Когда происходит показ, Google Mobile Ads SDK предоставляет данные о доходе от рекламы, связанном с этим показом. Вы можете использовать эти данные, чтобы рассчитать пожизненную ценность пользователя или передать их в другие системы.

Это руководство поможет вам настроить сбор данных о пожизненной ценности в приложении для iOS.

Требования

Как обрабатывать платные события

Протокол делегата каждого формата объявлений включает метод didRecordPaidEventWithAdValue:. В течение жизненного цикла объявления Google Mobile Ads SDK отслеживает события показа и вызывает этот метод делегата с полученным объектом GADAdValue.

В примере ниже показано, как обрабатывать события оплаты для объявления с вознаграждением.

Swift

func ad(_ ad: FullScreenPresentingAd, didRecordPaidEventWith adValue: 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.
  let value = adValue.value
  let currencyCode = adValue.currencyCode
  let precision = adValue.precision

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

Objective-C

- (void)ad:(id<GADFullScreenPresentingAd>)ad didRecordPaidEventWithAdValue:(GADAdValue *)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);
}

Как определить название источника объявлений для специального события

Для источников объявлений со специальными событиями свойство adSourceName возвращает название источника объявлений Custom event. Если вы используете несколько специальных событий, название источника объявлений не позволит вам различать их. Чтобы найти определенное специальное событие, выполните следующие действия:

  1. Получите свойство adNetworkClassName.
  2. Укажите уникальное название источника объявлений.

В следующем примере задается уникальное название источника объявлений для специального события:

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;
}

Подробнее о том, как получить информацию об ответе на запрос объявления…

Рекомендации по реализации

  • Задайте делегат сразу после создания или получения доступа к объекту объявления и обязательно до показа объявления. Это гарантирует, что вы не пропустите ни одного обратного вызова платного события.
  • Отправьте информацию о событии оплаты на нужный сервер аналитики сразу после вызова метода делегата didRecordPaidEventWithAdValue:. Это позволит избежать случайного пропуска обратных вызовов и расхождений в данных.

GADAdValue

GADAdValue – это класс, который представляет денежную ценность, полученную за объявление, включая код валюты и тип точности, закодированный следующим образом:

GADAdValuePrecision Описание
GADAdValuePrecisionUnknown Неизвестное значение объявления. Возвращается, если пингбек пожизненной ценности включен, но данных недостаточно.
GADAdValuePrecisionEstimated Доход от объявления рассчитывается на основе агрегированных данных.
GADAdValuePrecisionPublisherProvided Стоимость объявления, указанная издателем, например цена за тысячу показов, заданная вручную в группе медиации.
GADAdValuePrecisionPrecise Точная стоимость показа объявления.

Тестовые показы из Open Bidding

После того как в источнике объявлений Open Bidding произойдет событие, связанное с доходом от рекламы на уровне показа, вы получите только следующие значения:

  • GADAdValuePrecisionUnknown – тип точности.
  • 0 – дополнительные преимущества объявления.
Ранее вы могли видеть тип точности, отличный от GADAdValuePrecisionUnknown, и ценность объявления, превышающую 0.

Подробнее о том, как отправить тестовый запрос объявления…