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

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

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

Предпосылки

Реализовать платный обработчик событий

У каждого формата рекламы есть свойство paidEventHandler типа GADPaidEventHandler . В течение жизненного цикла события рекламы Google Mobile Ads SDK отслеживает события показов и вызывает обработчик с полученным значением.

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

Быстрый 

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

Определите название источника рекламы для пользовательского события

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

  1. Получите свойство adNetworkClassName .
  2. Задайте уникальное название источника рекламы.

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

Быстрый 

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

Дополнительную информацию о выигрышном источнике рекламы см. в разделе Получение информации об отклике на рекламу .

Лучшие практики внедрения

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

GADAdValue

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

GADAdValuePrecision Описание
GADAdValuePrecisionUnknown Неизвестная ценность объявления. Возвращается, если включена функция pingback LTV, но недостаточно данных.
GADAdValuePrecisionEstimated Ценность объявления, рассчитанная на основе агрегированных данных.
GADAdValuePrecisionPublisherProvided Издатель предоставил ценность рекламы, например, ручную установку CPM в группе посредничества.
GADAdValuePrecisionPrecise Точная стоимость этой рекламы.

Тестовые впечатления от открытых торгов

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

  • GADAdValuePrecisionUnknown : указывает тип точности.
  • 0 : указывает ценность объявления.

Ранее вы могли видеть тип точности как значение, отличное от GADAdValuePrecisionUnknown , и значение объявления больше 0 .

Подробную информацию об отправке тестового запроса на рекламу см. в разделе Включение тестовых устройств .