> 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に送信できます。この情報は、 [プログラムルール](https://help.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="とは別の名前として扱われます。" %}

* 値 `string`, `number`, `Boolean`および `null types`.
* 文字列の値は最大1024文字です。
* 日付はミリ秒単位のUNIXタイムスタンプ形式で指定する必要があります。
* 1回のリクエストで追加または更新できるフィールドは最大100個です。
* ユーザーのカスタムフィールドに `null` を設定すると、そのユーザーのフィールドが削除されます。
  {% endtab %}
  {% endtabs %}

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

データの送信方法にかかわらず、ユーザーの作成、更新、またはupsert時にカスタムフィールドを含めることができます。

{% tabs %}
{% tab title="ファイルのインポート" %}
新規ユーザーのインポート時や既存ユーザーの一括更新時に、カスタムフィールドを含めることができます。手順については、 [Advocate参加者の一括インポート](https://help.impact.com/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) ユーザーの作成、更新、またはアップサートを行います。これらは、次を使用する際にも含めることができます。 [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) アプリケーション内からユーザーを作成、更新、またはアップサートするために。
{% 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.
