Поисковый запрос

При открытии страницы полного поиска необходимо передавать событие "Поисковый запрос".

На данное событие завязаны следующие механики платформы:

1. Триггер "Брошенный поиск"
2. Некоторые поисковые метрики

Важно

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

POST https://api.rees46.ru/push

Параметры

Параметр	Обязателен?	Описание
shop_id	Да	API-ключ
did*	Да	Идентификатор устройства
sid	Да	Идентификатор сессии . Обязателен при передаче did, желателен при других идентификаторах, если есть возможность
email*	Да	Email клиента
phone*	Да	Телефон клиента
external_id*	Да	Внешний идентификатор клиента
loyalty_id*	Да	Идентификатор внешней программы лояльности клиента
telegram_id*	Да	Telegram ID клиента
event	Да	Код события. В данном случае search
search_query	Да	Поисковый запрос. Пустое значение или массив вызовут ошибку 422
segment	Нет	Идентификатор сегмента для встроенных A/B-тестов. Значения: A или B (латиница)
stream	Нет	Стрим
referer	Нет	Страница сайта, на которой произошло событие

Идентификаторы

Параметры, отмеченные [*] - обязателен хотя бы один из них. На стороне сайта или мобильных приложений SDK автоматически передает did.

Запрос

TODO

Ревью мобильных SDK

Пример запроса:

S2S

# Минимальный трекинг 
curl 'https://api.rees46.ru/push' \
    -X 'POST' \
    -H 'Content-Type: application/json' \
    --data-raw '{"event":"search", "shop_id":"SHOP_ID", "did":"DEVICE_ID", "search_query": "..." }'

# Вариант с сегментом
curl 'https://api.rees46.ru/push' \
    -X 'POST' \
    -H 'Content-Type: application/json' \
    --data-raw '{"event":"search", "shop_id":"SHOP_ID", "did":"DEVICE_ID", "sid":"SEANCE_ID", "segment":"A", "search_query": "..." }'

JS SDK

r46('track', 'search', search_query);

iOS

// Начиная с версии iOS SDK 2.1.0
sdk.track(event: .search(query: "red shoes")) { trackResponse in
    // ... обработка коллбэков показана в описании события "Просмотр товара"
}

Kotlin

TBD

Java (deprecated)

TBD

ReactNative

sdk.track("search", "This is a search example");

Ответ

Пример ответа сервера:

{
  "status": "success"
}

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

{
  "status": "success",
  "popup": {
    "id": 337,
    "channels": [],
    "position": "...",
    "delay": 0,
    "html": "...",
    "web_push_system": false,
    "popup_actions": { ... }
  }
}

В случае ошибки ответ будет в формате:

{
  "status": "error",
  "payload": {
    "message": "Device ID is not valid"
  }
}