Эта страница переведена с помощью Cloud Translation API.

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

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

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

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

Убедитесь, что вы включили функцию дохода от рекламы на уровне показов в пользовательском интерфейсе Менеджера рекламы.
Плагин Unity 5.0.0 или выше.
Полное начало работы . В ваше приложение Unity уже должен быть импортирован плагин Google Mobile Ads 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
Регулировать
ПриложенияФлаер
Единственное число
Тенджин

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

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

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

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

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

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

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

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

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

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

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

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

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