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

Настройка Firefly

Firefly — рекламная сеть, интегрированная с Adjust. Интеграция с нашей системой позволяет передавать в Firefly данные об атрибуции и событиях в приложении посредством автоматических колбэков.

Из этой статьи вы узнаете, как настроить измерение с помощью Firefly для вашего приложения. Речь пойдет об активации интеграции, создании ссылки на кампанию и выборе данных, которые Adjust может передавать Firefly.

Перед началом работы

Требования

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Учетные данные

Firefly Account Id

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

Выберите Firefly и свое приложение в Campaign Lab

  1. В разделе Campaign Lab выберите Партнеры .
  2. Выберите Новый партнер > Firefly . Выберите Далее , чтобы перейти к следующему экрану.
  3. На экране Выбор приложения выберите приложение, для которого вы хотите создать ссылку и включите интеграцию, чтобы поделиться данными с Firefly.
  4. Нажмите Далее .

Включение обмена данными

Включите обмен данными, чтобы активировать интеграцию с Firefly. Чтобы включить обмен данными:

  1. Введите Firefly Account Id.

После включения обмена данными с Firefly, Adjust автоматически отправляет Firefly следующие данные (по умолчанию).

  • установка
  • удаление приложения
  • переустановка
  • реатрибуция
  • событие
  • rejectedInstall
  • rejectedReattribution

Настройте параметры обмена данными

При работе с мультиплатформенными приложениями с возможностью совместного использования данных для нескольких платформ вы можете:

  1. Разделить параметры обмена данными на уровне платформы, выбрав Использовать настройки для определенной платформы .
  2. Установить одинаковые настройки обмена данными для нескольких платформ, выбрав Использовать глобальные настройки .

В разделе К чему будет предоставлен доступ? отметьте действия, которые Adjust будет передавать Firefly по умолчанию.

  • установка
  • удаление приложения
  • переустановка
  • реатрибуция
  • событие
  • rejectedInstall
  • rejectedReattribution

Отправка дополнительных данных

Выберите объем и тип данных для передачи Firefly посредством колбэков. Firefly может использовать эту информацию для оптимизации производительности.

  1. В разделе Какими источниками данных вы хотите поделиться? выберите источник атрибуции данных, которые вы хотите передавать Firefly:
  • Данные из всех источников атрибуции
  • Только данные, атрибутированные партнеру Firefly

Удаления или повторные установки

Передача данных об удалениях и переустановках позволяет Firefly получать данные об удалениях и переустановках вашего приложения, измеренные Adjust.

Примечание:

Для приложений под управлением iOS можно ожидать небольшого количества удалений и/или переустановок. Дополнительные сведения см. в разделе Оценка удалений и переустановок.

Сопоставление событий

Сопоставьте события, которые хотите передавать, со значениями, которые Firefly может получать. Данные событий, которые вы не сопоставили, не могут быть переданы Firefly.

Составить отдельные события

Если у вас мультиплатформенное приложение, вы можете выбрать разные события для каждой платформы и поделиться ими Firefly. Это позволяет вам:

  • настроить отдельные события для управления стратегиями кампаний для каждой платформы;
  • настроить обмен данными для каждой платформы.

В разделе Сопоставление событий выполните следующие действия, чтобы выбрать события в приложении, данные о которых следует передавать Firefly:

  1. Выберите Сопоставить событие .

  2. В списке Событие Adjust выберите событие Adjust, которым вы хотите поделиться с Firefly.

  3. В разделе «Событие партнера» необходимо выбрать событие Firefly, соответствующее событию Adjust.

    1. Для одноплатформенных и многоплатформенных приложений, в которых обмен данными включен только для одной платформы, выполняется сопоставление событий только для этой платформы. Для мультиплатформенных приложений с возможностью совместного использования данных для нескольких платформ вы можете:

      • Нажмите «Использовать сопоставление конкретной платформы» , чтобы сопоставить отдельные события на уровне платформы или не сопоставлять события для определенных платформ.
      • Нажмите «Использовать глобальное сопоставление» , чтобы отобразить одни и те же события для всех платформ.
    2. В списке Событие партнера выберите или введите имя настраиваемого события, которое нужно сопоставить с событием Adjust.

  4. Нажмите Применить .

Теперь 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}Текущее название трекера