DokumentationExperience PlatformZielhandbuch

Microsoft Dynamics 365-Verbindung

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
  • Benutzende

Ü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 die Contact Entity Reference API, mit der Sie Identitäten innerhalb einer Zielgruppe in Dynamics 365 aktualisieren können.

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, damit sie in den Feeds der Benutzer angezeigt werden, sobald Zielgruppen und Profile in Adobe Experience Platform aktualisiert werden.

Voraussetzungen prerequisites

Voraussetzungen für Experience Platform prerequisites-in-experience-platform

Bevor Sie Daten für das Dynamics 365-Ziel aktivieren, müssen Sie ein Schema, einen Datensatz und Audiences in Experience Platform erstellt haben.

Weitere Informationen finden Sie in der AdobeDokumentation zur Schemafeldgruppe „Details zur Zielgruppenzugehörigkeit , wenn Sie Anleitungen zu Zielgruppenstatus benötigen.

Voraussetzungen für Microsoft Dynamics 365 prerequisites-destination

Beachten Sie die folgenden Voraussetzungen in Dynamics 365, um Daten aus Experience 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 vom Typ Simple mit dem Felddatentyp , Single Line of Text den Experience Platform verwendet, um den Zielgruppenstatus in Dynamics 365 zu aktualisieren.

Weitere Anleitungen finden Sie in der Dynamics 365 Erstellen oder Bearbeiten eines Felds (Attribut).

Notieren Sie sich das Anpassungspräfix 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 im Abschnittund Bearbeiten von Feldern in der Dynamics 365.
Screenshot der Dynamics 365-Benutzeroberfläche mit dem Anpassungspräfix.

Im Folgenden sehen Sie ein Beispiel-Setup in Dynamics 365:
Screenshot der Benutzeroberfläche von Dynamics 365 mit den benutzerdefinierten Feldern.

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-Anmeldedaten gather-credentials

Beachten Sie die folgenden Punkte, bevor Sie sich beim Dynamics 365-CRM-Ziel authentifizieren:

Anmeldedaten
Beschreibung
Beispiel
Client ID
Die Dynamics 365-Client-ID für Ihr Azure Active Directory-Programm. Eine Anleitung finden Sie in der Dynamics 365 Dokumentation.
ababbaba-abab-baba-acac-acacacacacac
Client Secret
Den Dynamics 365-Client-Geheim-Code für Ihr Azure Active Directory-Programm. Sie würden Option 2 innerhalb der Dynamics 365 Dokumentation verwenden.
abcde~abcdefghijklmnopqrstuvwxyz12345678 für Anleitung.
Tenant ID
Die Dynamics 365-Mandanten-ID für Ihr Azure Active Directory-Programm. Eine Anleitung dazu finden Sie in der Dynamics 365 Dokumentation.
1234567-aaaa-12ab-ba21-1234567890
Region
Die mit der Umgebungs-URL verknüpfte Microsoft-Region.
Anleitungen finden Sie Dynamics 365 der.
Wenn Ihre Domain wie im Folgenden aussieht, müssen Sie bei der Authentifizierung beim Ziel“ den hervorgehobenen Wert für das CRMFeld in der Dropdown-Auswahl angeben
org57771b33.crm.dynamics.com
Beispiel: Wenn Ihr Unternehmen in der Region Nordamerika (NAM) bereitgestellt wird, ist Ihre URL crm.dynamics.com, und Sie müssen crm auswählen. Wenn Ihr Unternehmen in der Region Kanada (CAN) bereitgestellt ist, wird Ihre URL crm3.dynamics.com und Sie müssen crm3 auswählen.
Environment URL
Siehe die Dynamics 365 Dokumentation, um eine Anleitung zu erhalten.
Wenn Ihre Dynamics 365-Domain wie im Folgenden aussieht, benötigen Sie den hervorgehobenen Wert.
org57771b33.crm.dynamics.com

Leitplanken 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.

Ziel-Identität
Beispiel
Beschreibung
Zu beachten
contactid
7eb682f1-ca75-e511-80d4-00155d2a68d1
Eindeutige Kennung für einen Kontakt.
Obligatorisch. Siehe die Dynamics 365 Dokumentation, um weitere Informationen zu erhalten.

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.

Element
Typ
Anmerkungen
Exporttyp
Profilbasiert
  • Sie exportieren alle Mitglieder einer Zielgruppe zusammen mit den gewünschten Schemafeldern z. B. E-Mail-Adresse, Telefonnummer, Nachname) entsprechend Ihrer Feldzuordnung.
  • Jeder Zielgruppenstatus in Dynamics 365 wird mit dem entsprechenden Zielgruppenstatus von Experience Platform aktualisiert, basierend auf dem Wert Zuordnungs-ID, der im Schritt Zielgruppen-Planung angegeben wurde.
Exporthäufigkeit
Streaming
  • 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

IMPORTANT
Um eine Verbindung mit dem Ziel herzustellen, benötigen Sie Ziele anzeigen und Ziele verwalten Zugriffssteuerungsberechtigungen. Lesen Sie die Zugriffskontrolle – Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.

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.
Screenshot der Experience Platform-Benutzeroberfläche, auf dem die Authentifizierung gezeigt wird.

Füllen Sie die erforderlichen Felder aus. Eine Anleitung dazu finden Sie im Abschnitt Sammeln von Dynamics 365-Anmeldedaten.

  • 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. Ein Beispiel: Wenn Ihr Unternehmen in der Region Nordamerika (NAM) bereitgestellt wird, ist Ihre URL crm.dynamics.com und Sie müssen crm auswählen. Wenn Ihr Unternehmen in der Region Kanada (CAN) bereitgestellt ist, wird Ihre URL crm3.dynamics.com und Sie müssen crm3 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.
Screenshot der Experience Platform-Benutzeroberfläche mit den Zieldetails.

  • 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.
  • Anpassungspräfix: Die Customization prefix des benutzerdefinierten Felds, das Sie in Dynamics 365 erstellt haben. Weitere Informationen finden im Abschnittund Bearbeiten von Feldern in der 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

IMPORTANT

  • Zum Aktivieren von Daten benötigen Sie die Berechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen ​Zugriffssteuerung. Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.

  • Zum Exportieren Identitäten benötigen Sie die Berechtigung Identitätsdiagramm anzeigen Zugriffssteuerung.

    Wählen Sie einen im Workflow hervorgehobenen Identity-Namespace aus, um Zielgruppen für Ziele zu aktivieren. {width="100" modal="regular"}

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 Experience Platform-Konto und den entsprechenden Entsprechungen vom Ziel zu erstellen. Um Ihre XDM-Felder den Dynamics 365-Zielfeldern korrekt zuzuordnen, führen Sie die folgenden Schritte aus:

  1. Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird eine neue Zuordnungszeile angezeigt.
    Beispiel-Screenshot der Experience Platform-Benutzeroberfläche für „Neue Zuordnung hinzufügen“.

  2. Wählen Sie im Fenster Quellfeld auswählen die Kategorie Identity-Namespace auswählen und klicken Sie auf contactid.
    Screenshot-Beispiel der Experience Platform-Benutzeroberfläche für die Source-Zuordnung.

  3. 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.

      Screenshot der Experience Platform-Benutzeroberfläche mit Ziel-Zuordnung für contactId.

    • Fügen Sie die folgende Zuordnung zwischen Ihrem XDM-Profilschema und Ihrer Dynamics 365-Instanz hinzu:

      table 0-row-3 1-row-3
      XDM-Profilschema Instanz Dynamics 365 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.

      Screenshot der Experience Platform-Benutzeroberfläche mit Ziel-Zuordnung für E-Mail.

      note important
      IMPORTANT
      • Die Namen der Zielfelder sollten in lowercase sein.
      • Wenn Sie außerdem über ein Quellfeld für Datum oder Zeitstempel verfügen, das einem Zielfeld vom Typ Dynamics 365 ( oder Zeitstempel zugeordnet ist, stellen Sie sicher, dass der zugeordnete Wert nicht leer ist. Wenn der exportierte Feldwert leer ist, wird die Bad request reported while pushing events to the destination. Please contact the administrator and try again. Fehlermeldung angezeigt und die Daten werden nicht aktualisiert. Dies ist eine Dynamics 365-Beschränkung.

    • 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 hinzu:

      table 0-row-2 1-row-2 2-row-2 3-row-2
      XDM-Profilschema Instanz Dynamics 365
      person.name.firstName firstname
      person.name.lastName lastname
      personalEmail.address emailaddress1

    • Nachfolgend finden Sie ein Beispiel für die Verwendung dieser Zuordnungen:

    Beispiel-Screenshot der Experience Platform-Benutzeroberfläche mit Ziel-Zuordnungen.

Planen des Zielgruppenexports und Beispiel schedule-audience-export-example

Im Schritt Planen des Zielgruppenexports des Aktivierungs-Workflows müssen Sie Experience 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 aus Dynamics 365 in das Feld Zuordnungs-ID ein.

IMPORTANT
Der für die Zuordnungs-ID verwendete Wert sollte genau mit dem Namen des benutzerdefinierten Feldattributs übereinstimmen, das in Dynamics 365 erstellt wurde. Siehe die Dynamics 365 Dokumentation, wenn Sie Anleitungen zum Auffinden Ihrer benutzerdefinierten Feldattribute benötigen.

Nachfolgend finden Sie ein Beispiel:
Beispiel-Screenshot der Experience Platform-Benutzeroberfläche mit der Option „Zielgruppenexport planen“.

Überprüfen des Datenexports exported-data

Gehen Sie wie folgt vor, um zu überprüfen, ob Sie das Ziel korrekt eingerichtet haben:

  1. Wählen Sie Ziele > Durchsuchen aus, um zur Liste der Ziele zu navigieren.
    Screenshot der Experience Platform-Benutzeroberfläche mit den Durchsuchen-Zielen.

  2. Wählen Sie das Ziel aus und überprüfen Sie, ob der Status aktiviert ist.
    Screenshot der Experience Platform-Benutzeroberfläche mit Zielen der Datenflussausführung.

  3. Wechseln Sie zur Registerkarte Activation data und wählen Sie einen Zielgruppennamen aus.
    Beispiel-Screenshot der Experience Platform-Benutzeroberfläche mit Daten zur Aktivierung von Zielen.

  4. Überwachen Sie die Zielgruppenzusammenfassung und stellen Sie sicher, dass die Anzahl der Profile der in der Zielgruppe erstellten Anzahl entspricht.
    Beispiel-Screenshot der Experience Platform-Benutzeroberfläche mit der Zielgruppe.

  5. Melden Sie sich bei der Dynamics 365-Website an und navigieren Sie dann zur Seite Customers > Contacts , um zu überprüfen, ob die Profile aus der Audience hinzugefügt wurden. Sie können sehen, dass jeder Zielgruppenstatus in Dynamics 365 mit dem entsprechenden Zielgruppenstatus von Experience Platform aktualisiert wurde, basierend auf dem Wert Zuordnungs-ID, der im Schritt Zielgruppen-Planung angegeben wurde.
    Screenshot der Dynamics 365-Benutzeroberfläche mit der Seite „Kontakte“ und aktualisierten Zielgruppenstatus.

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.

Screenshot der Experience Platform-Benutzeroberfläche mit Fehlermeldung wegen fehlerhafter Anfrage.

Um diesen Fehler zu beheben, überprüfen Sie, ob die Zuordnungs-ID, die Sie in Dynamics 365 für Ihre Experience Platform-Zielgruppe angegeben haben, in Dynamics 365 vorhanden und gültig 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.

Änderungsprotokoll anzeigen
table 0-row-3 1-row-3 2-row-3 3-row-3 layout-auto
Veröffentlichungsmonat Art der Aktualisierung Beschreibung
Oktober 2023 Dokumentation aktualisieren Aktualisierte Anleitungen, um anzugeben, dass alle Zielattributnamen im Schritt Zuordnungsüberlegungen und Beispiel“ in Kleinbuchstabenwerden sollten.
August 2023 Funktions- und Dokumentationsaktualisierung Es wurde Unterstützung für Dynamics 365 benutzerdefinierte Feldpräfixe für benutzerdefinierte Felder hinzugefügt, die nicht innerhalb der Standardlösung in Dynamics 365 erstellt wurden. Ein neues Eingabefeld, Anpassungspräfix, wurde im Schritt Ausfüllen der Zieldetails hinzugefügt. (PLATIR-31602).
November 2022 Erstmalige Veröffentlichung Erstmalige Zielveröffentlichung und Dokumentation.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6