Атрибуты профиля

Передает параметры пользователя.

Пример использования: вы можете передавать параметры пользователя в Post API, чтобы дополнить профиль пользователей и использовать эти данные в сегментации по аудитории. Например, добавить атрибут о том, что пользователь участник программы лояльности.

Свойства событий можно передавать в параметрах запроса или в теле. При передаче данных в теле, к URL запроса необходимо добавить .csv. Подробнее в разделе Пример запроса.

Для привязки события к пользователю, необходимо использовать одно из следующих полей при запросе:

  • profile_id
  • appmetrica_device_id

Внимание

Post API содержит ограничения на загрузку данных. Подробнее в разделе Ограничения.

Формат запроса

POST https://api.appmetrica.yandex.ru/logs/v1/import/profiles
  ? post_api_key=<string>
  & application_id=<int>
  & profile_id=<string>
  & attributes=<>

post_api_key*

Токен для загрузки данных. Его можно получить в разделе Настройки вашего приложения.

application_id*

Уникальный числовой идентификатор приложения в AppMetrica.

profile_id*

Идентификатор профиля пользователя. Post API позволяет загружать данные только для идентификаторов, которые предварительно были отправлены через SDK.

Внимание

Не передавайте значение вместе с параметром appmetrica_device_id. Сервер принимает только один из параметров.

attributes*

Набор значений пользовательских атрибутов в формате {key:value}. Value может принимать тип string, number, bool, counter. Если для профиля уже записано значение переданного атрибута — оно будет перезаписано на новое. Предшествующие значения атрибута не сохранятся. Подробнее о пользовательских атрибутах профилей.

Внимание

Чтобы собирать собственные атрибуты профилей, необходимо добавить их в настройках приложения. Для этого на странице приложения нажмите в разделе Настройки нажмите Атрибуты профилей.

Коды ответа

Код Описание
200 Данные успешно загружены.
403 Запрос не содержит заголовка авторизации, либо указан неверный токен.
400 Запрос не содержит одного или нескольких обязательных параметров.

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

POST /logs/v1/import/profiles.csv?post_api_key=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012 HTTP/1.1
Host: api.appmetrica.yandex.ru
Connection: close

application_id,profile_id,attributes
1234567890,1234567890abcdef,"{""string_attribute_name"":""string_value"",""number_attribute_name"":1234,""bool_attribute_name"":true,""counter_attribute_name"":-1}"

POST /logs/v1/import/profiles?post_api_key=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012&application_id=1234567890&profile_id=1234567890abcdef&attributes={"string_attribute_name":"string_value","number_attribute_name":1234,"bool_attribute_name":true,"counter_attribute_name":-1} HTTP/1.1
Host: api.appmetrica.yandex.ru
Content-Length: 0
Connection: close

С помощью Post API можно изменить только собственные пользовательские атрибуты. Чтобы передать предопределенные атрибуты, используйте AppMetrica SDK. Подробнее см. в разделе Настройка отправки атрибутов профилей.

Другие методы Post API

Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

Написать в службу поддержки
Предыдущая
Загрузка событий Ecommerce
Следующая
Push API