DokumentationCampaignDokumentation zu Campaign v8

Arbeiten mit Campaign und Microsoft Dynamics 365 crm-ms-dynamics

Last update: Wed Sep 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Einsteiger
  • Fortgeschrittener
  • Admin
  • Benutzende

Aktivieren Sie Ihre CRM-Daten für Cross-Channel-Kommunikation: Erfahren Sie, wie Sie Kontakte von Microsoft Dynamics 365 an Adobe Campaign übertragen und Kampagnen-Performance-Daten (Sendungen, Öffnungen, Klicks und Bounces) von Adobe Campaign in Microsoft Dynamics 365 freigeben können.

Sobald die Konfiguration abgeschlossen ist, wird die Datensynchronisation zwischen den Systemen über eine spezielle Workflow-Aktivität durchgeführt. Weitere Informationen.

NOTE
Unterstützte Microsoft Dynamics-Versionen werden in der Kompatibilitätsmatrix von Campaign aufgeführt.

Gehen Sie wie folgt vor, um ein dediziertes externes Konto für den Import und Export von Microsoft Dynamics 365-Daten in Adobe Campaign zu konfigurieren.

Für jedes System müssen diese Schritte von einem Administrator ausgeführt werden.

CAUTION
Die Schritte in dieser Dokumentation helfen Ihnen beim Erstellen von Integrationen/Registrierungen, die die Zuweisung von Berechtigungen und/oder Administratorzugriff erfordern. Sie müssen vor der Ausführung sicherstellen, dass diese Schritte den Richtlinien Ihres Unternehmens entsprechen, und die Schritte dann sorgfältig durchführen.

Microsoft Dynamics 365 konfigurieren config-crm-microsoft

Um Microsoft Dynamics 365 mit Adobe Campaign über die Web-API zu verbinden, melden Sie sich bei Microsoft Azure Directory mit den Anmeldedaten eines globalen Administrators an und führen Sie die folgenden Schritte aus:

  1. Rufen Sie Ihre Dynamics 365-Anwendungs-ID (Client) ab. Weitere Informationen
  2. Generieren Sie die Microsoft Dynamics-Zertifikatschlüsselkennung und Schlüssel-ID. Weitere Informationen
  3. Konfigurieren Sie Berechtigungen. Weitere Informationen
  4. Erstellen Sie einen Anwender. Weitere Informationen
  5. Verschlüsseln Sie den privaten Schlüssel. Weitere Informationen

Abrufen der Dynamics 365 Client-ID get-client-id-microsoft

Um die Anwendungs-(Client-) ID abzurufen, müssen Sie eine Anwendung in Azure Active Directory registrieren.

  1. Gehen Sie zu Azure Active Directory > App-Registrierungen und klicken Sie auf Neue Registrierung.
  2. Geben Sie einen eindeutigen Namen ein, der zur Identifizierung einer Instanz verwendet werden kann, z. B. adobeccampaign<instance identifier>.

Nach dem Speichern weist Microsoft Azure Directory Ihrer Anwendung eine eindeutige Anwendungs-(Client-)-ID zu. Sie benötigen diese ID später bei der Konfiguration von Dynamics 365 in Adobe Campaign.

Weitere Informationen finden Sie in der Dokumentation zu Microsoft Dynamics 365.

Generieren der Microsoft Dynamics-Zertifikatschlüsselkennung und Schlüssel-ID config-certificate-key-id

Um die Zertifikatschlüsselkennung (customKeyIdentifier) und die Schlüssel-ID (keyId) abzurufen, müssen Sie ein Zertifikat hochladen. Zertifikate können als Geheimnisse verwendet werden, um bei Anforderung eines Tokens die Identität der Anwendung zu beweisen. Sie können auch als öffentliche Schlüssel bezeichnet werden.

Gehen Sie wie folgt vor:

  1. Gehen Sie zu Azure Active Directory > App-Registrierungen und wählen Sie die zuvor erstellte Anwendung aus.
  2. Wählen Sie Zertifikate und Geheimnis aus.
  3. Klicken Sie auf der Registerkarte Zertifikate auf Zertifikat hochladen.
  4. Laden Sie Ihr öffentliches Zertifikat hoch.
  5. Klicken Sie auf den Link Manifest, um die Zertifikatschlüsselkennung (customKeyIdentifier) und die Schlüssel-ID (keyId) abzurufen.

Die Zertifikatschlüsselkennung (customKeyIdentifier) und die Schlüssel-ID (keyId) werden in Campaign benötigt, um Ihr externes Microsoft Dynamics 365 CRM-Konto mit dem CRM-OAuth-Zertifikat zu konfigurieren.

Generieren des öffentlichen Zertifikats

Zum Generieren des Zertifikats können Sie "openssl" verwenden.

Beispiel:

code language-none 
- openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout '<'private key name'>' -out '<'public certificate name'>
note note
NOTE
Sie können die Anzahl der Tage, hier -days 365, im Code-Beispiel ändern, sodass der Gültigkeitszeitraum des Zertifikats verlängert wird.

Anschließend müssen Sie das Zertifikat in base64 kodieren. Dazu können Sie einen Base64-Encoder oder die Befehlszeile base64 -w0 private.key für Linux verwenden.

Berechtigungen konfigurieren config-permissions-microsoft

Schritt 1: Konfigurieren Sie die erforderlichen Berechtigungen für die erstellte Anwendung.

  1. Navigieren Sie zu Azure Active Directory > App-Registrierungen und wählen Sie die zuvor erstellte Anwendung aus.
  2. Klicken Sie oben links auf Einstellungen.
  3. Klicken Sie unter Erforderliche Berechtigungen auf Hinzufügen und wählen Sie eine API > Dynamics CRM Online.
  4. Klicken Sie auf Auswählen, aktivieren Sie die Checkbox Zugriff auf Dynamics 365 als Organisationsbenutzer und klicken Sie erneut auf Auswählen.
  5. Wählen Sie dann aus Ihrer Anwendung das Manifest unter dem Menü Verwalten aus.
  6. Ändern Sie im Manifest-Editor die Eigenschaft allowPublicClient von null auf true und klicken Sie auf Speichern.

Schritt 2: Erteilen Sie die Zustimmung durch den Administrator

  1. Gehen Sie zu Azure Active Directory > Enterprise-Anwendungen.
  2. Wählen Sie die Anwendung aus, der Sie eine mandantenweite Administrator-Zustimmung erteilen möchten.
  3. Wählen Sie im Menü im linken Fensterbereich unter Sicherheit die Option Berechtigungen aus.
  4. Klicken Sie auf Administratorzustimmung erteilen.

Weiterführende Informationen dazu finden Sie in der Dokumentation zu Azure.

Anwender erstellen create-app-user-microsoft

NOTE
Dieser Schritt ist bei der Authentifizierung mit einem Passwort optional.

Der Anwendungsbenutzer ist derjenige Benutzer, den die oben registrierte Anwendung verwenden wird. Alle Änderungen, die mit der oben registrierten Anwendung an Microsoft Dynamics vorgenommen werden, erfolgen über diesen Benutzer.

Schritt 1: Einen nicht interaktiven Benutzer in Azure Active Directory erstellen

  1. Klicken Sie auf Azure Active Directory > Benutzer und dann auf Neuer Benutzer.
  2. Geben Sie einen geeigneten Namen ein, den Sie verwenden möchten; der Benutzername sollte im E-Mail-Format vorliegen.
  3. Wählen Sie Dynamics 365-Administrator in der Verzeichnisrolle.

Schritt 2: Dem erstellten Benutzer eine ordnungsgemäße Lizenz zuweisen

  1. Klicken Sie in Microsoft Azure auf Admin-App.
  2. Navigieren Sie zu Benutzer > Aktive Benutzer und klicken Sie auf den neu erstellten Benutzer.
  3. Klicken Sie auf Produktlizenzen bearbeiten und wählen Sie Dynamics 365 Customer Engagement-Plan.
  4. Klicken Sie auf Schließen.

Schritt 3: Anwendungsbenutzer in Dynamics CRM erstellen

  1. Navigieren Sie von Microsoft Azure zu Einstellungen > Sicherheit > Benutzer.
  2. Klicken Sie auf die Dropdown-Liste, wählen Sie dann Anwender und klicken Sie auf Neu.
  3. Verwenden Sie denselben Benutzernamen wie für den Benutzer, der oben in Active Directory erstellt wurde.
  4. Weisen Sie die Anwendungs-ID für die zuvor erstellte Anwendung zu.
  5. Klicken Sie auf Rollen verwalten und wählen Sie den Benutzer die Rolle Systemadministrator für aus.

Campaign konfigurieren configure-acc-for-microsoft

Erstellen der Verbindung new-ms-dyn-external-account

Zunächst müssen Sie das externe Microsoft Dynamics 365-Konto erstellen.

  1. Durchsuchen Sie den Knoten Administration > Plattform > Externe Konten im Campaign Explorer und erstellen Sie ein externes Konto.

  2. Wählen Sie das externe Konto Microsoft Dynamics CRM im Abschnitt Typ aus.

  3. Wählen Sie die Authentifizierungsmethode in der Dropdown-Liste CRM-O-Auth-Typ aus.

    1. Um das externe Microsoft Dynamics CRM-Konto für die Verbindung mit Adobe Campaign mit Passwort-Anmeldedaten zu konfigurieren, geben Sie die folgenden Details an:

      • Server: URL Ihres Microsoft CRM-Servers Um Ihre Microsoft CRM-Server-URL zu finden, rufen Sie Ihr Microsoft Dynamics CRM-Konto auf, klicken Sie dann auf Dynamics 365 und wählen Sie Ihre Anwendung aus. Ihre Server-URL finden Sie dann in der Adressleiste Ihres Browsers, z. B. https://myserver.crm.dynamics.com/.
      • Konto: Konto, mit dem die Anmeldung bei Microsoft CRM erfolgt.
      • Passwort: Passwort, mit dem die Anmeldung bei Microsoft CRM erfolgt.
      • Client-ID: Anwendungs-(Client)-ID, die Sie über das Verwaltungsportal von Microsoft Azure in der Kategorie "Code aktualisieren" im Feld "Client-ID" finden.
      • CRM-Version: Hier wählen Sie die CRM-Version "Dynamics CRM 365" aus.

    2. Um das externe Microsoft Dynamics CRM-Konto für die Verbindung mit Adobe Campaign mit einem Zertifikat zu konfigurieren, geben Sie die folgenden Details an:

      • Server: URL Ihres Microsoft CRM-Servers Um Ihre Microsoft CRM-Server-URL zu finden, rufen Sie Ihr Microsoft Dynamics CRM-Konto auf, klicken Sie dann auf Dynamics 365 und wählen Sie Ihre Anwendung aus. Ihre Server-URL finden Sie dann in der Adressleiste Ihres Browsers, z. B. https://myserver.crm.dynamics.com/.
      • Privater Schlüssel: Kopieren Sie den base64-kodierten privaten Schlüssel und fügen Sie ihn wie in diesem Abschnitt beschrieben ein.
      • Schlüssel-ID: Schlüssel, der auf der Registerkarte Manifest Ihrer Anwendung verfügbar ist, wie in diesem Abschnitt erläutert.
      • Benutzerdefinierte Schlüsselkennung: Kennung, die auf der Registerkarte Manifest Ihrer Anwendung verfügbar ist, wie in diesem Abschnitt erläutert.
      • Clientkennung: Anwendungs-ID (Client), die Sie im Verwaltungsportal von Microsoft Azure finden, wie in diesem Abschnitt erläutert.
      • CRM-Version: Hier wählen Sie die CRM-Version "Dynamics CRM 365" aus.

  4. Wählen Sie die Option Aktivieren aus, um das Konto in Campaign zu aktivieren.

NOTE
Um die Einrichtung zu genehmigen, müssen Sie sich von der Adobe Campaign-Client-Konsole ab- und wieder anmelden.

Auswahl der zu synchronisierenden Tabellen ms-dyn-create-tables

Sie können jetzt die Tabellen konfigurieren, die synchronisiert werden sollen.

  1. Klicken Sie auf Konfigurationsassistent für Microsoft CRM….
  2. Wählen Sie die zu synchronisierenden Tabellen aus und starten Sie den Prozess.
  3. Überprüfen Sie das in Adobe Campaign generierte Schema im Knoten Administration > Konfiguration > Datenschemata.
NOTE
Fügen Sie der Zulassungsliste unbedingt zwei URLs hinzu: die Server-URL und login.microsoftonline.com. Wenden Sie sich dazu an Ihren Adobe-Support-Mitarbeiter.

Synchronisation der Auflistungen sfdc-enum-sync

Sobald das Schema erstellt ist, können Sie Auflistungen in Dynamics 365 automatisch mit Adobe Campaign synchronisieren.

  1. Öffnen Sie den Assistenten über den Link Auflistungen synchronisieren….
  2. Wählen Sie die Adobe Campaign-Auflistung aus, die der Dynamics 365-Auflistung entspricht.
    Sie können alle Werte einer Adobe Campaign-Auflistung durch die des CRM-Systems ersetzen: Wählen Sie hierzu in der Spalte Ersetzen die Option Ja.
  3. Klicken Sie abschließend auf Weiter und dann auf Starten, um mit dem Import der Auflistungen zu beginnen.
  4. Durchsuchen Sie den Knoten Administration > Plattform > Auflistungen, um die importierten Werte zu überprüfen.

Adobe Campaign und Microsoft Dynamics 365 sind nun miteinander verbunden. Sie können eine Datensynchronisation zwischen den beiden Systemen einrichten.

Um Daten zwischen Adobe Campaign und Microsoft CRM zu synchronisieren, müssen Sie einen Workflow erstellen und die Aktivität CRM-Connector verwenden.

Weitere Informationen zur Datensynchronisation finden Sie auf dieser Seite.

Unterstützte Felddatentypen ms-dyn-supported-types

Bei Microsoft Dynamics 365 werden folgende Attributtypen unterstützt/nicht unterstützt:

Attributtyp
Unterstützt
Basistypen: boolean, datetime, decimal, float, double, integer, bigint, string
Ja
Geld (als Dublette)
Ja
memo, entityname, primarykey, uniqueidentifier (als Zeichenfolgen)
Ja
Status, Auswahlliste (wir speichern die möglichen Werte in Auflistungen), Status (Zeichenfolge)
Ja
owner (als Zeichenfolge)
Ja
Suche (nur Referenzsuche einzelner Entitäten)
Ja
customer
Nein
Regarding
Nein
PartyList
Nein
ManagedProperty
Nein
recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b