> 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) ![](/files/ed3b94ea5dfb5606155c2234b71fd1a91c1eb13b) または [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) ![](/files/ed3b94ea5dfb5606155c2234b71fd1a91c1eb13b)
* イベントデータのインポート： [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/20lD8Gua3EtW8qIahBvciz/152fd3cfaa3f0ee4076a6729bc8d4164/userEventSample.csv) ![](/files/ed3b94ea5dfb5606155c2234b71fd1a91c1eb13b) または [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/2IPDDkVhCgDBPyQrRANfb9/d38643fba660ca1412b7d85f1b7c0f41/userEventSample.jsonl) ![](/files/ed3b94ea5dfb5606155c2234b71fd1a91c1eb13b)
  {% 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
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=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.