Используйте больше возможностей Google Analytics и Firebase с приложениями AdMob.

iOS+ Android

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

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

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

Особенность	Добавить SDK Mobile Ads + включить пользовательские метрики	Добавить SDK Mobile Ads + включить пользовательские метрики и Свяжите AdMob с Firebase	Добавить SDK Mobile Ads + включить пользовательские метрики и Свяжите AdMob с Firebase и Добавить Firebase SDK для Analytics
Просмотр показателей пользователей в вашем аккаунте AdMob
Автоматически собирайте аналитические события и свойства пользователей из вашего приложения
Просмотр подобранных пользовательских показателей в AdMob
Исследуйте и работайте с вашими аналитическими данными через Firebase
Просмотр ключевых показателей в консоли Firebase
Отметьте конверсии для рекламных кампаний
Создавайте индивидуальные аудитории
Экспорт и анализ данных в BigQuery
Получите доступ к дополнительным возможностям настройки ваших аналитических данных
Регистрируйте пользовательские события для аналитики и моделей (например, регистрируйте события ecommerce_purchase для показателей ARPU и ARPPU )
Настройте пользовательские конверсии для рекламных кампаний
Используйте другие продукты Firebase (например, Remote Config и A/B Testing )

Начните работу с Google Analytics

Google Analytics — это аналитический движок Firebase, который дает вам доступ к мощным аналитическим данным. Начните использовать Google Analytics в своем приложении, добавив Firebase SDK для Google Analytics .

Зачем добавлять Firebase SDK для Google Analytics ?

При базовой настройке AdMob вы можете просматривать агрегированную статистику автоматически собранных событий и свойств пользователей на панели аналитики консоли Firebase без добавления дополнительного кода в ваше приложение.

Однако, если вы хотите собирать дополнительные данные о пользовательских событиях или свойствах пользователя, вам нужно будет использовать Firebase SDK для Google Analytics . С помощью этого SDK вы можете регистрировать до 500 различных типов аналитических событий, и нет ограничений на общий объем событий, регистрируемых вашим приложением. Примером использования для регистрации пользовательских событий является включение данных в расчет дохода из пользовательского события под названием ecommerce_purchase , чтобы помочь вам лучше представлять показатели ARPU и ARPPU .

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

Следующие шаги описывают, как начать использовать Firebase SDK для Google Analytics в вашем приложении. После инициализации SDK посетите документацию Analytics , чтобы узнать, как начать регистрировать события в вашем приложении.

Шаг 1: Добавьте файл конфигурации в свое приложение.

Если вы зарегистрировали свое приложение в Firebase до создания ссылки AdMob , то вы уже добавили файл конфигурации Firebase в свое приложение.Проверьте наличие файла GoogleService-Info.plist в корне вашего проекта Xcode. Также убедитесь, что файл конфигурации добавлен во все цели.

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

1. На карточке Ваши приложения в > Настройки проекта выберите идентификатор пакета приложения, для которого вам нужен файл конфигурации.

2. Нажмите «Загрузить GoogleService-Info.plist» , чтобы получить файл конфигурации Firebase iOS ( GoogleService-Info.plist ).

   • Вы можете снова загрузить файл конфигурации Firebase iOS в любое время из > Настройки проекта .

   • Убедитесь, что к имени файла конфигурации не добавлены дополнительные символы, например (2) .

3. Переместите ваш файл конфигурации в корень вашего проекта Xcode. Если будет предложено, выберите добавление файла конфигурации ко всем целям.

Если в вашем проекте несколько идентификаторов пакетов, необходимо связать каждый идентификатор пакета с зарегистрированным приложением в консоли Firebase , чтобы каждое приложение могло иметь свой собственный файл GoogleService-Info.plist .

Примечание: Файл конфигурации Firebase содержит уникальные, но несекретные идентификаторы вашего проекта.
Подробнее об этом файле конфигурации можно узнать на странице «Понимание проектов Firebase» .

Шаг 2: Добавьте Firebase SDK для Analytics в свое приложение

1. Добавьте зависимость Firebase SDK для Google Analytics в свой Podfile:

   pod 'FirebaseAnalytics'
   

2. Запустите pod install , затем откройте созданный файл .xcworkspace .

3. Импортируйте модуль FirebaseCore в ваш UIApplicationDelegate , а также любые другие модули Firebase, которые использует ваш делегат приложения. Например, чтобы использовать Cloud Firestore и Authentication :

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Быстрый

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

4. Настройте общий экземпляр FirebaseApp в методе делегата приложения application application(_:didFinishLaunchingWithOptions:) :

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Быстрый

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

5. Если вы используете SwiftUI, вы должны создать делегат приложения и прикрепить его к структуре App через UIApplicationDelegateAdaptor или NSApplicationDelegateAdaptor . Вы также должны отключить swizzling делегата приложения. Для получения дополнительной информации см. инструкции SwiftUI .

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

Если вы отслеживаете покупки в приложении, вам необходимо инициализировать своего наблюдателя транзакций в application:didFinishLaunchingWithOptions: перед инициализацией Firebase, иначе ваш наблюдатель может не получить все уведомления о покупках. Для получения дополнительной информации см. рекомендации Apple по покупкам в приложении.

Реализовать пользовательское ведение журнала событий

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

Почему ecommerce_purchase важен для ARPU и ARPPU?

Ключевой метрикой для вашего приложения является доход по пользователю , который можно далее сегментировать на ARPU и ARPPU . Эти две метрики отображаются на карточке показателей пользователя вашего аккаунта AdMob и на панели аналитики консоли Firebase . Однако доход не измеряется напрямую; вместо этого он представляет собой сумму вашего предполагаемого дохода AdMob и следующих двух значений событий аналитики:

• in_app_purchase : когда пользователь совершает покупку в приложении, которая обрабатывается App Store в iTunes, например, первоначальная подписка, разблокировка премиум-услуг или покупка внутриигровых предметов.

• ecommerce_purchase : когда пользователь совершает покупку, например, совершает интернет-шопинг, покупает купоны или товары со скидкой или покупает билеты в кино

Без какого-либо дополнительного кода в вашем приложении Mobile Ads SDK автоматически собирает аналитические данные для событий in_app_purchase . Однако, если вы хотите также включить данные событий ecommerce_purchase в расчет дохода, вам необходимо реализовать пользовательское ведение журнала через Firebase SDK для Google Analytics .

Вот как реализовать пользовательскую регистрацию событий в вашем приложении:

1. Убедитесь, что вы выполнили раздел «Начало работы с Google Analytics на этой странице, который включает настройку приложения для использования Firebase, добавление Firebase SDK для Google Analytics и инициализацию SDK.

2. Зарегистрируйте событие ecommerce_purchase ( Swift | Obj-C ). Вот пример:

   Быстрый

   Analytics.logEvent(AnalyticsEventPurchase, parameters: [
     AnalyticsParameterCoupon: "SummerPromo",
     AnalyticsParameterCurrency: "JPY",
     AnalyticsParameterValue: 10000,
     AnalyticsParameterShipping: 500,
     AnalyticsParameterTransactionID: "192803301",
   ])

   Objective-C

   [FIRAnalytics logEventWithName:kFIREventPurchase
                       parameters:@{
     kFIRParameterCoupon: @"SummerPromo",
     kFIRParameterCurrency: @"JPY",
     kFIRParameterValue: @10000,
     kFIRParameterShipping: @500,
     kFIRParameterTransactionID: @"192803301",
   }];

Чтобы узнать больше о регистрации пользовательских событий в вашем приложении, посетите документацию Analytics .

Используйте другие продукты Firebase в своем приложении

После добавления Firebase SDK для Google Analytics вы также сможете начать использовать другие продукты Firebase, такие как Firebase Remote Config и Firebase A/B Testing .

• Remote Config позволяет вам изменять поведение и внешний вид вашего приложения без публикации обновления приложения, бесплатно и для неограниченного числа активных пользователей в день.

• A/B Testing дает вам возможность тестировать изменения в пользовательском интерфейсе, функциях или кампаниях по вовлечению вашего приложения, чтобы узнать, влияют ли они на ваши ключевые показатели (такие как доход и удержание), прежде чем внедрять изменения повсеместно.

Оптимизируйте рекламную монетизацию вашего приложения

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

• Протестируйте внедрение нового формата рекламы ( обзор | реализация ).

• Оптимизируйте частоту показов рекламы ( обзор | реализация ).