ビジネス固有の条件に基づいて、usersやleadsに関するカスタムデータ属性（CDA）を作成して追跡します。このデータを使って顧客セグメントをフィルタリング・作成し、ターゲットメッセージやキャンペーンを送信できます。また、qualification dataとしてleadsやtrial usersの資格判定にも利用可能です。
カスタムデータ属性とは何ですか？
カスタムデータ属性（CDA）は、顧客に関する事実を追跡します。例えば、誰かが利用しているプランや登録日時などです。これに対し、イベントは繰り返される顧客の行動を追跡します。
できないこと
カスタムデータ属性は、Settings > Data > Peopleで作成するフィールドです。会話やticketの一部のフィールド（例：Followers）はInboxに組み込まれており、カスタムデータ属性として作成されていないため、カスタムデータ属性としてアーカイブできません。
例：あなたの製品がプロジェクト管理ツールの場合、各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のsigned up時間は作成リクエスト時刻に設定されます。それ以外の場合は、値をあなたが設定する必要があります。
カスタムデータ属性を作成する
Intercomで新しい属性を作成するには、Settings > Data > Peopleに移動し、+ Create attributeをクリックします。新しい属性に名前と説明を付け、保存するデータの種類を選択します。
Messenger経由での属性更新を防ぐ
「Attribute Updates」が有効な場合、この属性への更新は認証済みリクエスト（REST APIまたはMessengerのJSON web token）からのみ受け付けられます。認証されていないリクエストは無視されます。
この設定は各属性ごとにオン・オフ可能で、Public APIやCSV Importsなど他のソースからの更新には影響しません。この設定が有効でない属性は安全でない更新を受け入れます。
注意：
不正な更新を防ぐために「Attribute Updates」を有効にすることを推奨します。その後、MessengerのJWTセキュリティを設定し、Messenger経由で安全に更新できるようにします。
Messenger経由の属性は、各属性でこの設定がオンの場合のみ安全でない更新から保護されます。
Messenger経由の属性更新はJWTで認証されたリクエストのみ処理されます。従来のIdentity Verification（User hash）方式は機能せず、user_hashを含むリクエストは保護された属性の更新を処理しません。
保存をクリックすると属性がリストに追加されます。まだ顧客には反映されていません。JavaScriptスニペット、API、またはアプリストアのアプリを通じてIntercomに送信する必要があります。👌
作成した属性の形式や説明を変更する必要がある場合は、編集して変更できます。
重要：カスタムデータ属性の名前は作成後に変更できません。既存の属性をアーカイブして新しい属性を作成する必要があります。
Messenger経由でカスタム属性を更新する
MessengerのJavascriptコードスニペットを使ってカスタムデータ属性を更新できます。
Messenger経由でカスタム属性を更新する際は、キーの値が常に文字列（テキスト）、数値、またはブール値（trueまたはfalse）のJSON有効な値であることを必ず確認してください。つまり、テキスト文字列はダブルクォーテーションで囲み、値が存在しない場合は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は常に設定オブジェクトのトップレベルキーとして直接渡してください。属性はMessenger経由で値を受け入れる前に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 imports、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属性名と重複しないように変更してください。カスタム属性名は作成後に変更できないため、既存の属性をアーカイブし、一意の名前で新しい属性を作成する必要があります。