Customer Insights - Data için Dataverse API'leri
Müşteri Profilini sorgulamak veya segment üyelikleri edinmek için zaten Customer Insights - Data API'lerini kullanıyorsanız bunun yerine API'lerinizi Dataverse API'lerine taşımanızı öneririz. Get Segment tanımı ve iş akışı yönetimi gibi meta verileri sorgulamak için destek yakında Dataverse API'lerine sunulacaktır.
API kullanarak veri sorgulamayı kullanmaya başladıysanız bunun yerine Dataverse API'lerinin kullanılmasını öneririz.
Önemli
Customer Insights - Data işlemlerinde sorunlara neden olabileceğinden Dataverse API'lerinin yalnızca veri okumak (GET) için kullanılması ve veri yazmak (POST/PATCH/PUT) için kullanılmaması önerilir.
Dataverse API'lerinin aşağıdaki avantajları vardır:
Filtreleme ve sıralama için genişletilmiş özellikler
Artırılmış ölçek ve performans
Dynamics 365 ve Power Platform uygulamalarında tutarlı API deneyimi
Örnek sorgular
Dataverse API'lerini kullanmaya başlamak için Azure'da bir uygulama kaydı oluşturun ve Customer Insights - Data'da Dataverse için izin isteyin ve uygulamanız için Görüntüleyici izinleri verin.
Sorgu örneklerini hedef ortamlarda çalışmak için değiştirin:
{serviceRoot}:
{Organization URI}/api/data/v9.2/burada {Kuruluş URI'sı} , ortamınızla ilişkili kiracının Dataverse URI'sıdır. Örneğin:https://{mydvorg}.crm.dynamics.com{CID}: Birleşik bir müşteri kaydının GUID'si. Örneğin:
ce759201f786d590bf2134bff576c369.{AlternateKey}: Veri kaynağı bir müşteri kaydının birincil anahtarının tanımlayıcısı. Örneğin:
CNTID_1002.{DSname}: Customer Insights - Data'ya alınan bir veri kaynağının tablo adına sahip dizedir. Örneğin:
Website_contacts.{SegmentName}: Bir segmentin çıkış tablosu adına sahip dizedir. Örneğin:
Male_under_40.{CookieId}: Her web sitesi ziyaretçisi için web izleme betiği kullanılırken otomatik olarak oluşturulan tanımlayıcı. Örneğin:
3f43317e-d1ef-4cd3-9917-2d3342111d1a.
Customer
CustomerProfile tablosu ve segment üyelikleri için örnek sorgular.
| Sorgu türü | Örnek | Not |
|---|---|---|
| Tüm müşterileri alma | {serviceRoot}/msdynci_customerprofiles |
|
| Kimliğe göre müşteriyi alma | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}' |
|
| Alternatif Anahtara göre müşteriyi alma | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' |
Alternatif anahtarlar birleşik müşteri tablosunda msdynci_DSname_TableName_PrimaryKeyColumnName biçiminde kalır |
| Müşteri için seçilen öznitelikleri alma | {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}' |
|
| Kimliklerine göre müşterileri alma (Uygulama içi) | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}' |
|
| Alternatif Anahtara göre müşterileri alma (Uygulama içi) | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}' |
|
| Müşteri arama | {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10 |
|
| Bir segmentin üyesi olan tüm müşterileri alma | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid |
|
| Bir segmentin üyesi olan müşteriyi alma | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid |
|
| Bir müşterinin tüm segment üyeliklerini alma | {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments |
Web Kişiselleştirme
CookieId'e göre web sitenizi kişiselleştirmek için örnek sorgular. Yanıt, bilinen ve bilinmeyen müşterilerin her ikisini de döndürür. Web izleme ve kişiselleştirme için oluşturulan tablolar Dataverse'te bulunur.
| Sorgu türü | Örnek | Not |
|---|---|---|
| CookieId'ye göre müşteriyi alın | {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}') |
|
| CookieId ile bir müşteri alın ve Segmentler, Önlemler, Etkinlikleri dahil edin | {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity']) |
|
| CookieId tarafından bir müşterinin en son (son 10) sayfa görünümlerini alma | {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) |
Bu sorgu, en fazla 200 son sayfa görüntülemesi döndürecek şekilde değiştirilebilir |
| CookieId tarafından bir müşterinin en son (son 10) sayfa tıklanmalarını alma | {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) |
Bu sorgu, en fazla 200 son sayfa tıklaması döndürecek şekilde değiştirilebilir |
| Bir müşterinin tüm etkinliklerini alma | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' |
|
| Bir müşterinin belirli bir zaman aralığındaki tüm etkinliklerini alma | {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 |
|
| Bir müşterinin activityType türüne ait tüm etkinliklerini alma | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}' |
|
| Bir müşterinin activityDisplayName adına ait tüm etkinliklerini alma | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}' |
|
| Bir müşterinin tüm etkinliklerini alma ve sıralama | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc |
Birleşik etkinlik
Web Kişiselleştirme kullanımda değilse UnifiedActivity tablosu için örnek sorgular.
| Sorgu türü | Örnek | Not |
|---|---|---|
| Bir müşterinin tüm etkinliklerini alma | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' |
|
| Bir müşterinin belirli bir zaman aralığındaki tüm etkinliklerini alma | {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 |
|
| Bir müşterinin activityType türüne ait tüm etkinliklerini alma | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}' |
|
| Bir müşterinin activityDisplayName adına ait tüm etkinliklerini alma | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}' |
|
| Bir müşterinin tüm etkinliklerini alma ve sıralama | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc |
Diğer örnekler
Diğer tablolar için örnek sorgular.
| Sorgu türü | Örnek | Not |
|---|---|---|
| Bir müşterinin tüm ölçümlerini alma | {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}' |
|
| Bir müşterinin zenginleştirilmiş markalarını alma | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft' |
|
| Bir müşterinin zenginleştirilmiş ilgi alanlarını alma | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft' |
|
| Bir müşterinin yapay zeka modeli sonuçlarını alma | {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel' |
Sonraki adımlar
Çoğu Customer Insights - Data tablosu Dataverse'de kullanılabilir. Daha fazla bilgi için bkz. Dataverse'teki tablolar.
Dataverse API'lerini test etmek için kapsamlı destek sunar, örneğin Insomnia aracılığıyla. Daha fazla bilgi için bkz. Dataverse Web API'si ile Insomnia kullama.
Dataverse API hizmet sınırları hakkında daha fazla bilgi edinmek için bkz. Microsoft Dataverse API sınırlarına genel bakış.
Dataverse API'lerini kullanma hakkında daha fazla bilgi için bkz. Web API'si kullanarak veri sorgulama.