Настройка Firefly
Firefly — рекламная сеть, интегрированная с Adjust. Интеграция с нашей системой позволяет передавать в Firefly данные об атрибуции и событиях в приложении посредством автоматических колбэков.
Из этой статьи вы узнаете, как настроить измерение с помощью Firefly для вашего приложения. Речь пойдет об активации интеграции, создании ссылки на кампанию и выборе данных, которые Adjust может передавать Firefly.
Перед началом работы
Требования
- Доступ к администрированию, редактированию или настраиваемый доступ к редактированию в Adjust.
- Adjust SDK версии 4.0.0 и более поздних версий для сопоставления параметров SDK с параметрами Firefly. Для использования этой функции следуйте приведенным ниже инструкциям.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Учетные данные
Firefly Account Id
- Чтобы узнать, как найти ваши учетные данные, обратитесь к своему представителю Firefly.
Выберите Firefly и свое приложение в Campaign Lab
- В разделе Campaign Lab выберите Партнеры .
- Выберите Новый партнер > Firefly . Выберите Далее , чтобы перейти к следующему экрану.
- На экране Выбор приложения выберите приложение, для которого вы хотите создать ссылку и включите интеграцию, чтобы поделиться данными с Firefly.
- Нажмите Далее .
Включение обмена данными
Включите обмен данными, чтобы активировать интеграцию с Firefly. Чтобы включить обмен данными:
- Введите Firefly Account Id.
После включения обмена данными с Firefly, Adjust автоматически отправляет Firefly следующие данные (по умолчанию).
- установка
- удаление приложения
- переустановка
- реатрибуция
- событие
- rejectedInstall
- rejectedReattribution
Настройте параметры обмена данными
При работе с мультиплатформенными приложениями с возможностью совместного использования данных для нескольких платформ вы можете:
- Разделить параметры обмена данными на уровне платформы, выбрав Использовать настройки для определенной платформы .
- Установить одинаковые настройки обмена данными для нескольких платформ, выбрав Использовать глобальные настройки .
В разделе К чему будет предоставлен доступ? отметьте действия, которые Adjust будет передавать Firefly по умолчанию.
- установка
- удаление приложения
- переустановка
- реатрибуция
- событие
- rejectedInstall
- rejectedReattribution
Отправка дополнительных данных
Выберите объем и тип данных для передачи Firefly посредством колбэков. Firefly может использовать эту информацию для оптимизации производительности.
- В разделе Какими источниками данных вы хотите поделиться? выберите источник атрибуции данных, которые вы хотите передавать Firefly:
- Данные из всех источников атрибуции
- Только данные, атрибутированные партнеру Firefly
Удаления или повторные установки
Передача данных об удалениях и переустановках позволяет Firefly получать данные об удалениях и переустановках вашего приложения, измеренные Adjust.
Для приложений под управлением iOS можно ожидать небольшого количества удалений и/или переустановок. Дополнительные сведения см. в разделе Оценка удалений и переустановок.
Сопоставление событий
Сопоставьте события, которые хотите передавать, со значениями, которые Firefly может получать. Данные событий, которые вы не сопоставили, не могут быть переданы Firefly.
Составить отдельные события
Если у вас мультиплатформенное приложение, вы можете выбрать разные события для каждой платформы и поделиться ими Firefly. Это позволяет вам:
- настроить отдельные события для управления стратегиями кампаний для каждой платформы;
- настроить обмен данными для каждой платформы.
В разделе Сопоставление событий выполните следующие действия, чтобы выбрать события в приложении, данные о которых следует передавать Firefly:
Выберите Сопоставить событие .
В списке Событие Adjust выберите событие Adjust, которым вы хотите поделиться с Firefly.
В разделе «Событие партнера» необходимо выбрать событие Firefly, соответствующее событию Adjust.
Для одноплатформенных и многоплатформенных приложений, в которых обмен данными включен только для одной платформы, выполняется сопоставление событий только для этой платформы. Для мультиплатформенных приложений с возможностью совместного использования данных для нескольких платформ вы можете:
- Нажмите «Использовать сопоставление конкретной платформы» , чтобы сопоставить отдельные события на уровне платформы или не сопоставлять события для определенных платформ.
- Нажмите «Использовать глобальное сопоставление» , чтобы отобразить одни и те же события для всех платформ.
В списке Событие партнера выберите или введите имя настраиваемого события, которое нужно сопоставить с событием Adjust.
Нажмите Применить .
Теперь Firefly будет получать данные о событии в приложении по каждому связанному событию.
Сопоставить все события
Если Firefly поддерживает автоматическое сопоставление всех событий, в разделе «Сопоставление событий» нажмите «Сопоставить все события». Это экономит время при сопоставлении отдельных событий.
Теперь Firefly будет получать данные о событии в приложении по каждому из ваших связанных событий.
Сконфигурируйте ссылки и настройки
Вы можете настроить следующие параметры:
Создайте ссылку и поделитесь ей с Firefly
На экране Проверка настройки вы можете просмотреть выбранные варианты. Вы можете вернуться и внести изменения в следующие настройки:
- Выбранное приложение
- Параметры обмена данными
- Параметры структуры ссылки
- Места назначения пользователей
- Настройки атрибуции
Нажмите Создать ссылку , чтобы создать URL клика, URL показа, QR-код и токен ссылки. При создании ссылки также включается обмен данными и интеграция с Firefly.
После того как ссылка создана, поделитесь ей с Firefly для размещения в кампании.
Список всех параметров, передаваемых Firefly
Firefly требует от Adjust отправлять следующие параметры (точки данных) вместе с колбэками:
Плейсхолдер | Информация |
{adid} | Идентификатор устройства Adjust (все платформы) |
{city} | Город, в котором используется устройство |
{cost_amount} | Стоимость вовлечения пользователя (доступна только для отслеживания расходов на рекламу) |
{cost_currency} | Валютный код ISO 4217 для данных о расходах (доступен только для отслеживания расходов на рекламу) |
{cost_type} | Модель ценообразования кампании (доступна только для отслеживания расходов на рекламу) |
{country_subdivision} | Регион, в котором находится устройство, например штат или область |
{country} | Код страны устройства из двух символов |
{device_name} | Номер модели устройства |
{device_type} | Тип устройства |
{fire_adid} | Рекламный идентификатор Fire OS |
{gps_adid} | Рекламный идентификатор магазина Google Play |
{idfa||android_id} | IDFA или Android ID, если IDFA пуст |
{idfv} | Идентификатор поставщика iOS, в верхнем регистре |
{ip_address} | IP-адрес устройства |
{language} | Код языка устройства из двух символов |
{os_name} | Операционная система устройства |
{os_version} | Номер версии операционной системы |
{postal_code} | Почтовый индекс по IP-адресу устройства |
{region} | Региональный код устройства |
{user_agent} | Входящий необработанный user agent |
{win_udid} | Уникальный идентификатор устройства на Windows Phone |
{activity_kind} | Тип действия пользователя |
{app_id} | Идентификатор App Store или Google Play Store |
{app_name} | Имя приложения |
{app_version} | Номер версии приложения (Android), номер версии сборки пакета (iOS) |
{campaign_name} | Название кампании (согласно трекеру) |
{created_at} | Временная отметка действия |
{device_manufacturer} | Название производителя устройства |
{installed_at} | Временная отметка установки (т. е. первого открытия приложения) |
{tracker_name} | Текущее название трекера |