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

1. Введение

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

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

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

В этом практическом занятии вы сможете пройти весь процесс разработки приложений, с которым сталкиваются наши клиенты. Если вы хотите получить более простое введение в Firebase iOS, начните с Firebase iOS Codelab Swift.

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

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

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

• Xcode
• Учетная запись Firebase
• Аккаунт Google Ads

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

Создайте простое шаблонное iOS-приложение на Swift. Вы можете модифицировать это стартовое приложение, чтобы создать готовое приложение.

Сначала запустите Xcode.

1. Если у вас нет открытых проектов, выберите «Создать новый проект Xcode» на главной странице.
2. В верхней части диалогового окна выберите iOS.
3. В разделе «Приложение» выберите «Приложение», а затем нажмите «Далее».
4. В появившемся диалоговом окне укажите следующие значения для названия вашего приложения, выберите дополнительные параметры для проекта и нажмите «Далее»:
5. Название продукта: например, приложение для iOS

Xcode использует введенное вами название продукта для именования вашего проекта и приложения.

2. Команда: Если это поле не заполняется автоматически, установите для команды значение «Нет».
3. Название организации: Название вашей организации или ваше собственное имя.
4. Идентификатор пакета: это значение генерируется автоматически на основе названия вашего продукта и идентификатора организации.
5. Язык: Swift
6. Выберите место для сохранения проекта и нажмите «Создать».
7. Xcode открывает ваш новый проект в окне рабочей области.

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

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

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

Если у вас есть существующий проект Firebase, в котором не включена Google Analytics, вы можете включить Google Analytics на вкладке «Интеграции» в настройках > Настройки проекта. Перейдите к шагу настройки Firebase.

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

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

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

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

4. Настройка Firebase

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

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

2. Важно указать идентификатор пакета iOS, который вы получите на следующем шаге.
3. В проекте Xcode для iOS-приложения выберите приложение верхнего уровня в навигаторе проекта, затем перейдите на вкладку «Общие».
4. Значение поля «Идентификатор пакета» — это идентификатор пакета iOS (например, com.yourcompany.yourproject ). Скопируйте это значение.
5. В диалоговом окне Firebase вставьте скопированный идентификатор пакета в поле « iOS bundle ID .
6. Нажмите «Зарегистрировать приложение» .
7. Продолжая работу в Firebase, следуйте инструкциям для загрузки файла конфигурации GoogleService-Info.plist

8. Перейдите в свой проект Xcode, затем переместите файл GoogleService-Info.plist (который вы только что скачали) в корневую папку вашего проекта Xcode.
9. Пропустите оставшиеся шаги и вернитесь на главную страницу консоли Firebase.

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

На этом шаге вы начнете добавлять Firebase SDK в свой проект Xcode.

Примечание: сервисы Google используют CocoaPods для установки и управления зависимостями. Если вы никогда раньше не использовали CocoaPods, вам сначала необходимо установить его, выполнив следующую команду в терминале:

$ sudo gem install cocoapods

1. Откройте окно терминала и перейдите в папку, где находится проект Xcode для вашего приложения.
2. Если у вас его нет, создайте файл Podfile:

$ pod init

3. Откройте свой Podfile и добавьте:

$ vi Podfile

$ pod 'Firebase/Analytics'

4. Сохраните файл и запустите:

$ pod install

5. Добавьте код инициализации:

Чтобы подключить Firebase при запуске приложения, добавьте приведенный ниже код инициализации в основной класс AppDelegate.

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}

6. Всё готово! Продолжайте утешать.

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

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

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

Firebase Analytics автоматически регистрирует некоторые события ; вам не нужно добавлять какой-либо код для их получения. Если вашему приложению необходимо собирать дополнительные данные, вы можете регистрировать до 500 различных типов пользовательских событий Analytics в своем приложении.

Журнал событий

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

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

Задайте параметры события по умолчанию.

С помощью функции setDefaultEventParameters можно регистрировать параметры для всех событий. Параметры по умолчанию связаны со всеми будущими событиями, которые будут регистрироваться.

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Просмотр событий в консоли отладки Xcode.

Вы можете включить подробное логирование, чтобы отслеживать события, регистрируемые SDK, и убедиться в правильности их регистрации. Это касается как автоматически, так и вручную регистрируемых событий.

Включить подробное логирование можно следующим образом:

1. В Xcode выберите Product > Scheme > Edit scheme...
2. Выберите пункт «Выполнить» в меню слева.
3. Выберите вкладку «Аргументы» .
4. В разделе «Аргументы, передаваемые при запуске» добавьте -FIRAnalyticsDebugEnabled.

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

Просматривайте события на панели управления.

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

Чтобы отметить «текстовый поиск» как конверсию, переместите переключатель «отметить как конверсию» вправо.

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

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

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

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

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

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

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

Теперь перейдите на сайт Google Ads и войдите в свой аккаунт.

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

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

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

5. Установите флажок и нажмите кнопку «Импорт и продолжить».

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

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

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

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

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

11. Настройка параметров кампании. Это выходит за рамки данного семинара, поэтому обратитесь к этим документам или свяжитесь с нами другими способами для оптимизации настроек.

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

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

Вы установили скрипт, создали и подготовили новый список изменений для Codelab, обновили и подготовили ожидающий список изменений для Codelab, проверили и утвердили список изменений для Codelab, а также отправили и опубликовали список изменений для Codelab.

Вы узнали

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