Атрибуты профиля
Передает параметры пользователя.
Пример использования: вы можете передавать параметры пользователя в 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 * | Числовой идентификатор приложения. |
profile_id * | Идентификатор профиля пользователя.. Post API позволяет загружать данные только для идентификаторов, которые предварительно были отправлены через SDK. Внимание. Не передавайте значение вместе с параметром appmetrica_device_id . Сервер принимает только один из параметров. |
attributes * | Набор значений пользовательских атрибутов в формате {key:value} . Value может принимать тип string, number, bool, counter. Если для профиля уже записано значение переданного атрибута — оно будет перезаписано на новое. Предшествующие значения атрибута не сохранятся. Подробнее о пользовательских атрибутах профилей.Внимание. Чтобы собирать собственные атрибуты профилей, необходимо добавить их в настройках приложения. Для этого на странице приложения нажмите в разделе Настройки нажмите Атрибуты профилей. |
post_api_key * | Токен для загрузки данных. Его можно получить в разделе Настройки вашего приложения. |
application_id * | Числовой идентификатор приложения. |
profile_id * | Идентификатор профиля пользователя.. Post API позволяет загружать данные только для идентификаторов, которые предварительно были отправлены через SDK. Внимание. Не передавайте значение вместе с параметром appmetrica_device_id . Сервер принимает только один из параметров. |
attributes * | Набор значений пользовательских атрибутов в формате {key:value} . Value может принимать тип string, number, bool, counter. Если для профиля уже записано значение переданного атрибута — оно будет перезаписано на новое. Предшествующие значения атрибута не сохранятся. Подробнее о пользовательских атрибутах профилей.Внимание. Чтобы собирать собственные атрибуты профилей, необходимо добавить их в настройках приложения. Для этого на странице приложения нажмите в разделе Настройки нажмите Атрибуты профилей. |
* Обязательный параметр
Коды ответа
Код | Описание |
---|---|
200 | Данные успешно загружены. |
403 | Запрос не содержит заголовка авторизации, либо указан неверный токен. |
400 | Запрос не содержит одного или нескольких обязательных параметров. |
Код | Описание |
---|---|
200 | Данные успешно загружены. |
403 | Запрос не содержит заголовка авторизации, либо указан неверный токен. |
400 | Запрос не содержит одного или нескольких обязательных параметров. |
Пример запроса
POST /logs/v1/import/profiles.csv?post_api_key=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012 HTTP/1.1
Host: api.appmetrica.yandex.com
Content-Length: 540i
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.csv?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.com
Content-Length: 0
Connection: close