Настройте API затрат ROI360 для измерения данных о затратах

Краткий обзор: Получайте совокупные данные о затратах на маркетинг (включая показатели эффективности LTV, связанные с затратами) с использованием API затрат на уровне приложения или аккаунта медиаисточника.

Обзор

ROI360 обеспечивает измерение затрат как на уровне приложения, так и на уровне аккаунта, позволяя заинтересованным сторонам анализировать детализацию расходов для каждого отдельного приложения или всего аккаунта медиа-источника.

Интеграция затрат управляется в двух разных местах в зависимости от медиа-источника:

  • Интеграция на уровне аккаунта регулируется в Настройках затрат. Эти интеграции настроены на уровне рекламного аккаунта. См. также список поддерживаемых рекламных сетей.
  • Интеграция на уровне приложения регулируется на вкладке «Затраты». Эти интеграции настраиваются отдельно для каждого приложения. Если медиаисточник недоступен в Настройках затрат, настройте его интеграцию затрат на вкладке Затраты на уровне приложения.

 Примечание

Доступ к «Настройкам затрат» регулируется с помощью разрешений ролей. Если у вас нет доступа к Настройкам затрат, попросите администратора изменить разрешения для вашей роли на странице Управление пользователями. Для этого необходимо перейти к Подключению затрат.

Включение API затрат

Существует два способа активации интеграции затрат: на уровне приложения и аккаунта.

Включение интеграции затрат на уровне приложения (вкладка «Затраты»)

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

  1. В AppsFlyer в боковом меню выберите Сотрудничество > Активные интеграции и выберите партнёра.
  2. Нажмите Управление интеграцией.
  3. Откройте вкладку Затраты интегрированного партнёра.
  4. Включите параметр Получить данные по затратам. Отображаются требования к подключению к партнёру.
  5. Настройте и аутентифицируйте подключение затрат к партнёру. Способ аутентификации зависит от медиаисточника. Методы интеграции затрат см. ниже.
  6. Если в настройках затрат партнёра есть сопоставление идентификаторов сайтов, выберите нужную конфигурацию из выпадающего списка. См. сопоставление идентификаторов сайта ниже.
  7. Нажмите Сохранить затраты.
    • Данные о затратах начнут отображаться на ваших дэшбордах в течение 5–6 часов.
    • AppsFlyer собирает данные от партнёров 6 раз в день, в среднем каждые четыре часа.
    • Аккаунт медиаисточника в разделе Настройки затрат обновляется в соответствии с вашими действиями на уровне приложения на вкладке Стоимость.

Включение интеграции затрат на уровне аккаунта (настройка затрат)

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

Как активировать интеграцию затрат на уровне аккаунта:

  1. В AppsFlyer в боковом меню откройте Настройки > ROI360 > Настройки дохода.
  2. Выберите медиаисточник для получения данных о затратах и нажмите Далее.
  3. Настройте и аутентифицируйте подключение затрат к медиаисточнику. Способ аутентификации зависит от медиаисточника. Методы интеграции затрат см. ниже.
  4. Введите (или настройте) название интеграции затрат.
  5. Выберите приложения для включения в эту интеграцию затрат.
  6. Нажмите Сохранить интеграцию.
    • Данные о затратах начнут отображаться на ваших дэшбордах в течение 5–6 часов.
    • AppsFlyer собирает данные от медиаисточника 6 раз в день, в среднем каждые четыре часа.
    • Обновления на уровне аккаунта в Настройках затрат автоматически применяются ко вкладке Затраты в Активной интеграции для соответствующих приложений и медиаисточников.

 Примечание

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

Методы интеграции затрат

Способ включения интеграции затрат зависит от режима интеграции медиаисточника с AppsFlyer. Это может быть один из следующих:

  • Вход в систему: нажмите Войти в <Медиаисточник>, чтобы открыть окно входа в медиаисточник. Затем следуйте подсказкам для входа в медиаисточник.
  • Учётные данные: введите значения параметров для конкретного медиаисточника, например, API Key.
  • Отсутствует: конфигурация подключения не требуется, за исключением активации переключателя Получать данные о затратах, как указано выше.

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

Сопоставление идентификаторов сайтов

Некоторые партнёрские интеграции позволяют выбирать способ заполнения поля идентификатора сайта при формировании отчётности по данным о затратах. Это гарантирует, что макрос ссылки атрибуции AppsFlyer site-id соответствует ожидаемому медиаисточником значению.

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

Чтобы настроить сопоставление идентификаторов сайта на уровне приложения, выполните следующие действия:

  1. На вкладке Затраты интегрированного партнёра перейдите в раздел Сопоставление идентификаторов сайтов и выберите конфигурацию из выпадающего меню.
  2. Нажмите Сохранить затраты. Изменения вступают в силу со следующего дня по всемирному координированному времени (UTC).

Удаление интеграций затрат

Вы можете удалить интеграцию затрат как на уровне приложения, так и на уровне аккаунта. После удаления AppsFlyer больше не сможет извлекать данные о затратах из этого аккаунта. Удаление интеграции не влияет на исторические данные.

Удаление интеграции затрат на уровне приложения (вкладка «Затраты»)

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

Как удалить интеграцию затрат на уровне приложения:

  1. В AppsFlyer в боковом меню выберите Сотрудничество > Активные интеграции.
  2. Выберите интегрированного партнёра, например, Meta Ads.
  3. Нажмите Управление интеграцией.
  4. Откройте вкладку Затраты. Отобразится список подключённых аккаунтов.
  5. В столбце Действия наведите курсор на аккаунт и нажмите Удалить подключение.
  6. В ответ на запрос подтверждения нажмите Да, удалить.

Интеграция затрат, ранее настроенная на уровне приложения, была удалена как на уровне приложения, так и на уровне аккаунта. В результате сбор данных о затратах прекращается немедленно. Это изменение не повлияет на уже собранные исторические данные о затратах.

Удаление интеграции затрат на уровне аккаунта (настройка затрат)

Как удалить интеграцию затрат на уровне аккаунта:

  1. В AppsFlyer в боковом меню выберите Настройки > ROI360 > Настройки затрат и выберите медиаисточник, из которого нужно удалить интеграцию.
  2. В списке интеграций для каждого медиаисточника нажмите delete.jpeg в записи об интеграции.
  3. В ответ на запрос подтверждения нажмите Да, удалить.

Интеграция затрат, ранее настроенная на уровне аккаунта, была удалена как на уровне приложения, так и на уровне аккаунта. В результате сбор данных о затратах прекращается немедленно. Это изменение не повлияет на уже собранные исторические данные о затратах.

Отключение API затрат

Отключение API затрат доступно только на уровне приложения.

Чтобы отключить API затрат, выполните следующие действия:

  1. Перейдите в раздел Активные интеграции и выберите медиаисточник.
  2. Перейдите на вкладку Затраты.
  3. Выключите параметр Получить данные по затратам.
  4. Нажмите Сохранить затраты.

 Примечание

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

Статус API затрат

Операционный статус интеграций затрат доступен следующим образом:

Просмотр статуса интеграции затрат на медиаисточники (вкладка «Затраты»)

Вкладка Затраты на странице Активная интеграция с медиаисточником (актуально для медиаисточников, поддерживающих получение данных о затратах через API) отображает:

  • Статус интеграции затрат выбранного приложения.
  • В последний раз, когда AppsFlyer успешно извлёк соответствующие данные о затратах для приложения.

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

  1. В AppsFlyer в боковом меню выберите Сотрудничество > Активные интеграции.
  2. Выберите медиаисточник.
  3. На странице Активная интеграция медиаисточника в списке приложений над панелью вкладок выберите приложение, статус затрат которого вы хотите посмотреть.
  4. Перейдите на вкладку Затраты. Будут показаны статус и время последней синхронизации.

Просмотр статуса интеграции агрегированных затрат на медиаисточники (настройка затрат)

Чтобы просмотреть статус интеграции агрегированных затрат на медиаисточники, выполните следующие действия:

  1. В AppsFlyer в боковом меню выберите Настройки > ROI360 > Настройки затрат.
  2. Выберите соответствующий медиаисточник.
  3. На странице медиаисточника в столбце Статус можно посмотреть состояние аккаунта медиаисточника. Этот статус отображается, если все приложения, связанные с аккаунтом, имеют одинаковый статус. Если статусы приложений различаются, статус отображается как Смешанный статус.
  4. Чтобы просмотреть статус конкретного приложения, связанного с аккаунтом медиаисточника, нажмите на строку аккаунта медиаисточника и отобразите страницу интеграции затрат.
  5. Просмотрите статус приложения в списке приложений, связанных с медиаисточником.

Таблица статусов

Статус Замечания/необходимые действия
Активно Интеграция активирована и успешно подключена к медиаисточнику.
API не возвращает соответствующие данные о затратах Это может произойти потому, что:
• Идентификатор кампании не был предоставлен, поэтому затраты не могут быть соотнесены с кампаниями.

• Вы интегрировали другой рекламный аккаунт партнёра при входе в систему партнёра через AppsFlyer (например, другой аккаунт Meta Ads). Проверьте, что вы подключили нужный рекламный аккаунт партнёра.

• Одно из полей с учётными данными в интеграции затрат партнёра является некорректным. Например, идентификатор пакета. Просмотрите и исправьте учётные данные интеграции.

• Ваши кампании приостановлены, и данные отсутствуют.
API партнёра не отвечает • Сервер интегрированного партнёра не отвечает на запросы AppsFlyer.
• Подождите 6 часов. Если сообщение о статусе не изменится, обратитесь в службу поддержки AppsFlyer.
Недействительные учётные данные. • AppsFlyer не может получить данные через API, так как учётные данные не действительны.
• Повторно подключитесь, используя правильные учётные данные.
Свяжитесь со своим менеджером в рекламной сети, чтобы получить доступ к API отчётности. Совместно с менеджером партнёра включите интеграцию затрат в системе партнёра.
API партнёра не возвращает данные. Проверьте интеграцию. Это происходит, потому что:
• Ваши кампании приостановлены, и данные отсутствуют.
Ваш аккаунт не активирован в системе партнёра для получения данных о затратах. Свяжитесь с партнёром.
Смешанный статус Статус отображается здесь: Настройки затрат > Медиаисточник только в том случае, если связанные приложения имеют разные статусы. На странице Медиаисточник откройте страницу Интеграции, чтобы просмотреть статус отдельного приложения. Этот статус не отображается на дэшборде состояния

Конфигурация затрат на уровне аккаунта с поддержкой медиаисточников

Клиенты ROI360 могут создавать и редактировать интеграции затрат на уровне учетной записи в разделе Настройки затрат и на вкладке Затраты . Следующие медиа-источники поддерживают настройку затрат на уровне учетной записи:

Поддерживаемые медиа-источники

Отображаемое имя ID интеграции
AdAction3 adaction5_int
Adbloom adbloom_int
AdColony adcolony_int
AdGate Media adgatemedia_int
adjoe GmbH adjoe_int
Adikteev Retargeting trademob_int
Apple Search Ads iossearchads_int
AppLift applift_int
Blind Ferret Agency blindferret_int
Bluestacks bluestacks_int
bytedance bytedance_int
Dataseat dataseat_int
Digital Turbine Legacy appia_int
Digital Turbine On Device digitalturbine_int
Domob domobc_int
DV360 dv360_int
GlobalWide Media globalwide_int
Google Реклама googleadwords_int
InMobi inmobi_int
InMobi DSP inmobidsp_int
Liftoff Influence jetfuelit_int
Mediaforce mediaforce_int
Meta Ads facebook
Mintegral mintegral_int
Mobupps mobupps_int
Moloco moloco_int
MoPub Acquire crossinstall_int
Opera Mobile operaevent_int
Persona.ly RTB personalyrtb_int
Pinterest pinterest_int
Pinsight pinsight_int
Point2Web point2web_int
Reddit reddit_int
Smadex smadex_int
Snapchat snapchat_int
Tapjoy tapjoy_int
Taptica taptica_int
TUNE hasoffers_int
Unity Ads unityads_int
X (Twitter) twitter

 Примечание

Дополнительные источники данных доступны через рекламные сети InCost. Чтобы получить полный список поддерживаемых рекламных сетей InCost, свяжитесь с вашим CSM.

Ограничения и особенности

Специфика Примечания
Агентства Агентства не могут использовать настройки затрат для одновременной интеграции затрат для нескольких приложений.
Приложения, которые будут добавлены позже, автоматически наследуют настройки затрат в настройках затрат на уровне аккаунта В настоящее время не поддерживается
Поведение данных о затратах при подключении рекламодателя и агентства к одной рекламной сети
Если и рекламодатель, и агентство подключают интеграцию затрат для одного и того же аккаунта рекламной сети (например, Google Ads), данные о затратах извлекаются из аккаунта, получающего атрибуцию.

Пример сценария:
  • Рекламодатель подключается к интеграции затрат с использованием учетных данных рекламодателя
  • Агентство связывает интеграцию затрат с помощью учетных данных агентства
  • Атрибуция присваивается аккаунту агентства

Результат

  • ROI360 собирает данные о затратах от подключенного агентства.
  • Рекламодательпоказывает подключение рекламодателя как NO-DATA.