Aktualisieren von Adobe Experience Platform-Profilen über Adobe Campaign-Landingpages ac-aep-lp
Durch die Integration von Adobe Campaign mit Adobe Experience Platform können Sie Profildaten nahtlos zwischen Ihren Adobe Campaign-Landingpages und Adobe Experience Platform synchronisieren. Diese Integration ermöglicht Ihnen Folgendes:
- Abrufen von Adobe Experience Platform-Profilattributen zur Anzeige aktualisierter Informationen auf Adobe Campaign-Landingpages,
- Senden aktualisierter Profilattribute an Adobe Experience Platform, um die entsprechenden Attribute basierend auf den in den Landingpages ausgefüllten und gesendeten Elementen zu aktualisieren.
Die wichtigsten Schritte zum Einrichten dieser Integration sind:
Einrichten einer OAuth-Verbindung oauth
Adobe Cloud Platform-APIs verwenden das OAuth 2.0-Protokoll zur Authentifizierung und Autorisierung. Um über API-Aufrufe eine Verbindung zwischen Adobe Experience Platform und Adobe Campaign herzustellen, müssen Sie mithilfe der in Adobe Developer Console erstellten OAuth-Integration ein Zugriffstoken generieren.
Gehen Sie dazu wie folgt vor:
-
Rufen Sie die Adobe Developer Console auf.
-
Erstellen Sie eine neue API-Verbindung mit dem Adobe Experience Platform-API-Produkt. Ausführliche Anweisungen zum Abrufen eines OAuth 2.0-Zugriffstokens finden Sie in der Dokumentation zur Adobe Developer Console.
-
Nachdem die Verbindung erstellt wurde, navigieren Sie zum Menü OAuth Server-zu-Server und kopieren Sie die folgenden Details, die für die Authentifizierung in Campaign erforderlich sind:
CLIENT ID
CLIENT SECRET
ORGANIZATION ID
Nachdem Sie Ihre Oauth-Verbindung konfiguriert haben, erstellen und konfigurieren Sie eine neue HTTP-API-Quellverbindung zur Verknüpfung von Adobe Campaign mit Adobe Experience Platform.
Erstellen einer HTTP-API-Quellverbindung source
Mit der vorhandenen OAuth-Verbindung besteht der nächste Schritt darin, eine HTTP-API-Quellverbindung in Adobe Experience Platform zu erstellen. Mit dieser Verbindung können Sie Daten mithilfe von APIs an Adobe Experience Platform streamen. Führen Sie folgende Schritte aus:
-
Navigieren Sie zu Adobe Experience Platform-Quellen, suchen Sie nach der HTTP-API-Quelle und klicken Sie dann auf Daten hinzufügen.
-
Konfigurieren Sie die Verbindung entsprechend Ihren Anforderungen. Detaillierte Informationen zum Konfigurieren einer HTTP-API-Verbindung finden Sie in der Dokumentation zu Adobe Experience Platform-Quellen.
Aktivieren Sie im Schritt Authentifizierung die Option Authentifizierung aktivieren, um sich mit dem zuvor über die OAuth-Integration generierten Zugriffstoken zu authentifizieren.
-
Sobald die Quellverbindung konfiguriert ist, wird der Streaming-Endpunkt angezeigt. Dieser Endpunkt ist erforderlich, um Daten in Adobe Experience Platform aufzunehmen.
Sie können auch auf ein Beispiel des in Adobe Experience Platform erfassten Datenformats zugreifen, indem Sie den neu erstellten Datenfluss über die Registerkarte Datenflüsse aufrufen.
Nachdem jetzt die HTTP-API-Quellverbindung eingerichtet worden ist, müssen Sie bestimmte Optionen zu Adobe Campaign hinzufügen, um die Verbindung zu Adobe Experience Platform zu aktivieren.
Hinzufügen von Authentifizierungsoptionen in Adobe Campaign xtk
Nachdem die HTTP-API-Quellverbindung konfiguriert worden ist, müssen Sie bestimmte Optionen zu Adobe Campaign hinzufügen, um die Verbindung mit Adobe Experience Platform zu aktivieren. Dies kann entweder im Menü „Kampagnen-Administration“ oder bei der Ausführung des Landingpage-Workflows durch Hinzufügen einer spezifischen JavaScript-Code-Aktivität erfolgen.
Auf den nachstehenden Registerkarten finden Sie die beiden Methoden:
-
Navigieren Sie zum Menü Administration > Plattform > Optionen.
-
Fügen Sie die folgenden Optionen mit den entsprechenden Werten aus der Adobe Developer Console hinzu:
- IMS_CLIENT_ID = cryptString(CLIENT ID)
- IMS_CLIENT_SECRET = cryptString(CLIENT SECRET)
- IMS_ORG_ID = ORGANIZATION ID
- IMS_CLIENT_API_KEY = cryptString(CLIENT ID)
note note NOTE Die Funktion „cryptString()“ wird zum Verschlüsseln Ihrer Authentifizierungsdaten verwendet.
Um diese Optionen bei Ausführung des Landingpage-Workflows automatisch zu konfigurieren, fügen Sie eine JavaScript-Code-Aktivität zu Ihrem Workflow mit dem unten stehenden Code hinzu. Erfahren Sie, wie Sie eine JavaScript-Code-Aktivität konfigurieren.
Bei Ausführung des Workflows werden die Optionen automatisch in der Campaign-Konsole mit den angegebenen Werten erstellt.
code language-none |
---|
|
Nachdem nun die Authentifizierungsoptionen in Campaign konfiguriert worden sind, müssen Sie benutzerdefinierte JavaScript-Codes erstellen, um die Datensynchronisation zwischen Campaign und Adobe Experience Platform von Ihrer Landingpage aus zu ermöglichen.
Hinzufügen von Optionen bei der Workflow-Ausführung javacript
Um die Datensynchronisation zwischen Landingpages und Adobe Experience Platform zu ermöglichen, müssen benutzerdefinierte JavaScript-Codes zu Adobe Campaign hinzugefügt werden. Führen Sie folgende Schritte aus:
-
Navigieren Sie zum Menü Administration > Konfiguration > JavaScript-Codes.
-
Erstellen Sie neue JavaScript-Codes und fügen Sie die unten stehenden Snippets ein.
note note NOTE Zugriffstoken und Authentifizierungsdaten werden automatisch aus den zuvor eingerichteten Optionen abgerufen.
Dieser Code prüft, ob das Profil in Adobe Experience Platform vorhanden ist, bevor die Landingpage geladen wird. Er ruft die Profilattribute ab und zeigt sie in den entsprechenden Feldern der Landingpage an.
code language-javascript |
---|
|
Dieser Code aktualisiert die Profilattribute in Adobe Experience Platform mit den auf der Landingpage übermittelten Werten.
code language-javascript |
---|
|
Nachdem nun die benutzerdefinierten JavaScript-Codes in Adobe Campaign erstellt worden sind, können Sie den Workflow mit Ihrer Landingpage so konfigurieren, dass diese JavaScript-Codes für die Datensynchronisation verwendet werden.
Konfigurieren von Landingpage-Workflows script
Mit den zu Adobe Campaign hinzugefügten JavaScript-Codes können Sie diese mit JavaScript-Code-Aktivitäten in Ihren Landingpage-Workflow einbinden:
- Um Daten von Experience Platform zu laden, bevor die Landingpage geladen wird, fügen Sie eine JavaScript-Code-Aktivität vor der Landingpage-Aktivität hinzu und fügen Sie Skript 1 ein.
code language-javascript |
---|
|
- Um die Experience Platform-Profilattribute mit den auf der Landingpage eingegebenen Daten zu aktualisieren, fügen Sie eine JavaScript-Code-Aktivität nach der Landingpage-Aktivität hinzu und fügen Sie Skript 2 ein.
code language-javascript |
---|
|
Hier ist ein Beispiel für einen Workflow, der die JavaScript-Code-Aktivitäten vor und nach einer Landingpage verwendet:
Im Folgenden finden Sie ein Beispiel für eine Landingpage und eine JavaScript-Code-Aktivität, die zur Aktualisierung von Profilattributen in Adobe Experience Platform konfiguriert wurde: