{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Profiles APIトラブルシューティング","description":"Treasure Data Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"profiles-apiトラブルシューティング","__idx":0},"children":["Profiles APIトラブルシューティング"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Profiles APIを次の目的で使用する場合、以下の問題が発生する可能性があります。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["セグメントIDをツールに提供します。ツールはセグメントを使用して、パーソナライズされたメッセージングを提供したり、アクティビティを監視および報告したりできます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["このトピックには以下が含まれます。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ja/products/customer-data-platform/audience-studio/profiles/profiles-api-troubleshooting#make-sure-that-the-routing-operation-has-been-completed"},"children":["ルーティング操作が完了していることを確認する"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ja/products/customer-data-platform/audience-studio/profiles/profiles-api-troubleshooting#returning-segment-ids-to-your-tool"},"children":["ツールへのセグメントIDの返却"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ja/products/customer-data-platform/audience-studio/profiles/profiles-api-troubleshooting#limit-the-number-of-segment-ids-that-can-be-returned"},"children":["返却できるセグメントIDの数の制限"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ja/products/customer-data-platform/audience-studio/profiles/profiles-api-troubleshooting#key-column-mismatch"},"children":["キーカラムの不一致"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ja/products/customer-data-platform/audience-studio/profiles/profiles-api-troubleshooting#review-the-profiles-api-set-up"},"children":["Profiles APIセットアップの確認"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ja/products/customer-data-platform/audience-studio/profiles/profiles-api-troubleshooting#verify-the-profiles-api-key-column-against-the-segment-attributes-and-profile-values"},"children":["セグメント属性とプロファイル値に対するProfiles APIキーカラムの検証"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ja/products/customer-data-platform/audience-studio/profiles/profiles-api-troubleshooting#make-sure-to-send-behavior-data-after-configuring-profiles-api-token-and-real-time-segment"},"children":["Profiles APIトークンとリアルタイムセグメントを設定した後に動作データを送信するようにする"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ja/products/customer-data-platform/audience-studio/profiles/profiles-api-troubleshooting#make-sure-to-include-a-key-column-for-behavior-data-sent-from-js-sdk"},"children":["JS SDKから送信される動作データにキーカラムを含めるようにする"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ルーティング操作が完了していることを確認する","__idx":1},"children":["ルーティング操作が完了していることを確認する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["以下のJS SDKエンドポイントを使用する場合、リアルタイムセグメンテーションを使用するには、バックエンドからのルーティング有効化が必要です。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure サポート"]},"に連絡して、ルーティングを有効にする",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["database"]},"、および",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["table"]},"をお知らせください。バックエンドから有効化します。この制限は将来のリリースで削除される予定です。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AP02リージョン"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ap02.records.in.treasuredata.com"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["東京リージョン"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ap01.records.in.treasuredata.com"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["米国リージョン"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["us01.records.in.treasuredata.com"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["EU01リージョン"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["eu01.records.in.treasuredata.com"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ツールへのセグメントidの返却","__idx":2},"children":["ツールへのセグメントIDの返却"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API呼び出しがセグメントIDを返せない理由はいくつかあります。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"返却できるセグメントidの数の制限","__idx":3},"children":["返却できるセグメントIDの数の制限"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["APIが返すことができるセグメントIDの数には1KBの制限があります。セグメントIDはProfile APIによって配列として返されます。Profiles APIを設定する際にセグメントを選択する場合は、セグメントの数を制限してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"キーカラムの不一致","__idx":4},"children":["キーカラムの不一致"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Profiles APIセットアップのセグメントには、Profile APIで指定されたキーカラムと一致する値を持つプロファイルが含まれている必要があります。APIキーカラムと一致するプロファイルがない場合、API呼び出しはセグメントIDを返しません。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["セグメント内のプロファイルを確認して、少なくともいくつかのプロファイルがProfiles APIキーカラムと一致する値を持っていることを確認できます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"profiles-apiセットアップの確認","__idx":5},"children":["Profiles APIセットアップの確認"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["次のプロファイルセットアップでは、キーカラムは",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gender"]},"です。API呼び出しによってセグメントIDが返されるには、属性としてgenderが指定され、値（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["male"]},"や",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["female"]},"など）を持つセグメント内のレコードが存在する必要があります。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/keycolsegment.49f4b251f9eb8fb490ec51031ec857cea4362bdbc2427d4c0fa83b2620ad2473.cf3845cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["次の例は、API呼び出しがどのようになるかを示しています。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://cdp.in.treasuredata.com/cdp/lookup/collect/segments?version=2&token=<apiToken>&key.gender=female&callback=TreasureJSONPCallback1"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["key.gender=female"]},"に注目してください。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["この例では、API呼び出しは、genderが'female'である指定されたセグメント内のプロファイルを見つけるように設定されており、プロファイルが含まれているセグメントのIDを取得するように設定されています。"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["genderとして",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["female"]},"を指定する設定はセグメント内にあります。Profiles APIキーを呼び出してセグメントIDを取得する設定は、WebアプリまたはクライアントにあるJavaScript内にあります。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"セグメント属性とプロファイル値に対するprofiles-apiキーカラムの検証","__idx":6},"children":["セグメント属性とプロファイル値に対するProfiles APIキーカラムの検証"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["セグメントをチェックして、指定されたキーカラムを持つプロファイルがセグメント内に存在するかどうかを確認できます。指定された属性の値を返すプロファイルを表示できます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["次の例では、セグメント内のgender値は'Female'に設定されています。セグメントは16のプロファイルを返し、API呼び出しがこのセグメントにいくつかの値を返すことができ、呼び出された場合にこのセグメントIDを提供できることを確認します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/segdefaultfolder.609b68c07c2138ad4fe090a651432f22d4007001aa1af52b7f467f1aee5299d8.cf3845cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"profiles-apiトークンとリアルタイムセグメントを設定した後に動作データを送信するようにする","__idx":7},"children":["Profiles APIトークンとリアルタイムセグメントを設定した後に動作データを送信するようにする"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Profiles APIトークンとリアルタイムセグメントを登録した後、Profiles APIから動作データを取得するためのルール情報をバックエンドに保存します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["APIトークンとリアルタイムセグメントプロファイルを設定した後、JS SDKから動作データを送信してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"js-sdkから送信される動作データにキーカラムを含めるようにする","__idx":8},"children":["JS SDKから送信される動作データにキーカラムを含めるようにする"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Profiles API経由でデータを取得する場合は、JS SDKから送信されるデータにキーカラム（Profiles APIトークンで指定）を含めてください。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["キーはSDKデータに存在する必要があります。そうでない場合、Profiles APIはセグメントを正しく取得できません。"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ルックアップキーとして",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_global_id"]},"を使用する場合、Profiles APIはAPIリクエストのクエリパラメータではなく、ブラウザクッキーからルックアップ値を取得します。ブラウザ外でのテストや検証目的（例：Postman）の場合は、別のカラムを使用して手動でルックアップ値を渡してください。"]}]}]},"headings":[{"value":"Profiles APIトラブルシューティング","id":"profiles-apiトラブルシューティング","depth":1},{"value":"ルーティング操作が完了していることを確認する","id":"ルーティング操作が完了していることを確認する","depth":2},{"value":"ツールへのセグメントIDの返却","id":"ツールへのセグメントidの返却","depth":2},{"value":"返却できるセグメントIDの数の制限","id":"返却できるセグメントidの数の制限","depth":2},{"value":"キーカラムの不一致","id":"キーカラムの不一致","depth":2},{"value":"Profiles APIセットアップの確認","id":"profiles-apiセットアップの確認","depth":2},{"value":"セグメント属性とプロファイル値に対するProfiles APIキーカラムの検証","id":"セグメント属性とプロファイル値に対するprofiles-apiキーカラムの検証","depth":2},{"value":"Profiles APIトークンとリアルタイムセグメントを設定した後に動作データを送信するようにする","id":"profiles-apiトークンとリアルタイムセグメントを設定した後に動作データを送信するようにする","depth":2},{"value":"JS SDKから送信される動作データにキーカラムを含めるようにする","id":"js-sdkから送信される動作データにキーカラムを含めるようにする","depth":2}],"frontmatter":{"seo":{"title":"Profiles APIトラブルシューティング"}},"lastModified":"2026-06-01T09:34:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/products/customer-data-platform/audience-studio/profiles/profiles-api-troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}