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

1. Введение

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

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

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

В рамках этой лаборатории вы сможете ознакомиться со всем процессом бизнеса приложений, с которым сталкиваются наши клиенты. Если вы хотите более подробно познакомиться с Firebase и Admob на iOS, начните с AdMob+Firebase 101 Unity: основы настройки и аналитики .

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

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

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

• Xcode
• Единство
• Аккаунт Firebase
• Аккаунт Google Рекламы

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

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

Запустить Unity

1. Если у вас нет открытых проектов, выберите «Создать новый проект».
2. Выберите 3D-шаблоны в диалоговом окне.
3. Заполните имя проекта: например, «Пользовательское событие Unity Firebase».
4. Выберите место для сохранения проекта и нажмите СОЗДАТЬ.
5. Unity открывает новый проект в окне рабочей области.

3. Создайте и настройте проект 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. Конфигурация Юнити

1. В Unity > Файл > Настройки сборки. Важным значением является установка идентификатора пакета iOS, который вы получите, выполнив следующий шаг.

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

2. В проекте Unity для приложения iOS откройте диалоговое окно «Настройки сборки», «Файл» > «Настройки сборки» (если для платформы не установлена ​​iOS, вы можете выбрать «Платформа iOS» и нажать кнопку «Переключить платформу »).

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

5. Настройте Firebase Analytics в Unity

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

1. Перейдите в консоль Firebase .
2. В центре страницы обзора проекта щелкните значок Unity ( ), чтобы запустить рабочий процесс установки. Если вы уже добавили приложение в свой проект Firebase, нажмите «Добавить приложение» , чтобы отобразить параметры платформы.
3. Выберите цель сборки вашего проекта Unity, которую вы хотите зарегистрировать, или вы даже можете выбрать регистрацию обеих целей одновременно.

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

4. Введите идентификаторы платформы вашего проекта Unity.

• Для iOS — введите идентификатор iOS вашего проекта Unity в поле «Идентификатор пакета iOS» .
• Для Android — введите Android ID вашего проекта Unity в поле имени пакета Android . Термины «имя пакета» и «идентификатор приложения» часто используются как взаимозаменяемые.

5. Где найти идентификатор вашего проекта Unity?

Примечание. Убедитесь, что вы вводите идентификатор, который фактически использует ваш проект. Значение идентификатора чувствительно к регистру, и его нельзя изменить для этих приложений Firebase после того, как они зарегистрированы в вашем проекте Firebase.

6. (Необязательно) Введите псевдонимы для конкретной платформы вашего проекта Unity. Эти псевдонимы являются внутренними удобными идентификаторами и видны только вам в консоли Firebase.
7. Нажмите Зарегистрировать приложение .

Добавьте SDK Firebase Analytics Unity

1. В консоли Firebase нажмите «Загрузить Firebase Unity SDK» , затем разархивируйте SDK в удобное место.

• Вы можете снова загрузить Firebase Unity SDK в любое время.
• Firebase Unity SDK не зависит от платформы.

2. В открытом проекте Unity перейдите в Assets > Import Package > Custom Package .
3. В разархивированном SDK выберите поддерживаемые продукты Firebase , которые вы хотите использовать в своем приложении.

• Добавьте пакет Firebase для Google Analytics: FirebaseAnalytics.unitypackage.
• Добавьте пакеты для любых других продуктов Firebase, которые вы хотите использовать в своем приложении. Например, чтобы использовать аутентификацию Firebase и базу данных Firebase Realtime: FirebaseAuth.unitypackage и FirebaseDatabase.unitypackage.

Unity 5.x и более ранние версии используют платформу .NET 3.x, поэтому импортируйте пакет dotnet3/ . Unity 2017.x и более поздние версии позволяют использовать платформу .NET 4.x. Если в вашем проекте Unity используется .NET 4.x, импортируйте пакет dotnet4/ . Unity 2019 и более поздних версий больше не поддерживает платформу .NET 3.x, поэтому импортируйте пакет dotnet4/ .

4. В окне «Импорт пакета Unity» нажмите «Импорт» .
5. Вернувшись в консоль Firebase, в рабочем процессе установки нажмите «Далее» .

Важно! При использовании Firebase Unity SDK для iOS не отключайте метод swizzling . SDK требует Swizzling; без него ключевые функции Firebase (например, обработка токенов FCM) не будут работать должным образом.

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

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

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

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

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

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

Просмотр событий в консоли отладки 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 с Unity и Google Ads! Это поможет вам повысить эффективность вашей кампании.

Вы узнали

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

Справочная документация

• Добавьте Firebase в свой проект Unity
• Github: firebase/quickstart-unity