Customer Insights - Data 向けの Dataverse API
顧客プロファイルのクエリやセグメント メンバーシップの取得など、データのクエリにすでに Customer Insights - Data API を使用している場合は、代わりに API を Dataverse API に移行することをお勧めします。 セグメント定義の取得やワークフロー管理などのメタデータのクエリのサポートが、 Dataverse API に間もなく追加される予定です。
API を使用してデータのクエリを開始する場合は、代わりに Dataverse API を使用することをお勧めします。
重要
Customer Insights - Data の処理で問題が発生する可能性があるため、Dataverse API はデータの読み取り (GET) のみに使用し、データの書き込み (POST/PATCH/PUT) には使用しないことをお勧めします。
Dataverse API には、次の利点があります。
フィルタリングと並べ替えのための拡張機能
拡張性とパフォーマンスの向上
Dynamics 365 と Power Platform アプリの一貫した API エクスペリエンス
サンプル クエリ
Dataverse の API の使用を開始するには、Azure でアプリケーション登録を作成し、Dataverse の権限を要求し、Customer Insights - Data でアプリの閲覧者権限を付与します。
クエリ サンプルを変更して、ターゲット環境で機能するようにします。
{serviceRoot}:
{Organization URI}/api/data/v9.2/{組織 URI} は、環境に関連付けられた Dataverse テナントの URI です。 例:https://{mydvorg}.crm.dynamics.com{CID}: 統合された顧客レコードの GUID。 例:
ce759201f786d590bf2134bff576c369。{AlternateKey}: データ ソースの顧客レコードの主キーの識別子。 例:
CNTID_1002。{DSname}: Customer Insights - Data に取り込まれるデータ ソースのテーブル名を持つ文字列。 例:
Website_contacts。{SegmentName}: セグメントの出力テーブル名を含む文字列。 例:
Male_under_40。{CookieId}: 各 Web サイト訪問者の識別子は、Web 追跡スクリプトを使用するときに自動的に生成されます。 例:
3f43317e-d1ef-4cd3-9917-2d3342111d1a。
大変お世話になっております
CustomerProfile テーブルとセグメント メンバーシップのサンプル クエリ。
| クエリの種類 | 例 | 注意 |
|---|---|---|
| すべての顧客を取得 | {serviceRoot}/msdynci_customerprofiles |
|
| ID で顧客を取得する | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}' |
|
| 代替キーで顧客を取得する | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' |
代替キーは、msdynci_DSname_TableName_PrimaryKeyColumnName の形式で統合顧客テーブルに保持されます |
| 顧客の選択された属性を取得する | {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}' |
|
| ID で顧客を取得する (In) | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}' |
|
| 代替キーで顧客を取得する (In) | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}' |
|
| 顧客の検索 | {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10 |
|
| セグメントのメンバーであるすべての顧客を取得する | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid |
|
| 顧客がセグメントのメンバーどうか確認する | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid |
|
| セグメント メンバーであるすべての顧客を取得する | {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments |
Web カスタマイズ
CookieId に基づいて Web サイトをカスタマイズ するためのサンプル クエリ。 応答では、既知の顧客と不明な顧客の両方が返されます。 Web 追跡と個人用設定のために作成されたテーブルは Dataverse で利用できます。
| クエリの種類 | 例 | ヒント |
|---|---|---|
| CookieId で顧客を取得する | {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}') |
|
| CookieId で顧客を取得し、セグメント、メジャー、アクティビティを含める | {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity']) |
|
| CookieId で顧客の最近のページビュー (過去 10 件) を取得する | {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) |
このクエリでは、最大 200 件の最近のページ ビューを返すように変更できます |
| CookieId で顧客の最近のページ クリック (過去 10 件) を取得する | {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) |
このクエリでは、最大 200 件の最近のページ クリックを返すように変更できます |
| 顧客に関するすべてのアクティビティ | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' |
|
| 期間内の顧客のすべてのアクティビティを取得する | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytime gt 2024-01-01T00:00:00Z and msdynci_activitytime lt 2024-06-01T00:00:00Z |
|
| 顧客の activityType のすべてのアクティビティを取得する | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}' |
|
| 顧客の activityDisplayName のすべてのアクティビティを取得する | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}' |
|
| 顧客のすべての活動を取得し、それらを並べ替える | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc |
統合した活動
Web パーソナライゼーションが使用されていない場合の UnifiedActivity テーブルのサンプル クエリ。
| クエリの種類 | 例 | ヒント |
|---|---|---|
| 顧客に関するすべてのアクティビティ | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' |
|
| 期間内の顧客のすべてのアクティビティを取得する | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytime gt 2024-01-01T00:00:00Z and msdynci_activitytime lt 2024-06-01T00:00:00Z |
|
| 顧客の activityType のすべてのアクティビティを取得する | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}' |
|
| 顧客の activityDisplayName のすべてのアクティビティを取得する | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}' |
|
| 顧客のすべての活動を取得し、それらを並べ替える | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc |
その他の例
他のテーブルのサンプル クエリ。
| クエリの種類 | 例 | 注意 |
|---|---|---|
| 顧客のすべての測定値を取得する | {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}' |
|
| 顧客のブランドを強化する | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft' |
|
| 顧客の関心を強化する | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft' |
|
| 顧客の AI モデル結果を取得する | {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel' |
次の手順
ほとんどの Customer Insights - Data テーブルは Dataverse で使用できます。 詳細については、Dataverse のテーブルを参照してください。
Dataverse は、Insomnia などを介して、API をテストするための広範なサポートを提供します。 詳細については、Dataverse Web API に Insomnia を使用する を参照してください。
Dataverse API サービスの制限の詳細情報については、Microsoft Dataverse API 制限の概要 を参照してください。
Dataverse API の使用方法の詳細については、Web API を使用してデータを照会する を参照してください。