Freigeben über

Dataverse APIs für Customer Insights - Data

  • Artikel

Wenn Sie Customer Insights - Data-APIs bereits verwenden, z. B. zum Abfragen eines Kundenprofils oder zum Abrufen von Segmentmitgliedschaften, empfehlen wir Ihnen stattdessen, Ihre APIs zu Dataverse-APIs zu migrieren. Unterstützung für die Abfrage von Metadaten, wie zum Beispiel das Abrufen von Segmentdefinitionen und die Workflow-Verwaltung, wird in Kürze für Dataverse APIs verfügbar sein.

Wenn Sie mit der Abfrage von Daten mithilfe von APIs beginnen, empfehlen wir stattdessen die Verwendung von Dataverse APIs.

Wichtig

Es wird empfohlen, Dataverse-APIs nur zum Lesen von Daten (GET) und nicht zum Schreiben von Daten (POST/PATCH/PUT) zu verwenden, da dies zu Problemen bei der Customer Insights - Data-Verarbeitung führen kann.

Dataverse-APIs bieten die folgenden Vorteile:

  • Erweiterte Möglichkeiten zum Filtern und Sortieren

  • Verbesserte Saklierung und Leistung

  • Konsistente API-Erfahrung über Dynamics 365 und Power Platform Apps hinweg

Beispielabfragen

Um mit der Verwendung von Dataverse-APIs zu beginnen, erstellen Sie eine Anwendungsregistrierung in Azure, fordern Sie Berechtigungen für Dataverse an und erteilen Sie Ihre App-Viewer-Berechtigungen in Customer Insights - Data.

Sie müssen die Abfragebeispiele ändern, damit sie in den Zielumgebungen funktionieren:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/, wobei {Organisations-URI} der URI des Dataverse-Mandanten ist, der Ihrer Umgebung zugeordnet ist. Beispiel: https://{mydvorg}.crm.dynamics.com

  • {CID}: GUID eines einheitlichen Kundendatensatzes. Beispiel: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: Identifikator des Primärschlüssels eines Kundendatensatzes in einer Datenquelle. Beispiel: CNTID_1002.

  • {DSname}: Zeichenfolge mit dem Tabellennamen einer Datenquelle, die in Customer Insights - Data aufgenommen wird. Beispiel: Website_contacts.

  • {SegmentName}: Zeichenfolge mit dem Ausgabetabellennamen eines Segments. Beispiel: Male_under_40.

  • {CookieId}: Kennung für jeden Website-Besucher. Diese wird automatisch bei Verwendung des Webnachverfolgungsskripts generiert. Beispiel: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

Kundin/Kunde

Beispielabfragen für die CustomerProfile Tabelle und Segmentmitgliedschaften.

Abfragetyp Beispiel Anmerkung
Alle Kunden abrufen {serviceRoot}/msdynci_customerprofiles
Kunde nach ID abrufen {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
Kunde nach Alternativschlüssel abrufen {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' Alternative Schlüssel bleiben in der einheitlichen Kundentabelle im Format msdynci_DSname_TableName_PrimaryKeyColumnName bestehen
Ausgewählte Attribute für einen Kunden auswählen {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
Kunde nach ID abrufen (In) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
Kunde nach Alternativschlüssel abrufen (In) {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
Suche nach Kunden {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
Erhalten Sie alle Kunden, die Mitglieder eines Segments sind {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
Einen Kunden abrufen, wenn er Mitglied eines Segments ist {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
Alle Segmentmitgliedschaften für einen Kunden abrufen {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

Webpersonalisierung

Beispielabfragen zur Personalisierung Ihrer Website basierend auf der CookieId. Die Antwort gibt sowohl bekannte als auch unbekannte Kunden zurück.

Abfragetyp Beispiel Anmerkung
Kunde nach CookieId abrufen {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}')
Einen Kunden per CookieId abrufen und Segmente, Maßnahmen und Aktivitäten einschließen {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Aktuelle (letzte 10) Seitenaufrufe eines Kunden per CookieId abrufen {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) Dies kann geändert werden, um bis zu 200 aktuelle Seitenaufrufe zurückzugeben
Aktuelle (letzte 10) Seitenclicks eines Kunden per CookieId abrufen {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) Dies kann geändert werden, um bis zu 200 aktuelle Seitenclicks zurückzugeben

Vereinheitlichte Aktivität

Beispielabfragen für die Tabelle UnifiedActivity.

Abfragetyp Beispiel Anmerkung
Alle Aktivitten für einen Kunden abrufen {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'
Erhalten Sie alle Aktivitäten eines Kunden innerhalb eines Zeitraums {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytime gt 2017-01-01T00:00:00Z and msdynci_activitytime lt 2017-01-01T00:00:00Z
Holen Sie sich alle Aktivitäten eines Aktivitätstyps eines Kunden {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Holen Sie sich alle Aktivitäten eines activityDisplayName eines Kunden {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Holen Sie sich alle Aktivitäten eines Kunden und sortieren Sie diese {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Weitere Beispiele

Beispielabfragen für andere Tabellen.

Abfragetyp Beispiel Anmerkung
Alle Massnahmen für einen Kunden abrufen {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
Erhalten Sie bereicherte Marken eines Kunden {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
Erhalten Sie Interessen eines Kunden {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
KI-Modellergebnisse eines Kunden abrufen {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

Nächste Schritte,