1. Введение
Последнее обновление: 14.12.2020
Что вы построите
В этом практическом занятии вы узнаете, как реализовать события с помощью Google Analytics for Firebase (GA4F) и запускать рекламные кампании с помощью Google Ads.
В этом практическом занятии основное внимание уделяется реализации событий с помощью GA4F и импорту событий в Google Ads. Если вы хотите узнать, как создать Android-приложение с помощью Firebase, обратитесь к Firebase Android Codelab-Build Friendly Chat .
Что вы узнаете
- Как создать проект Firebase
- Как внедрить Firebase SDK в Android-приложение
- Как создавать события и параметры.
- Как импортировать события из Firebase в Google Ads
- Запускайте рекламные кампании Google Ads с использованием пользовательских событий.
Что вам понадобится
- Android Studio 3.6 или выше
- Учетная запись Firebase
- Аккаунт Google Ads
2. Создайте и настройте проект Firebase.
Для начала работы с Firebase вам потребуется создать и настроить проект Firebase.
Создайте проект Firebase.
- Войдите в консоль Firebase, используя свою учетную запись Google.
- Нажмите кнопку, чтобы создать новый проект, а затем введите название проекта (например,
FriendlyChat). - Нажмите «Продолжить» .
- Если появится запрос, ознакомьтесь с условиями использования Firebase и примите их, после чего нажмите «Продолжить» .
- (Необязательно) Включите помощь ИИ в консоли Firebase (в Firebase она называется "Gemini").
- Для выполнения этого практического задания вам потребуется Google Analytics для отслеживания событий действий и конверсий, поэтому оставьте переключатель для опции Google Analytics включенным . Следуйте инструкциям на экране, чтобы настроить Google Analytics.
- Нажмите «Создать проект» , дождитесь завершения подготовки проекта, а затем нажмите «Продолжить» .
Чтобы узнать больше о проектах Firebase, см. раздел «Понимание проектов Firebase» .
На следующем шаге вы узнаете, как добавить Firebase в ваше Android-приложение.
3. Добавьте Firebase в свое Android-приложение.
Зарегистрируйте приложение
- В консоли Firebase выберите «Обзор проекта» в левой панели навигации, затем нажмите кнопку Android под заголовком «Начните работу, добавив Firebase в ваше приложение».

- Заполните необходимую информацию.
Чтобы задать имя пакета Android, в Android Studio перейдите в каталог приложения, откройте файл build.gradle . В файле найдите параметр applicationId . Это значение и есть имя пакета Android. Скопируйте это значение и вставьте его.
- Нажмите кнопку «Зарегистрировать приложение».
Скачать файл конфигурации
- Нажмите кнопку «Скачать google-services.json», чтобы загрузить файл конфигурации
google-services.json.

- В Android Studio перейдите в каталог
appи переместите файлgoogle-services.json(который вы только что скачали) в этотapp. Вернитесь в консоль Firebase и нажмите кнопку «Далее».
Включите Firebase в своем приложении.
- Для чтения файла
google-services.json, сгенерированного Firebase, вам потребуется плагин Gradle для Google Services . - В Android Studio откройте файл
<project>/build.gradleи добавьте в него следующие строки:
buildscript {
repositories {
// Check that you have the following line (if not, add it):
google() //Google's Maven repository
}
dependencies {
...
// Add this line
classpath 'com.google.gms:google-services:4.3.4'
}
}
allprojects {
...
repositories {
// Check that you have the following line (if not, add it):
google() //Google's Maven repository
...
}
}
}
- Откройте файл
<project>/<app-module>/build.gradleи добавьте в него следующие строки:
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'
Теперь вы завершили добавление Firebase в ваше Android-приложение!
На следующем шаге вы узнаете, как добавить Firebase SDK в ваше приложение.
4. Добавьте Firebase SDK в ваше приложение.
На этом шаге вы добавите Firebase SDK, а именно Firebase SDK для Google Analytics.
Мы будем использовать Firebase Android BoM, который позволяет управлять версиями библиотек Firebase, используемых в вашем приложении, указывая версию BoM. Чтобы узнать, какие версии библиотек Firebase сопоставлены с конкретной версией BoM, ознакомьтесь с примечаниями к выпуску для этой версии BoM.
- Откройте файл
<project>/<app-module>/build.gradleи добавьте в него следующие строки:
dependencies {
// ...
//Import the Firebase BoM
implementation platform('com.google.firebase:firebase-bom:26.1.1')
//Declare the dependency for the Firebase SDK for Google Analytics
implementation 'com.google.firebase:firebase-analytics-ktx'
Как видите, указав только версию в BoM, вам не нужно указывать версию библиотеки Firebase Analytics. Но если вы хотите использовать нужную версию для вашей библиотеки Firebase независимо от того, какая версия указана в BoM, вам просто нужно указать нужную версию следующим образом:
dependencies {
// ...
//Import the Firebase BoM
implementation platform('com.google.firebase:firebase-bom:26.1.1')
//Declare the dependency for the Firebase SDK for Google Analytics
implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'
- Теперь синхронизируйте приложение, нажав кнопку
Sync Now.
Теперь вы завершили добавление Firebase SDK для Google Analytics в ваше Android-приложение!
На следующем шаге вы узнаете, как регистрировать события Firebase в вашем Android-приложении.
5. Регистрируйте события с помощью Firebase Analytics.
На этом этапе вы узнаете, как регистрировать события с помощью Firebase Analytics в приложении для Android.
Существует два способа регистрации событий: использование предлагаемых событий или пользовательских событий.
Использование предложенных событий
SDK Firebase Analytics определяет ряд рекомендуемых событий, которые можно использовать в различных типах приложений, таких как игры, розничная торговля, путешествия и электронная коммерция. Также существуют рекомендуемые события, для которых требуются заданные параметры, и с помощью этих параметров вы можете максимально подробно отображать информацию в отчетах Firebase. ( Справочник рекомендуемых событий )
- Объявите объект FirebaseAnalytics в самом начале активности:
private lateinit var firebaseAnalytics: FirebaseAnalytics
- Инициализируйте объект в методе
onCreate():
firebaseAnalytics = Firebase.analytics
- Начните регистрировать события с помощью метода
logEvent(). Следующий код регистрирует событие PURCHASE , когда пользователь покупает товар(ы) в приложении:
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
param(FirebaseAnalytics.Param.VALUE, 10)
param(FirebaseAnalytics.Param.CURRENCY, "USE")
}
Использование пользовательских событий
Если вам нужны события, не охваченные предлагаемыми событиями, вы можете регистрировать собственные пользовательские события с пользовательскими параметрами:
firebaseAnalytics.logEvent("delete_item"){
param("item name", name)
param("reason", text)
}
Отладочные события
В консоли Firebase можно просматривать сводные данные и отчеты о событиях. Однако обновления происходят периодически в течение дня, и вы не сможете просмотреть эти события сразу после того, как внесли их в приложение.
Для оперативного тестирования и отладки можно использовать Firebase DebugView. DebugView позволяет просматривать данные о событиях, регистрируемых вашим приложением на устройствах разработки, практически в режиме реального времени. Подробную информацию о DebugView см. в разделе «Отладка событий» .
Теперь вы завершили регистрацию событий в вашем Android-приложении!
На следующем шаге вы узнаете, как импортировать эти события в Google Ads.
6. Импортируйте события Firebase в Google Ads.
Настройка Firebase для Android завершена, и вы готовы запустить рекламную кампанию приложения с регистрируемыми событиями действий. Начните с привязки Firebase к Google Ads. Благодаря привязке Firebase к Google Ads, рекламные кампании приложений смогут лучше понимать аудиторию и повышать эффективность, что обычно приводит к улучшению показателей и конверсий.
Связать Firebase и Google Ads
- Перейдите в настройки Firebase, нажав кнопку справа от раздела «Обзор проекта».

- На вкладке «Интеграции» вы увидите Google Ads и кнопку «Ссылка». Нажмите «Ссылка» и «Продолжить».

- Выберите аккаунт Google Ads, который хотите связать.
Теперь вы завершили связывание Firebase и Google Ads. Давайте импортируем события Firebase в Google Ads.
Импорт событий Firebase
- В консоли Firebase перейдите в меню «События» и отметьте событие, которое вы хотите импортировать как конверсию.

- Теперь перейдите в Google Ads и войдите в учетную запись, которую вы связали с Firebase.
- В Google Ads перейдите в Инструменты → Измерение → Конверсии

- Нажмите кнопку +

- Выберите Приложение → Свойства Google Analytics 4 (Firebase) и нажмите Продолжить.

- Вы можете просмотреть все аналитические события, помеченные как конверсии. Найдите событие, которое хотите импортировать. В данном случае выберите событие
delete_item, которое мы уже реализовали ранее. Нажмите кнопку «Импорт и продолжить».
- Вы успешно импортировали событие конверсии из Firebase.

Теперь импорт событий Firebase в Google Ads завершен.
На следующем шаге вы узнаете, как запустить рекламную кампанию с использованием только что импортированного события.
7. Запуск кампаний по использованию приложения с помощью импортированных событий.
- Перейдите на вкладку «Кампании приложений» в своем текущем аккаунте Google Ads и создайте новую кампанию, нажав кнопку «+».

- Мы запустим рекламную кампанию приложения с опцией «Установки приложения». Внизу выберите приложение, которое хотите продвигать, и нажмите «Продолжить».

- В разделе «Торги» в выпадающем меню выберите «Действия в приложении», чтобы просмотреть события. Выберите событие (или события), на которых вы хотите сосредоточиться.

- Настройте остальные параметры кампании, и готово.
8. Поздравляем!
Поздравляем, вы успешно интегрировали Firebase и Google Ads! Это поможет вам повысить эффективность вашей рекламной кампании.
Вы узнали
- Как настроить Firebase Analytics для Android
- Как регистрировать события с помощью Firebase Analytics в приложении для Android.
- Как импортировать события и использовать их для проведения кампаний с активными действиями.