Измеряйте доход от рекламы

Измерение источников дохода помогает понять пожизненную ценность пользователей и развивать ваш бизнес в сфере мобильных приложений. В этом руководстве показано, как настроить измерение дохода от рекламы для вашей платформы.

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

Прежде чем начать

Если вы еще этого не сделали, обязательно выполните следующие задания:

  1. Настройте свой проект и приложение, как описано в разделе «Начало работы с Analytics .

  2. Убедитесь, что ваш проект Firebase связан с учетной записью Google Analytics .

  3. Убедитесь, что в ваше приложение включен Android SDK версии 17.6.0+ или SDK платформ Apple версии 6.34.0+.

Выполнение

Вы можете использовать Google Analytics для измерения дохода от рекламы, полученного от показа объявлений на платформах монетизации, таких как AdMob , AppLovin и ironSource. Для измерения дохода от рекламы необходимо регистрировать события ad_impression всякий раз, когда пользователь видит рекламу в вашем приложении. Эти события содержат такие сведения, как рекламная платформа, источник, валюта и стоимость.

AdMob

Если вы используете платформу AdMob , свяжите свое приложение AdMob с Firebase и Analytics , чтобы включить автоматическое измерение дохода от рекламы. SDK Firebase для Google Analytics автоматически регистрирует событие ad_impression всякий раз, когда ваши пользователи видят показ рекламы.

Другие платформы монетизации рекламы

Такие платформы, как AppLovin и ironSource, предоставляют данные о доходах на уровне показов, которые затем можно использовать для регистрации событий ad_impression Google Analytics .

В следующих разделах представлены примеры реализации для нескольких различных платформ монетизации рекламы.

AppLovin

Быстрый

Примечание: Данный продукт Firebase недоступен на целевой платформе macOS. 
func didPayRevenue(_ impressionData: MAAd?) {
  if let impressionData = impressionData {
    Analytics.logEvent(
      AnalyticsEventAdImpression,
      parameters: [
        AnalyticsParameterAdPlatform: "AppLovin",
        AnalyticsParameterAdUnitName: impressionData.adUnitIdentifier,
        AnalyticsParameterAdFormat: impressionData.format,
        AnalyticsParameterValue: impressionData.revenue,
        AnalyticsParameterCurrency: "USD",  // All Applovin revenue is sent in USD
        AnalyticsParameterAdSource: impressionData.networkName,
      ])
  }
}
ViewController.swift

Objective-C

Примечание: Данный продукт Firebase недоступен на целевой платформе macOS. 
- (void)didPayRevenueForAd:(MAAd *)impressionData {
    [FIRAnalytics logEventWithName:kFIREventAdImpression
                    parameters: @{
                        kFIRParameterAdPlatform: @"AppLovin",
                        kFIRParameterAdSource: impressionData.networkName,
                        kFIRParameterAdFormat: impressionData.format,
                        kFIRParameterAdUnitName: impressionData.adUnitIdentifier,
                        kFIRParameterCurrency: @"USD", // All Applovin revenue is sent in USD
                        kFIRParameterValue: impressionData.revenue
                    }];
}
AnalyticsHelper.m

Kotlin 

override fun onAdRevenuePaid(impressionData: MaxAd?) {
    impressionData?.let {
        firebaseAnalytics = Firebase.analytics
        firebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION) {
            param(FirebaseAnalytics.Param.AD_PLATFORM, "appLovin")
            param(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.adUnitId)
            param(FirebaseAnalytics.Param.AD_FORMAT, impressionData.format.label)
            param(FirebaseAnalytics.Param.AD_SOURCE, impressionData.networkName)
            param(FirebaseAnalytics.Param.VALUE, impressionData.revenue)
            param(FirebaseAnalytics.Param.CURRENCY, "USD") // All Applovin revenue is sent in USD
        }
    }
}
MainActivity.kt

Java 

@Override
public void onAdRevenuePaid(MaxAd impressionData) {

    double revenue = impressionData.getRevenue(); // In USD

    mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
    Bundle params = new Bundle();
    params.putString(FirebaseAnalytics.Param.AD_PLATFORM, "appLovin");
    params.putString(FirebaseAnalytics.Param.AD_SOURCE, impressionData.getNetworkName());
    params.putString(FirebaseAnalytics.Param.AD_FORMAT, impressionData.getFormat().getLabel());
    params.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.getAdUnitId());
    params.putDouble(FirebaseAnalytics.Param.VALUE, revenue);
    params.putString(FirebaseAnalytics.Param.CURRENCY, "USD"); // All Applovin revenue is sent in USD
    mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, params);
}
MainActivity.java

Единство 

// Attach callbacks based on the ad format(s) you are using
MaxSdkCallbacks.Interstitial.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
MaxSdkCallbacks.Rewarded.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
MaxSdkCallbacks.Banner.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
MaxSdkCallbacks.MRec.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
private void OnAdRevenuePaidEvent(string adUnitId, MaxSdkBase.AdInfo impressionData)
{
double revenue = impressionData.Revenue;
var impressionParameters = new[] {
  new Firebase.Analytics.Parameter("ad_platform", "AppLovin"),
  new Firebase.Analytics.Parameter("ad_source", impressionData.NetworkName),
  new Firebase.Analytics.Parameter("ad_unit_name", impressionData.AdUnitIdentifier),
  new Firebase.Analytics.Parameter("ad_format", impressionData.AdFormat),
  new Firebase.Analytics.Parameter("value", revenue),
  new Firebase.Analytics.Parameter("currency", "USD"), // All AppLovin revenue is sent in USD
};
Firebase.Analytics.FirebaseAnalytics.LogEvent("ad_impression", impressionParameters);
}

ironSource

Быстрый

Примечание: Данный продукт Firebase недоступен на целевой платформе macOS. 
func impressionDataDidSucceed(_ impressionData: ISImpressionData!) {
  Analytics.logEvent(
    AnalyticsEventAdImpression,
    parameters: [
      AnalyticsParameterAdPlatform: "ironSource",
      AnalyticsParameterAdSource: impressionData.ad_network ?? "No ad_network",
      AnalyticsParameterAdFormat: impressionData.ad_unit ?? "No ad_unit",
      AnalyticsParameterAdUnitName: impressionData.instance_name ?? "No instance_name",
      AnalyticsParameterCurrency: "USD",
      AnalyticsParameterValue: impressionData.revenue ?? 0,
    ])
}
ViewController.swift

Objective-C

Примечание: Данный продукт Firebase недоступен на целевой платформе macOS. 
- (void)impressionDataDidSucceed:(ISImpressionData *)impressionData {
  [FIRAnalytics logEventWithName:kFIREventAdImpression
                      parameters:@{
                        kFIRParameterAdPlatform: @"ironSource",
                        kFIRParameterAdSource: impressionData.ad_network,
                        kFIRParameterAdFormat: impressionData.ad_unit,
                        kFIRParameterAdUnitName: impressionData.instance_name,
                        kFIRParameterCurrency: @"USD",
                        kFIRParameterValue: impressionData.revenue
                      }];
}
AnalyticsHelper.m

Kotlin 

override fun onImpressionSuccess(impressionData: ImpressionData) {
    // The onImpressionSuccess will be reported when the rewarded video and interstitial ad is
    // opened.
    // For banners, the impression is reported on load success. Log.d(TAG, "onImpressionSuccess" +
    // impressionData)
    firebaseAnalytics = Firebase.analytics
    firebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION) {
        param(FirebaseAnalytics.Param.AD_PLATFORM, "ironSource")
        param(FirebaseAnalytics.Param.AD_SOURCE, impressionData.adNetwork)
        param(FirebaseAnalytics.Param.AD_FORMAT, impressionData.adUnit)
        param(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.instanceName)
        param(FirebaseAnalytics.Param.CURRENCY, "USD")
        param(FirebaseAnalytics.Param.VALUE, impressionData.revenue)
    }
}
MainActivity.kt

Java 

@Override
public void onImpressionSuccess(ImpressionData impressionData) {
    // The onImpressionSuccess will be reported when the rewarded video and interstitial ad is opened.
    // For banners, the impression is reported on load success. Log.d(TAG, "onImpressionSuccess" + impressionData);
    mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
    if (impressionData != null) {
        Bundle bundle = new Bundle();
        bundle.putString(FirebaseAnalytics.Param.AD_PLATFORM, "ironSource");
        bundle.putString(FirebaseAnalytics.Param.AD_SOURCE, impressionData.getAdNetwork());
        bundle.putString(FirebaseAnalytics.Param.AD_FORMAT, impressionData.getAdUnit());
        bundle.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.getInstanceName());
        bundle.putString(FirebaseAnalytics.Param.CURRENCY, "USD");
        bundle.putDouble(FirebaseAnalytics.Param.VALUE, impressionData.getRevenue());
        mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, bundle);
    }
}
MainActivity.java

Единство 

private void ImpressionSuccessEvent(IronSourceImpressionData impressionData) {
  if (impressionData != null) {
      Firebase.Analytics.Parameter[] AdParameters = {
        new Firebase.Analytics.Parameter("ad_platform", "ironSource"),
        new Firebase.Analytics.Parameter("ad_source", impressionData.adNetwork),
        new Firebase.Analytics.Parameter("ad_unit_name", impressionData.getInstanceName),
        new Firebase.Analytics.Parameter("ad_format", impressionData.getAdUnit),
        new Firebase.Analytics.Parameter("currency","USD"),
        new Firebase.Analytics.Parameter("value", impressionData.getRevenue)
      };
      Firebase.Analytics.FirebaseAnalytics.LogEvent("ad_impression", AdParameters);
  }
}

Вопросы реализации

Чтобы Google Ads мог обработать ваш ad_impression , убедитесь, что вы указали как currency , так и value (описано ниже). Оба параметра должны быть максимально точными, чтобы избежать завышения или занижения оценок пользователей.

Параметр валюты

Параметр currency ( iOS+ | Android | Unity ) следует передавать в виде строки в трехбуквенном формате ISO_4217 (например, "USD" ). Некоторые платформы монетизации рекламы не указывают валюту, поэтому вам может потребоваться задать этот параметр вручную.

Параметр значения

Параметр value ( iOS+ | Android | Unity ) следует передавать с использованием точки в качестве десятичного разделителя. Возможно, потребуется преобразовать значения, полученные с некоторых платформ, чтобы они соответствовали указанному выше формату. Некоторые платформы локализуют числовые форматы и используют запятые в качестве десятичных разделителей. В некоторых случаях платформа может вообще не отправлять значение.

Кроме того, значение должно быть числовым типом, например, double или long. Например, 1000.01 , 0.001 и 1.00 — все допустимые значения.

Проверка

Google Analytics предлагает множество функций для проверки вашей реализации на протяжении всего цикла разработки.

  1. DebugView
    При первом тестировании вашей реализации используйте DebugView , чтобы просмотреть тестовые данные ad_impression в консоли. При выборе события ad_impression вы можете просмотреть передаваемые параметры на панели «Параметры» (в правой части экрана). Это поможет вам убедиться, что обрабатывается правильная информация.

  2. В реальном времени
    После развертывания приложения используйте отчет Google Analytics в режиме реального времени, чтобы убедиться в корректной работе системы. В отчете в режиме реального времени просмотрите карточку « Количество событий по названию события» и выберите «показы объявлений» , чтобы увидеть подробную информацию о событиях и параметрах за последние 30 минут.

  3. BigQuery
    Используйте экспорт BigQuery , чтобы извлечь выборку событий ad_impression за один или несколько дней. Используйте эту извлеченную выборку для поиска проблем, таких как нулевые или незаданные значения, и внесите исправления в свой код для любых необработанных случаев.

Следующие шаги

Перейдите на панель Analytics в консоли Firebase или в связанный с вами ресурс Analytics в консоли Analytics . Доход от рекламы учитывается в таких показателях, как средний доход на пользователя (ARPU) и пожизненная ценность клиента (LTV).