# 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="値" %}

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

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

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

{% 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) （ユーザーを作成、更新、またはアップサートする）を使用する際に含めることができます。また、次を使用する際にも含めることができます [UTT](https://integrations.impact.com/impact-brand/docs/install-the-utt) または当社の [モバイルオプション](https://integrations.impact.com/impact-brand/docs/saasquatch-mobile-overview-1) を使用して、アプリケーション内からユーザーを作成、更新、またはアップサートできます。
{% 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.