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

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

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

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

Реализация платного обработчика событий

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

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


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<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary<string, 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
Регулировать
ПриложенияФлаер
Единственное число
Тенджин

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

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

Стоимость объявления

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

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

В случае посредничества AdMob пытается предоставить ESTIMATED ценность для оптимизированных источников объявлений . Для неоптимизированных источников объявлений или в случаях, когда агрегированных данных недостаточно для получения значимой оценки, возвращается значение PUBLISHER_PROVIDED .