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

使用できます *カスタムフィールド* を使用して、紹介プログラムの参加者に関する追加データを impact.com に送信できます。この情報は、 [プログラムルール](/brand/ja/nitsuitebitaidesuka/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="値" %}

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

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

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

{% tabs %}
{% tab title="ファイルのインポート" %}
新規ユーザーのインポートや既存ユーザーの一括更新の際に、カスタムフィールドを含めることができます。手順については、 [アドボケート参加者を一括でインポートする](/brand/ja/nitsuitebitaidesuka/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/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 %}


---

# Agent Instructions: 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:

```
GET https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.