--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://appmetrica.yandex.by/docs/en/mobile-api/post/post-profile-attributes.md - https://appmetrica.yandex.by/docs/ru/mobile-api/post/post-profile-attributes.md --- > **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/ru/llms.txt # Атрибуты профиля Передает параметры пользователя. Пример использования: вы можете передавать параметры пользователя в Post API, чтобы дополнить профиль пользователей и использовать эти данные в сегментации по аудитории. Например, добавить атрибут о том, что пользователь участник программы лояльности. Свойства событий можно передавать в параметрах запроса или в теле. При передаче данных в теле, к URL запроса необходимо добавить `.csv`. Подробнее в разделе [Пример запроса](#sample). Для привязки события к пользователю, необходимо использовать одно из следующих полей при запросе: - `profile_id` - `appmetrica_device_id` {% note alert %} Post API содержит ограничения на загрузку данных. Подробнее в разделе [Ограничения](https://appmetrica.yandex.by/docs/ru/mobile-api/post/restrictions.md). {% endnote %} ## Формат запроса ``` POST https://api.appmetrica.yandex.ru/logs/v1/import/profiles ? post_api_key= & application_id= & profile_id= & attributes=<> ``` #| || `post_api_key`* | Токен для загрузки данных. Его можно получить в разделе **Настройки** вашего приложения. || || `application_id`* | Уникальный числовой идентификатор приложения в AppMetrica. || || `profile_id`* | Идентификатор профиля пользователя. Post API позволяет загружать данные только для идентификаторов, которые предварительно были отправлены через SDK. {% note alert %} Не передавайте значение вместе с параметром `appmetrica_device_id`. Сервер принимает только один из параметров. {% endnote %} || || `attributes`* | Набор значений пользовательских атрибутов в формате `{key:value}`. Value может принимать тип string, number, bool, counter. Если для профиля уже записано значение переданного атрибута — оно будет перезаписано на новое. Предшествующие значения атрибута не сохранятся. Подробнее о [пользовательских атрибутах профилей](https://appmetrica.yandex.by/docs/ru/data-collection/profile-attributes.md). {% note alert %} Чтобы собирать собственные атрибуты профилей, необходимо добавить их в настройках приложения. Для этого на странице приложения нажмите в разделе **Настройки** нажмите **Атрибуты профилей**. {% endnote %} || |# ### First-party data {#fpd} First-party data (FPD, 1PD) — это логины, email, телефоны, внутренние идентификаторы `user_id`, `CRM_id` и другие данные, которые позволяют однозначно идентифицировать пользователя. Это позволяет корректно связать между собой действия пользователя, если он выполняет часть действий в веб-интерфейсе сервиса, а часть — в мобильном приложении, или использует разные устройства (например, мобильное приложение на смартфоне и планшете). AppMetrica не хранит значения атрибутов first-party data в открытом виде. Переданные идентификаторы сохраняются в хешированном виде и используются для сопоставления действий пользователя между устройствами и платформами. В профиле пользователя доступна только информация о том, какие атрибуты first-party data были переданы для данного пользователя. Post API поддерживает отправку атрибутов: - `appmetrica_1pd_phone_sha256_0`..`appmetrica_1pd_phone_sha256_9` — хеши номеров телефонов (не больше 10 значений); - `appmetrica_1pd_email_sha256_0`..`appmetrica_1pd_email_sha256_9` — хеши адресов email (не больше 10 значений); - `appmetrica_1pd_telegram_sha256` — хеш логина Telegram (одно значение). Пример запроса, отправляющего хеш номера телефона: ``` POST https://api.appmetrica.yandex.ru/logs/v1/import/profiles ? post_api_key= & application_id= & profile_id= & attributes={"appmetrica_1pd_phone_sha256_0":""} ``` При отправке запроса с атрибутами first-party data AppMetrica автоматически сгенерирует атрибуты с названиями `appmetrica_1pd_phone_0`..`appmetrica_1pd_phone_9`, `appmetrica_1pd_email_0`..`appmetrica_1pd_email_9`, `appmetrica_1pd_telegram`. Факт передачи атрибутов first-party data можно проверить с помощью булевых атрибутов профиля: - `appmetrica_1pd_phone_passed` — равен `true`, если от пользователя получено хотя бы одно корректное значение атрибута `appmetrica_1pd_phone_sha256_*`. - `appmetrica_1pd_email_passed` - равен `true`, если от пользователя получено хотя бы одно корректное значение атрибута `appmetrica_1pd_email_sha_256_*`. - `appmetrica_1pd_telegram_passed` — равен `true`, если от пользователя получено корректное значение атрибута `appmetrica_1pd_telegram_sha256`. В интерфейсе AppMetrica не отображаются сами переданные данные FPD, но факт передачи атрибута first-party data можно проверить в [списке профилей](https://appmetrica.yandex.by/docs/ru/mobile-reports/profile-list.md) — в параметрах сегментирования и в группировках по атрибутам профиля в подразделе **Предопределенные атрибуты**. {% cut "Сегментирование в списке профилей" %} ![сегментирование в списке профилей](../../../_images/profile-fpd-segment-ru.png){style="border: solid 1px #cccccc; max-width: 400px;"} {% endcut %} {% cut "Группировка в списке профилей" %} ![группировка в списке профилей](../../../_images/profile-fpd-grouping-ru.png){style="border: solid 1px #cccccc; max-width: 500px;"} {% endcut %} Отправка атрибутов first-party data доступна также через SDK: - [для Android](https://appmetrica.yandex.by/docs/ru/sdk/android/analytics/android-operations.md#send-attribute-profile-1pd) - [для iOS](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-operations.md#send-attribute-profile-1pd) ## Коды ответа {#response-codes} | Код | Описание | | ----- | ----- | | 200 | Данные успешно загружены. | | 403 | Запрос не содержит заголовка авторизации, либо указан неверный токен. | | 400 | Запрос не содержит одного или нескольких обязательных параметров. | ## Пример запроса {#sample} {% list tabs %} - Передача данных в теле запроса ```http translate=no 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}" ``` Передача first-party data: ```http translate=no 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,"{""appmetrica_1pd_phone_sha256_0"":""phone-number-hash"",""appmetrica_1pd_email_0"":""email-hash"",""appmetrica_1pd_telegram"":""login-hash""}" ``` - Передача данных в параметрах запроса ```http translate=no 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 ``` Передача first-party data: ```http translate=no POST /logs/v1/import/profiles?post_api_key=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012&application_id=1234567890&profile_id=1234567890abcdef&attributes={"appmetrica_1pd_phone_sha256_0":"phone-number-hash","appmetrica_1pd_email_0":"email-hash","appmetrica_1pd_telegram":"login-hash"} HTTP/1.1 Host: api.appmetrica.yandex.ru Content-Length: 0 Connection: close ``` {% endlist %} С помощью Post API можно изменить только [собственные](https://appmetrica.yandex.by/docs/ru/data-collection/profile-attributes.md#custom) пользовательские атрибуты. Чтобы передать [предопределенные](https://appmetrica.yandex.by/docs/ru/data-collection/profile-attributes.md) атрибуты, используйте AppMetrica SDK. Подробнее см. в разделе [Настройка отправки атрибутов профилей](https://appmetrica.yandex.by/docs/ru/data-collection/about-profiles.md#profile-settings). ## Другие методы Post API {#other-methods} - [Загрузка событий](https://appmetrica.yandex.by/docs/ru/mobile-api/post/post-import-events.md) - [Загрузка событий In-app Revenue](https://appmetrica.yandex.by/docs/ru/mobile-api/post/post-revenue.md) - [Загрузка событий Ad Revenue](https://appmetrica.yandex.by/docs/ru/mobile-api/post/post-adrevenue.md) - [Загрузка событий Ecommerce](https://appmetrica.yandex.by/docs/ru/mobile-api/post/post-ecommerce.md) Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот. Написать в службу поддержки Предложить улучшение для документации