Настройка колбэков сервера

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

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

Что нужно знать, чтобы начать работу.

Требования

Доступ к администрированию, редактированию или настраиваемому редактированию
Вам понадобится собственное решение для бизнес-аналитики или хранилище данных для приема запросов колбэков. Убедитесь, что ваш сервер может принимать все нужные параметры и хранить все входящие данные. Количество пользователей вашего приложения влияет на то, насколько быстрыми должны быть серверы. Если вы измеряете такие одноразовые события, как регистрация, вы получите один колбэк для каждого конвертированного пользователя. Колбэки для событий конверсии обычно не имеют значимого влияния на пропускную способность сервера.
Чтобы убедиться, что вы получаете данные только от Adjust, добавьте наши IP-адреса сервера в список разрешений.

Типы колбэков

Вы можете настраивать колбэки для следующих триггеров.

Доступные триггеры

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

Примечание:

Общие колбэки не включают следующие действия:

Доход от рекламы
Клики SAN
Просмотры SAN
Установки SKAdNetwork
События SKAdNetwork

Необходимо настроить отдельные колбэки для этих действий.

Колбэки для отдельного действия

Колбэк для отдельного действия — это колбэк для одной определенной активности, например для клика. Это отличный вариант, если вам необходимы данные только для определенного действия. В ряде случаев (например, для показов и кликов) общие колбэки генерируют большие объемы данных. Если хотите уменьшить объем данных, направляемых Adjust в вашу систему бизнес-аналитики, настройте колбэки для отдельных действий.

Примечание:

Если настроить для одного и того же события и общий колбэк, и колбэк единичного события, вы получите два колбэка для одного действия: по одному для каждой конечной точки.

Несколько колбэков на одно действие

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

Настройка колбэков сервера

Для создания колбэков сервера можно использовать инструкции по настройке или классическую конфигурацию. При создании URL колбэков Adjust рекомендует использовать инструкции по настройке.

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

Инструкции по настройке

Получите доступ к настройке колбэка сервера из карточки приложения или на вкладке Управление данными в настройках приложения.
- (Только с правами администратора, редактора или с настраиваемым доступом к редактированию) Чтобы настроить колбэк сервера из карточки приложения, в разделе AppView выберите Все приложения . Найдите свое приложение и выберите раздел Колбэки сервера .
- Чтобы настроить колбэк сервера на вкладке Управление данными в настройках своего приложения, в разделе AppView выберите Все приложения . Выберите свое приложение, а затем откройте вкладку Управление данными .
В разделе Колбэки сервера выберите Добавить колбэк > Инструкции по настройке .
В списке Триггер колбэка выберите действие или событие, которые будут служить триггером колбэка.
В поле Конечная точка сервера укажите URL-адрес конечной точки, на который вы хотите получать данные.
(Дополнительно) Выберите Добавить условие , чтобы добавить условие в сочетании с плейсхолдерами и значениями. Колбэк будет запущен только при соблюдении этого условия.
В поле Метод запроса выберите, будет ли для колбэка использоваться метод GET или POST. По умолчанию используется метод GET.
- При выборе метод POST можно ввести пары «ключ — значение» в качестве тела запроса в формате key=value. Adjust кодирует тело запроса и отправляет его как плоский JSON-объект.
Выберите Добавить плейсхолдер , чтобы динамически включать в колбэк данные вовлечения или пользователя. На этом этапе можно добавить несколько плейсхолдеров.
Выберите Создать URL колбэка , чтобы создать закодированный колбэк.

Классическая схема

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

<метод>,<условия>,<url>[,<тело>]
В телах POST-запросов используется key1=value1&key2=value2, и Adjust преобразует их в плоский JSON.

Можно ввести несколько колбэков, разделенных пробелом. По умолчанию используется метод запроса GET, если вы явно не указали метод POST.

Управление колбэками

Созданные URL колбэков можно просмотреть на странице Колбэки серверов . С колбэками можно выполнять следующие действия:

Нажмите (значок копирования), чтобы копировать URL-адрес колбэка.
Нажмите (значок дублирования), чтобы дублировать колбэк и открыть классическую конфигурацию.
Нажмите (значок удаления), чтобы удалить колбэк.
Нажмите (значок редактирования), чтобы изменить URL колбэка, используя классическую конфигурацию.