> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md).

# Advocateのカスタムフィールドの解説

使用できます *カスタムフィールド* impact.com に、紹介プログラムの参加者に関する追加データを送信するために使えます。この情報は、あなたの [プログラムのルール](/brand/ja/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) 目標やアクションがいつ発火するかを判断するために使えます。また、カスタムフィールドの値に基づいて参加者をセグメント化することもできます。

送信するカスタムフィールドの種類は柔軟です。たとえば、参加者の次のような情報を含めたい場合があります：

* 誕生日
* 言語
* 所在地
* サブスクリプションの種類
* 会員ステータス

ユーザーインポートファイルをアップロードする場合、または UTT、API、SDK、その他の統合方法を介して、カスタムフィールドを impact.com に送信できます。

#### フィールドの特性

送信するカスタムフィールドは、フィールド名と値についていくつかの要件を満たす必要があります。

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

* 最大64文字。
* 使用できるのは英数字、ハイフン、アンダースコアのみです（文字はアクセント記号なしである必要があります）。
* 大文字と小文字を区別します。たとえば、 `customFieldName` は次と区別されます： `customfieldname`.
  {% endtab %}

{% tab title="値" %}

* サポート `文字列`, `数`, `ブール値`、および `null 型`.
* 文字列の最大長は 1024 文字です。
* 日付はミリ秒単位の UNIX タイムスタンプとして書式設定する必要があります。
* 1回のリクエストで追加/更新できるフィールドは最大100件です。
* ユーザーのカスタムフィールドを次の値に設定すると： `null` そのユーザーからそのフィールドは削除されます。
  {% endtab %}
  {% endtabs %}

#### カスタムフィールド情報を impact.com に送信する

データの送信方法に関係なく、ユーザーの作成、更新、または upsert を行う際にはいつでもカスタムフィールドを含めることができます。

{% tabs %}
{% tab title="ファイルインポート" %}
新規ユーザーのインポート時や既存ユーザーの一括更新時にカスタムフィールドを含めることができます。 [Advocate の参加者を一括インポートする](/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/import-advocate-participants-in-bulk.md) 手順については、

以下は、インポートの参考にできるサンプルファイル2つです。

* ユーザーデータのインポート： [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) ![](https://1458456015-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://1458456015-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://1458456015-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://1458456015-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/integration-guides/for-brands/advocate/advocate-api/graphql-api) または [REST API エンドポイント](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/advocate-rest-api) でユーザーの作成、更新、または upsert を行う際に、カスタムフィールドを含めることができます。また、 [UTT](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-tracking-integrations/advocate-installation-scripts) または当社の [モバイルオプション](https://integrations.impact.com/integration-guides/for-brands/advocate/mobile-options-for-advocate/mobile-options-for-advocate-programs) を使用して、アプリケーション内からユーザーを作成、更新、または upsert する場合にも含められます。
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.