Adobe Analytics Migrationsleitfaden

Adobe Analytics Migration

Qualtrics Website-Feedback unterstützt derzeit eine 2-Wege-Erweiterung mit Adobe Analytics, die sowohl das Targeting von Intercepts basierend auf Adobe-Analytics-Variablen als auch den Austausch von Qualtrics-Daten zurück an Adobe ermöglicht.

Die Erweiterung zum Zurücksenden von Qualtrics-Daten an Adobe basiert derzeit auf der Adobe-Data-Connector-Technologie. Adobe hat das Ende des Lebenszyklus der Data-Connector-Technologie für Erweiterungen angekündigt, die am 1. August 2021 in Kraft tritt. Während neue Datenkonnektoren nach dem 1. August nicht mehr angelegt werden können, bleiben vorhandene Datenkonnektoren mindestens bis zum 31. Dezember funktionsfähig. Dies wirkt sich nur auf Umfragen aus, die derzeit Qualtrics-Daten an Adobe senden. Dies hat keine Auswirkungen auf Integrationen, die Adobe-Daten von Websites in Qualtrics erfassen.

Qualtrics hat eine neue Adobe-Analytics-Erweiterung mithilfe von Workflows entwickelt, die zwei neue Aufgaben enthält, die Qualtrics-Daten zurück an Adobe senden:

• Klassifizierungsaufgabe: Mit dieser Aufgabe können Benutzer Umfragefelder zu Zuordnungszwecken in die Adobe Report Suite hochladen. Diese Aufgabe wird jedes Mal ausgeführt, wenn eine Umfrage veröffentlicht wird.
• Daten-Upload-Aufgabe: Diese Aufgabe sendet Antwortdaten an die Adobe Report Suite. Diese Aufgabe wird jedes Mal ausgeführt, wenn eine Umfrageantwort eingereicht wird.

Im Rahmen der Migration erstellt Qualtrics automatisch die oben genannten Workflows für jede Umfrage, die derzeit für die Adobe-Analytics-Datensynchronisierung aktiviert ist und Adobe-Antworten enthält. Benutzer müssen nur einen kleinen Satz von Feldern konfigurieren, z.B. Adobe-Authentifizierungsinformationen und -IDs.

Automatisch angelegte Workflows

Im Rahmen der Migration hat Qualtrics automatisch zwei neue Adobe-Workflows für alle vorhandenen Umfragen erstellt, die derzeit einen Datenkonnektor verwenden, um Antwortdaten an Adobe zu senden. Benutzer müssen ihre Adobe-Authentifizierungsinformationen eingeben, damit diese Workflows aktiviert werden können. Bis diese Authentifizierungsinformationen eingegeben werden, werden auf der Seite Workflows unvollständige Workflows angezeigt.

Neue Adobe-Analytics-Integration aktivieren

Um die neue Adobe-Analytics-Integration zu aktivieren, müssen Sie beide von Qualtrics generierten Workflows aktivieren.

1. Navigieren Sie zur Seite Workflows.
   
2. Klicken Sie auf den von Qualtrics erstellten Workflow „Umfragendefinition“.
   
   Tipp: Klicken Sie oben rechts auf Schritt-für-Schritt-Anleitungen, um diese Anweisungen beim Erstellen Ihres Workflows anzuzeigen.
3. Wählen Sie aus, ob der Workflow gestartet werden soll, wenn die Umfrage aktiviert, geschlossen oder veröffentlicht ist.
   
   Tipp: Qualtrics empfiehlt, diesen Workflow nur zu starten, wenn die Umfrage veröffentlicht wird.
4. Klicken Sie auf Fertig stellen.
5. Die Workflow-Bedingungen werden automatisch so konfiguriert, dass der Workflow nur gestartet wird, wenn die Umfrage-ID dem richtigen Umfrageprojekt entspricht. Wählen Sie Bedingungen bearbeiten, wenn Sie weitere Anpassungen vornehmen möchten. Weitere Informationen zum Anlegen und Anpassen von Konditionen finden Sie unter Bedingungen anlegen.
   
6. Wählen Sie die Aufgabe Adobe-Analytics-Klassifizierungen hochladen.
7. Wählen Sie Ihr Konto aus, oder klicken Sie auf Benutzerkonto hinzufügen, wenn Sie noch kein Adobe-Konto hinzugefügt haben.
   
   Achtung: Wenn Sie noch kein Konto für die Authentifizierung bei Adobe erstellt haben, werden Sie aufgefordert, die Adobe-Anmeldeinformationen anzugeben, die Sie im Abschnitt Geheime Adobe-Authentifizierungsschlüssel erhalten haben.
8. Geben Sie Ihre Adobe-Kontodetails ein.
   
9. Wählen Sie Konto verbinden.
10. Nachdem Sie Ihr Konto ausgewählt haben, wählen Sie Weiter.
    
11. Stellen Sie sicher, dass die Listenvariablen „Bericht-Suite-ID“ und „Antwort“ korrekt sind und mit den Angaben in Ihrem Adobe-Konto übereinstimmen.
    
12. Wählen Sie Sichern.
13. Nachdem Sie Ihren Workflow gesichert haben, wählen Sie Zurück.
    
14. Wählen Sie den von Qualtrics erstellten Workflow „Umfrageantwort“ aus.
    
15. Wählen Sie Umfrageantwort.
    
16. Stellen Sie sicher, dass das richtige Umfrageprojekt in der Dropdown-Liste ausgewählt ist.
    
17. Klicken Sie auf Weiter.
18. Wählen Sie aus, ob der Arbeitsablauf gestartet werden soll, wenn eine neue Umfrageantwort angelegt wird, eine vorhandene Antwort über API aktualisiert wird oder beides.
    
19. Klicken Sie auf Fertig stellen.
20. Wählen Sie die Aufgabe Daten an Adobe Analytics senden.
    
21. Wählen Sie Ihr Konto aus, oder klicken Sie auf Benutzerkonto hinzufügen, wenn Sie noch kein Adobe-Konto hinzugefügt haben. Führen Sie die Schritte 8-9 aus, um ein neues Benutzerkonto zu verbinden.
    
22. Klicken Sie auf Weiter.
23. Stellen Sie sicher, dass die Berichts-Suite-ID, die Listenvariable „Antwort“ und die Variable „Antwort-ID“ korrekt sind und mit den Angaben in Ihrem Adobe-Konto übereinstimmen.
    
24. Aktivieren Sie Zeitstempel mit Daten senden, wenn in Ihrer Berichts-Suite die Einstellung “Zeitstempel erforderlich” aktiviert ist. Sie können diese Einstellungen in Ihrem Adobe-Konto prüfen. Weitere Informationen finden Sie in der Adobe-Zeitstempeldokumentation.
25. Aktivieren Sie Teilantworten einschließen, wenn Teilantworten an Ihre Berichtssuite gesendet werden sollen. Unter Umfrageantwortereignisse erfahren Sie, wie Sie einen Workflow für unvollständige Antworten starten.
26. Wählen Sie Sichern.
27. Kehren Sie zur Seite Workflows zurück, und aktivieren Sie beide Workflows, indem Sie sie in der Spalte Ein/Aus aktivieren.
    
28. Testen Sie, ob die Integration funktioniert, indem Sie einen der folgenden Schritte ausführen:
    • Greifen Sie auf Ihr Website-Feedback-Intercept zu, und füllen Sie einige Testantworten aus.
    • Zeigen Sie eine Vorschau Ihrer Umfrage an, und füllen Sie einige Testantworten aus.
      Tipp: Wenn Sie eine Vorschau Ihrer Umfrage anzeigen, ohne auf das Intercept zuzugreifen, müssen Sie einen Wert für Ihr in Q_AA_PARMS eingebettetes Datenfeld fest programmieren. Beispiel: {“marketingCloudVisitorID”:”test123″}.
29. Kehren Sie zur Seite Workflows zurück, und klicken Sie auf Ausführungsverlauf.
    
30. Stellen Sie sicher, dass der Workflow für das Umfrageantwortereignis für jede von Ihnen gesendete Testumfrageantwort ausgeführt wurde und den Status „Erfolgreich“ hat.
    Tipp: Es kann einige Minuten dauern, bis Workflows im Ausführungsverlauf angezeigt werden.

Alte Adobe Data Connectors entfernen

Nachdem Sie die neuen Workflows zum Senden von Qualtrics-Daten an Adobe aktiviert haben, müssen Sie Ihre alten Adobe-Datenkonnektoren entfernen.

1. Navigieren Sie zur Projekte-Seite.
   
2. Klicken Sie auf das Umfrageprojekt mit dem Datenkonnektor.
   Tipp: Wenn Sie sich des Umfragenamens nicht sicher sind, finden Sie diesen in einem Ihrer neuen Adobe-Workflows.
   
3. Gehe zu Umfrageoptionen.
   
4. Klicken Sie auf Adobe Analytics. Diese finden Sie unten unter „Erweiterte Optionen“.
   Achtung: Wenn eine Fehlermeldung angezeigt wird, klicken Sie auf OK. Dies kann daran liegen, dass Adobe seine Datenkonnektortechnologie eingestellt hat.
5. Heben Sie die Auswahl aller ausgewählten Integrationen auf. Die Datenkonnektoren werden als “Unbekannt” angezeigt, da Adobe ihre Datenkonnektortechnologie eingestellt hat.
   
6. Wählen Sie Sichern.

Geheime Schlüssel für Adobe-Authentifizierung

Sie müssen Ihre Adobe-Anmeldedaten angeben, damit Qualtrics sich bei Adobe Analytics Report Suite authentifizieren kann. Dies ist erforderlich, wenn Sie Ihre neuen Adobe-Analytics-Workflows aktivieren.

ERSTELLEN VON ADOBE AUTHENTICATION SECRETS

Sie müssen die folgenden Anmeldeinformationen in Qualtrics angeben, wenn Sie Ihre Adobe-Workflows einrichten und ein Konto für die Interaktion mit Adobe Analytics erstellen.

• Client-ID: Client-ID, die in der Adobe-Konsole als Teil der Credential-Details bereitgestellt wird.
• Geheimer Client-Schlüssel: Der geheime Client-Schlüssel, der in der Adobe-Konsole als Teil der Credential-Details bereitgestellt wird.
• Technische Konto-ID: Die technische Konto-ID, die in der Adobe-Konsole als Teil der Anmeldedaten bereitgestellt wird.
• Organisations-ID: Die Organisations-ID, die in der Adobe-Konsole als Teil der Anmeldeinformationsdetails bereitgestellt wird. Diese ID ist eine 24-stellige alphanumerische Zeichenfolge, gefolgt von @AdobeOrg.
• Privater Schlüssel: Der Schlüssel, der dem öffentlichen Schlüssel entspricht, der an Ihre Dienstkontoverbindung angehängt ist.
  Achtung: Achten Sie darauf, den gesamten Inhalt der Datei mit dem privaten Schlüssel von Adobe zu kopieren, einschließlich der Abschnitte “—–BEGIN PRIVATE KEY—–” und “—–END PRIVATE KEY—–“.

ANLEGEN VON ADOBE AUTHENTICATION SECRETS

Wenn Sie noch keine geheimen Authentifizierungsschlüssel haben, führen Sie die folgenden Schritte aus, um sie zu erstellen. Weitere Informationen finden Sie in der Supportdokumentation von Adobe.

1. Navigieren Sie zur Projektseite Ihres Adobe-Kontos.
2. Klicken Sie auf Neues Projekt erstellen.
   
3. Klicken Sie auf API hinzufügen.
   
4. Wählen Sie “Adobe Analytics”.
   
5. Wählen Sie Service Account (JWT) als Authentifizierungsmethode.
   
6. Klicken Sie auf Weiter.
7. Wählen Sie aus, ob Adobe ein Schlüsselpaar für Sie generieren oder Ihren öffentlichen Schlüssel hochladen soll.
   
   Tipp: Wenn Adobe ein Schlüsselpaar für Sie generiert, bewahren Sie diesen privaten Schlüssel an einem sicheren Ort auf, den Sie beim Einrichten des Adobe-Analytics-Workflows in Qualtrics verwenden können.
8. Klicken Sie auf Weiter.
9. Wählen Sie ein Produktprofil aus, das für Adobe-Analytics-Berechtigungen konfiguriert wurde. Damit die Qualtrics-Integration funktioniert, benötigt das von Ihnen ausgewählte Produktprofil Berechtigungen für die folgenden Funktionen:
   • Analysewerkzeuge: Web-Services und entweder Zugriff auf Analysis-Arbeitsbereich oder Zugriff auf Berichte und Analysen.
   • Report Suite Tools: Klassifizierungen.
10. Sichern Sie Ihr API.