API Dataverse untuk Customer Insights - Data
Jika Anda sudah menggunakan Customer Insights - Data API, seperti membuat kueri Profil Pelanggan atau mendapatkan keanggotaan segmen, sebaiknya migrasikan API ke Dataverse API. Dukungan untuk mengkueri metadata, seperti mendapatkan definisi segmen dan manajemen alur kerja, akan segera hadir di Dataverse API.
Jika Anda mulai mengkueri data menggunakan API, sebaiknya gunakan Dataverse API sebagai gantinya.
Penting
Disarankan untuk menggunakan Dataverse API hanya untuk membaca data (GET) dan tidak menulis data (POST/PATCH/PUT) karena dapat menyebabkan masalah dengan Customer Insights - Data pemrosesan.
Dataverse API memiliki keunggulan sebagai berikut:
Kemampuan yang diperluas untuk memfilter dan mengurutkan
Peningkatan skala dan kinerja
Pengalaman API yang konsisten di Dynamics 365 dan Power Platform aplikasi
Contoh kueri
Untuk mulai menggunakan API, Dataverse buat pendaftaran aplikasi di Azure dan minta izin untuk dan Dataverse berikan izin Penampil aplikasi Anda. Customer Insights - Data
Ubah sampel kueri agar berfungsi pada lingkungan target:
{serviceRoot}:where
{Organization URI}/api/data/v9.2/{ URI Organisasi} adalah URI penyewa yang Dataverse terkait dengan lingkungan Anda. Misalnya:https://{mydvorg}.crm.dynamics.com{CID}: GUID rekaman pelanggan terpadu. Sebagai contoh:
ce759201f786d590bf2134bff576c369.{AlternateKey}: Pengidentifikasi kunci utama rekaman pelanggan dalam sumber data. Sebagai contoh:
CNTID_1002.{DSname}: String dengan nama tabel sumber data yang diserap Customer Insights - Data. Sebagai contoh:
Website_contacts.{SegmentName}: String dengan nama tabel output segmen. Sebagai contoh:
Male_under_40.{CookieId}: Pengidentifikasi untuk setiap pengunjung situs web, yang dibuat secara otomatis saat menggunakan skrip pelacakan web. Sebagai contoh:
3f43317e-d1ef-4cd3-9917-2d3342111d1a.
yang terhormat
Contoh kueri untuk tabel CustomerProfile dan keanggotaan segmen.
| Jenis kueri | Contoh | Catatan |
|---|---|---|
| Dapatkan semua pelanggan | {serviceRoot}/msdynci_customerprofiles |
|
| Dapatkan pelanggan dengan ID | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}' |
|
| Dapatkan pelanggan dengan Kunci Alternatif | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' |
Kunci alternatif tetap ada di tabel pelanggan terpadu dalam format msdynci_DSname_TableName_PrimaryKeyColumnName |
| Mendapatkan atribut yang dipilih untuk pelanggan | {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}' |
|
| Dapatkan pelanggan dengan ID (In) | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}' |
|
| Dapatkan pelanggan dengan Kunci Alternatif (In) | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}' |
|
| Cari pelanggan | {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10 |
|
| Dapatkan semua pelanggan yang merupakan anggota segmen | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid |
|
| Dapatkan pelanggan jika mereka adalah anggota segmen | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid |
|
| Mendapatkan semua keanggotaan segmen pelanggan | {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments |
Personalisasi Web
Contoh kueri untuk mempersonalisasi situs web Anda berdasarkan CookieId. Respons mengembalikan pelanggan yang dikenal dan tidak dikenal. Tabel yang dibuat untuk pelacakan web dan personalisasi tersedia di. Dataverse
| Jenis kueri | Contoh | Catatan |
|---|---|---|
| Dapatkan pelanggan dengan CookieId | {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}') |
|
| Dapatkan pelanggan dengan CookieId dan sertakan Segmen, Pengukuran, Aktivitas | {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity']) |
|
| Mendapatkan tampilan halaman terbaru (10 terakhir) pelanggan dengan CookieId | {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) |
Kueri ini dapat diubah untuk menampilkan hingga 200 tampilan halaman terbaru |
| Mendapatkan klik halaman terbaru (10 terakhir) pelanggan dengan CookieId | {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) |
Kueri ini dapat diubah untuk menampilkan hingga 200 klik halaman terbaru |
| Dapatkan semua aktivitas pelanggan | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' |
|
| Dapatkan semua aktivitas pelanggan dalam jangka waktu tertentu | {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 |
|
| Mendapatkan semua aktivitas aktivitasJenis pelanggan | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}' |
|
| Mendapatkan semua aktivitas activityDisplayName pelanggan | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}' |
|
| Dapatkan semua aktivitas pelanggan dan urutkan | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc |
Aktivitas terpadu
Contoh kueri untuk tabel UnifiedActivity jika Personalisasi Web tidak digunakan.
| Jenis kueri | Contoh | Catatan |
|---|---|---|
| Dapatkan semua aktivitas pelanggan | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' |
|
| Dapatkan semua aktivitas pelanggan dalam jangka waktu tertentu | {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 |
|
| Mendapatkan semua aktivitas aktivitasJenis pelanggan | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}' |
|
| Mendapatkan semua aktivitas activityDisplayName pelanggan | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}' |
|
| Dapatkan semua aktivitas pelanggan dan urutkan | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc |
Contoh lainnya
Contoh kueri untuk tabel lain.
| Jenis kueri | Contoh | Catatan |
|---|---|---|
| Dapatkan semua ukuran pelanggan | {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}' |
|
| Dapatkan merek pelanggan yang diperkaya | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft' |
|
| Dapatkan minat pelanggan yang diperkaya | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft' |
|
| Dapatkan hasil model AI dari pelanggan | {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel' |
Langkah berikutnya
Sebagian besar Customer Insights - Data tabel tersedia di. Dataverse Untuk informasi selengkapnya, lihat Tabel di. Dataverse
Dataverse menawarkan dukungan ekstensif untuk menguji API mereka, misalnya melalui Insomnia. Untuk informasi selengkapnya, lihat Menggunakan Insomnia dengan Dataverse Web API.
Untuk informasi selengkapnya tentang Dataverse batas layanan API, lihat Microsoft Dataverse Gambaran umum batas API.
Untuk informasi selengkapnya tentang cara menggunakan Dataverse API, lihat Mengkueri data menggunakan API Web.