Запуск кампаний Google Ads с использованием пользовательских событий Google Analytics и Flutter

1. Введение

Последнее обновление: 25.01.2021

Что вы построите

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

Мы будем использовать стандартное приложение Flutter с простым виджетом-счетчиком. Мы будем рекламировать наше приложение потенциальным пользователям, которые, скорее всего, кликнут на этот виджет.

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

• Как инициализировать GA4F (Google Analytics for Firebase) во Flutter
• Как создавать пользовательские события и параметры
• Как импортировать события из Firebase в Google Ads
• Как запускать рекламные кампании с использованием пользовательских событий

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

• Android Studio 3.6 или выше
• Xcode (для поддержки iOS)
• Учетная запись Firebase
• Аккаунт Google Ads

2. Создайте новый проект Flutter.

Создайте простое шаблонное Flutter-приложение. Для этого практического занятия вы модифицируете это стартовое приложение.

Запустите Android Studio.

Примечание: Если в вашей IDE отсутствует опция «Создать новый проект Flutter», убедитесь, что у вас установлены плагины для Flutter и Dart .

1. Если у вас нет открытых проектов, выберите «Создать новое приложение Flutter» на главной странице. В противном случае выберите «Файл» > «Новый» > «Новый проект Flutter».
2. Выберите тип проекта «Flutter Application» и нажмите «Далее» .
3. Убедитесь, что путь к Flutter SDK указывает местоположение самого SDK. (Если текстовое поле пустое, выберите «Установить SDK» .)
4. Введите название проекта и нажмите «Далее» .
5. Используйте имя пакета по умолчанию, предложенное Android Studio, и нажмите «Далее» .
6. Нажмите «Готово» .
7. Дождитесь, пока Android Studio установит SDK и создаст проект.

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

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

Создайте проект Firebase.

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

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

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

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

4. Конфигурация Firebase для конкретной платформы (Android)

Настройка Android

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

Вы увидите диалоговое окно, показанное на следующем экране.

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

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

3. В каталоге вашего Flutter-приложения откройте файл android/app/src/main/AndroidManifest.xml .
4. В элементе manifest найдите строковое значение атрибута package . Это значение представляет собой имя пакета Android (например, com.yourcompany.yourproject ). Скопируйте это значение.
5. В диалоговом окне Firebase вставьте скопированное имя пакета в поле Android package name .
6. Здесь нам не нужен ключ SHA-1, если только вы не планируете использовать вход через Google или динамические ссылки Firebase (обратите внимание, что они не входят в данный практический пример). Если вы планируете импортировать данные in_app_purchase из Google Play, вам придется установить ключ позже.
7. Нажмите «Зарегистрировать приложение» .
8. Продолжая работу в Firebase, следуйте инструкциям, чтобы загрузить файл конфигурации google-services.json .

9. Перейдите в каталог вашего Flutter-приложения, затем переместите файл google-services.json (который вы только что скачали) в каталог android/app .
10. Вернувшись в консоль Firebase, пропустите оставшиеся шаги и вернитесь на главную страницу консоли Firebase.
11. Наконец, вам понадобится плагин Google Services Gradle для чтения файла google-services.json , сгенерированного Firebase.
12. В вашей IDE или редакторе откройте файл android/app/build.gradle и добавьте следующую строку в качестве последней :

apply plugin: 'com.google.gms.google-services'

13. Откройте файл android/build.gradle , затем внутри тега buildscript добавьте новую зависимость:

buildscript { 
   repositories {
      // ...
   }
   dependencies {
      // ...
      Classpath 'com.google.gms:google-services:4.3.3'
   }
}

14. Если ваше приложение все еще запущено, закройте его и пересоберите, чтобы Gradle мог установить зависимости.

Настройка вашего Flutter-приложения для Android завершена! Для iOS вы можете обратиться к этому руководству ( Знакомство с Firebase для Flutter ).

5. Настройка Firebase Analytics во Flutter

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

Файл pubspec управляет ресурсами для приложения Flutter. В pubspec.yaml добавьте в список зависимостей firebase_analytics: ^6.2.0 ( firebase_analytics 6.2.0 или выше):

dependencies: 
   flutter: 
      sdk: flutter 
   cupertino_icons: ^0.1.2 
   firebase_analytics: ^6.2.0   # add this line

В редакторе Android Studio, просматривая файл pubspec, нажмите кнопку «Получить пакеты» . Это добавит пакет в ваш проект. В консоли вы должны увидеть следующее:

flutter packages get 
Running "flutter packages get" in startup_namer... 
Process finished with exit code 0

При выполнении Pub get также автоматически генерируется файл pubspec.lock со списком всех пакетов, подключенных к проекту, и их номерами версий.

Внимание: для некоторых версий Firebase при первой инициализации класса FirebaseAnalytics отображается java.lang.IllegalArgumentException: Service not registered (см. проблему 1662 на GitHub) .

В lib/main.dart импортируйте новый пакет:

import 'package:firebase_analytics/firebase_analytics.dart';

В классе MyApp инициализируйте объект FirebaseAnalytics , вызвав конструктор.

class MyApp extends StatelessWidget {
 static FirebaseAnalytics analytics = FirebaseAnalytics();
   ...
}

Теперь вы готовы запускать пользовательские журналы событий!

6. Регистрируйте пользовательские события с помощью Firebase Analytics.

Если бы вы создали новый шаблон в приложении Flutter, вы бы увидели переменную _counter и метод _incrementCounter() внутри класса State по умолчанию. Теперь вам нужно регистрировать пользовательские события, когда кнопка увеличения счетчика нажимается более пяти раз чрезмерно активными пользователями. Позже мы запустим рекламную кампанию приложения, чтобы привлечь потенциальных активных пользователей.

Во-первых, мы хотим передать инициализированные нами аналитические объекты виджету Stateful . Для начала добавим параметр analytics в конструктор MyHomePage .

MyHomePage({Key key, this.title, this.analytics}) : super(key: key);

При вызове конструктора вам также потребуется добавить параметр аналитики.

home: MyHomePage(
   title: 'Flutter Demo Home Page',
   analytics: analytics,
),

Теперь вы можете легко регистрировать события с помощью метода logEvent() . Добавьте этот метод и увеличьте значение переменной _counter .

void _incrementCounter() {
 setState(() {
   _counter++;

   //add this
   if(_counter > 5) { 
     widget.analytics.logEvent(name: "clicked_counter"); 
   }

 });
}

Теперь ваше приложение готово к запуску записи в пользовательский журнал событий!

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

Теперь всё готово. В Android Studio запустите файл "main.dart".

(Необязательно) Отправка дополнительной информации в Firebase Analytics с использованием параметров.

Вы можете передавать дополнительную информацию через параметры. Пользовательские параметры можно зарегистрировать для формирования отчетов в вашей системе аналитики . Их также можно использовать в качестве фильтров в определениях аудитории , которые применяются к каждому отчету. Если ваше приложение связано с проектом BigQuery, пользовательские параметры также доступны в BigQuery (см. Экспорт BigQuery для Firebase ).

Здесь мы задаем значение _counter в качестве параметра.

void _incrementCounter() {
 setState(() {
   _counter++;

   if(_counter > 5) {
     widget.analytics.logEvent(name: "clicked_counter", parameters: {'count' : _counter});
   }
 });
}

Проверка и отладка событий

Через несколько часов вы сможете увидеть зарегистрированные события в консоли Firebase. Просто перейдите на вкладку «События» в разделе «Аналитика» в консоли Firebase. Вы также можете проверить значения внутри события clicked_counter , просто щелкнув по событию.

Отметьте clicked_counter как конверсию, переместив переключатель «Отметить как конверсию» вправо.

Если событие находится на вкладке «Конверсии», значит, вы успешно отметили его как конверсию. Теперь Google Ads сможет импортировать это событие из Firebase.

Для отладки используйте Firebase DebugView. Дополнительные сведения см. в разделе «События отладки» .

7. Импорт аналитических событий в Google Ads

После завершения настройки Firebase-Flutter вы готовы запустить рекламные кампании приложения с событиями действий. Начните с привязки Firebase к Google Ads . Благодаря привязке Firebase к Google Ads, рекламные кампании приложения смогут импортировать события Firebase. Этот процесс также помогает Google Ads повысить эффективность рекламных кампаний приложения, позволяя ему получать больше информации о целевой аудитории.

1. Перейдите в настройки Firebase, нажав кнопку рядом с разделом «Обзор проекта» .
2. На вкладке «Интеграции» вы увидите Google Ads и кнопку «Ссылка» . Нажмите «Ссылка» , а затем нажмите «Продолжить» .

3. Выберите аккаунт Google Ads.

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

Теперь работа с Firebase завершена.

Перейдите в Google Ads .

1. Войдите в систему и перейдите в раздел Инструменты и настройки > Измерение > Конверсии , чтобы импортировать пользовательские события в качестве конверсий.
2. Нажмите кнопку «+» , чтобы добавить новые действия по конверсии.

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

4. Вы можете увидеть все аналитические события, помеченные как конверсии. Найдите событие clicked_counter , которое мы реализовали ранее.

5. Выберите нужное действие, нажмите «Импорт», а затем нажмите «Продолжить» .

После установки clicked_counter в качестве действия конверсии вы можете запускать кампании, ориентированные на пользователей, которые с высокой вероятностью совершат более 5 событий clicked_counter .

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

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

6. Перейдите на вкладку «Кампании» в вашем текущем аккаунте и начните новую кампанию, нажав кнопку «+» . Нажмите [Новая кампания] , а затем нажмите « Продолжить» .
7. Запустите рекламную кампанию приложения с помощью опции «Установка приложения» .

8. Найдите своё приложение, введя название приложения, имя пакета или имя издателя.
9. В разделе «Торги» выберите «Действия в приложении» в выпадающем меню.
10. Найдите своё пользовательское событие в предоставленном списке. Установите целевую стоимость за действие и заполните все дополнительные поля.

11. Завершите настройку кампании.

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

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

Вы узнали

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