Bagikan melalui

Contoh kueri OData

  • Artikel

Catatan

Customer Insights - Data tabel juga dapat diakses menggunakan Dataverse API. Kami menyarankan Anda menggunakan Dataverse API untuk mengkueri data Customer Insights karena API menawarkan pemfilteran yang lebih luas, throughput yang lebih besar, dan latensi yang lebih rendah. Untuk informasi selengkapnya, lihat Dataverse API untuk Customer Insights.

Open Data Protocol (OData) adalah protokol akses data yang dibangun di atas protokol inti seperti HTTP. Ini menggunakan metodologi yang diterima secara umum seperti REST untuk web. Ada berbagai macam pustaka dan alat yang dapat digunakan untuk mengonsumsi layanan OData.

Untuk membantu Anda membuat implementasi sendiri berdasarkan Dynamics 365 Customer Insights - Data API, tinjau beberapa contoh kueri yang sering diminta.

Ubah sampel kueri agar berfungsi pada lingkungan target:

  • {serviceRoot}: https://api.ci.ai.dynamics.com/v1/instances/{instanceId} where {instanceId} adalah GUID lingkungan yang Customer Insights - Data ingin Anda kueri. Operasi ListAllInstances memungkinkan Anda menemukan {InstanceId} akses yang Anda miliki.
  • {CID}: GUID rekaman pelanggan terpadu. Contoh: ce759201f786d590bf2134bff576c369.
  • {AlternateKey}: Pengidentifikasi kunci utama rekaman pelanggan dalam sumber data. Contoh: CNTID_1002
  • {DSname}: String dengan nama tabel sumber data yang diserap Customer Insights - Data. Contoh: Website_contacts.
  • {SegmentName}: String dengan nama tabel output dari segmen di. Customer Insights - Data Contoh: Male_under_40.

yang terhormat

Contoh kueri untuk tabel Pelanggan .

Jenis kueri Contoh Catatan
ID pelanggan tunggal {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}' 
Kunci alternatif {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} eq '{AlternateKey}' Kunci alternatif tetap ada di tabel pelanggan terpadu
Select {serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1'
Masuk {serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’)
Kunci Alternatif + Masuk {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} in ('{AlternateKey}','{AlternateKey}')
Pencarian {serviceRoot}/data/Customer?$top=10&$skip=0&$search="string" Menampilkan 10 hasil teratas untuk string pencarian
Keanggotaan segmen {serviceRoot}/data/Customer?select=*&$filter=IsMemberOfSegment('{SegmentName}')&$top=10 Mengembalikan jumlah baris yang telah ditetapkan dari tabel segmentasi.
Keanggotaan segmen untuk pelanggan {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'&IsMemberOfSegment('{SegmentName}') Menampilkan profil pelanggan jika mereka adalah anggota segmen tertentu

Aktivitas terpadu

Contoh kueri untuk tabel UnifiedActivity .

Jenis kueri Contoh Catatan
Aktivitas CID {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}'  Mencantumkan aktivitas profil pelanggan tertentu
Kerangka waktu kegiatan {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityTime gt 2017-01-01T00:00:00.000Z and ActivityTime lt 2020-01-01T00:00:00.000Z Aktivitas profil pelanggan dalam jangka waktu
Jenis aktivitas {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityType eq '{ActivityName}'
Aktivitas berdasarkan nama tampilan {serviceRoot}/data/UnifiedActivity$filter=CustomerId eq ‘{CID}’ and ActivityTypeDisplay eq ‘{ActivityDisplayName}’
Penyortiran aktivitas {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq ‘{CID}’ & $orderby=ActivityTime asc Mengurutkan aktivitas naik atau turun
Semua aktivitas dan tindakan untuk pelanggan {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId eq '{CID}' Aktivitas dan tindakan adalah pasangan kunci/nilai tambahan pada profil pelanggan yang dikembalikan

Kelola Alur Kerja

Contoh kueri yang terkait dengan proses Customer Insights - Data seperti me-refresh sumber data, menyatukan data, atau mendapatkan status pekerjaan penyatuan.

Jenis kueri Contoh Catatan
Mendapatkan ID sumber data {serviceRoot}/manage/datasources/v2 Mengembalikan semua sumber data di lingkungan Anda. Dari respons, Anda dapat memeriksa 'friendlyName' untuk sumber data tertentu dan kemudian menggunakan 'dataSourceId'-nya.
Segarkan sumber data {serviceRoot}/manage/workflows/main/jobs?operationType=Ingestion&identifiers='{dataSourceId}'&forceRunRequested=true Gunakan 'dataSourceId' dari respons di atas untuk me-refresh sumber data. Ini adalah permintaan POST.
Jalankan refresh penuh {serviceRoot}/manage/workflows/main/jobs?operationType=all&forceRunRequested=true Menyegarkan semua proses di lingkungan Anda. Ini adalah permintaan POST.
Mendapatkan status proses {serviceRoot}/manage/workflows/main/jobs

Contoh lainnya

Contoh kueri untuk tabel lain.

Jenis kueri Contoh Catatan
Ukuran CID {serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}'
Merek CID yang diperkaya {serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}'
Kepentingan CID yang diperkaya {serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}'
In-Klausul + Perluas {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}')

Pembatasan

  • Customer Insights API mengembalikan maksimal 100 objek secara default. Anda dapat mengurai lebih dari 100 objek yang dikembalikan dengan menggunakan teknik pagination standar. Atau, Anda dapat mengekspor data Anda.

  • Kueri berikut tidak didukung:

    • $filter pada tabel sumber yang diserap. Anda hanya dapat menjalankan kueri $filter pada tabel sistem yang Customer Insights - Data dibuat.
    • $expand dari $search kueri. Sebagai contoh: Customer?$expand=UnifiedActivity$top=10&$skip=0&$search="corey".
    • $expand dari jika $select hanya subset atribut yang dipilih. Sebagai contoh: Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}'.
    • $expand merek yang diperkaya atau afinitas minat untuk pelanggan tertentu. Sebagai contoh: Customer?$expand=BrandShareOfVoiceFromMicrosoft&$filter=CustomerId eq '518291faaa12f6d853c417835d40eb10'.
    • Tabel output model prediksi kueri melalui kunci alternatif. Sebagai contoh: OOBModelOutputTable?$filter=HotelCustomerID eq '{AK}'.