Dynamics 365 Müşteri İçgörüleri

Dynamics 365 Customer Insights bağlayıcısı, Dynamics 365 Customer Insights örnekleriyle etkileşim kurmak için bir dizi API sağlar.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet	Class	Bölgeler
Copilot Studio	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri : - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)
Logic Apps	Standart	Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Çin bölgeleri - ABD Savunma Bakanlığı (DoD)
Power Apps	Premium	Aşağıdakiler dışında tüm Power Apps bölgeleri : - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)
Power Automate	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri : - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)

İletişim
İsim	Microsoft
URL	https://support.microsoft.com

Bağlayıcı Meta Verileri
Publisher	Microsoft
Web Sitesi	https://dynamics.microsoft.com/en-us/ai/customer-insights/
Gizlilik ilkesi	https://privacy.microsoft.com/
Categories	Veri

Dynamics 365 Customer Insights'a kaydolmak için buraya tıklayın.

Bu bağlayıcıyı Power Apps'te kullanmak için burada daha fazla bilgi edinin.

Azaltma Sınırları

Name	Çağrılar	Yenileme Dönemi
Bağlantı başına API çağrıları	100	60 saniye

Eylemler

Bir bölümden veri alma (Önizleme)	Bir bölümden veri alma.
Durum raporunu gönderir	Durum raporunu gönderir.
V2 durum raporunu gönderir	V2 durum raporunu gönderir.
V2 varlığı için bölümleri alma (Önizleme)	V2 varlığı için bölümleri alma.
Varlık için bölümleri alma (Önizleme)	Bir varlık için bölümleri alma.
Varlıkları alma	Bu işlem bir örnekteki varlıkları alır
Varlıktan öğe alma	Bu işlem bir varlıktan öğe alır. Varlığa bağlı olarak alanlar filtre olarak tanımlanabilir: UnifiedActivity varlığı: ActivityId ve CustomerId alanları Müşteri varlığı: CustomerId alanı ve Customer Insights örneğinde dizine alınan diğer alanlar Diğer varlıklar: CustomerId alanı.
Öğe oluşturma (Önizleme)	Bu işlem bir varlıkta öğe oluşturur
Öğeyi al	Bu işlem bir varlıktan öğe alır
Öğeyi güncelleştirme (Önizleme)	Bu işlem varlık üzerindeki bir öğeyi güncelleştirir

Bir bölümden veri alma (Önizleme)

İşlem Kimliği:: GetPartitionData

Bir bölümden veri alma.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Customer Insights veri kümesi	dataset	True	string	Customer Insights veri kümesi.
Varlık	table	True	string	Varlık.
Bölümün başvurusu (URI veya Ad)	partitionUri	True	string	Bölümün başvurusu (URI veya Ad).
Virgülle ayrılmış sütun satırı	select		string	Virgülle ayrılmış sütun satırı.
Okumanın başlatıldığı konumdan bayt cinsinden konum	offsetStart		integer	Okumanın başlatıldığı konumdan bayt cinsinden konum.
Okunacak en fazla bayt sayısı	maxSize		integer	Okunacak bayt üst sınırı.
Döndürülecek en fazla kayıt sayısı	maxResults		integer	Döndürülecek en fazla kayıt sayısı.

Döndürülenler

Bir bölümdeki veriler.

Body: PartitionDataResponse

Durum raporunu gönderir

İşlem Kimliği:: SendStatusReport

Durum raporunu gönderir.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Örnek kimliği	dataset	True	string	Bir örnek seçin.
Rapor türü	reportType	True	string	Bir rapor türü seçin.

V2 durum raporunu gönderir

İşlem Kimliği:: SendStatusReportV2

V2 durum raporunu gönderir.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Örnek kimliği	dataset	True	string	Bir örnek seçin.
Rapor türü	reportType	True	string	Bir rapor türü seçin.

V2 varlığı için bölümleri alma (Önizleme)

İşlem Kimliği:: GetPartitionsV2

V2 varlığı için bölümleri alma.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Customer Insights veri kümesi	dataset	True	string	Customer Insights veri kümesi.
Varlık	table	True	string	Varlık.
Filtre uygulamak için partitionDisplayName değeri	partitionDisplayName		string	Filtre uygulamak için partitionDisplayName değeri.

Döndürülenler

Bölümlerin listesi

Body: PartitionListResponse

Varlık için bölümleri alma (Önizleme)

İşlem Kimliği:: GetPartitions

Bir varlık için bölümleri alma.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Customer Insights veri kümesi	dataset	True	string	Customer Insights veri kümesi.
Varlık	table	True	string	Varlık.

Döndürülenler

response: array of Table

Varlıkları alma

İşlem Kimliği:: GetTables

Bu işlem bir örnekteki varlıkları alır

Parametreler

Name	Anahtar	Gerekli	Tür	Description
instanceId	dataset	True	string	Örneğin tanımlayıcısı

Döndürülenler

Tablo listesini temsil eder.

Body: TablesList

Varlıktan öğe alma

İşlem Kimliği:: GetItems

Bu işlem bir varlıktan öğe alır. Varlığa bağlı olarak alanlar filtre olarak tanımlanabilir:

UnifiedActivity varlığı: ActivityId ve CustomerId alanları
Müşteri varlığı: CustomerId alanı ve Customer Insights örneğinde dizine alınan diğer alanlar
Diğer varlıklar: CustomerId alanı.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
instanceId	dataset	True	string	Örneğin tanımlayıcısı
varlıkAdı	table	True	string	Varlığın adı
Filtre Sorgusu	$filter		string	Döndürülen girişleri kısıtlamak için bir ODATA filtre sorgusu (örn. stringColumn eq 'string' OR numberColumn lt 123).
En Çok Sayı	$top		integer	Alınacak toplam girdi sayısı (varsayılan = tümü).
Sorgu Seç	$select		string	Girdilerden alınacak belirli alanlar (varsayılan = tümü).

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Öğe oluşturma (Önizleme)

İşlem Kimliği:: PostItem

Bu işlem bir varlıkta öğe oluşturur

Parametreler

Name	Anahtar	Gerekli	Tür	Description
instanceId	dataset	True	string	Örneğin tanımlayıcısı
varlıkAdı	table	True	string	Varlığın adı
recordItem	item	True	dynamic	Oluşturulacak kayıt

Öğeyi al

İşlem Kimliği:: GetItem

Bu işlem bir varlıktan öğe alır

Parametreler

Name	Anahtar	Gerekli	Tür	Description
instanceId	dataset	True	string	Örneğin tanımlayıcısı
varlıkAdı	table	True	string	Varlığın adı
itemIdentifier	id	True	string	Öğenin tanımlayıcısı

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Öğeyi güncelleştirme (Önizleme)

İşlem Kimliği:: PatchItem

Bu işlem varlık üzerindeki bir öğeyi güncelleştirir

Parametreler

Name	Anahtar	Gerekli	Tür	Description
instanceId	dataset	True	string	Örneğin tanımlayıcısı
varlıkAdı	table	True	string	Varlığın adı
itemIdentifier	id	True	string	Öğenin tanımlayıcısı
recordItem	item	True	dynamic	Güncelleştirilecek kayıt

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Tetikleyiciler

Customer Insights'taki bir işlem tamamlandığında akışı tetikler	Seçili işlemin zamanlanmış yenilemeleri için bir akış tetiklenir. Ayrıca, el ile yenilemeler için bir akışı tetiklemeyi de seçebilirsiniz.
Customer Insights'ın tam yenilemesi tamamlandığında bir akışı tetikler	Bu işlem, Customer Insights'ın tam yenilemesi (veri kaynakları, segmentler, ölçüler,...) tamamlandığında bir akışı tetikler.
İş ölçüsü eşiği aşıldığında akışı tetikler	Bu işlem, Dynamics 365 Customer Insights'ta bir iş ölçüsü eşiği aşıldığında bir akışı tetikler.
Segment eşiği aşıldığında akışı tetikler	Bu işlem, Dynamics 365 Customer Insights'ta segment eşiği aşıldığında bir akışı tetikler.
Yenileme başarısız olduğunda veri kaynağından bir akışı tetikler	Bu işlem, Dynamics 365 Customer Insights'ta yenileme başarısız olduğunda veri kaynağından bir akışı tetikler.
Yenileme tamamlandığında veri kaynağından bir akışı tetikler	Bu işlem, Dynamics 365 Customer Insights'ta yenileme tamamlandığında veri kaynağından bir akışı tetikler.

Customer Insights'taki bir işlem tamamlandığında akışı tetikler

İşlem Kimliği:: GetOnProcessCompleted

Seçili işlemin zamanlanmış yenilemeleri için bir akış tetiklenir. Ayrıca, el ile yenilemeler için bir akışı tetiklemeyi de seçebilirsiniz.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Örnek Adı	dataset	True	string	Bir örnek seçin.
İşlem	process		string	Bir işlem seçin.
El ile tetiklenen işlemi dahil et	includingManualRefreshes		boolean	El ile tetiklenen işlem dahil edilecekse Evet'i seçin.

Döndürülenler

Yürütülen işlem hakkındaki bilgiler

Body: ProcessData

Customer Insights'ın tam yenilemesi tamamlandığında bir akışı tetikler

İşlem Kimliği:: GetOnFullDagRefreshCompleted

Bu işlem, Customer Insights'ın tam yenilemesi (veri kaynakları, segmentler, ölçüler,...) tamamlandığında bir akışı tetikler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Örnek Adı	dataset	True	string	Bir örnek seçin.

Döndürülenler

Yürütülen tam yenileme hakkındaki bilgiler

Body: FullRefreshProcessData

İş ölçüsü eşiği aşıldığında akışı tetikler

İşlem Kimliği:: GetOnBusinessMeasureUpdated

Bu işlem, Dynamics 365 Customer Insights'ta bir iş ölçüsü eşiği aşıldığında bir akışı tetikler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Örnek Adı	dataset	True	string	Bir örnek seçin.
İş Ölçüsü adı	measure	True	string	Bir ölçü seçin.
Eşik	threshold	True	double	Herhangi bir sayıyı eşik olarak ayarlayın.

Döndürülenler

İş Ölçüsü verileri

Body: MeasureData

Segment eşiği aşıldığında akışı tetikler

İşlem Kimliği:: GetOnSegmentUpdated

Bu işlem, Dynamics 365 Customer Insights'ta segment eşiği aşıldığında bir akışı tetikler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Örnek Adı	dataset	True	string	Bir örnek seçin.
Segment adı	segment	True	string	Bir segment seçin.
Eşik	threshold	True	integer	Herhangi bir sayıyı eşik olarak ayarlayın.

Döndürülenler

Verileri segmentlere ayırma

Body: SegmentData

Yenileme başarısız olduğunda veri kaynağından bir akışı tetikler

İşlem Kimliği:: GetOnDataSourceRefreshFail

Bu işlem, Dynamics 365 Customer Insights'ta yenileme başarısız olduğunda veri kaynağından bir akışı tetikler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Çevre	dataset	True	string	veri kümesi adı.

Döndürülenler

DataSourcesList

Body: DataSourcesList

Yenileme tamamlandığında veri kaynağından bir akışı tetikler

İşlem Kimliği:: GetOnDataSourceRefreshComplete

Bu işlem, Dynamics 365 Customer Insights'ta yenileme tamamlandığında veri kaynağından bir akışı tetikler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Çevre	dataset	True	string	veri kümesi adı.

Döndürülenler

DataSourcesList

Body: DataSourcesList

Tanımlar

DataSourcesList

Name	Yol	Tür	Description
value	value	array of DataSource	Veri kaynaklarının listesi

Veri Kaynağı

DataSource Sınıfı

Name	Yol	Tür	Description
RefreshType	RefreshType	string	Veri yenileme türü
RefreshObjectId	RefreshObjectId	string	Nesne kimliğini yenileme
RefreshObjectVersion	RefreshObjectVersion	integer	Nesne sürümünü yenileme
Operation	Operation	string	İşlem adı
JobType	JobType	string	İş türü
ErrorCode	ErrorCode	string	Veri yenileme sırasındaki hata kodu.
Hata Mesajı	ErrorMessage	string	Yenileme sırasında hata iletisi
ErrorSeverity	ErrorSeverity	string	Yenileme sırasında hata sunucusu
StartTimeUtc	StartTimeUtc	string	Veri yenileme için başlangıç zamanı
EndTimeUtc	EndTimeUtc	string	Veri yenileme için bitiş saati

SegmentData

Verileri segmentlere ayırma

Name	Yol	Tür	Description
İsim	Name	string	Segment adı
Gösterim Adı	DisplayName	string	Segment görünen adı
EvaluationDate	EvaluationDate	date-time	Segment değerlendirme tarihi
EntityCount	EntityCount	integer	Segment üyelerinin gerçek sayısı
Eşik	Threshold	integer	Segment eşiği

MeasureData

İş Ölçüsü verileri

Name	Yol	Tür	Description
İsim	Name	string	Ölçü adı
Gösterim Adı	DisplayName	string	Ölçü görünen adı
EvaluationDate	EvaluationDate	date-time	Ölçü değerlendirme tarihi
Değer	Value	double	Ölçünün değeri
ValueDisplayName	ValueDisplayName	string	Değerin görünen adı
Eşik	Threshold	double	Ölçü eşiği

FullRefreshProcessData

Yürütülen tam yenileme hakkındaki bilgiler

Name	Yol	Tür	Description
NumberOfFailedTasks	NumberOfFailedTasks	integer	Başarısız görevlerin sayısı
StartTime	StartTime	date-time	İş akışı adımının başlangıç saati
EndTime	EndTime	date-time	İş akışı adımının bitiş saati
Süre	Duration	integer	İşlemin dakika cinsinden süresi
Statü	Status	string	İş akışı adımının durumu
StatusPage (Durum Sayfası)	StatusPage	string	Durum sayfasının bağlantısı

ProcessData

Yürütülen işlem hakkındaki bilgiler

Name	Yol	Tür	Description
StartTime	StartTime	date-time	İş akışı adımının başlangıç saati
EndTime	EndTime	date-time	İş akışı adımının bitiş saati
Süre	Duration	integer	İşlemin dakika cinsinden süresi
Statü	Status	string	İş akışı adımının durumu
StatusPage (Durum Sayfası)	StatusPage	string	Durum sayfasının bağlantısı

Tablo

Tabloyu temsil eder.

Name	Yol	Tür	Description
İsim	Name	string	Tablonun adı. Ad çalışma zamanında kullanılır.
Gösterim Adı	DisplayName	string	Tablonun görünen adı.
DynamicProperties	DynamicProperties	object	Bağlayıcı tarafından istemcilere sağlanan ek tablo özellikleri.

PartitionListResponse

Bölümlerin listesi

Name	Yol	Tür	Description
Header	Header	string	Varlığın özniteliklerini içeren üst bilgi
Partitions	Partitions	array of Table	Bölümlerin listesi

PartitionDataResponse

Bir bölümdeki veriler.

Name	Yol	Tür	Description
OffsetStart	OffsetStart	integer	Başlangıç uzaklığı.
OffsetEnd	OffsetEnd	integer	Bitiş uzaklığı.
Boyut	Size	integer	Döndürülen veri sayısı.
Eşya	Items	array of object	'OffsetStart' ile 'OffsetEnd' uzaklığı arasında bir bölümden en fazla 'Boyut' öğesi içeren sözlük.
items	Items	object

TablesList

Tablo listesini temsil eder.

Name	Yol	Tür	Description
value	value	array of Table	Tablo Listesi