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

Выберите платформу: Android (бета-версия)Новый Android iOS Unity

Когда происходит показ, 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

Для получения дополнительной информации об источнике объявления-победителя см. раздел «Получение информации об отклике на объявление» .

Интеграция с партнерами по атрибуции приложений (AAP)

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

Партнерский SDK
Регулировать
AppsFlyer
Единственное число
Тенджин

Передовые методы внедрения

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

ГАДАдВалью

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

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

Тестовые показы из рекламных источников, участвующих в аукционе.

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

  • GADAdValuePrecisionUnknown : указывает тип точности.
  • 0 : указывает на стоимость рекламы.

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

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