#
Просмотр
Для всех пользователей необходимо передавать информацию о просмотре страниц на сайте или экранов в приложении. В API V2 для этого используется запрос /visit.
#
visit: передача просмотра страницы или экрана
API reference
type принимает значения:
pageview- просмотр web-страницы;screenview- просмотр экрана приложения.
#
Активация и таргетинг
/visit не возвращает контент кампании. Этот запрос передаёт просмотр страницы или экрана и может вернуть кампании, подходящие под этот visit.
Если в ответе вернулся непустой campaigns[], это означает:
- Для переданного просмотра нашлась кампания.
- Пользователь и текущий
ctxподходят под условия этой кампании. campaigns[].campaignIdможно использовать в/choose, чтобы получить контент.
Если campaigns[] пустой или отсутствует, это не ошибка интеграции. Это означает, что для текущего пользователя и контекста нет кампаний, подходящих под этот visit.
curl --request POST
--url 'https://evs-01.gravityfield.ai/v2/visit'
--header 'content-type: application/json'
--header 'Authorization: Bearer your-api-key'
--data '
{
"sec": "YOUR_SECTION_ID",
"user": {
"uid": "665f0a000000000000000001",
"ses": "7356efc2-6ffd-4553-bade-b9ab5d9ce141"
},
"ctx": {
"type": "PRODUCT",
"data": ["sku-123"],
"location": "https://shop.ru/product/sku-123",
"lng": "MOW"
},
"device": {
"ua": "Mozilla/5.0",
"ip": "54.100.200.255"
},
"type": "pageview"
}'
{
"user": {
"uid": "665f0a000000000000000001",
"ses": "7356efc2-6ffd-4553-bade-b9ab5d9ce141"
},
"campaigns": [
{
"campaignId": "665f0b000000000000000001",
"experienceId": "665f0c000000000000000001",
"trigger": "screenview",
"priority": 10,
"delayTime": 0
}
]
}
#
Как использовать ответ
- Сохраните обновлённые
user.uidиuser.ses, если они пришли в ответе. - Если
campaigns[]пустой, продолжайте обычный сценарий без персонализированного контента. - Если
campaigns[]не пустой, выберите кампанию для показа и передайте еёcampaignIdв/choose.
Контент, вариация и tracking URL возвращаются на следующем шаге в /choose.