Campaign und Microsoft Dynamics 365 verbinden

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

Implementierungsmöglichkeiten:

• per Web-API (empfohlen). Im folgenden Abschnitt erfahren Sie, wie Sie die Verbindung mit Microsoft Dynamics herstellen.
• mit Office 365. Sehen Sie sich dieses Video an, um die wichtigsten Schritte zum Einrichten der Integration kennenzulernen.
• Für eine On-Premise-Implementierung wenden Sie die Hauptschritte für Office 365 an.

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. Client-Geheimnis für Microsoft Dynamics generieren
3. Berechtigungen konfigurieren
4. Anwender erstellen
5. Privaten Schlüssel kodieren

Weitere 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

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

Client-Geheimnis für Microsoft Dynamics generieren

Das Client-Geheimnis ist derjenige Schlüssel, der für die Client-ID eindeutig ist. Gehen Sie wie folgt vor, um die Zertifikatschlüsselkennung 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'>
   

5. Klicken Sie auf den Link manifest, um die Zertifikatschlüsselkennung und die Schlüsselkennung abzurufen.

Berechtigungen konfigurieren

Sie müssen die erforderlichen Berechtigungen für die erstellte Anwendung konfigurieren.

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 dann auf Auswählen, aktivieren Sie das Kontrollkästchen Access Dynamics 365 als Organisationsbenutzer und klicken Sie auf Auswählen.

Anwendungsbenutzer 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. Erstellen Sie ein neues externes Konto und wählen Sie den Typ Microsoft Dynamics CRM sowie die Option Aktivieren.

3. Wählen Sie den Freigabetyp Web-API:

   Adobe Campaign Classic unterstützt die Dynamics 365 REST-Schnittstelle mit dem OAuth-Protokoll zur Authentifizierung mit einem Zertifikat oder Passwort.

   Nutzen Sie die Einstellungen, die Sie in Azure Directory zuvor definiert haben, um das externe Konto zu konfigurieren.

   

   HINWEIS

   Die Konfiguration des externen Microsoft Dynamics CRM-Kontos wird in diesem Abschnitt genauer erläutert.

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.

Integration mit Microsoft Dynamics CRM und Office 365 konfigurieren

Sehen Sie sich dieses Video an, um zu erfahren, wie Sie Dynamics 365 im Rahmen einer Office 365-Implementierung mit Adobe Campaign Classic integrieren können.

Unterstützte Felddatentypen

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

Attributtyp	Unterstützt
Basistypen: Boolesch, Datum + Uhrzeit, Dezimalzahl, Gleitkommazahl, Dublette, Integer, Bigint, Zeichenfolge	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