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

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

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

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

Требования

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

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

В коде ниже показано, как обрабатывать события оплаты для объявления с вознаграждением.

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"];
}

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

Интеграция с партнерами по атрибуции конверсий в приложениях

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

SDK партнера
Adjust
AppsFlyer
Singular
Tenjin

Рекомендации по реализации

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

AdValue

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

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

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

Тестовые показы из Open Bidding

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

  • Unknown – указывает тип точности.
  • 0 – элемент, указывающий ценность объявления;
Ранее вы могли видеть тип точности, отличный от Unknown, и ценность объявления, превышающую 0.

Подробнее о том, как отправить тестовый запрос объявления…