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

1. Введение

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

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

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

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

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

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

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

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

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

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

Запуск Unity

1. Если у вас нет открытых проектов, выберите «Создать новый проект».
2. Выберите 3D-шаблоны в диалоговом окне.
3. Укажите название проекта: например, Unity Firebase Custom Event.
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. Конфигурация Unity

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

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

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

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

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

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

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

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

4. Введите идентификатор(ы) вашего проекта Unity, специфичный(е) для вашей платформы.

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

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

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

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

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

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

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

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

• Добавьте пакет Firebase для Google Analytics: FirebaseAnalytics.unitypackage
• Добавьте пакеты для любых других продуктов Firebase, которые вы хотите использовать в своем приложении. Например, для использования Firebase Authentication и Firebase Realtime Database: 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 не отключайте подмену методов . Подмена методов необходима для работы SDK; без нее ключевые функции Firebase (например, обработка токенов FCM) не будут работать должным образом.

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

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

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

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

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

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

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

Вы узнали

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

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

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