Google Реклама с пользовательскими событиями Google Analytics для Firebase – Android

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.

1. Войдите в Firebase .

В консоли Firebase нажмите «Добавить проект» (или «Создать проект») и назовите свой проект Firebase так, как вам угодно.

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

Чтобы узнать больше о проектах Firebase, см. раздел «Понимание проектов Firebase» .

3. Выберите учетную запись Google Analytics. Если у вас уже есть учетная запись, выберите ее или создайте новую. Нажмите кнопку «Создать проект».

4. Сборка проекта Firebase завершена!

На следующем шаге вы узнаете, как добавить Firebase в ваше Android-приложение.

3. Добавьте Firebase в свое Android-приложение.

Зарегистрируйте приложение

1. В консоли Firebase выберите «Обзор проекта» в левой панели навигации, затем нажмите кнопку Android под заголовком «Начните работу, добавив Firebase в ваше приложение».

2. Заполните необходимую информацию.

Чтобы задать имя пакета Android, в Android Studio перейдите в каталог приложения, откройте файл build.gradle . В файле найдите applicationId . Это значение — имя пакета Android. Скопируйте это значение и вставьте его.

Ключ SHA-1 здесь не нужен, если вы не планируете использовать вход через Google или динамические ссылки Firebase (обратите внимание, что они не входят в данную практическую работу; для получения дополнительной информации о ключе SHA-1, пожалуйста, обратитесь к этому документу ).

Совет : Для получения дополнительной информации об идентификаторах пакетов и приложений ознакомьтесь с разделом «Установка идентификатора приложения» .

3. Нажмите кнопку «Зарегистрировать приложение».

Скачать файл конфигурации

1. Нажмите кнопку «Скачать google-services.json», чтобы загрузить файл конфигурации google-services.json .

2. В Android Studio перейдите в каталог app и переместите файл google-services.json (который вы только что скачали) в этот app . Вернитесь в консоль Firebase и нажмите кнопку «Далее».

Включите Firebase в своем приложении.

1. Для чтения файла google-services.json , сгенерированного Firebase, вам потребуется плагин Gradle для Google Services .
2. В 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
      ...
      }
   }
}

3. Откройте файл <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.

1. Откройте файл <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'

2. Теперь синхронизируйте приложение, нажав кнопку Sync Now .

Теперь вы завершили добавление Firebase SDK для Google Analytics в ваше Android-приложение!

На следующем шаге вы узнаете, как регистрировать события Firebase в вашем Android-приложении.

5. Регистрируйте события с помощью Firebase Analytics.

На этом этапе вы узнаете, как регистрировать события с помощью Firebase Analytics в приложении для Android.

Существует два способа регистрации событий: использование предлагаемых событий или пользовательских событий.

Использование предложенных событий

SDK Firebase Analytics определяет ряд рекомендуемых событий, которые можно использовать в различных типах приложений, таких как игры, розничная торговля, путешествия и электронная коммерция. Также существуют рекомендуемые события, для которых требуются заданные параметры, и с помощью этих параметров вы можете максимально подробно отображать информацию в отчетах Firebase. ( Справочник рекомендуемых событий )

1. Объявите объект FirebaseAnalytics в самом начале активности:

private lateinit var firebaseAnalytics: FirebaseAnalytics

2. Инициализируйте объект в методе onCreate() :

firebaseAnalytics = Firebase.analytics

3. Начните регистрировать события с помощью метода 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

1. Перейдите в настройки Firebase, нажав кнопку справа от раздела «Обзор проекта».

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

3. Выберите аккаунт Google Ads, который хотите связать.

Теперь вы завершили связывание Firebase и Google Ads. Давайте импортируем события Firebase в Google Ads.

Импорт событий Firebase

1. В консоли Firebase перейдите в меню «События» и отметьте событие, которое вы хотите импортировать как конверсию.

Внимание: если целевое событие не помечено как конверсия, Google Ads не сможет его импортировать. Убедитесь, что событие правильно помечено как конверсия.

2. Теперь перейдите в Google Ads и войдите в учетную запись, которую вы связали с Firebase.
3. В Google Ads перейдите в Инструменты → Измерение → Конверсии
4. Нажмите кнопку +
5. Выберите Приложение → Свойства Google Analytics 4 (Firebase) и нажмите Продолжить.
6. Вы можете просмотреть все аналитические события, помеченные как конверсии. Найдите событие, которое хотите импортировать. В данном случае выберите событие delete_item , которое мы уже реализовали ранее. Нажмите кнопку «Импорт и продолжить».
7. Вы успешно импортировали событие конверсии из Firebase.

Теперь импорт событий Firebase в Google Ads завершен.

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

7. Запуск кампаний по использованию приложения с помощью импортированных событий.

Важно: для запуска рекламной кампании вашего приложения вам необходимо иметь готовое к публикации приложение в Google Play. Если вы еще не готовы к публикации приложения, пропустите этот шаг.

1. Перейдите на вкладку «Кампании приложений» в своем текущем аккаунте Google Ads и создайте новую кампанию, нажав кнопку «+».

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

4. Настройте остальные параметры кампании, и готово.

8. Поздравляем!

Поздравляем, вы успешно интегрировали Firebase и Google Ads! Это поможет вам повысить эффективность вашей рекламной кампании.

Вы узнали

• Как настроить Firebase Analytics для Android
• Как регистрировать события с помощью Firebase Analytics в приложении для Android.
• Как импортировать события и использовать их для проведения кампаний с активными действиями.