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

1. Введение

Последнее обновление: 25 января 2021 г.

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

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

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

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

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

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

• Android Studio 3.6 или выше
• Xcode (для поддержки iOS)
• Аккаунт Firebase
• Аккаунт Google Рекламы

2. Начните новый проект Flutter.

Создайте простое шаблонное приложение Flutter. Вы измените это начальное приложение для этой лаборатории кода.

Запустите Android-студию.

Примечание. Если вы не видите опцию «Новый проект Flutter» в своей IDE, убедитесь, что у вас установлены плагины для 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

Просматривая pubspec в редакторе Android Studio, нажмите Packages get . Это вставит пакет в ваш проект. В консоли вы должны увидеть следующее:

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 . Начнем с добавления параметра аналитики в конструктор 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-студии запустите «main.dart».

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

Вы можете отправить дополнительную информацию через параметры. Пользовательские параметры можно зарегистрировать для отчетов в отчетах Google 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 Реклама теперь сможет импортировать это событие из Firebase.

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

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

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

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

3. Выберите аккаунт Google Рекламы.

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

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

Зайдите в Google Рекламу .

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

3. Выберите ресурсы Google Аналитики 4 (Firebase) и нажмите Продолжить .

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

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

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

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

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

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

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

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

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

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

Вы узнали

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