用户属性与标签

定义客户的各类值，从姓名、出生日期到剩余积分、等级和营销同意状态，都通过用户属性和自定义标签来集成。借助它们，您可以将客户划分为细分人群，或自动化消息发送。

用户属性与标签的区别

用户属性是诸如电话号码和出生日期等特殊数据，它们以预定义格式集成，并在多个功能中使用。其他任何自由形式的数据则作为自定义标签集成。

	用户属性	自定义标签
对象	用户	用户、设备
格式	预定义	自由形式
数据	仅限特定数据（电话号码、出生日期、时区等）	无限制
用途	发送到电话号码、生日细分等	细分（标签）、个性化消息等

集成用户属性

对于与 FlareLane 各项功能紧密关联的用户专属数据，请按正确格式集成下列用户属性数据。

可用属性

	key	value
电子邮件	email	abc@example.com
电话号码	phoneNumber	E.164 格式 (+821011112222)
出生日期	dob	YYYY-MM-DD (1992-03-01)
时区	timeZone	tz database (Asia/Seoul)
姓名	name	无限制
国家/地区	country	ISO-3166-1 alpha-2 标准 (KR)
语言	language	ISO-639-1 标准 (ko)

如何集成

使用 track API 的 userAttributes 值。

对于通过批量集成等方式进行定期同步，请使用下方 API：

REST API： POST /v1/projects/PROJECT_ID/track

示例：通过 API 集成用户属性

curl --request POST \
     --url https://api.flarelane.com/v1/projects/PROJECT_ID/track \
     --header 'Authorization: Bearer API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "userAttributes": [
    {
      "userId": "userid1",
      "name": "name",
      "phoneNumber": "+821011112222",
      "email": "john@example.com",
      "dob": "1990-01-01",
      "timeZone": "Asia/Seoul",
      "country": "KR",
      "language": "ko"
    }
  ]
}
'

验证已集成的用户属性

您可以在用户列表中查看已集成的用户属性。

FlareLane 用户列表，显示已集成的用户属性字段

集成标签

除用户属性外，诸如购买历史、持有的优惠券列表和营销同意状态等自由形式的属性值，都作为标签集成。借助已集成的标签，您可以进行更精细的细分定向，或将其用作超个性化的消息变量。

下面是一个标签示例。

{
  "gender": "male",
  "order_count": 2,
  "liked_products": [1,2,3],
  "coupon_names": ["coupon1","coupon2","coupon3"],
  "firstPurchasedAt": "2024-04-19T14:23:56+09:00"
  "ad_agreement_datetime": "2024-04-19T14:23:56+09:00"
}

如何集成

您可以使用 track API 的 tags 值，也可以通过 SDK 添加标签。

集成标签时，只有您包含的标签会被应用。要删除某个标签，请将其值设为 null。

对于通过批量集成等方式进行定期同步，请使用下方 API：

REST API： POST /v1/projects/PROJECT_ID/track

当值在客户端发生变化时：

Web SDK / Mobile SDK： FlareLane.setTags({ key: value }})

示例：通过 API 集成标签

curl --request POST \
     --url https://api.flarelane.com/v1/projects/PROJECT_ID/track \
     --header 'Authorization: Bearer API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "tags": [
    {
      "subjectType": "user",
      "subjectId": "userid1",
      "tags": {
        "gender": "male",
        "order_count": 2,
        "liked_products": [1,2,3],
        "coupon_names": ["coupon1","coupon2","coupon3"],
        "firstPurchasedAt": "2024-04-19T14:23:56+09:00"
        "ad_agreement_datetime": "2024-04-19T14:23:56+09:00"
      }
    }
  ]
}
'

支持的数据类型

标签的值支持以下数据类型：

String
Number
Time（使用其中一种，并严格遵循格式）
- ISO8601 字符串：例如 "2024-04-19T14:23:56+09:00"
- 以毫秒为单位的 Unix Timestamp：例如 1681721331085
Boolean（true/false）
Array（类型必须一致：全部为字符串或全部为数字）
null（删除标签）

设备标签如何随用户 ID 场景变化

当集成用户 ID 时，当前设备的标签会随场景的不同而一同变化。详情请参阅设备标签如何随用户 ID 场景变化指南。

我们通常建议按用户 ID 一致地管理标签。但如果您需要按设备管理标签，请在标签键前加上 @device_ 前缀，这样此策略将不会被应用。

验证已集成的标签

您可以在用户列表或设备列表中查看已集成的标签。

在同一页面更下方的已集成标签列表中，您可以查看可供使用的数据。当您集成一个新标签时，稍有延迟后它会自动添加到列表中；如果不想等待，您也可以手动将其添加到列表并立即使用。（被添加到列表并不一定意味着数据已被正确集成。）

FlareLane 标签列表页面，显示可供使用的已集成标签

用例 1）创建细分人群

通过细分筛选条件中的标签筛选项，您可以自由地构建各类人群。您可以使用多种条件来创建判断，例如等于、比较运算符和存在性检查。

使用等于、比较和存在性条件的标签细分筛选条件

用例 2）消息个性化变量

已集成的标签可以通过个性化消息（Liquid）语法插入到消息内容中。

用法： {{ tags.tagName | default: defaultValue }}

消息编辑器将标签作为 Liquid 个性化变量插入

限制

标签数据存在数量上限。由于此上限，不建议动态分配标签名。
对象数组将在未来支持。