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

При показе рекламы 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&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.PrecisionType Описание
Unknown Неизвестная ценность объявления. Возвращается, если включена функция pingback LTV, но недостаточно данных.
Estimated Ценность объявления, рассчитанная на основе агрегированных данных.
PublisherProvided Издатель предоставил ценность рекламы, например, ручную установку CPM в группе посредничества.
Precise Точная стоимость этого объявления.

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

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

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

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

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

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