# Advocate向けカスタムフィールドの概要

次の方法を使用できます *カスタムフィールド* を使用して、紹介プログラムの参加者に関する追加のデータをimpact.comに送信します。この情報はあなたの [プログラム規則](https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/getting-started-with-advocate/advocate-program-rules-explained) で、ゴールやアクションがいつトリガーされるかを判断するために使用できます。また、カスタムフィールドの値に基づいて参加者をセグメント化することもできます。

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

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

カスタムフィールドは、ユーザーのインポートファイルをアップロードする際、または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="ファイルインポート" %}
新しいユーザーをインポートする場合や既存ユーザーを一括で更新する場合にカスタムフィールドを含めることができます。詳しくは [アドボケート参加者を一括でインポートする](https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/manage-advocate-participants/import-advocate-participants-in-bulk) を参照してください。

以下はインポートの参考にできる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/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 %}