Manuelles Konfigurieren der Integration mit Adobe Target

Sie können entweder die Konfigurationen des Opt-in-Assistenten ändern, die Sie beim Verwenden des Assistenten vorgenommen haben, oder Sie können die Integration mit Adobe Target manuell vornehmen, ohne den Assistenten zu verwenden.

Ändern der Konfigurationen für den Opt-in-Assistenten

Der Opt-in-Assistent, mit dem AEM mit Adobe Target integriert wird, erstellt automatisch eine Target-Cloud-Konfiguration mit dem Namen „Bereitgestellte Target-Konfiguration“. Außerdem erstellt der Assistent ein Target-Framework für die Cloud-Konfiguration mit dem Namen „Bereitgestelltes Target-Framework“. Sie können bei Bedarf die Eigenschaften der Cloud-Konfiguration und des Frameworks ändern.

Darüber hinaus können Sie Adobe Target auch als Quelle für das Reporting für bestimmte Inhalte konfigurieren, indem Sie die „A4T-Analytics-Cloud-Konfiguration“ konfigurieren.

Navigieren Sie über Tools > Bereitstellung > Cloud zu Cloud-Services, um die Cloud-Konfiguration und das Framework zu ermitteln. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html) Klicken oder tippen Sie unterhalb von Adobe Target auf Konfigurationen anzeigen.

Eigenschaften der bereitgestellten Target-Konfiguration

Die folgenden Eigenschaftswerte werden in der vom Opt-in-Assistenten erstellten Cloud-Konfiguration der bereitgestellten Target-Konfiguration verwendet:

• Client-Code: Wie im Opt-in-Assistenten eingegeben

• E-Mail: Wie im Opt-in-Assistenten eingegeben

• Kennwort: Wie im Opt-in-Assistenten eingegeben

• API-Typ: REST

• Segmente aus Adobe Target synchronisieren: Ausgewählt

• Client-Bibliothek: mbox.js

• DTM zur Bereitstellung der Client-Bibliothek verwenden: Nicht ausgewählt Wählen Sie diese Option aus, wenn Sie DTM oder ein anderes System für das Tag-Management nutzen, um die Datei „mbox.js“ oder „AT.js“ zu hosten. Adobe empfiehlt zum Bereitstellen der Bibliothek die Verwendung von DTM anstelle von AEM.

• Benutzerdefinierte mbox.js: Keine Angabe, sodass die standardmäßige Datei „mbox.js“ verwendet wird. Geben Sie bei Bedarf eine benutzerdefinierte mbox.js-Datei an, die Sie verwenden möchten. Sie wird nur angezeigt, wenn Sie „mbox.js“ ausgewählt haben.

• Benutzerdefinierte AT.js: Keine Angabe, sodass die standardmäßige Datei „AT.js“ verwendet wird. Geben Sie bei Bedarf eine benutzerdefinierte AT.js-Datei an, die Sie verwenden möchten. Sie wird nur angezeigt, wenn Sie „AT.js“ ausgewählt haben.

Bereitgestellte Target-Framework-Eigenschaften

Das vom Opt-in-Assistenten erstellte bereitgestellte Target-Framework ist so konfiguriert, dass Kontextdaten aus dem Profildatenspeicher gesendet werden. Die Datenelemente zu Alter und Geschlecht aus dem Speicher werden standardmäßig an Target gesendet. Es kann sein, dass für Ihre Lösung zusätzliche Parameter gesendet werden müssen.

Sie können das Framework so konfigurieren, dass zusätzliche Kontextinformationen an Target gesendet werden, wie unter Hinzufügen eines Target-Frameworks beschrieben.

Konfigurieren der A4T-Analytics-Cloud-Konfiguration

Sie können Adobe Target so konfigurieren, dass Adobe Analytics als Quelle für das Reporting zu bestimmten Inhalten verwendet wird.

Dazu geben Sie an, mit welcher A4T-Cloud-Konfiguration Sie Ihre Adobe Target-Cloud-Konfiguration verbinden möchten:

1. Navigieren Sie über das AEM-Logo und Tools > Bereitstellung > Cloud-Services zu Cloud-Services.

2. Klicken Sie im Abschnitt Adobe Target auf Jetzt konfigurieren.

3. Stellen Sie eine erneute Verbindung zu Ihrer Adobe Target-Konfiguration her.

4. Wählen Sie im Dropdown-Menü A4T-Analytics-Cloud-Konfiguration das Framework aus.

   HINWEIS

   Es sind nur Analytics-Konfigurationen verfügbar, die für A4T aktiviert sind.

   Beim Konfigurieren von A4T mit AEM kann es vorkommen, dass der Eintrag „Konfigurationsverweis fehlt“ angezeigt wird. Gehen Sie wie folgt vor, um das Analytics-Framework auswählen zu können:

   1. Navigieren Sie zu Tools > Allgemein > CRXDE Lite.
   2. Navigieren Sie zum Dialogfeld „A4T-Analytics-Konfiguration“ (siehe unten)
   3. Legen Sie die Eigenschaft deaktivieren auf false fest.
   4. Tippen oder klicken Sie auf Alle speichern.

Dialogfeld „A4T-Analytics-Konfiguration“

/libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig

Klicken Sie auf OK. Beim Verwenden von Adobe Target für Inhalte können Sie die Quelle für das Reporting auswählen.

Manuelle Integration mit Adobe Target

Sie können die Integration mit Adobe Target auch manuell durchführen, anstatt den Opt-in-Assistenten zu verwenden.

Erstellen einer Target-Cloud-Konfiguration

Um AEM die Interaktion mit Adobe Target zu ermöglichen, erstellen Sie eine Target-Cloud-Konfiguration. Um die Konfiguration zu erstellen, geben Sie den Adobe Target-Clientcode und die Benutzeranmeldeinformationen an.

Sie erstellen die Target-Cloud-Konfiguration nur einmal, da Sie die Konfiguration mit mehreren AEM-Kampagnen verknüpfen können. Wenn Sie mehrere Adobe Target-Clientcodes haben, erstellen Sie für jeden Clientcode eine Konfiguration.

Sie können die Cloud-Konfiguration so konfigurieren, dass Segmente aus Adobe Target synchronisiert werden. Wenn Sie die Synchronisierung aktivieren, werden Segmente im Hintergrund aus Target importiert, sobald die Cloud-Konfiguration gespeichert wurde.

Gehen Sie wie folgt vor, um eine Target-Cloud-Konfiguration in AEM zu erstellen:

1. Navigieren Sie zu Cloud Services über das AEM-Logo > Tools > Cloud-Services > Legacy-Cloud-Services. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

   Die Übersichtsseite Cloud-Services wird geöffnet.

2. Klicken Sie im Abschnitt Adobe Target auf Jetzt konfigurieren.

3. Im Dialogfeld Konfiguration erstellen:

   1. Geben Sie der Konfiguration einen Titel.
   2. Wählen Sie die Vorlage Adobe Target-Konfiguration aus.
   3. Klicken Sie auf Erstellen.

   Das Dialogfeld „Bearbeiten“ wird geöffnet.

   

   HINWEIS

   Beim Konfigurieren von A4T mit AEM kann es vorkommen, dass der Eintrag „Konfigurationsverweis fehlt“ angezeigt wird. Gehen Sie wie folgt vor, um das Analytics-Framework auswählen zu können:

   1. Navigieren Sie zu Tools > Allgemein > CRXDE Lite.
   2. Navigieren Sie zu /libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig.
   3. Legen Sie die Eigenschaft deaktivieren auf false fest.
   4. Tippen oder klicken Sie auf Alle speichern.

4. Geben Sie im Dialogfeld Werte für diese Eigenschaften an.

   • Client-Code: Der Client-Code des Target-Kontos

   • E-Mail: Die E-Mail-Adresse des Target-Kontos.

   • Kennwort: Das Kennwort des Target-Kontos.

   • API-Typ: Entweder „REST“ oder „XML“

   • A4T-Analytics-Cloud-Konfiguration: Wählen Sie die Analytics Cloud-Konfiguration aus, die für Target-Aktivitätsziele und -metriken verwendet wird. Sie benötigen diese Konfiguration, wenn Sie Adobe Analytics als Quelle für das Reporting für bestimmte Inhalte verwenden. Falls Ihre Cloud-Konfiguration nicht angezeigt wird, hilft Ihnen der Hinweis unter Konfigurieren der A4T-Analytics-Cloud-Konfiguration weiter.

   • Präzises Targeting verwenden: Dieses Kontrollkästchen ist standardmäßig aktiviert. Wenn diese Option aktiviert ist, wartet die Cloud-Service-Konfiguration auf das Laden des Kontexts, bevor der Inhalt geladen wird. Siehe folgenden Hinweis.

   • Segmente aus Adobe Target synchronisieren: Aktivieren Sie diese Option, um in Target definierte Segmente herunterzuladen und in AEM zu verwenden. Wählen Sie diese Option, wenn die Eigenschaft „API-Typ“ auf „REST“ festgelegt ist, da Inline-Segmente nicht unterstützt werden und Sie immer Segmente aus Target verwenden müssen. (Der AEM-Begriff „Segment“ ist gleichbedeutend mit dem Target-Begriff „Zielgruppe“.)

   • Client-Bibliothek: Wählen Sie aus, ob Sie die Client-Bibliothek „mbox.js“ oder „AT.js“ verwenden möchten.

   • DTM zur Bereitstellung der Client-Bibliothek verwenden: Wählen Sie diese Option, um entweder „AT.js“ oder „mbox.js“ über DTM oder ein anderes Tag-Management-System zu nutzen. Konfigurieren Sie die DTM-Integration, um diese Option verwenden zu können. Adobe empfiehlt zum Bereitstellen der Bibliothek die Verwendung von DTM anstelle von AEM.

   • Benutzerdefinierte mbox.js: Lassen Sie dieses Feld leer, wenn Sie das Feld „DTM“ aktiviert haben oder die standardmäßige Datei „mbox.js“ verwenden möchten. Alternativ hierzu können Sie Ihre benutzerdefinierte Datei „mbox.js“ hochladen. Sie wird nur angezeigt, wenn Sie „mbox.js“ ausgewählt haben.

   • Benutzerdefinierte AT.js: Lassen Sie dieses Feld leer, wenn Sie das Feld „Tag-Management“ aktiviert haben oder die standardmäßige Datei „AT.js“ verwenden möchten. Alternativ hierzu können Sie Ihre benutzerdefinierte Datei „AT.js“ hochladen. Sie wird nur angezeigt, wenn Sie „AT.js“ ausgewählt haben.

   HINWEIS

   Wenn Sie den Opt-in für den Adobe Target-Konfigurationsassistenten durchführen, wird die „präzise Zielgruppenerfassung“ aktiviert.

   Präzise Zielgruppenerfassung bedeutet, dass für die Cloud Service-Konfiguration gewartet wird, bis das Laden des Kontexts erfolgt ist, bevor der Inhalt geladen wird. Aus diesem Grund kann hinsichtlich der Leistung eine präzise Zielgruppenbestimmung eine Verzögerung von einigen Millisekunden verursachen, bevor das Laden des Inhalts erfolgt.

   Die präzise Zielgruppenerfassung ist auf der Autoreninstanz immer aktiviert. Auf der Veröffentlichungsinstanz können Sie die präzise Zielgruppenerfassung aber global deaktivieren, indem Sie in der Cloud Service-Konfiguration das Häkchen neben „Präzise Zielgruppenerfassung“ entfernen (http://localhost:4502/etc/cloudservices.html). Sie können die präzise Zielgruppenerfassung auch für einzelne Komponenten aktivieren und deaktivieren, unabhängig von Ihrer Einstellung in der Cloud-Service-Konfiguration.

   Wenn Sie bereits Zielkomponenten erstellt haben und Sie diese Einstellung ändern, wirken sich Ihre Änderungen nicht auf diese Komponenten aus. Ändern Sie diese Komponenten direkt.

5. Klicken Sie auf Mit Target verbinden, um die Verbindung mit Target zu initialisieren. Wenn die Verbindungsherstellung erfolgreich war, wird die Meldung Die Verbindung wurde hergestellt angezeigt. Klicken Sie auf OK und dann auf OK.

   Falls Sie keine Verbindung mit Target herstellen können, helfen Ihnen die Informationen im Abschnitt zur Fehlerbehebung weiter.

Hinzufügen eines Target-Frameworks

Nachdem Sie die Target-Cloud-Konfiguration konfiguriert haben, fügen Sie ein Target-Framework hinzu. Das Framework identifiziert die Standardparameter, die von den verfügbaren Client Context- oder ContextHub-Komponenten an Adobe Target gesendet werden. Target nutzt die Parameter, um die Segmente zu ermitteln, die für den aktuellen Kontext gelten.

Sie können mehrere Frameworks für eine einzelne Target-Konfiguration erstellen. Mehrere Frameworks sind nützlich, wenn Sie für unterschiedliche Abschnitte Ihrer Website jeweils einen anderen Parametersatz an Target senden müssen. Erstellen Sie ein Framework für jeden Parametersatz, den Sie versenden. Verknüpfen Sie jeden Bereich Ihrer Website mit dem entsprechenden Framework. Eine Web-Seite kann jeweils nur ein Framework verwenden.

1. Klicken Sie auf der Seite für die Target-Konfiguration auf das Pluszeichen (+) neben „Verfügbare Frameworks“.

2. Geben Sie im Dialogfeld „Framework erstellen“ einen Titel an, wählen Sie die Option Adobe Target-Framework und klicken Sie auf Erstellen.

   

   Die Framework-Seite wird geöffnet. Der Sidekick verfügt über Komponenten mit Informationen zu Client-Kontext oder ContextHub, die Sie zuordnen können.

   

3. Ziehen Sie die ClientContext-Komponente mit den Daten, die Sie für die Zuordnung nutzen möchten, auf das Ablageziel. Alternativ hierzu können Sie die ContextHub-Store-Komponente auf das Framework ziehen.

   HINWEIS

   Bei der Zuordnung werden Parameter über einfache Zeichenfolgen an eine mBox übergeben. Es ist nicht möglich, Arrays aus ContextHub zuzuordnen.

   Ziehen Sie beispielsweise die Komponente Profildaten auf die Seite, um Profildaten zu Ihren Website-Besuchenden zum Steuern Ihrer Target-Kampagne zu verwenden. Es werden die Profildatenvariablen angezeigt, die für die Zuordnung zu Target-Parametern verfügbar sind.

   

4. Wählen Sie die Variablen aus, die für das Adobe Target-System sichtbar sein sollen, indem Sie das Kontrollkästchen Freigeben in den entsprechenden Spalten auswählen.

   

   HINWEIS

   Das Synchronisieren von Parametern erfolgt nur in eine Richtung, nämlich von AEM zu Adobe Target.

Ihr Framework wird erstellt. Um das Framework auf der Veröffentlichungsinstanz zu replizieren, verwenden Sie die Option Framework aktivieren aus dem Sidekick.

Zuordnen von Aktivitäten mit der Target-Cloud-Konfiguration

Ordnen Sie Ihre AEM-Aktivitäten Ihrer Target-Cloud-Konfiguration zu, damit Sie die Aktivitäten in Adobe Target spiegeln können.

Verknüpfen des Target-Frameworks mit Ihrer Site

Nachdem Sie ein Target-Framework in AEM erstellt haben, verknüpfen Sie Ihre Web-Seiten mit dem Framework. Die Targeting-Komponenten auf den Seiten senden die durch das Framework definierten Daten zur Nachverfolgung an Adobe Target. (Siehe Content-Targeting.)

Wenn Sie dem Framework eine Seite zuordnen, erben die untergeordneten Seiten die Zuordnung.

1. Navigieren Sie in der Sites-Konsole zu der Website, die Sie konfigurieren möchten.

2. Wählen Sie über Schnellaktionen oder den Auswahlmodus die Option Eigenschaften anzeigen.

3. Wählen Sie die Registerkarte Cloud-Services aus.

4. Tippen/klicken Sie auf Bearbeiten.

5. Tippen/Klicken Sie auf Konfiguration hinzufügen unter Cloud-Service-Konfigurationen und wählen Sie Adobe Target.

   

6. Wählen Sie unter Konfigurationsreferenz das gewünschte Framework aus.

   HINWEIS

   Stellen Sie sicher, dass Sie das spezifische Framework auswählen, das Sie erstellt haben, und nicht die Target-Cloud-Konfiguration, unter der es erstellt wurde.

7. Klicken oder tippen Sie auf Fertig.

8. Aktivieren Sie die Stammseite der Website, um sie auf dem Veröffentlichungs-Server zu replizieren. (Siehe Veröffentlichen von Seiten.)

   HINWEIS

   Wenn das Framework, das Sie an die Seite angehängt haben, noch nicht aktiviert wurde, wird ein Assistent geöffnet, mit dem Sie es auch veröffentlichen können.

Durchführen der Fehlerbehebung für Target-Verbindungsprobleme

Um Probleme zu beheben, die beim Herstellen einer Verbindung mit Target auftreten, können Sie die folgenden Aufgaben ausführen:

• Stellen Sie sicher, dass die von Ihnen angegebenen Benutzeranmeldeinformationen korrekt sind.
• Stellen Sie sicher, dass die AEM-Instanz eine Verbindung zum Target-Server herstellen kann. Achten Sie beispielsweise darauf, dass Firewall-Regeln nicht zu einer Blockierung von ausgehenden AEM-Verbindungen führen oder dass AEM für die Verwendung erforderlicher Proxys konfiguriert ist.
• Suchen Sie im AEM-Fehlerprotokoll nach hilfreichen Meldungen. Die Datei „error.log“ befindet sich im Verzeichnis crx-quickstart/logs, in dem AEM installiert ist.
• Beim Bearbeiten der Aktivität in Adobe Target zeigt die URL auf „localhost“. Umgehen Sie dieses Problem, indem Sie den AEM-Externalizer auf die richtige URL setzen.