# Advocate 自定义字段说明

您可以使用 *自定义字段* 向 impact.com 发送有关您推荐计划中参与者的额外数据。这些信息可用于您的 [计划规则](https://help.impact.com/brand/zh/nin-xiang-liao-jie-shen-me/advocate-program/getting-started-with-advocate/advocate-program-rules-explained) 以确定何时触发目标和操作。您还可以根据自定义字段值对参与者进行分段。

您发送的自定义字段类型很灵活。例如，您可能希望包含有关参与者的以下信息：

* 生日
* 语言
* 位置
* 订阅类型
* 会员状态

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

#### 字段特性

您发送的任何自定义字段都需要满足字段名称和值的一些要求。

{% tabs %}
{% tab title="名称" %}

* 最多 64 个字符。
* 仅接受字母数字字符、连字符和下划线（字母必须为无重音字符）。
* 区分大小写，例如， `customFieldName` 被视为与 `customfieldname`.
  {% endtab %}

{% tab title="数值" %}

* 支持 `字符串`, `数量`, `布尔值`，和 `空值 类型`.
* 字符串最大值为 1024 个字符。
* 日期必须格式化为以毫秒为单位的 UNIX 时间戳。
* 每个请求最多可添加/更新 100 个字段。
* 将用户的自定义字段设置为 `null` 将删除该用户的该字段。
  {% endtab %}
  {% endtabs %}

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

无论使用哪种发送数据的方法，只要您创建、更新或 upsert 用户时，都可以包含自定义字段。

{% tabs %}
{% tab title="文件导入" %}
在批量导入新用户或更新现有用户时，您可以包含自定义字段。请参阅 [批量导入推荐参与者](https://help.impact.com/brand/zh/nin-xiang-liao-jie-shen-me/advocate-program/manage-advocate-participants/import-advocate-participants-in-bulk) 以获取说明。

下面是两个示例文件，您可以用来指导导入。

* 用户数据导入： [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) 或 [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media)
* 事件数据导入： [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/20lD8Gua3EtW8qIahBvciz/152fd3cfaa3f0ee4076a6729bc8d4164/userEventSample.csv) ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) 或 [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/2IPDDkVhCgDBPyQrRANfb9/d38643fba660ca1412b7d85f1b7c0f41/userEventSample.jsonl) ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media)
  {% endtab %}

{% tab title="API 和 SDK" %}
在使用 impact.com 的 [GraphQL 方法](https://integrations.impact.com/impact-brand/docs/graphql-reference) 或 [REST API 端点](https://integrations.impact.com/impact-brand/docs/saasquatch-rest-api-1) 创建、更新或 upsert 用户时，可以包含自定义字段。使用 [UTT](https://integrations.impact.com/impact-brand/docs/install-the-utt) 或我们的 [移动选项](https://integrations.impact.com/impact-brand/docs/saasquatch-mobile-overview-1) 也可以在您的应用程序内创建、更新或 upsert 用户时包含它们。
{% endtab %}
{% endtabs %}