Передача событий

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

post

Report a predefined or custom event.

Authorizations

Body

userobjectrequired

User ID. A Gravity Field-generated identifier is used, and managed via cookies. For a new user, send this object empty.

sessionobjectrequired

Session ID. A Gravity Field-generated identifier is used. For new sessions, send this object empty.

contextobjectrequired

The request's context.

eventsany of[]required

One or more events to report.

Responses

application/json

text/plain

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://evs.gravityfield.ai/ssapi/event' \
  --header 'Authorization: Bearer API-KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "user": {
      "id": "100"
    },
    "session": {
      "custom": "custom_session_100"
    },
    "context": {
      "page": {
        "type": "PRODUCT",
        "data": [
          "sku_1"
        ],
        "location": "https://test.ru/product/sku_1"
      },
      "device": {
        "userAgent": "Mozilla/5.0 ...",
        "ip": "8.8.8.8"
      }
    },
    "events": [
      {
        "name": "Purchased online",
        "properties": {
          "eventType": "purchase-v1",
          "value": 100,
          "uniqueTransactionId": "f8709115-eeaa-404d-84da-a1eeafb82e0e",
          "cart": [
            {
              "productId": "sku_1",
              "quantity": 2,
              "itemPrice": 10
            },
            {
              "productId": "sku_2",
              "quantity": 1,
              "itemPrice": 80
            }
          ]
        }
      }
    ]
  }'

EventAPIPurchasedEventHybridAddToCartEventHybridAuthorizationEventStoreUserAndAuthorizationCuidInvalidContextData

200

204

401

422

200

{
  "user": {
    "slid": "65fafcdae8dc0a8e690a4102"
  },
  "session": {
    "sl": "58DA42F2-BD26-4517-A81B-4DA4369E2529"
  }
}

Successful store event