Advocate 自定义字段说明

你可以使用 自定义字段 向 impact.com 发送关于你的推荐计划参与者的额外数据。这些信息可用于你的 计划规则 以确定何时触发目标和操作。你还可以根据自定义字段值对参与者进行细分。

自定义字段的类型非常灵活。例如，你可能希望包含有关参与者以下方面的信息：

• 生日

• 语言

• 位置

• 订阅类型

• 会员状态

当你上传用户导入文件，或通过 UTT、API、SDK 或其他集成方式时，可以将自定义字段发送到 impact.com。

字段特性

你发送的任何自定义字段都需要满足字段名称和值的若干要求。

名称

• 最多 64 个字符。

• 仅接受字母数字字符、连字符和下划线（字母必须不带重音符号）。

• 区分大小写，例如， customFieldName 被视为与 customfieldname.

值

• 支持 字符串, 数值, 布尔值，以及 null 类型.

• 字符串最大值为 1024 个字符。

• 日期必须格式化为毫秒级 UNIX 时间戳。

• 每个请求最多可添加/更新 100 个字段。

• 将用户的自定义字段设置为 null 将移除该用户的该字段。

向 impact.com 发送自定义字段信息

无论你通过何种方式发送数据，在创建、更新或 upsert 用户时，都可以包含自定义字段。

文件导入

在批量导入新用户或更新现有用户时，可以包含自定义字段。请参阅 批量导入 Advocate 参与者 了解操作说明。

以下是两个可用于指导导入的示例文件。

• 用户数据导入： CSV 或 JSONL

• 事件数据导入： CSV 或 JSONL

API 和 SDK

在使用 impact.com 的 GraphQL 方法 或 REST API 端点 用于创建、更新或 upsert 用户。它们也可在使用 UTT 或我们的 移动端选项 在你的应用内创建、更新或 upsert 用户。