Начало интеграции

Коллекция Postman

У API-документации есть коллекция запросов с примерами. Вы можете просматривать ее без учетной записи Postman.

Если вы уже используете Postman, вы можете форкнуть и запустить коллекцию в Postman.

Авторизация

Это API использует авторизацию bearer authentication, используя ключ API для вашего проекта.

Ваш заголовок авторизации должен выглядеть примерно так:

--header 'Authorization: Bearer YWhhbWwsdG9uQGFwaWdlZS5jb206bClwYXNzdzByZAo'

API-ключ создаётся в вашем аккаунте.

Секция

Ваш аккаунт Gravity Ads обладает уникальным идентификатором секции. Секции содержат все ресурсы: плейсменты, сегменты и т.д. В запросах вы будете использовать id секции аккаунта.

Конечный пользователь

В рамках серверной интеграции вы можете самостоятельно назначать ID для конечных пользователей и сессий. Они передаются в запросах в объекте user.custom и session.custom.

В качестве ID вы можете использовать внутренний ID пользователя или SHA-256 хэш номера телефона или email.

Также можно использовать идентификатор, выданный платформой. Для этого сохраните user.uid, возвращаемый в любом запросе и передавайте его с другими запросами.

Контекст страницы (экрана)

Контексты позволяют платформе понять пользовательский путь посетителей сайта, создавать плейсменты только в определенных контекстах и запускать кампании в соответствии с условиями таргетинга.

Полное описание контекстов вы найдете по ссылке ниже:

Контексты