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

1. Введение

Последнее обновление: 14 декабря 2020 г.

Что ты построишь

В этой лаборатории кода вы узнаете, как реализовывать события с помощью Google Analytics для Firebase (GA4F) и запускать кампании действий через Google Ads.

В этой лаборатории кода основное внимание уделяется реализации событий с помощью GA4F и импорту событий в Google Рекламу. Если вы хотите узнать, как создать приложение для Android с помощью Firebase, обратитесь к дружественному чату Firebase Android Codelab-Build .

Что вы узнаете

  • Как создать проект Firebase
  • Как реализовать Firebase SDK в приложении для Android
  • Как создавать события и параметры.
  • Как импортировать события из Firebase в Google Рекламу
  • Запускайте кампании Google Ads с настраиваемыми событиями.

Что вам понадобится

  • Android Studio 3.6 или выше
  • Аккаунт Firebase
  • Аккаунт Google Рекламы

2. Создайте и настройте проект Firebase.

Чтобы начать работу с Firebase, вам необходимо создать и настроить проект Firebase.

Создать проект Firebase

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

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

8525e77df3536fbb.png

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

e58151a081f0628.png

Дополнительные сведения о проектах Firebase см. в разделе Общие сведения о проектах Firebase .

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

ac928e5947ba7cbf.png

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

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

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

Зарегистрировать приложение

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

6cbb33ad3e7c9132.png

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

3b7d3b33d81fe8ea.png

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

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

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

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

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

52f08aa18c8d59d0.png

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

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

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

Мы будем использовать BoM Firebase Android, который позволит вам управлять версиями библиотеки 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'

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

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'
  1. Теперь синхронизируйте свое приложение, нажав кнопку Sync Now . 937206076c88ae5c.png

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

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

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

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

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

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

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

  1. Объявите объект FirebaseAnalytics в верхней части действия:
private lateinit var firebaseAnalytics: FirebaseAnalytics
  1. Инициализируйте объект в методе onCreate() :
firebaseAnalytics = Firebase.analytics
  1. Начните регистрацию событий с помощью метода 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 Рекламу.

6. Импортируйте события Firebase в Google Рекламу.

Настройка Firebase-Android завершена, и вы готовы запустить кампанию для приложений с зарегистрированными событиями действий. Вы начнете с связывания Firebase с Google Рекламой. Связав Firebase с Google Рекламой, кампании приложений смогут больше узнать об аудитории и повысить эффективность кампаний приложений, что обычно приводит к повышению эффективности и конверсий.

  1. Перейдите в настройки Firebase, нажав кнопку рядом с обзором проекта.

412830708c61fdc0.png

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

796c921fb2b873ae.png

  1. Выберите аккаунт Google Рекламы, который хотите связать.

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

Импортировать события Firebase

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

a5f302ba01a1863c.png

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

Теперь вы завершили импорт событий Firebase в Google Рекламу.

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

7. Запуск кампаний действий в приложении с импортированными событиями.

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

19856a65ab999ad7.png

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

b75e410c7dbdfec8.png

  1. Установите остальные настройки кампании и готово.

8. Поздравления

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

Вы узнали

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