个人资料属性

传输用户参数。

使用示例：您可以通过 Post API 发送用户参数，以补充用户档案，并使用这些数据进行基于用户群体的分段。例如，添加一个属性，表示用户是忠诚计划的成员。

事件属性可以通过参数或请求体传递。当您在请求体中传递数据时，应在请求 URL 中添加 .csv。要了解更多信息，请查看示例请求。

要将事件绑定到用户，您需要在API请求中使用以下字段之一：

profile_id
appmetrica 设备 ID

注意

Post API 有数据加载限制。要了解更多信息，请查看限制。

请求格式

提交 https://api.boost.yandex.com/logs/v1/import/profiles
  ? post_api_key=<string>
  & application_id=<int>
  & profile_id=<string>
  & attributes=<>

`post API 密钥`*	用于数据上传的令牌。您可以在应用的设置部分获取它。
`应用ID`*	应用在 Analytics module 中的唯一数字标识符。
`profile_id`*	用户个人资料 ID。 Post API 仅允许您上传先前通过 SDK 发送的标识符的数据。注意不要传递 `appmetrica_device_id` 参数的值。服务器只接受这些参数中的一个。
`attributes`*	一组自定义属性值，格式为 `{key:value}`。可能的值类型：字符串、数字、布尔值或计数器。如果传递的属性值已为该账户记录，它将被新值覆盖。之前的属性值将被删除。了解更多关于用户资料属性的信息。注意要收集自定义个人资料属性，请在应用设置中添加它们。要做这一步，打开应用页面，选择设置，然后点击个人属性。

First-party data

第一方数据（FPD，1PD）指的是登录信息、电子邮箱、电话号码、内部标识符（如user_id和CRM_id等），以及其他能唯一识别用户的数据。这可以确保用户在服务的网页界面执行部分操作、在移动应用执行其他操作时，或者使用不同设备（例如在智能手机上使用移动应用和在平板上使用）时，用户操作能正确关联。

Analytics module 不以纯文本形式存储第一方数据属性值。已传递的标识符会以哈希形式保存，用于跨设备和平台匹配用户操作。用户个人资料仅包含有关为该用户传递的第一方数据属性的信息。

Post API 支持发送以下属性：

appmetrica_1pd_phone_sha256_0..appmetrica_1pd_phone_sha256_9 — 电话号码哈希值（最多10个值）；
appmetrica_1pd_email_sha256_0..appmetrica_1pd_email_sha256_9 — 电子邮箱地址哈希值（最多10个值）；
appmetrica_1pd_telegram_sha256 — Telegram 登录哈希（一个值）。

示例：发送电话号码哈希的请求

POST（提交） https://api.boost.yandex.com/logs/v1/import/profiles
  ? post_api_key=<string>
  & application_id=<int>
  & profile_id=<string>
  & attributes={"appmetrica_1pd_phone_sha256_0":"<string>"}

在发送包含第一方数据属性的请求时，Analytics module会自动生成名称为appmetrica_1pd_phone_0..appmetrica_1pd_phone_9、appmetrica_1pd_email_0..appmetrica_1pd_email_9、appmetrica_1pd_telegram的属性。

您可以通过布尔型个人资料属性来验证第一方数据属性是否已传递：

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 属性的有效值。

该Analytics module接口不会显示传递的FPD，但您可以在个人资料列表中验证已传递第一方数据属性——在分段参数中以及预定义属性子部分中按个人资料属性进行分组。

个人资料列表中的分段

在个人资料列表中分组

通过 SDK 也可发送第一方数据属性：

Response codes

Code	描述
200	数据已成功上传。
403	请求缺少授权头，或指定了无效的令牌。
400	请求中缺少一个或多个必需参数。

示例请求

在请求体中发送数据

通过请求参数发送数据

POST /logs/v1/import/profiles.csv?post_api_key=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012 HTTP/1.1
Host: api.boost.yandex.com
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 HTTP/1.1
Host: api.boost.yandex.com
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""}"

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.boost.yandex.com
Content-Length: 0
Connection: close

发送第一方数据：

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.boost.yandex.com
Content-Length: 0
Connection: close

你只能使用 Post API 来修改用户的自定义属性。要传递预定义属性，请使用AppMetrica SDK。有关更多信息，请参阅设置发送属性配置。

其他 Post API 方法

如果您没有找到所需答案，可以通过反馈表单提交您的问题。请尽可能详细地描述问题。如果可能，请附上截图。

联系支持建议改进文档

这篇文章是否有用？

上传电子商务事件

Push API