Microsoft Dynamics 365-Verbindung
Übersicht overview
Microsoft Dynamics 365 ist eine Cloud-basierte Plattform für geschäftliche Anwendungen, die Enterprise Resource Planning (ERP) und Customer Relationship Management (CRM) mit Produktivitätsanwendungen und KI-Tools kombiniert, um einen rundum reibungsloseren und besser kontrollierten Betrieb, besseres Wachstumspotenzial und Kostenreduzierungen zu erzielen.
Dieses Adobe Experience Platform Ziel nutzt den Contact Entity Reference API, der es Ihnen ermöglicht, Identitäten innerhalb einer Zielgruppe in Dynamics 365 zu aktualisieren.
Dynamics 365 verwendet OAuth 2 mit Autorisierungs-Grant als Authentifizierungsmechanismus für die Kommunikation mit der Contact Entity Reference API. Anweisungen zur Authentifizierung bei Ihrer Dynamics 365-Instanz sehen Sie weiter unten im Abschnitt Authentifizieren bei Ziel.
Anwendungsbeispiele use-cases
Als Marketing-Experte können Sie Ihren Benutzern personalisierte Erlebnisse auf der Basis von Attributen aus ihren Adobe Experience Platform-Profilen bereitstellen. Sie können Zielgruppen aus Ihren Offline-Daten erstellen und diese Zielgruppen an Dynamics 365 senden, um sie in den Feeds der Benutzer anzuzeigen, sobald Zielgruppen und Profile in Adobe Experience Platform aktualisiert wurden.
Voraussetzungen prerequisites
Voraussetzungen für Experience Platform prerequisites-in-experience-platform
Bevor Sie Daten für das Ziel Dynamics 365 aktivieren, müssen Sie über ein Schema, einen Datensatz und Zielgruppen verfügen, die in Experience Platform erstellt wurden.
Weitere Informationen zum Zielgruppenstatus finden Sie in der Adobe-Dokumentation für die Schemafeldergruppe Zielgruppenzugehörigkeitsdetails .
Voraussetzungen für Microsoft Dynamics 365 prerequisites-destination
Beachten Sie die folgenden Voraussetzungen in Dynamics 365, um Daten von Platform in Ihr Dynamics 365-Konto zu exportieren:
Sie benötigen ein Microsoft Dynamics 365-Konto prerequisites-account
Navigieren Sie zur Testversion-Seite von Dynamics 365, um sich zu registrieren und ein Konto zu erstellen, falls Sie noch keines haben.
Erstellen eines Felds in Dynamics 365 prerequisites-custom-field
Erstellen Sie das benutzerdefinierte Feld des Typs Simple
mit dem Felddatentyp Single Line of Text
, mit dem Experience Platform den Zielgruppenstatus in Dynamics 365 aktualisiert.
Weitere Informationen finden Sie in der Dokumentation zum Dynamics 365 Erstellen oder Bearbeiten eines Felds (Attribut) .
Notieren Sie sich das Präfix der Anpassung des benutzerdefinierten Felds, das Sie in Dynamics 365 erstellen. Sie benötigen dieses Präfix während des Schritts Ausfüllen der Zieldetails . Weitere Informationen finden Sie im Abschnitt Felder erstellen und bearbeiten der Dokumentation zu Dynamics 365 .
Im Folgenden sehen Sie ein Beispiel-Setup in Dynamics 365:
Registrieren von Programmen und Programmbenutzern in Azure Active Directory prerequisites-app-user
Um Dynamics 365 für den Zugriff auf Ressourcen zu aktivieren, müssen Sie sich mit Ihrem Azure Account bei Azure Active Directory anmelden und Folgendes erstellen:
- Ein Azure Active Directory-Programm
- Einen Dienstprinzipal
- Einen Programm-Geheim-Code
Sie müssen außerdem Programmbenutzer in Azure Active Directory erstellen und sie mit dem neu erstellten Programm verknüpfen.
Sammeln von Dynamics 365-Anmeldeinformationen gather-credentials
Beachten Sie die folgenden Punkte, bevor Sie sich beim Dynamics 365-CRM-Ziel authentifizieren:
Client ID
ababbaba-abab-baba-acac-acacacacacac
Client Secret
abcde~abcdefghijklmnopqrstuvwxyz12345678
für Anleitung.Tenant ID
1234567-aaaa-12ab-ba21-1234567890
Region
Eine Anleitung finden Sie in der Dynamics 365 Dokumentation .
org57771b33.
crm
.dynamics.comBeispiel: Wenn Ihr Unternehmen in der Region Nordamerika (NAM) bereitgestellt wird, wäre Ihre URL
crm.dynamics.com
und Sie müssen crm
auswählen. Wenn Ihr Unternehmen in der Region Kanada (CAN) bereitgestellt wird, lautet Ihre URL crm3.dynamics.com
und Sie müssen crm3
auswählen.Environment URL
org57771b33
.crm.dynamics.comLeitplanken guardrails
Auf der Seite Anforderungsbeschränkungen und Zuweisungen werden die Dynamics 365-API-Beschränkungen für Ihre Dynamics 365-Lizenz detailliert aufgeführt. Sie müssen sicherstellen, dass Ihre Daten und Payloads innerhalb dieser Beschränkungen liegen.
Unterstützte Identitäten supported-identities
Dynamics 365 unterstützt die Aktualisierung von Identitäten, die in der folgenden Tabelle beschrieben werden. Erhalten Sie weitere Informationen zu Identitäten.
contactid
Unterstützte Zielgruppen supported-audiences
In diesem Abschnitt werden alle Zielgruppen beschrieben, die Sie an dieses Ziel exportieren können.
Dieses Ziel unterstützt die Aktivierung aller durch die Experience Platform generierten Zielgruppen über den Segmentierungsdienst.
Exporttyp und -häufigkeit export-type-frequency
Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.
- Sie exportieren alle Mitglieder einer Zielgruppe zusammen mit den gewünschten Schemafeldern (z. B. E-Mail-Adresse, Telefonnummer, Nachname) gemäß Ihrer Feldzuordnung.
- Jeder Zielgruppenstatus in Dynamics 365 wird anhand des Werts Zuordnungs-ID aktualisiert, der während des Schritts Zielgruppenplanung angegeben wurde, und erhält den entsprechenden Zielgruppenstatus von Platform.
- Streaming-Ziele sind „immer verfügbare“ API-basierte Verbindungen. Sobald ein Profil in Experience Platform auf der Grundlage einer Zielgruppenauswertung aktualisiert wird, sendet der Connector das Update nachgelagert an die Zielplattform. Lesen Sie mehr über Streaming-Ziele.
Herstellen einer Verbindung mit dem Ziel connect
Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Tutorial zur Zielkonfiguration beschrieben vor. Füllen Sie im Workflow zum Konfigurieren des Ziels die Felder aus, die in den beiden folgenden Abschnitten aufgeführt sind.
Suchen Sie in Ziele > Katalog nach Dynamics 365. Alternativ können Sie es unter der CRM-Kategorie finden.
Beim Ziel authentifizieren authenticate
Um sich beim Ziel zu authentifizieren, wählen Sie Mit Ziel verbinden.
Füllen Sie die erforderlichen Felder aus. Eine Anleitung dazu finden Sie im Abschnitt Sammeln von Dynamics 365-Anmeldeinformationen.
- Client-ID: Die Dynamics 365-Client-ID für Ihr Azure Active Directory-Programm.
- Mandanten-ID: Die Dynamics 365-Mandanten-ID für Ihr Azure Active Directory-Programm.
- Client-Geheimnis: Der Dynamics 365-Client-Geheim-Code für Ihr Azure Active Directory-Programm.
- Region: Ihre Dynamics 365 Region. Beispiel: Wenn Ihr Unternehmen in der Region Nordamerika (NAM) bereitgestellt wird, lautet Ihre URL
crm.dynamics.com
und Sie müssencrm
auswählen. Wenn Ihr Unternehmen in der Region Kanada (CAN) bereitgestellt wird, lautet Ihre URLcrm3.dynamics.com
und Sie müssencrm3
auswählen. - Umgebungs-URL: Ihre Dynamics 365-Umgebungs-URL.
Wenn die angegebenen Details gültig sind, zeigt die Benutzeroberfläche den Status Verbunden mit einem grünen Häkchen an. Sie können dann mit dem nächsten Schritt fortfahren.
Ausfüllen der Zieldetails destination-details
Füllen Sie die folgenden erforderlichen und optionalen Felder aus, um Details für das Ziel zu konfigurieren. Ein Sternchen neben einem Feld in der Benutzeroberfläche zeigt an, dass das Feld erforderlich ist.
- Name: Ein Name, durch den Sie dieses Ziel in Zukunft erkennen können.
- Beschreibung: Eine Beschreibung, die Ihnen hilft, dieses Ziel in Zukunft zu identifizieren.
- Anpasspräfix: Die
Customization prefix
des benutzerdefinierten Felds, das Sie in Dynamics 365 erstellt haben. Weitere Informationen finden Sie im Abschnitt Felder erstellen und bearbeiten der Dokumentation zu Dynamics 365 .
Aktivieren von Warnhinweisen enable-alerts
Sie können Warnhinweise aktivieren, um Benachrichtigungen zum Status des Datenflusses zu Ihrem Ziel zu erhalten. Wählen Sie einen Warnhinweis aus der zu abonnierenden Liste aus, um Benachrichtigungen über den Status Ihres Datenflusses zu erhalten. Weitere Informationen zu Warnhinweisen finden Sie im Handbuch zum Abonnieren von Zielwarnhinweisen über die Benutzeroberfläche.
Wenn Sie alle Details für Ihre Zielverbindung eingegeben haben, klicken Sie auf Weiter.
Aktivieren von Zielgruppen für dieses Ziel activate
- Um Daten zu aktivieren, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen .Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
- Um identities zu exportieren, benötigen Sie die Zugriffssteuerungsberechtigung Identitätsdiagramm anzeigen 🔗.
Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Profilen und Zielgruppen für Streaming-Zielgruppen-Exportziele.
Zuordnungsüberlegungen und Beispiel mapping-considerations-example
Um Ihre Zielgruppendaten ordnungsgemäß von Adobe Experience Platform an das Dynamics 365-Ziel zu senden, müssen Sie den Schritt zur Feldzuordnung durchlaufen. Die Zuordnung besteht darin, eine Verknüpfung zwischen den Schemafeldern Ihres Experience-Datenmodells (XDM) in Ihrem Platform-Konto und den jeweiligen Entsprechungen vom Ziel zu erstellen. Um Ihre XDM-Felder den Dynamics 365-Zielfeldern korrekt zuzuordnen, führen Sie die folgenden Schritte aus:
-
Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird eine neue Zuordnungszeile angezeigt.
-
Wählen Sie im Fenster Quellfeld auswählen die Kategorie Identity-Namespace auswählen und klicken Sie auf
contactid
.
-
Wählen Sie im Fenster Zielfeld auswählen den Typ des Zielfelds aus, dem Sie Ihr Quellfeld zuordnen möchten.
-
Identity-Namespace auswählen: Wählen Sie diese Option aus, um Ihr Quellfeld einem Identity-Namespace aus der Liste zuzuordnen.
-
Fügen Sie die folgende Zuordnung zwischen Ihrem XDM-Profilschema und Ihrer Dynamics 365-Instanz hinzu:
|XDM-Profilschema|Dynamics 365 Instanz| Obligatorisch|
|—|—|—|
|contactid
|contactid
| Ja | -
Benutzerdefinierte Attribute auswählen: Wählen Sie diese Option aus, um Ihr Quellfeld einem benutzerdefinierten Attribut zuzuordnen, das Sie im Feld Attributname definieren. Eine umfassende Liste der unterstützten Attribute finden Sie in der Dynamics 365 Dokumentation.
note important IMPORTANT - Die Zielfeldnamen müssen in
lowercase
stehen. - Wenn Sie außerdem über ein Quellfeld für Datum oder Zeitstempel verfügen, das einem Zielfeld für Dynamics 365 Datum oder Zeitstempel zugeordnet ist, stellen Sie sicher, dass der zugeordnete Wert nicht leer ist. Wenn der exportierte Feldwert leer ist, wird eine Fehlermeldung vom Typ
Bad request reported while pushing events to the destination. Please contact the administrator and try again.
ausgegeben und die Daten werden nicht aktualisiert. Dies ist eine Dynamics 365-Beschränkung.
- Die Zielfeldnamen müssen in
-
Fügen Sie je nach den Werten, die Sie aktualisieren möchten, beispielsweise die folgende Zuordnung zwischen Ihrem XDM-Profilschema und Ihrer Dynamics 365-Instanz ein:
|XDM-Profilschema|Dynamics 365 Instanz|
-
|—|—|
|person.name.firstName
|firstname
|
|person.name.lastName
|lastname
|
|personalEmail.address
|emailaddress1
|
-
Nachfolgend finden Sie ein Beispiel für die Verwendung dieser Zuordnungen:
Zielgruppenexport und Beispiel planen schedule-audience-export-example
Im Schritt Zielgruppenexport planen des Aktivierungs-Workflows müssen Sie Platform-Zielgruppen manuell dem benutzerdefinierten Feldattribut in Dynamics 365 zuordnen.
Wählen Sie dazu jede Zielgruppe aus und geben Sie dann das entsprechende benutzerdefinierte Feldattribut von Dynamics 365 in das Feld Zuordnungs-ID ein.
Nachfolgend finden Sie ein Beispiel:
Überprüfen des Datenexports exported-data
Gehen Sie wie folgt vor, um zu überprüfen, ob Sie das Ziel korrekt eingerichtet haben:
-
Wählen Sie Ziele > Durchsuchen aus, um zur Liste der Ziele zu navigieren.
-
Wählen Sie das Ziel aus und überprüfen Sie, ob der Status aktiviert ist.
-
Wechseln Sie zur Registerkarte Activation data und wählen Sie einen Zielgruppennamen aus.
-
Überwachen Sie die Audience-Zusammenfassung und stellen Sie sicher, dass die Anzahl der Profile der in der Audience erstellten Anzahl entspricht.
-
Melden Sie sich bei der Dynamics 365 -Website an, navigieren Sie zur Seite Customers > Contacts und überprüfen Sie, ob die Profile aus der Zielgruppe hinzugefügt wurden. Sie können sehen, dass jeder Zielgruppenstatus in Dynamics 365 anhand des Werts Zuordnungs-ID, der beim Schritt Zielgruppenplanung angegeben wurde, mit dem entsprechenden Zielgruppenstatus von Platform aktualisiert wurde.
Datennutzung und -Governance data-usage-governance
Alle Adobe Experience Platform-Ziele sind bei der Verarbeitung Ihrer Daten mit Datennutzungsrichtlinien konform. Ausführliche Informationen darüber, wie Adobe Experience Platform Data Governance erzwingt, finden Sie unter Data Governance – Übersicht.
Fehler und Fehlerbehebung errors-and-troubleshooting
Unbekannte Fehler beim Pushen von Ereignissen an das Ziel aufgetreten unknown-errors
Wenn Sie beim Überprüfen eines Datenflusses die folgende Fehlermeldung erhalten: Bad request reported while pushing events to the destination. Please contact the administrator and try again.
Um diesen Fehler zu beheben, überprüfen Sie, ob die Zuordnungs-ID, die Sie in Dynamics 365 für Ihre Platform-Audience angegeben haben, gültig ist und in Dynamics 365 vorhanden ist.
Weitere Ressourcen additional-resources
Weitere nützliche Informationen aus der Dynamics 365 Dokumentation finden Sie im Folgenden:
Änderungsprotokoll
In diesem Abschnitt werden aktualisierte Funktionen und wesentliche Dokumentationsänderungen für diesen Ziel-Connector erfasst.
table 0-row-3 1-row-3 2-row-3 3-row-3 layout-auto | ||
---|---|---|
Veröffentlichungsmonat | Art der Aktualisierung | Beschreibung |
Oktober 2023 | Aktualisierung der Dokumentation | Die Anleitung wurde aktualisiert, um anzugeben, dass alle Zielattribut-Namen in Kleinbuchstaben geschrieben werden sollten, und zwar in den Schritten Zuordnen und Beispiel . |
August 2023 | Funktions- und Dokumentationsaktualisierung | Unterstützung für benutzerdefinierte Feldpräfixe mit Dynamics 365 für benutzerdefinierte Felder hinzugefügt, die nicht in der Standardlösung in Dynamics 365 erstellt wurden. Im Schritt Zieldetails ausfüllen wurde ein neues Eingabefeld hinzugefügt, das Anpasspräfix. (PLATIR-31602). |
November 2022 | Erstmalige Veröffentlichung | Erste Zielversion und Veröffentlichung der Dokumentation. |