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

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

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

Данное руководство призвано помочь вам внедрить сбор данных о доходах от рекламы на уровне показов в вашем проекте Unity.

Предварительные требования

• Убедитесь, что в пользовательском интерфейсе Ad Manager включена функция учета дохода от рекламы на уровне показов .
• Плагин Unity версии 5.0.0 или выше.
• Завершите процесс « Начало работы» . В вашем приложении Unity уже должен быть импортирован плагин Google Mobile Ads Unity.

• Прежде чем вы сможете получать данные о доходах от рекламы на уровне показов, вам необходимо внедрить как минимум один рекламный формат:

  • Баннер
  • Интерстициальный
  • Награжден
  • Вознагражденный интерстициальный
  • Родной

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

Для каждого формата рекламы существует событие OnPaidEvent . В течение жизненного цикла события рекламы SDK Google Mobile Ads отслеживает события показов и вызывает обработчик с полученным значением.

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

RewardedAd rewardedAd;

private void RequestRewardedAd()
{
   rewardedAd = new RewardedAd("AD_UNIT_ID");
   
   rewardedAd.OnPaidEvent += this.HandleAdPaidEvent;
   
   AdRequest adRequest = new AdRequest();
   rewardedAd.LoadAd(adRequest);
}


public void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    AdValue adValue = args.AdValue;
    long valueMicros = adValue.Value;
    string currencyCode = adValue.CurrencyCode;
    PrecisionType precision = adValue.Precision;

    ResponseInfo responseInfo = rewardedAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();

    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
    Dictionary&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary&ltstring, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

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

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

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

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

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

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

AdValue

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

Ключевой момент: значение AdValue — это микрозначение, отражающее ценность каждого объявления. Например, значение 5000 означает, что стоимость этого объявления оценивается в 0,005 доллара.

AdValue.PrecisionType	Описание
Unknown	Неизвестное значение объявления. Оно возвращается, когда включена функция отслеживания LTV, но данных недостаточно.
Estimated	Оценка стоимости рекламы на основе агрегированных данных.
PublisherProvided	Издатель предоставлял рекламную ценность, например, ручную настройку CPM в группе по урегулированию споров.
Precise	Точная стоимость этой рекламы.

В случае медиации Ad Manager пытается предоставить ESTIMATED значение для источников рекламы, у которых включен автоматический сбор данных. Дополнительную информацию см. в разделе «Автоматический сбор данных» . Для источников рекламы, у которых автоматический сбор данных не включен, или в случаях, когда недостаточно агрегированных данных для предоставления осмысленной оценки, возвращается значение PUBLISHER_PROVIDED .

Тестовые показы с открытых торгов

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

• Unknown : указывает тип точности.

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

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

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