ビジネス固有の基準に基づいて、usersやleadsに関するカスタムデータ属性（CDA）を作成して追跡します。このデータを使って顧客セグメントをフィルタリング・作成し、ターゲットメッセージやキャンペーンを送信できます。また、qualification dataとしてleadsやtrial usersの資格判定にも利用可能です。
カスタムデータ属性とは何ですか？
カスタムデータ属性（CDA）は、顧客に関する事実を追跡します。例えば、誰かがどのプランに加入しているか、いつ登録したかなどです。これに対し、イベントは繰り返される顧客の行動を追跡します。
例：あなたの製品がプロジェクト管理ツールの場合、各userが持つファイル数のデータを追跡できます。ファイルをまだ追加していないuserに対してオンボーディング支援のメッセージを送りたい場合、「files less than 1」のuserをターゲットにしたメッセージを設定できます。
Intercomで最も一般的に設定されるCDAは、顧客開発に関するものです。例えば：
料金プラン
購入金額
追加されたチームメンバー数
再生された曲数
サブスクリプション終了日
重要:
signed_upの値は統合を通じてIntercomに送信する必要があります。この値はuserがサービスに登録した時間を示します。
値を更新する方法は次の通りです：
Intercomは以下の場合にのみsigned_upの日付を自動設定します：
SDK（Android/iOS）および未識別のusers
created_at値なしでJSスニペットを通じて作成されたusers
これらの場合、usersの登録時間は作成リクエストの時間に設定されます。それ以外の場合は、値をあなたが設定する必要があります。
カスタムデータ属性を作成する
Intercomで新しい属性を作成するには、設定 > データ > Peopleに移動し、+ 属性を作成をクリックします。新しい属性に名前と説明を付け、保存するデータの種類を選択します。
Messenger経由の属性更新を防止する
「属性更新」が有効な場合、この属性への更新は認証済みリクエスト（REST APIまたはMessengerのJSON Web Token）からのみ受け付けられます。認証されていないリクエストは無視されます。
この設定は各属性ごとにオン/オフ可能で、Public API、CSVインポートなど他のソースからの更新には影響しません。設定が有効でない属性は安全でない更新を受け入れます。
注意：
不正な更新を防ぐために「属性更新」を有効にすることを推奨します。その後、MessengerのJWTセキュリティを設定し、Messenger経由で安全にフィールドを更新できるようにします。
Messenger経由の属性は、各属性で設定がオンの場合のみ安全でない更新から保護されます。
Messenger経由の属性更新はJWTで認証されたリクエストのみ処理されます。従来のIdentity Verification（User hash）方式は機能せず、user_hashを含むリクエストは保護された属性の更新を処理しません。
保存をクリックすると属性が属性リストに追加されます。まだ顧客には反映されていません。JavaScriptスニペット、API、またはアプリストアのアプリを通じてIntercomに送信する必要があります。👌
作成した属性の形式や説明を変更する必要がある場合は、編集して変更できます。
重要：カスタムデータ属性の名前は作成後に変更できません。既存の属性をアーカイブし、新しい属性を作成する必要があります。
Messenger経由でカスタム属性を更新する
カスタムデータ属性はMessengerのJavaScriptコードスニペットを使って更新できます。
Messenger経由でカスタム属性を更新する際は、キーの値が常にJSON有効な文字列（テキスト）、数値、またはブール値（trueまたはfalse）であることを必ず確認してください。つまり、テキスト文字列はダブルクォーテーションで囲み、値が存在しない場合はNULLを送信してください。
日付やURLも送信可能です。URLはテキスト文字列として追跡できます。例：「http://www.google.com」。Intercomはこれを認識し、自動的にハイパーリンクに変換します。日付はUNIXタイムスタンプ（秒単位）で送信してください。キー名が「_at」で終わる場合、自動的に日付として扱います（例：「last_order_at」）。Intercomの日付の扱いについてはこちら。
重要：UNIXタイムスタンプはミリ秒ではなく秒単位で送信してください。
データ属性のキーと値のペアの例をいくつか紹介します：
window.intercomSettings = {
email: "bob@example.com",
user_id: "123",
app_id: "abc1234",
created_at: 1234567890,
"subdomain": "intercom", // Put quotes around text strings
"teammates": 4, // Send numbers without quotes
"active_accounts": 12,
"last_order_at" : 1350466020, // Send dates in unix timestamp format and end key names with "_at"
"custom_domain": null // Send null when no value exists for a user
}
重要：Messenger JSスニペット経由でCDAを渡す際にcustom_attributes: {}のネストされたオブジェクトを使用しないでください。この形式（例：custom_attributes: { lead_source: "Intercom" }）はREST API専用です。window.intercomSettingsやwindow.Intercom("boot", ...)経由で渡すとMessengerはこれらの値を無視し、バックエンドは更新されません。CDAは常に設定オブジェクトのトップレベルキーとして直接渡してください。属性は事前にIntercomに存在している必要があります。
Intercomに送信できるCDAの種類
文字列（例：URL、プラン名、userタイプなど）
数値（整数）
ブール値（true / false）
タイムスタンプ（日時）例：「converted_at」
注意：日時フィールドはレポートやフィルターで日単位で扱われ、時間・分・秒単位ではありません。カスタム日時属性は対応しないメトリクスのレポートに表示されない場合があります。
覚えておくべきこと：
キー名は大文字小文字を区別し、ピリオド（'.'）、ドル記号（'$'）、~`!@#%^&*'{}[]|\"やNULL文字などの文字は含められません。— サポートされていない文字が使われた場合、属性はその位置にアンダースコアを使って作成されます。
データ値はJSONの文字列、数値、またはブール値（trueまたはfalse）で送信する必要があります。オブジェクト、ネストされたハッシュ、配列形式のデータは受け付けられません。
テキスト文字列の値は最大255文字までしか保持できません。これはカスタム属性にのみ適用され、会話データ属性には適用されません。
空の文字列を送信することで、既存のデータの値をクリアできます。
Intercomは多数の標準属性を自動的に追跡します。カスタム属性を作成する前にこれらを確認してください。
ソフトリミットは250のアクティブなCDAです。
数値の値は「0」で始めることはできません。整数は整数値なので、「01234」は「1234」として入力してください。州の郵便番号のように先頭に「0」が含まれる数字の文字列を収集する必要がある場合は、文字列属性を使用してください。
People属性とCompany属性は名前空間を共有しています：Peopleで使用されたカスタム属性名はCompanyで再利用できず、その逆も同様です。既存の属性がアーカイブされていても同じです。つまり、誤ってPeople用に作成した属性をCompany用に使いたい場合（またはその逆の場合）、元の名前は再利用できません。誤った属性をアーカイブし、少し異なる名前で新しい属性を作成してください。会話属性は別で、PeopleやCompany属性と名前を共有しても問題ありません。
カスタム属性は削除できません：カスタム属性はUIを通じて永久に削除できず、アーカイブのみ可能です。Intercomサポートも代わりに削除できません。
Companyの「Plan Name」属性：IntercomにはCompany用の組み込みシステム属性「Plan Name」があります。設定には表示されませんが、会話サイドバーには表示されます。同じ名前のカスタムCompany属性を作成すると、両方がサイドバーに表示され、重複して見えます。これを避けるために「Subscription Plan」など異なる名前を使用してください。
コードスニペットを更新してデータの追跡を開始したら、次のことを行ってください。
各属性の説明を作成して、チームメンバーが理解しやすくします。
重要：geo-locationデータは、ユーザーのIPアドレスに基づき、Maxmindというサードパーティサービスから取得しています。データの制御はできず、API経由で更新もできませんが、誤りがある場合はこちらのページからデータ修正リクエストを提出できます。
さらに、これらのusersはVPNを使用しているか、現在旅行中の可能性があり、そのため位置情報が誤って表示されることがあります。
「region」属性について：米国では「region」は州を指します。他国では異なる場合があり、例えばカナダでは「region」は州（Province）を指します。
すべてのregion値とその略称の一覧はこちらで確認できます。
その他の方法
usersのカスタム属性を追跡・更新するには、CSVインポート、IntercomのREST API、または多くのサードパーティアプリケーションを利用できます。
重要：カスタムデータ属性は、統合やサードパーティアプリが値を更新する前にIntercomで作成されている必要があります。統合やREST APIは既存属性の値のみ更新可能で、新しい属性定義は作成できません。新しい属性を追加するには、設定 > データ > Peopleで手動作成してください。
カスタム資格データとは何ですか？
資格データは、顧客プロフィールを手動で更新しながら資格付けを行うための特別な属性セットです。Intercomの簡単なフォームで設定できます。手動で更新する場合は他に何もする必要はありません。
このデータをping経由で追跡したい場合は、他のカスタムデータと同様にintercomSettingsコードスニペットにキー/バリューのペアを追加してください。
新しいカスタム資格データを作成するには、設定 > データ > People > Lead qualificationに移動してください。
下にスクロールしてデータを追加をクリックし、ドロップダウンメニューから+ 新しいデータを作成を選択します。
ここで名前（キー）を作成し、収集する値の形式（テキスト、数値、真偽値、リスト）を選択できます。
リスト形式を選択した場合、これは配列構造ではなく、値があらかじめ決められた選択肢のリストです。
注意：REST APIを使うと、手動で設定していないリスト属性の値を設定可能です。ただし、この値は手動で変更するとリストの恒久的な選択肢には追加されず、チームメンバーが手動で変更すると失われる可能性があります。
最後に、チームメンバーがデータを理解しやすいように説明を追加できます。
カスタム資格データにはシンプルな名前を付けてください。Messengerで資格付けを行う場合、顧客はこれらの名前をMessengerで目にします。
重要：Peopleデータの手動選択可能なドロップダウン（リスト）属性は、属性ごとに35オプションまでに制限されています。この制限は解除できません。35以上の値が必要な場合はテキスト属性を使用し、REST API経由で値を設定してください。
データ属性をアーカイブする
カスタムデータ属性は完全に削除できませんが、アーカイブは可能です。アーカイブされたデータはusersやleadsリストのフィルターに表示されないため、不要なデータの整理に便利です。
設定 > データ > Peopleに移動してください。
アーカイブしたいデータを選択し、その横の編集アイコンをクリックして、ポップアップでアーカイブをクリックします。取り消しも可能ですが、カスタムデータ属性を完全に削除することはできません。
アーカイブされたカスタム属性を見つけるには、ページの一番下までスクロールしてください。
カスタム属性のアーカイブを解除したい場合は、属性を開いて「アーカイブ解除」をクリックしてください。
CDAの制限とベストプラクティスの理解
カスタムデータ属性（CDA）には、最適なパフォーマンスを維持するためのワークスペース制限があります。
ワークスペースごとにPeopleとCompanyのCDAは250までの制限がありますが、未使用の属性をアーカイブしてスペースを確保できます。
新しい属性を作成する際は、以下のベストプラクティスを考慮してください。
users全体に広く適用できる属性を作成してください。
一時的な状況のためだけの属性作成は避けてください。
特定のシナリオにはEventsを代替手段として検討してください。
適切な場合はタグを活用してください。タグには同様の制限がありません。
CDAの使用状況を定期的に見直し、効率的なワークスペース管理を行ってください。最適化後に容量増加が必要な場合は、追加の制限増加がリクエスト可能です。
注意：Messenger経由でusersのデータを送信する場合は、Messengerのセキュリティ強化を強く推奨します。詳細は以下をご覧ください。
よくある質問
「Country」属性はどのように設定され、workflowsでの使用にどれくらい迅速に更新されますか？
「Country」属性はどのように設定され、workflowsでの使用にどれくらい迅速に更新されますか？
「Country」属性はユーザーのIPアドレスに基づいて自動的に設定・更新されます。これはユーザーがアプリをアクティブにしたりMessengerとやり取りした瞬間にリアルタイムで行われます。そのため、ユーザーが会話を開始した直後にworkflowsを分岐させることが可能です。
「Country」属性は手動で編集できますか？
「Country」属性は手動で編集できますか？
いいえ、「Country」属性はシステム生成フィールドであり、手動編集はできません。ユーザーや管理者が手動で更新可能な国フィールドが必要な場合は、カスタム属性を作成してください。
Jira統合を使用した際にカスタム属性へのAPI更新が失敗するのはなぜですか？
Jira統合を使用した際にカスタム属性へのAPI更新が失敗するのはなぜですか？
カスタム属性がJira属性と同じ名前を共有している場合、APIによるカスタム属性の更新はサイレントに失敗することがあります。重複した名前が存在すると、APIの更新リクエストはカスタム属性ではなくJira属性にルーティングされ、Jira属性の更新はブロックされるためリクエストが失敗します。
これを修正するには、カスタム属性の名前をJira属性名と重複しないように変更してください。カスタム属性名は作成後に変更できないため、既存の属性をアーカイブし、ユニークな名前で新しい属性を作成する必要があります。