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

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

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

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

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

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

В следующем примере обрабатываются платные события для объявления с вознаграждением:

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

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

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

Тестовые показы из источников объявлений с назначением ставок

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

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

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

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