[Бета] API Server-to-Server (S2S) для веб-атрибуции

{"user_id":{"customer_user_id":"15667737-366d-4994-ac8b-653fe6b2be4a"},"event_name":"af_purchase","event_revenue":49.99,"event_revenue_currency":"USD","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.