Campaign und Microsoft Dynamics 365 verbinden

Auf dieser Seite erfahren Sie, wie Sie Campaign Classic mit Microsoft Dynamics CRM 365 verbinden.

Die Implementierung kann über die Web-API erfolgten (empfohlen). Im folgenden Abschnitt erfahren Sie, wie Sie die Verbindung mit Microsoft Dynamics herstellen.

Die Datensynchronisation erfolgt über eine eigene Workflow-Aktivität. Weitere Informationen.

Implementierungsschritte

Um Microsoft Dynamics 365 per Web-API mit Adobe Campaign zu verbinden, müssen Sie folgende Schritte ausführen:

In Microsoft Dynamics CRM:

1. Microsoft Dynamics Client-ID abrufen
2. Microsoft Dynamics-Zertifikatschlüsselkennung und Schlüssel-ID generieren
3. Berechtigungen konfigurieren
4. Anwender erstellen
5. Privaten Schlüssel kodieren

Weiterführende Informationen finden Sie in diesem Abschnitt

In Campaign Classic:

1. Neues externes Konto erstellen
2. Externes Konto mit Microsoft Dynamics-Einstellungen konfigurieren
3. Konfigurationsassistenten nutzen, um Tabellen zuzuordnen und Auflistungen zu synchronisieren
4. Synchronisations-Workflows erstellen

Weiterführende Informationen finden Sie in diesem Abschnitt

Microsoft Dynamics CRM konfigurieren

Um das Zugriffs-Token und die Schlüssel zum Einrichten des Kontos zu generieren, müssen Sie sich bei Microsoft Azure Directory unter Verwendung von Anmeldedaten für einen globalen Administrator anmelden. Gehen Sie dann wie folgt vor:

Microsoft Dynamics Client-ID abrufen

Um die Client-ID abzurufen, müssen Sie eine Anwendung in Azure Active Directory registrieren. Die Client-ID ist mit der Anwendungs-ID identisch.

1. Navigieren Sie zu Azure Active Directory > App-Registrierungen und klicken Sie auf Neue Anwendung registrieren.
2. Geben Sie einen eindeutigen Namen ein, der zur Identifizierung einer Instanz verwendet werden kann, z. B. adobeccampaign<instance identifier>.
3. Wählen Sie Anwendungstyp als Web-App/API.
4. Verwenden Sie http://localhost für die Anmelde-URL.

Nach dem Speichern erhalten Sie eine Anwendungs-ID, die der Client-Kennung für Campaign entspricht.

Weiterführende Informationen finden Sie auf dieser Seite.

Microsoft Dynamics-Zertifikatschlüsselkennung und Schlüssel-ID generieren

Gehen Sie wie folgt vor, um die Zertifikatschlüsselkennung (customKeyIdentifier) und die Schlüssel-ID (keyId) abzurufen:

1. Navigieren Sie zu Azure Active Directory > App-Registrierungen und wählen Sie die zuvor erstellte Anwendung aus.

2. Klicken Sie auf Zertifikate und Geheimnis.

3. Klicken Sie auf Zertifikat hochladen, bevor Sie Ihr erzeugtes öffentliches Zertifikat suchen und hochladen.

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

   Beispiel:

   - openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout '<'private key name'>' -out '<'public certificate name'>
   

   HINWEIS

   Sie können die Anzahl der Tage, hier -days 365, im Code-Beispiel ändern, sodass der Gültigkeitszeitraum des Zertifikats verlängert wird.

5. Sie müssen sie dann in Base64 codieren. Dazu können Sie einen Base64-Encoder oder die Befehlszeile base64 -w0 private.key für Linux verwenden.

6. 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 später benötigt, um Ihr externes Microsoft Dynamics CRM-Konto mit dem CRM-OAuth-Zertifikat zu konfigurieren.

Berechtigungen konfigurieren

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

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.

   HINWEIS

   Sollten Sie denselben Namen verwenden, wird der Fehler für doppelte Schlüssel ausgegeben. Nutzen Sie daher einen anderen Benutzernamen und fahren Sie fort, bis Sie eine Bestätigung erhalten haben, ob dieser Schritt erforderlich ist.

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

Um Microsoft Dynamics 365 mit Campaign zu verbinden, müssen Sie ein dediziertes externes Konto in Campaign erstellen und konfigurieren.

1. Navigieren Sie zu Administration > Plattform > Externe Konten.

2. Wählen Sie das externe Microsoft Dynamics CRM-Konto aus. Kreuzen Sie die Option Aktiviert an.

3. Geben Sie die Informationen ein, die zum Verbinden von Microsoft Dynamics 365 und Campaign erforderlich sind.

   HINWEIS

   Die Konfiguration des externen Microsoft Dynamics CRM-Kontos mit jedem CRM-OAuth-Typ wird in diesem Abschnitt beschrieben.

   

4. Klicken Sie auf den Link Konfigurationsassistent für Microsoft CRM …. Adobe Campaign erkennt die Tabellen aus der Microsoft Dynamics-Datenvorlage automatisch.

   

5. Wählen Sie die Tabellen aus, die abgerufen werden sollen.

   

6. Klicken Sie auf Weiter, um die Erstellung des entsprechenden Schemas zu starten.

   

   HINWEIS

   Zur Übernahme der Konfiguration müssen Sie sich von der Adobe Campaign-Konsole ab- und wieder anmelden.

   Sie können überprüfen, ob das entsprechende Datenschema in Adobe Campaign verfügbar ist.

   

7. Klicken Sie auf den Link Auflistungssynchronisation…, um mit dem Synchronisieren von Auflistungen zwischen Adobe Campaign und Microsoft Dynamics zu beginnen.

   

Campaign und Microsoft Dynamics sind nun miteinander verbunden. Sie können eine Datensynchronisation zwischen den beiden Systemen einrichten. Weitere Informationen finden Sie im Abschnitt Datensynchronisation.

Unterstützte Felddatentypen

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