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

1. Введение

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

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

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

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

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

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

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

• Xcode
• Аккаунт Firebase
• Аккаунт Google Рекламы

2. Запустите новый проект iOS Swift.

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

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

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

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

2. Команда: если это поле не заполняется автоматически, установите для команды значение Нет.
3. Название организации: название вашей организации или ваше собственное имя.
4. Идентификатор пакета: это значение генерируется автоматически на основе названия вашего продукта и идентификатора организации.
5. Язык: Свифт
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. Значением поля Bundle Identifier является идентификатор пакета 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. Создайте подфайл, если у вас его нет:

$ pod init

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

$ 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 выберите «Продукт» > «Схема» > «Редактировать схему»...
2. Выберите «Выполнить» в меню слева.
3. Выберите вкладку Аргументы .
4. В разделе «Аргументы, передаваемые при запуске» добавьте -FIRAnalyticsDebugEnabled.

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

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

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

Вы пометите «text_search» как конверсию, сдвинув переключатель «Отметить как конверсию» вправо.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вы узнали

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