{"user_id":{"customer_user_id":"15667737-366d-4994-ac8b-653fe6b2be4a"},"event_name":"af_purchase","event_revenue":49.99,"event_revenue_currency":"USD","af_customer_event_id": "550e8400-e29b-41d4-a716-446655440000","event_value":{"af_content_id":"SKU-001","af_quantity":2,"custom_parameters":{"promo_code":"SUMMER10"}},"event_url":"https://example.com/checkout/success","timestamp":1712000000000,"ip":"35.244.183.10","user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) ...","email_hashed":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"}

{"user_id":{"appsflyer_id":"1234567890abcdef","customer_user_id":"15667737-366d-4994-ac8b-653fe6b2be4a"},"event_url":"https://example.com/products/sneakers","timestamp":1712000000000,"ip":"35.244.183.10","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) ...","http_referrer":"https://www.google.com/","email_hashed":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"}

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

Поскольку на сайте не используется Web SDK, который мог бы установить afUserIdcookie за вас, назначать и управлять им придётся самостоятельно – это должен быть HTTP-cookie, задаваемый в Set-Cookieзаголовке ответа, а не cookie на стороне клиента, созданный на JavaScript.

Вот почему это важно: срок действия cookie-файла на стороне клиента (устанавливается черезdocument.cookie) истекает быстро: всего за 7 дней в Safari или за 24 часа в доменах, находящихся под управлением ITP. После истечения срока действия идентификатор сбрасывается, и вернувшийся посетитель выглядит как новый. Файл cookie, установленный вашим сервером, не подпадает под это ограничение и может сохраняться в течение максимального срока, установленного браузером (Chrome разрешает до 400 дней). Его также можно пометитьHttpOnly таким образом, что скрипты страницы и блокировщики рекламы не могут прочитать или удалить его, и он вообще не зависит от каких-либо скриптов, запущенных на странице.

Как задать и прочитать его:

1. При первом запросе от посетителя, у которого нет cookie, сгенерируйте на своем сервере стабильный уникальный идентификатор (например, UUID).

2. Верните его в собственном файле cookie:

   Set-Cookie: af_web_id=<generated-id>; Max-Age=34128000; Path=/; Secure; HttpOnly; SameSite=Lax

3. При каждом последующем запросе считывайте значение из входящего заголовка Cookie и используйте его повторно. Не генерируйте его заново.
4. Отправляйте это значение в AppsFlyer при каждом вызове как appsflyer_id в составе объекта запроса user_id.

Вы можете назвать cookie-файл как угодно; AppsFlyer считывает отправленное вами значение , а не название cookie-файла. Просто убедитесь, что вы указываете его своего собственного домена.

Каждый вызов требует объектuser_id, имеющий хотя бы один из параметров:appsflyer_id ( значение cookie) илиcustomer_user_id (ваш внутренний идентификатор пользователя). Отправка обоих, если они у вас есть, повышает точность идентификации.

Вот что следует помнить: посещения в основном анонимны, поэтому всегда отправляйте значение cookie. Для событий на сайте добавляйте customer_user_id после идентификации пользователя и продолжайте передавать cookie вместе с ним. Для событий, которые не инициируются в браузере, достаточноcustomer_user_id, если AppsFlyer уже знает этого пользователя из ранее идентифицированной сессии.

Объектuser_id требуется при каждом запросе. Необходимо указать хотя бы один из следующих идентификаторов.

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

Все поля с персональными данными должны быть хешированы с помощью алгоритма SHA256 перед отправкой. Перед хешированием выполните нормализацию текста (преобразование в нижний регистр, обрезка). Каждый хеш должен состоять ровно из 64 шестнадцатеричных символов (регистр не имеет значения).

• Шаблон для всех хешированных полей: ^[a-fA-F0-9]{64}$
• Номера телефонов, использующие полеphone_number_e164_hashed должны соответствовать формату E.164 (например,+14155552671 ) перед хешированием.

• afUserId — это уникальный идентификатор, устанавливаемый Web SDK при первом посещении пользователем вашего сайта.
• Если вам нужен afUserId, воспользуйтесь одним из следующих способов.

Получение afUserId из заголовка HTTP cookie

• Значение afUserId отправляется браузером посетителя при обращении к вашему сайту.
• При необходимости извлеките его из заголовка HTTP cookie.

Просмотр afUserId в браузере посетителя

• Просмотрите afUserId в браузере посетителя, чтобы устранить неполадки и для отладки.
• Чтобы параметр стал доступен, посетитель должен хотя бы один раз зайти на страницу с веб-SDK.
• Файл cookie, содержащий afUserId, является файлом cookie первой стороны по отношению к вашему домену.
• Следующая процедура была подготовлена с использованием Chrome 81. Возможны различия в зависимости от браузера и операционной системы.

Чтобы получить afUserId из браузера посетителя:

1. В своём браузере перейдите на свой сайт.
2. Нажмите на правую кнопку мыши, выберите Проверить. Откроется окно браузера для проверки элементов.
3. Перейти на вкладку (A) Заявка.
4. В боковом меню (B) раскройте Cookies.
5. Выберите свой сайт. Если он не отображается, обновите браузер.
6. В поле (C) фильтр введите afUserId. Отобразится значение afUserID.

В AppsFlyer пока нет готового назначения Segment для S2S API, поэтому вам нужно настроить его как пользовательское назначение в Segment, которое будет отправлять каждое событие в конечную точку S2S. Это можно сделать двумя способами — в зависимости от того, насколько большой контроль над форматом данных вам нужен.

Вариант 1: назначение Webhooks (Actions)

Это рекомендуемая отправная точка. Код не требуется, а вся настройка выполняется в пользовательском интерфейсе Segment.

Чтобы настроить это, выполните следующее:

1. В Segment добавьте назначение Webhooks из каталога назначений.
2. Подключите его к источнику, который собирает события, которые вы хотите отправить.
3. Для каждого типа события создайте сопоставление, которое определяет URL-адрес AppsFlyer, задаёт метод POST, добавляет необходимые заголовки и формирует JSON-данные из полей события.

Вариант 2: функция назначения

Используйте этот параметр только в том случае, если сопоставление Webhooks не может сформировать формат данных, который нужен AppsFlyer. Функция назначения — это небольшая функция JavaScript, которая выполняется в Segment, получает каждое событие и отправляет его в конечную точку AppsFlyer через fetch.

Используйте этот параметр, когда:

• Для данных нужна вложенная структура — например, user_id, вложенный в объект user, — которую пользовательский интерфейс сопоставления Webhooks не может построить.
• Перед отправкой данные события нужно преобразовать, например изменить формат метки времени.

Какой бы вариант настройки вы ни использовали, укажите эту конечную точку:

POST https://events.appsflyer.com/v2.0/s2s/inapps/app/web/website-{your_domain}

Authorization: Bearer {s2s-token}
Content-Type: application/json

Получите свой ключ API S2S на странице управления токенами AppsFlyer (см. Аутентификация). В пути используйте идентификатор веб-приложения (например, website-www.your_domain), а не UUID Web SDK ID на странице настроек приложения.

Сформируйте тело JSON для каждого сопоставленного события со следующими полями:

{
  "user_id": {
    "customer_user_id": "<ваш внутренний идентификатор пользователя>",
    "appsflyer_id": "<значение cookie afUserId, если доступно>"
  },
  "event_name": "signup",
  "event_url": "<URL-адрес страницы, на которой произошло событие>",
  "ip": "<IP-адрес конечного пользователя>",
  "user_agent": "<user_agent конечного пользователя>",
  "af_customer_event_id": "<messageId в Segment>"
}

1. Web SDK должен работать на маркетинговом сайте: он фиксирует посещения, а Segment передаёт события. Как указано во введении к этому разделу, перед событием у пользователя должно быть посещение, иначе событие будет атрибутировано как органическое. Если вы хотите полностью серверную настройку без использования Web SDK, следуйте инструкциям в разделе Настройка полностью серверной интеграции.
2. Для каждого запроса также нужны правильные идентификаторы: отправляйте ту же комбинацию appsflyer_id и customer_user_id, которая описана в разделе Отправляйте правильные идентификаторы при каждом запросе.

Когда назначение и данные готовы, выполните развертывание в три этапа:

1. Сопоставьте одно или два события в Segment (для начала хорошо подойдет событие регистрации) и отправьте тестовое событие с помощью инструмента проверки сопоставления.
2. Убедитесь, что они корректно отображаются в отчете с необработанными данными и сопоставляются с посещением маркетингового сайта.
3. После подтверждения расширьте сопоставление на остальные события.

Когда назначение и данные готовы, выполните развертывание в три этапа:

1. Сопоставьте одно или два события в Segment (для начала хорошо подойдет событие регистрации) и отправьте тестовое событие с помощью инструмента проверки сопоставления.
2. Убедитесь, что они корректно отображаются в отчете с необработанными данными и сопоставляются с посещением маркетингового сайта.
3. После подтверждения расширьте сопоставление на остальные события.