Integration von Dynamic Media Viewern mit Adobe Analytics und Experience Platform Launch

Was ist die Integration von Dynamic Media Viewers mit Adobe Analytics und Experience Platform Launch?

Mit der neuen Erweiterung Dynamic Media Viewers für Platform launch und Dynamic Media Viewers 5.13 können Kunden von Adobe Analytics und Platform launch Ereignis und Daten, die für die Viewer spezifisch sind, in ihrer Platform launch-Konfiguration verwenden.

Diese Integration sorgt dafür, dass Sie die Nutzung von Dynamic Media-Viewern auf Ihrer Website mit Adobe Analytics verfolgen können. Gleichzeitig können Sie die von den Viewern offen gelegten Ereignis und Daten mit jeder anderen Platform launch-Erweiterung verwenden, die von der Adobe oder einem Drittanbieter stammt.

Weitere Informationen zu Erweiterungen finden Sie unter Adobe-Erweiterungen im Experience Platform Launch-Benutzerhandbuch.

Dieses Thema ist für folgende Zwecke gedacht: Site-Administratoren, Entwickler auf der Adobe Experience Manager-Plattform und Mitarbeiter im Betrieb.

Einschränkungen der Integration

  • Die Experience Platform Launch-Integration für Dynamic Media-Viewer funktioniert nicht im Experience Manager-Autorenknoten. Sie können keine Verfolgung einer WCM-Seite anzeigen, bis diese veröffentlicht wurde.
  • Die Integration von Experience Platform Launchs in Dynamic Media-Viewer wird nicht für den Popup-Betriebsmodus unterstützt, bei dem die Viewer-URL über die Schaltfläche "URL"auf der Seite "Asset-Details"abgerufen wird.
  • Die Integration von Experience Platform Launchs kann nicht gleichzeitig mit der Analytics-Integration älterer Viewer verwendet werden (über den Parameter config2=).
  • Unterstützung für das Video-Tracking ist auf das Core-Wiedergabe-Tracking beschränkt, wie unter Tracking-Übersicht beschrieben. Insbesondere wird die Verfolgung von QoS, Anzeigen, Kapiteln/Segmenten oder Fehlern nicht unterstützt.
  • Die Konfiguration der Speicherdauer für Datenelemente wird bei Datenelementen, die die Erweiterung Dynamic Media-Viewer verwenden, nicht unterstützt. Die Speicherdauer muss auf Ohne eingestellt sein.

Anwendungsbeispiele für die Integration

Der primäre Anwendungsfall für die Integration mit Experience Platform Launch sind Kunden, die sowohl Experience Manager-Assets als auch Experience Manager-Sites verwenden. In solchen Fällen können Sie eine Standardintegration zwischen dem Autorenknoten und dem Experience Platform Launch Ihres Experience Managers einrichten und dann Ihre Sites-Instanz mit der Experience Platform Launch-Eigenschaft verknüpfen. Danach verfolgt jede Dynamic Media-WCM-Komponente, die einer Sites-Seite hinzugefügt wird, Daten und Ereignisse von Viewern.

Siehe Verfolgen von Dynamic Media-Viewern in Experience Manager-Sites.

Ein sekundärer Anwendungsfall, den die Integration unterstützt, sind diejenigen Kunden, die nur Experience Manager Assets oder Dynamic Media Classic verwenden. In solchen Fällen können Sie den Einbettungs-Code für Ihren Viewer abrufen und der Web-Seite hinzufügen. Rufen Sie dann die Produktions-URL der Experience Platform Launch-Bibliothek von Experience Platform Launch ab und fügen Sie sie manuell zum Webseitencode hinzu.

Siehe Verfolgen von Dynamic Media-Viewern mit Einbettungscode.

Funktionsweise der Daten- und Ereignisverfolgung in der Integration

Die Integration nutzt zwei separate und unabhängige Typen der Verfolgung von Dynamic Media-Viewern: Adobe Analytics und Adobe Analytics for Audio and Video.

Informationen zum Tracking mit Adobe Analytics

Mit Adobe Analytics können Sie Aktionen verfolgen, die vom Endbenutzer bei der Interaktion mit Dynamic Media-Viewern auf Ihrer Website ausgeführt werden. Mit Adobe Analytics können Sie außerdem Viewer-spezifische Daten verfolgen. Sie können beispielsweise Ansichten-Ladeaktionen mit dem Asset-Namen, ggf. eingetretene Zoomaktionen und Videowiedergabeaktionen verfolgen und aufzeichnen.

In Experience Platform Launch arbeiten die Konzepte von Datenelemente und Regeln zusammen, um die Adobe Analytics-Verfolgung zu ermöglichen.

Datenelemente in Experience Platform Launch

Ein Datenelement in Experience Platform Launch ist eine benannte Eigenschaft, deren Wert entweder statisch definiert oder basierend auf dem Status einer Webseite oder Dynamic Media Viewer-Daten dynamisch berechnet wird.

Die für eine Datenelementdefinition verfügbaren Optionen hängen von der Liste der Erweiterungen ab, die in der Experience Platform Launch-Eigenschaft installiert sind. Die Erweiterung „Core“ ist vorinstalliert und in jeder Konfiguration standardmäßig verfügbar. Mit dieser "Core"-Erweiterung können Sie ein Datenelement definieren, das aus Cookies, JavaScript-Code, Abfragen-Zeichenfolge und vielen anderen Quellen stammt.

Für die Adobe Analytics-Verfolgung müssen mehrere weitere Erweiterungen installiert werden, wie unter Installation und Einrichtung von Erweiterungen beschrieben. Die Erweiterung „Dynamic Media-Viewer“ bietet die Möglichkeit, ein Datenelement zu definieren, dessen Wert ein Argument des Dynamic Media-Viewer-Ereignisses ist. Beispielsweise können Sie auf den Viewer-Typ oder den Asset-Namen verweisen, der vom Viewer beim Laden gemeldet wird, auf den Zoomgrad, der beim Zoomen des Endbenutzers gemeldet wird, und vieles mehr.

Die Dynamic Media Viewer-Erweiterung hält die Werte der Datenelemente automatisch auf dem neuesten Stand.

Nachdem Sie es definiert haben, kann ein Datenelement an anderen Stellen der Benutzeroberfläche des Experience Platform Launchs mithilfe des Widgets "Datenelementauswahl"verwendet werden. Insbesondere werden Datenelemente, die für die Verfolgung von Dynamic Media-Viewern definiert werden, in der Regel unter "Variablenaktion von Adobe Analytics-Erweiterung festlegen"referenziert (siehe unten).

Siehe Datenelemente im Experience Platform Launch-Benutzerhandbuch.

Info zu Regeln in Experience Platform Launch

Eine Regel im Experience Platform Launch ist eine agnostische Konfiguration, die drei Regelbereiche definiert: Ereignis, Conditions und Aktionen:

  • Ereignis (if) geben dem Experience Platform Launch an, wann eine Regel Trigger werden soll.
  • Bedingungen (falls) geben dem Experience Platform Launch an, welche anderen Einschränkungen beim Auslösen einer Regel zulässig oder nicht zulässig sind.
  • Mit Aktionen (dann) wird dem Experience Platform Launch mitgeteilt, wie er vorgehen soll, wenn eine Regel ausgelöst wird.

Die Optionen, die im Abschnitt "Ereignis", "Bedingungen"und "Aktionen"verfügbar sind, hängen von den Erweiterungen ab, die in der Eigenschaft "Experience Platform Launch"installiert sind. Die Erweiterung Core ist vorinstalliert und in jeder Konfiguration standardmäßig verfügbar. Die Erweiterung bietet mehrere Optionen für Ereignisse wie grundlegende Aktionen auf Browserebene, die Fokusänderung, Tastendruck und Formularübermittlungen umfassen. Sie enthält zudem Optionen für Bedingungen, wie z. B. Cookie-Wert, Browser-Typ und mehr. Für Aktionen steht nur die Option „Benutzerspezifischer Code“ zur Verfügung.

Für die Adobe Analytics-Verfolgung müssen mehrere weitere Erweiterungen installiert werden, wie unter Installation und Einrichtung von Erweiterungen beschrieben. Insbesondere gilt:

  • Die Erweiterung „Dynamic Media-Viewer“ erweitert die Liste der unterstützten Ereignisse auf Ereignisse, die für Dynamic Media-Viewer spezifisch sind, z. B. Laden des Viewers, Austauschen von Assets, Vergrößern und Abspielen von Videos.
  • Die Adobe Analytics-Erweiterung erweitert die Liste der unterstützten Aktionen um zwei Aktionen, die zum Senden von Daten an Tracking-Server erforderlich sind: Variablen festlegen und Beacon senden.

Zur Verfolgung von Dynamic Media-Viewern können Sie jeden der folgenden Typen verwenden:

  • Ereignisse aus der Erweiterung „Dynamic Media-Viewer“, der Core-Erweiterung oder einer anderen Erweiterung.
  • Bedingungen in der Regeldefinition. Alternativ können Sie den Bedingungsbereich leer lassen.

Im Abschnitt „Aktionen“ müssen Sie über die Aktion Variablen festlegen verfügen. Diese Aktion teilt Adobe Analytics mit, wie Tracking-Variablen mit Daten ausgefüllt werden. Gleichzeitig sendet die Aktion Variablen festlegen nichts an den Tracking-Server.

Auf die Aktion Variablen festlegen muss eine Aktion vom Typ Beacon senden folgen. Mit der Aktion Beacon senden werden tatsächlich Daten an den Analytics-Tracking-Server gesendet. Beide Aktionen (Variablen festlegen und Beacon senden) kommen aus der Adobe Analytics-Erweiterung.

Siehe Rules im Experience Platform Launch-Benutzerhandbuch.

Beispielkonfiguration

Die folgende Beispielkonfiguration in Experience Platform Launch zeigt, wie ein Asset-Name beim Laden des Viewers verfolgt wird.

  1. Definieren Sie auf der Registerkarte Datenelemente ein Datenelement AssetName, das auf den asset-Parameter des LOAD-Ereignisses in der Erweiterung „Dynamic Media-Viewer“ verweist.

    image2019-11

  2. Definieren Sie auf der Registerkarte Regeln eine Regel für TrackAssetOnLoad.

    In dieser Regel verwendet das Feld Ereignis das LOAD-Ereignis aus der Erweiterung „Dynamic Media-Viewer“.

    image2019-22

  3. Die Aktionskonfiguration umfasst zwei Aktionstypen aus der Adobe Analytics-Erweiterung:

    Variablen festlegen, wodurch eine Analytics-Variable Ihrer Wahl dem Wert des Datenelements AssetName zugeordnet wird;

    Beacon senden, wodurch Tracking-Daten an Adobe Analytics gesendet werden.

    image2019-3

  4. Die daraus resultierende Regelkonfiguration sieht wie folgt aus:

    image2019-4

Informationen zu Adobe Analytics for Audio and Video

Wenn für die Verwendung von Adobe Analytics for Audio and Video ein Experience Cloud-Konto abonniert wird, reicht es, in den Einstellungen der Erweiterung Dynamic Media-Viewer das Video-Tracking zu aktivieren. Videometriken werden so in Adobe Analytics verfügbar. Video-Tracking ist auf die Erweiterung „Adobe Media Analytics for Audio and Video“ angewiesen.

Siehe Installation und Einrichtung von Erweiterungen.

Derzeit ist die Unterstützung für Video-Tracking auf das Tracking „Core-Wiedergabe“ beschränkt, wie in der Tracking-Übersicht beschrieben. Insbesondere wird die Verfolgung von QoS, Anzeigen, Kapiteln/Segmenten oder Fehlern nicht unterstützt.

Verwenden der Erweiterung „Dynamic Media-Viewer“

Wie unter Anwendungsfälle für die Integration erwähnt, ist es möglich, Dynamic Media-Viewer mit der neuen Experience Platform Launch-Integration in Experience Manager-Sites und mithilfe von Einbettungscode zu verfolgen.

Verfolgen von Dynamic Media-Viewern in Experience Manager-Sites

Zur Verfolgung von Dynamic Media-Viewern auf Experience Manager-Sites müssen alle unter Konfigurieren aller Integrationselemente aufgeführten Schritte ausgeführt werden. Insbesondere müssen Sie die IMS-Konfiguration und die Experience Platform Launch Cloud-Konfiguration erstellen.

Nach ordnungsgemäßer Konfiguration verfolgt jeder Dynamic Media-Viewer, den Sie einer Sites-Seite mithilfe einer von Dynamic Media unterstützten WCM-Komponente hinzufügen, automatisch Daten für Adobe Analytics oder Adobe Analytics for Video oder beides.

Siehe Hinzufügen von Dynamic Media-Assets zu Seiten mit Adobe Sites.

Verfolgen von Dynamic Media-Viewern mit Einbettungs-Code

Kunden, die keine Experience Manager-Sites verwenden oder Dynamic Media-Viewer in Webseiten außerhalb von Experience Manager-Sites oder beides einbetten, können weiterhin die Experience Platform Launch-Integration verwenden.

Führen Sie die Konfigurationsschritte aus den Abschnitten Adobe Analytics konfigurieren und Experience Platform Launch konfigurieren aus. Es sind jedoch keine Konfigurationsschritte im Zusammenhang mit dem Experience Manager erforderlich.

Nach ordnungsgemäßer Konfiguration können Sie einer Webseite mit einem Dynamic Media-Viewer Experience Platform Launch-Unterstützung hinzufügen.

Weitere Informationen zur Verwendung des Einbettungscodes in der Experience Platform Launch-Bibliothek finden Sie unter Hinzufügen Experience Platform Launch-Einbettungscode.

Weitere Informationen zur Verwendung der Einbettungscode-Funktion von Experience Manager Dynamic Media finden Sie unter Einbetten des Video- oder Bild-Viewers auf einer Webseite.

So verfolgen Sie Dynamic Media-Viewer mit Einbettungs-Code:

  1. Verwenden Sie eine Web-Seite, die bereit zum Einbetten eines Dynamic Media-Viewers ist.
  2. Rufen Sie den Einbettungscode für die Experience Platform Launch-Bibliothek ab, indem Sie sich zuerst bei Experience Platform Launch anmelden (siehe Experience Platform Launch konfigurieren).
  3. Klicken Sie auf Eigenschaften und dann auf die Registerkarte Umgebungen.
  4. Wählen Sie die für die Umgebung der Web-Seite relevante Umgebungsebene aus. Klicken Sie dann in der Spalte Installieren auf das Kontrollkästchen.
  5. Kopieren Sie im Dialogfeld "Webinstallationsanweisungen"den Einbettungscode der gesamten Experience Platform Launch-Bibliothek zusammen mit den umliegenden <script/> Tags.

Referenzhandbuch für die Erweiterung „Dynamic Media-Viewer“

Über die Konfiguration der Dynamic Media-Viewer

Die Dynamic Media Viewer-Erweiterung wird automatisch in die Experience Platform Launch-Bibliothek integriert, wenn die folgenden Bedingungen erfüllt sind:

  • Globales Experience Platform Launch-Bibliotheksobjekt ( _satellite) ist auf der Seite vorhanden.

  • Die Erweiterungsfunktion für „Dynamic Media-Viewer“ _dmviewers_v001() ist für _satellite definiert.

  • Der Viewer-Parameter config2= wurde nicht angegeben. Das bedeutet, dass der Viewer keine ältere Analytics-Integration verwendet.

Außerdem gibt es die Möglichkeit, die Integration von Experience Platform Launchs im Viewer explizit zu deaktivieren, indem Sie in der Viewer-Konfiguration den Parameter launch=0 angeben. Der Standardwert dieses Parameters ist 1.

Konfigurieren der Erweiterung „Dynamic Media-Viewer“

Die einzige Konfigurationsoption für die Erweiterung „Dynamic Media-Viewer“ ist Adobe Media Analytics for Audio and Video aktivieren.

Wenn Sie diese Option aktivieren (aktivieren) und die Adobe Mediums Analytics for Audio and Video-Erweiterung installiert und konfiguriert ist, werden Videowiedergabemetriken für die Audio- und Videolösung an das Adobe Analytics gesendet. Durch Deaktivieren dieser Option wird das Video-Tracking deaktiviert.

Wenn Sie diese Option aktivieren, ohne die Erweiterung "Adobe Mediums Analytics for Audio and Video"installiert zu haben, hat diese Option keine Auswirkungen.

image2019-7-22_12-4-23

Datenelemente in der Erweiterung „Dynamic Media-Viewer“

Der einzige Datenelementtyp, den die Erweiterung „Dynamic Media-Viewer“ bietet, ist Viewer-Ereignis aus der Dropdown-Liste Datenelementtyp.

Wenn diese Option aktiviert ist, rendert der Datenelement-Editor ein Formular mit zwei Feldern:

  • Ereignisdatentyp DM-Viewer – eine Dropdown-Liste, die alle Viewer-Ereignisse identifiziert, die von der Erweiterung „Dynamic Media-Viewer“ unterstützt werden und Argumente sowie ein spezielles COMMON-Element aufweisen. Ein COMMON-Element stellt eine Liste von Ereignisparametern dar, die allen von den Viewern gesendeten Ereignistypen gemein sind.
  • Tracking-Parameter – ein Argument des ausgewählten Dynamic Media-Viewer-Ereignisses.

image2019-7-22_12-5-46

Die Liste der unterstützten Ereignis nach Viewer-Typ finden Sie im Referenzhandbuch Dynamic Media Viewer. Rufen Sie den Abschnitt zu einem bestimmten Viewer auf und klicken Sie dann auf Support für Adobe Analytics-Tracking-Unterabschnitt. Derzeit sind Ereignisargumente im Referenzhandbuch für Dynamic Media-Viewer nicht dokumentiert.

Betrachten wir nun den Lebenszyklus des Datenelements von „Dynamic Media-Viewer“. Der Wert dieses Datenelements wird ausgefüllt, nachdem das entsprechende Dynamic Media-Viewers-Ereignis auf der Seite eintritt. Angenommen, das Datenelement verweist auf das Ereignis LOAD und das zugehörige "asset"-Argument. Der Wert dieses Datenelements empfängt gültige Daten, nachdem der Viewer das LOAD-Ereignis zum ersten Mal ausführt. Wenn das Datenelement auf das ZOOM-Ereignis und das zugehörige "scale"-Argument verweist, bleibt der Wert dieses Datenelements leer, bis der Viewer zum ersten Mal ein ZOOM-Ereignis sendet.

Gleichermaßen werden die Werte von Datenelementen automatisch aktualisiert, wenn der Viewer ein entsprechendes Ereignis auf der Seite sendet. Der Wert wird auch dann aktualisiert, wenn das betreffende Ereignis nicht in der Regelkonfiguration angegeben ist. Angenommen, das Datenelement ZoomScale wird für den Parameter "scale"des ZOOM-Ereignisses definiert. Die einzige in der Regelkonfiguration vorhandene Regel wird jedoch durch das Ereignis LOAD ausgelöst. Der Wert von ZoomScale wird immer noch aktualisiert, wenn ein Benutzer im Viewer Zoom ausführt.

Jeder Dynamic Media-Viewer verfügt auf der Web-Seite über eine eindeutige Kennung. Das Datenelement verfolgt den Wert selbst und den Viewer, der den Wert ausgefüllt hat. Angenommen, es gibt mehrere Viewer auf derselben Seite und ein AssetName-Datenelement, das auf das LOAD-Ereignis und das zugehörige "asset"-Argument verweist. Das Datenelement AssetName verwaltet eine Sammlung von Asset-Namen, die mit jedem auf der Seite geladenen Viewer verknüpft sind.

Der jeweilige vom Datenelement zurückgegebene Wert hängt vom Kontext ab. Wenn das Datenelement in einer Regel angefordert wird, die durch ein Dynamic Media-Viewer-Ereignis ausgelöst wurde, wird der Datenelementwert für den Viewer zurückgegeben, der die Regel initiiert hat. Und das Datenelement wird in einer Regel angefordert, die durch ein Ereignis einer anderen Platform launch-Erweiterung ausgelöst wurde. An diesem Punkt stammt der Wert des Datenelements aus dem Viewer, der zuletzt dieses Datenelement aktualisiert hat.

Betrachten Sie die folgende Beispieleinrichtung:

  • Eine Webseite mit zwei Dynamic Media-Zoom-Viewern: viewer1 und viewer2.

  • Das Datenelement ZoomScale verweist auf das ZOOM-Ereignis und das zugehörige „scale“-Argument.

  • TrackPan-Regel mit folgenden Eigenschaften:

    • Verwendet das Dynamic Media-Viewer-Ereignis PAN als Auslöser.
    • Sendet den Wert des ZoomScale-Datenelements an Adobe Analytics.
  • TrackKey-Regel mit folgenden Eigenschaften:

    • Verwendet das Ereignis der Tastenpresse aus der Core Experience Platform Launch Extension als Trigger.
    • Sendet den Wert des ZoomScale-Datenelements an Adobe Analytics.

Nehmen wir nun an, dass der Endbenutzer die Web-Seite mit beiden Viewern lädt. In Viewer1 zoomt er auf eine Skalierung von 50 %. In Viewer2 zoomt er dann auf eine Skalierung von 25 %. In Viewer1 schwenkt er das Bild und drückt schließlich eine Taste auf der Tastatur.

Die Aktivitäten des Endbenutzers führen dazu, dass die folgenden beiden Tracking-Aufrufe an Adobe Analytics gesendet werden:

  • Der erste Aufruf erfolgt, weil die TrackPan-Regel ausgelöst wird, wenn der Benutzer in Viewer1 schwenkt. Dieser Aufruf sendet 50 % als Wert des Datenelements ZoomScale, da das Datenelement weiß, dass die Regel von viewer1 ausgelöst wird, und den entsprechenden Skalierungswert abrufen;
  • Der zweite Aufruf erfolgt, weil die TrackKey-Regel ausgelöst wird, wenn der Benutzer eine Taste auf der Tastatur drückt. Bei diesem Aufruf werden 25 % als Wert des ZoomScale-Datenelements gesendet, da die Regel nicht vom Viewer ausgelöst wurde. Daher gibt das Datenelement den aktuellsten Wert zurück.

Das oben aufgestellte Beispiel wirkt sich auch auf die Lebensdauer des Datenelementwerts aus. Der Wert des vom Dynamic Media Viewer verwalteten Datenelements wird auch dann im Experience Platform Launch-Bibliothekscode gespeichert, wenn der Viewer selbst auf der Webseite abgelegt wird. Diese Funktion bedeutet, dass das Datenelement den letzten bekannten Wert zurückgibt, wenn es eine Regel gibt, die von einer Nicht-Dynamic Media-Viewer-Erweiterung ausgelöst wird und auf dieses Datenelement verweist. Auch wenn der Viewer nicht mehr auf der Webseite vorhanden ist.

In jedem Fall werden die von Dynamic Media Viewern angetriebenen Datenelementwerte nicht auf der lokalen Datenspeicherung oder auf dem Server gespeichert. Sie werden stattdessen nur in der clientseitigen Experience Platform Launch-Bibliothek gespeichert. Die Werte solcher Datenelemente verschwinden, wenn die Web-Seite neu geladen wird.

Im Allgemeinen unterstützt der Datenelement-Editor eine Festlegung der Speicherdauer. Datenelemente, die die Dynamic Media Viewer-Erweiterung verwenden, unterstützen jedoch nur die Option für die Datenspeicherung von Keine. Das Festlegen eines anderen Werts ist in der Benutzeroberfläche möglich, in diesem Fall wird jedoch das Verhalten des Datenelements nicht definiert. Die Erweiterung verwaltet den Wert des Datenelements selbst: das Datenelement, das den Wert des Viewer-Ereignisarguments während des gesamten Lebenszyklus des Viewers beibehält.

Über Regeln in der Erweiterung „Dynamic Media-Viewer“

Im Regeleditor werden mit der Erweiterung neue Konfigurationsoptionen für den Ereigniseditor hinzugefügt. Außerdem bietet der Editor eine Option zum manuellen Referenzieren von Ereignis-Parametern im Action-Editor als Kurzoption, anstatt vorkonfigurierte Datenelemente zu verwenden.

Über den Ereigniseditor

Im Ereignis-Editor fügt die Dynamic Media Viewer-Erweiterung einen Ereignistyp mit dem Namen Viewer-Ereignis hinzu.

Wenn diese Option aktiviert ist, rendert der Ereigniseditor die Dropdown-Liste Dynamic Media-Viewer-Ereignisse und listet alle verfügbaren Ereignisse auf, die von Dynamic Media-Viewern unterstützt werden.

image2019-8-2_15-13-1

Über den Aktionseditor

Mit der Erweiterung „Dynamic Media-Viewer“ können Sie Ereignisparameter von Dynamic Media-Viewern verwenden, um im Editor „Variablen festlegen“ der Adobe Analytics-Erweiterung Analysevariablen zuzuordnen.

Die einfachste Methode dazu besteht darin, den folgenden zweistufigen Vorgang durchzuführen:

  • Definieren Sie zunächst ein oder mehrere Datenelemente, wobei jedes Datenelement einen Parameter eines Dynamic Media-Viewer-Ereignisses darstellt.
  • Klicken Sie dann im Editor „Variablen festlegen“ der Adobe Analytics-Erweiterung auf das Symbol für die Datenelementauswahl (drei gestapelte Festplatten), um das Dialogfeld „Datenelement auswählen“ zu öffnen; wählen Sie dann ein Datenelement aus.

image2019-7-10_20-41-52

Es ist jedoch möglich, einen anderen Ansatz zu verwenden und die Erstellung von Datenelementen zu umgehen. Sie können direkt auf ein Argument aus einem Dynamic Media Viewer-Ereignis verweisen. Geben Sie im Eingabefeld value der Analytics-Variablenzuweisung den vollständig qualifizierten Namen des Ereignis-Arguments ein. Stellen Sie sicher, dass Sie die Prozentzeichen (%) eintragen. Beispiel:

%event.detail.dm.LOAD.asset%

image2019-7-12_19-2-35

Es gibt einen wichtigen Unterschied zwischen der Verwendung von Datenelementen und der Referenz zu direkten Ereignissen. Bei Datenelementen spielt es keine Rolle, welches Ereignis die Aktion "Variablen festlegen"Trigger. Das Ereignis, dass die Regel Trigger des dynamischen Viewers sein kann (z. B. Klicken auf die Webseite in der Core-Erweiterung). Bei Verwendung eines direkten Argumentverweises muss jedoch sichergestellt werden, dass das Ereignis, das die Regel auslöst, dem Ereignisargument entspricht, auf das es verweist.

Wenn Sie beispielsweise auf %event.detail.dm.LOAD.asset% verweisen, wird der richtige Asset-Name zurückgegeben, wenn die Regel durch das LOAD-Ereignis der Dynamic Media-Viewer-Erweiterung ausgelöst wird. Bei jedem anderen Ereignis wird jedoch ein leerer Wert zurückgegeben.

In der folgenden Tabelle sind die Dynamic Media-Viewer-Ereignisse sowie die unterstützten Argumente aufgeführt:

Name des Viewer-Ereignisses Argumentverweis
COMMON %event.detail.dm.objID%
%event.detail.dm.compClass%
%event.detail.dm.instName%
%event.detail.dm.timeStamp%
BANNER %event.detail.dm.BANNER.asset%
%event.detail.dm.BANNER.frame%
%event.detail.dm.BANNER.label%
HREF %event.detail.dm.HREF.rollover%
ITEM %event.detail.dm.ITEM.rollover%
LOAD %event.detail.dm.LOAD.applicationname%
%event.detail.dm.LOAD.asset%
%event.detail.dm.LOAD.company%
%event.detail.dm.LOAD.sdkversion%
%event.detail.dm.LOAD.viewertype%
%event.detail.dm.LOAD.viewerversion%
METADATA %event.detail.dm.METADATA.length%
%event.detail.dm.METADATA.type%
MILESTONE %event.detail.dm.MILESTONE.milestone%
PAGE %event.detail.dm.PAGE.frame%
%event.detail.dm.PAGE.label%
PAUSE %event.detail.dm.PAUSE.timestamp%
PLAY %event.detail.dm.PLAY.timestamp%
SPIN %event.detail.dm.SPIN.framenumber%
STOP %event.detail.dm.STOP.timestamp%
SWAP %event.detail.dm.SWAP.asset%
SWATCH %event.detail.dm.SWATCH.frame%
%event.detail.dm.SWATCH.label%
TARG %event.detail.dm.TARG.frame%
%event.detail.dm.TARG.label%
ZOOM %event.detail.dm.ZOOM.scale%

Konfigurieren aller Integrationselemente

Voraussetzungen

Adobe empfiehlt, dass Sie die gesamte Dokumentation vor diesem Abschnitt gründlich überprüfen, damit Sie die vollständige Integration verstehen.

In diesem Abschnitt werden die Konfigurationsschritte erläutert, die zur Integration von Dynamic Media-Viewern mit Adobe Analytics und Adobe Analytics for Audio and Video erforderlich sind. Auch wenn die Dynamic Media Viewer-Erweiterung für andere Zwecke im Experience Platform Launch verwendet werden kann, werden solche Szenarien in dieser Dokumentation nicht behandelt.

Sie verwenden die folgenden Adoben zur Konfiguration Ihrer Integration:

  • Adobe Analytics - zur Konfiguration von Verfolgungsvariablen und Berichten.
  • Experience Platform Launch: Dient zum Definieren einer Eigenschaft, einer oder mehrerer Regeln und eines oder mehrerer Datenelemente, um die Viewer-Verfolgung zu aktivieren.

Wenn diese Integrationslösung mit Experience Manager-Sites verwendet wird, muss die folgende Konfiguration durchgeführt werden:

  • Adobe I/O Console - Die Integration wird für den Experience Platform Launch erstellt.
  • Experience Manager-Autorenknoten - IMS-Konfiguration und Experience Platform Launch-Cloud-Konfiguration.

Vergewissern Sie sich, dass Sie im Rahmen der Konfiguration Zugriff auf eine Firma in Adobe Experience Cloud haben, für die Adobe Analytics und Experience Platform Launch bereits aktiviert sind.

Konfigurieren von Adobe Analytics für die Integration

Nach der Konfiguration von Adobe Analytics wird Folgendes für die Integration eingerichtet:

  • Eine Report Suite ist vorhanden und ausgewählt.
  • Analytics-Variablen stehen zum Empfang von Verfolgungsdaten zur Verfügung.
  • Es gibt Berichte zur Anzeige der in Adobe Analytics erfassten Daten.

Siehe auch Analytics-Implementierungshandbuch.

So konfigurieren Sie Adobe Analytics für die Integration:

  1. Beginnen Sie, indem Sie über die Experience Cloud-Startseite auf Adobe Analytics zugreifen. Klicken Sie in der Menüleiste auf das Symbol „Lösungen“ (eine Tabelle mit drei mal drei Punkten) oben rechts auf der Seite und klicken Sie dann auf Analytics.

    2019-07-22_18-08-47

    Wählen Sie jetzt eine Report Suite aus.

Auswählen einer Report Suite

  1. Wählen Sie rechts oben auf der Seite „Adobe Analytics“ rechts neben dem Feld Berichte durchsuchen die gewünschte Report Suite aus der Dropdown-Liste. Wenn mehrere Report Suites verfügbar sind und Sie nicht sicher sind, welche verwendet werden soll, wenden Sie sich an Ihren Adobe Analytics-Administrator, um sich bei der Auswahl der zu verwendenden Report Suite helfen zu lassen.

    In der folgenden Abbildung hat ein Benutzer eine Report Suite mit dem Namen DynamicMediaViewersExtensionDoc erstellt und aus der Dropdown-Liste ausgewählt. Der Name der Report Suite dient nur zur Veranschaulichung. Der Name der Report Suite, die Sie letztendlich auswählen, liegt bei Ihnen.

    Wenn keine Report Suite verfügbar ist, müssen Sie oder Ihr Adobe Analytics-Administrator eine erstellen, bevor Sie mit der Konfiguration fortfahren können.

    Siehe Berichte und Report Suites und Report Suite erstellen.

    In Adobe Analytics werden Report Suites unter Admin > Report Suites verwaltet.

    2019-07-22_18-09-49

    Richten Sie jetzt Adobe Analytics-Variablen ein.

Einrichten von Adobe Analytics-Variablen

  1. Legen Sie eine oder mehrere Adobe Analytics-Variablen fest, die Sie zur Verfolgung des Dynamic Media-Viewer-Verhaltens auf der Webseite verwenden möchten.

    Es lassen sich beliebige Variablentypen verwenden, die von Adobe Analytics unterstützt werden. Die Entscheidung über den Variablentyp (z. B. Custom Traffic [props], Conversion [eVar]) wird von spezifischen Anforderungen Ihrer Analytics-Implementierung bestimmt.

    Siehe Übersicht über props und eVars.

    Für die Zwecke dieser Dokumentation wird nur eine Eigenschaftsvariable (Custom Traffic) verwendet, da sie in einem Analytics-Bericht innerhalb weniger Minuten nach dem Auftreten einer Aktion auf einer Webseite verfügbar ist.

    Um eine neue Custom Traffic-Variable zu aktivieren, klicken Sie in Adobe Analytics in der Symbolleiste auf Admin > Report Suites.

  2. Wählen Sie auf der Seite Report Suite Manager den gewünschten Bericht aus und klicken Sie dann in der Symbolleiste auf Einstellungen bearbeiten > Traffic > Traffic-Variablen.

  3. Wählen Sie dort eine nicht verwendete Variable aus, geben Sie ihr einen beschreibenden Namen ( Viewer-Asset (prop 30)) und ändern Sie das Kombinationsfeld in der Spalte Aktiviert in "Aktiviert".

    Der folgende Screenshot ist ein Beispiel für eine Custom Traffic-Variable ( prop30) zur Verfolgung eines vom Viewer verwendeten Asset-Namens:

    image2019-6-26_23-6-59

  4. Klicken Sie unten in der Variablenliste auf Speichern.

Einrichten eines Berichts

  1. Im Allgemeinen wird die Einrichtung eines Berichts in Adobe Analytics von den jeweiligen Projektanforderungen bestimmt. Die Einrichtung detaillierter Berichte ist daher für diese Integration nicht relevant.

    Es ist jedoch ausreichend zu wissen, dass die Berichte zum benutzerdefinierten Traffic in Adobe Analytics automatisch verfügbar werden, nachdem Sie unter Einrichten von Adobe Analytics-Variablen benutzerdefinierte Traffic-Variablen eingerichtet haben.

    Beispielsweise ist der Bericht für Viewer-Asset (prop 30) im Menü „Berichte“ unter Custom Traffic > Custom Traffic 21-30 > Viewer-Asset (prop 30) verfügbar.

    Beim Aufrufen dieses Berichts direkt nach der Erstellung von Viewer-Asset (prop 30) werden keine Daten angezeigt; das ist an diesem Punkt der Integration zu erwarten.

    image2019-6-26_23-12-49

Konfigurieren von Experience Platform Launch für die Integration

Nach der Konfiguration von Experience Platform Launch wird Folgendes für die Integration eingerichtet:

  • Erstellung einer neuen Eigenschaft, um alle Konfigurationen zusammenzuhalten.
  • Installation und Einrichtung von Erweiterungen. Der Client-seitige Code aller in der Eigenschaft installierten Erweiterungen wird in einer Bibliothek kompiliert. Diese Bibliothek wird später von der Web-Seite verwendet.
  • Konfiguration von Datenelementen und Regeln. Diese Konfiguration bestimmt darüber, welche Daten von den Dynamic Media-Viewern erfasst werden, wann die Tracking-Logik ausgelöst wird und wohin die Daten des Viewers in Adobe Analytics gesendet werden.
  • Veröffentlichen der Bibliothek.

So konfigurieren Sie den Experience Platform Launch für die Integration:

  1. Beginn durch Zugriff auf Experience Platform Launch aus dem Experience Cloud Startseite. Klicken Sie in der Menüleiste auf das Symbol „Lösungen“ (eine Tabelle mit drei mal drei Punkten) oben rechts auf der Seite und klicken Sie dann auf Launch.

    Sie können auch Experience Platform Launch direkt öffnen.

    image2019-7-8_15-38-44

Erstellen einer Eigenschaft in Experience Platform Launch

Eine Eigenschaft in Experience Platform Launch ist eine benannte Konfiguration, die alle Einstellungen zusammenhält. Es wird eine Bibliothek der Konfigurationseinstellungen erstellt und in verschiedenen Umgebungsebenen (Entwicklung, Staging und Produktion) veröffentlicht.

Siehe auch Erstellen einer Experience Platform Launch-Eigenschaft.

  1. Klicken Sie in Experience Platform Launch auf Neue Eigenschaft.

  2. Geben Sie im Dialogfeld Eigenschaft erstellen im Feld Name einen beschreibenden Namen ein, z. B. den Titel Ihrer Website. Beispiel: DynamicMediaViewersProp.

  3. Geben Sie im Feld Domains die Domain Ihrer Website ein.

  4. Aktivieren Sie in der Dropdown-Liste Erweiterte Optionen die Option Für Erweiterungsentwicklung konfigurieren (kann später nicht mehr geändert werden), falls die gewünschte Erweiterung (in diesem Fall Dynamic Media-Viewer) noch nicht veröffentlicht wurde.

    image2019-7-8_16-3-47

  5. Klicken Sie auf Speichern.

    Klicken Sie auf die neu erstellte Eigenschaft und fahren Sie dann mit Installation und Einrichtung von Erweiterungen fort.

Installation und Einrichtung von Erweiterungen

Alle verfügbaren Erweiterungen in Experience Platform Launch werden unter Erweiterungen > Katalog aufgelistet.

Um eine Erweiterung zu installieren, klicken Sie auf Installieren. Führen Sie bei Bedarf eine einmalige Erweiterungskonfiguration durch und klicken Sie dann auf Speichern.

Wenn erforderlich, müssen die folgenden Erweiterungen installiert und konfiguriert werden:

  • (Erforderlich) Experience Cloud ID Service-Erweiterung

Es ist keine zusätzliche Konfiguration erforderlich; akzeptieren Sie die vorgeschlagenen Werte. Wenn Sie fertig sind, klicken Sie auf Speichern.

Siehe Experience Cloud ID Service-Erweiterung.

  • (Erforderlich) Adobe Analytics-Erweiterung

Zum Konfigurieren dieser Erweiterung benötigen Sie die Report Suite-ID in Adobe Analytics unter Admin > Report Suite unter der Spaltenüberschrift Report Suite-ID.

(Nur zu Demonstrationszwecken wird die Report Suite-ID der DynamicMediaViewersExtensionDoc Report Suite in den folgenden Screenshots verwendet. Diese ID wurde unter Auswählen einer Report Suite zuvor erstellt und eingesetzt.)

image2019-7-8_16-45-34

Geben Sie auf der Seite „Erweiterung installieren“ die Report Suite-ID in das Feld Report Suites Entwicklung, das Feld Report Suites Staging und das Feld Report Suites Produktion ein.

image2019-7-8_16-47-40

Konfigurieren Sie das folgende Element nur, wenn Sie Video-Tracking verwenden möchten:

Erweitern Sie auf der Seite Erweiterung installieren den Eintrag Allgemein und geben Sie dann den Tracking-Server an. Der Tracking-Server folgt der Vorlage <trackingNamespace>.sc.omtrdc.net, wobei <trackingNamespace> die in der Bereitstellungs-E-Mail abgerufene Information darstellt.

Klicken Sie auf Speichern.

Siehe Adobe Analytics-Erweiterung.

  • (Optional; nur erforderlich, wenn Video-Tracking benötigt wird) Erweiterung Adobe Media Analytics for Audio and Video

Füllen Sie das Feld für den Tracking-Server aus. Der Tracking-Server für die Erweiterung Adobe Media Analytics for Audio and Video unterscheidet sich von dem für Adobe Analytics verwendeten Tracking-Server. Er folgt der Vorlage <trackingNamespace>.hb.omtrdc.net, wobei <trackingNamespace> die Information aus der Bereitstellungs-E-Mail darstellt.

Alle anderen Felder sind optional.

Siehe Erweiterung Adobe Media Analytics for Audio and Video.

  • (Erforderlich) Erweiterung Dynamic Media-Viewer

Wählen Sie Adobe Analytics for Video aktivieren, um das Video-Heartbeat-Tracking zu aktivieren (einzuschalten).

Nach dieser Veröffentlichung ist die Erweiterung Dynamic Media Viewers nur verfügbar, wenn die Experience Platform Launch-Eigenschaft für die Entwicklung erstellt wurde.

Siehe Erstellen einer Eigenschaft in Experience Platform Launch.

Nachdem die Erweiterungen installiert und eingerichtet wurden, werden im Bereich „Erweiterungen“ > „Installiert“ mindestens die folgenden fünf Erweiterungen aufgeführt (vier, wenn Sie kein Video-Tracking nutzen).

image2019-7-22_12-7-36

Einrichten von Datenelementen und Regeln

Erstellen Sie in Experience Platform Launch Datenelemente und Regeln, die zur Verfolgung von Dynamic Media-Viewern erforderlich sind.

Eine Übersicht über die Verfolgung mit Experience Platform Launch finden Sie unter Funktionsweise der Daten- und Ereignis-Verfolgung in der Integration.

Eine Beispielkonfiguration in Experience Platform Launch finden Sie unter Beispielkonfiguration, die zeigt, wie ein Asset-Name beim Laden des Viewers verfolgt wird.

Detaillierte Informationen zu den Funktionen der Erweiterung finden Sie unter Konfigurieren der Erweiterung „Dynamic Media-Viewer“.

Veröffentlichen einer Bibliothek

Um die Konfiguration des Experience Platform Launchs zu ändern (einschließlich Eigenschaften, Erweiterungen, Regeln und Datenelemente einrichten), müssen Sie publish-Änderungen vornehmen. Die Veröffentlichung in Experience Platform Launch erfolgt über die Registerkarte "Veröffentlichen"unter der Eigenschaftenkonfiguration.

platform launch kann potenziell über mehrere Development-Umgebung, eine Staging-Umgebung und eine Production-Umgebung verfügen. Standardmäßig verweist die Platform launch Cloud-Konfiguration in Experience Manager den Knoten "Experience Manager-Autor"auf die Umgebung "Phase"von Platform launch. Der Veröffentlichungsknoten des Experience Managers verweist auf die Umgebung Produktion von Platform launch. Diese Vorgehensweise bedeutet, dass bei den Standardeinstellungen für Experience Manager die Platform launch-Bibliothek in der Staging-Umgebung veröffentlicht werden muss. Auf diese Weise können Sie es im Experience Manager-Autor verwenden. Sie können sie dann in der Produktions-Umgebung veröffentlichen, damit sie in der Veröffentlichung von Experience Managern verwendet werden kann.

Weitere Informationen zu Experience Platform Launch-Umgebung finden Sie unter Umgebung.

Das Veröffentlichen einer Bibliothek umfasst die folgenden zwei Schritte:

  • Hinzufügen und Erstellen einer neuen Bibliothek, indem alle erforderlichen Änderungen (neue und Aktualisierungen) in die Bibliothek aufgenommen werden.
  • Die Bibliothek wird durch die verschiedenen Ebenen der Umgebung (von "Entwicklung" bis "Staging"und "Produktion") hochgeladen.

Hinzufügen und Erstellen einer neuen Bibliothek

  1. Wenn Sie die Registerkarte "Veröffentlichung"in Experience Platform Launch zum ersten Mal öffnen, ist die Liste "Bibliothek"leer.

    Klicken Sie in der linken Spalte auf Neue Bibliothek hinzufügen.

    image2019-7-15_14-43-17

  2. Geben Sie auf der Seite „Neue Bibliothek erstellen“ im Feld Name einen beschreibenden Namen für die neue Bibliothek ein. Beispiel:

    DynamicMediaViewersLib

    Wählen Sie in der Dropdown-Liste „Umgebung“ die Umgebungsebene aus. Zunächst steht nur die Entwicklungsebene zur Auswahl zur Verfügung. Klicken Sie unten links auf der Seite auf Alle geänderten Ressourcen hinzufügen.

    image2019-7-15_14-49-41

  3. Klicken Sie in der rechten oberen Ecke auf Für Entwicklung speichern und erstellen.

    In wenigen Minuten wird die Bibliothek erstellt und einsatzbereit.

    image2019-7-15_15-3-34

    HINWEIS

    Wenn Sie das nächste Mal Ihre Experience Platform Launch-Konfiguration ändern, wechseln Sie zur Registerkarte Veröffentlichung unter Eigenschaft und klicken Sie dann auf Ihre zuvor erstellte -Konfiguration.

    Klicken Sie im Bildschirm zur Bibliotheksveröffentlichung auf Alle geänderten Ressourcen hinzufügen und klicken Sie dann auf Für Entwicklung speichern und erstellen.

Eine Umgebung durch die Ebenen hochbewegen

  1. Nachdem eine neue Bibliothek hinzugefügt wurde, befindet sie sich in der Development-Umgebung. Um sie auf die Ebene der Staging-Umgebung (was der Spalte „Gesendet“ entspricht) zu verschieben, klicken Sie im Dropdown-Menü der Bibliothek auf Zur Genehmigung senden.

    image2019-7-15_15-52-37

  2. Klicken Sie im Bestätigungsdialogfeld auf Senden.

    Nachdem die Bibliothek in die Spalte „Gesendet“ verschoben wurde, klicken Sie im Dropdown-Menü der Bibliothek auf Für Staging erstellen.

    image2019-7-15_15-54-37

  3. Um die Bibliothek von der Staging-Umgebung in die Produktions-Umgebung (die Spalte "Veröffentlicht") zu verschieben, führen Sie einen ähnlichen Vorgang aus.

    Klicken Sie zunächst im Dropdown-Menü auf Veröffentlichung genehmigen.

    image2019-7-15_16-7-39

  4. Klicken Sie im Dropdown-Menü auf Für Produktion erstellen und veröffentlichen.

    image2019-7-15_16-8-9

    Weitere Informationen zum Veröffentlichungsprozess in Experience Platform Launch finden Sie unter Veröffentlichung.

Konfigurieren von Adobe Experience Manager für die Integration

Voraussetzungen:

  • In Experience Manager werden die Instanzen im Autorenmodus und im Veröffentlichungsmodus ausgeführt.
  • Experience Manager-Autorenknoten wird in Dynamic Media eingerichtet.
  • Dynamic Media WCM-Komponenten sind in Experience Manager-Sites aktiviert.

Die Konfiguration des Experience Managers umfasst die folgenden zwei Hauptschritte:

  • Konfiguration von Experience Manager IMS.
  • Konfiguration der Experience Platform Launch Cloud.

Konfigurieren von Experience Manager IMS

  1. Klicken Sie im Autorenmodus auf das Symbol Tools (Hammer) und dann auf Sicherheit > Adobe IMS Configurations.

    2019-07-25_11-52-58

  2. Klicken Sie auf der Seite „Adobe IMC-Konfigurationen“ links oben auf Erstellen.

  3. Klicken Sie auf der Seite Adobe IMS Technical Account Configuration in der Dropdown-Liste Cloud Solution auf Experience Platform Launch.

  4. Aktivieren Sie Neues Zertifikat erstellen und geben Sie dann in das Textfeld einen beliebigen aussagekräftigen Wert für das Zertifikat ein. Beispiel: AdobeLaunchIMSCert. Klicken Sie auf Zertifikat erstellen.

    Die folgende Informationsmeldung wird angezeigt:

    Um ein gültiges Zugriffstoken abzurufen, muss der öffentliche Schlüssel des neuen Zertifikats auf Adobe I/O dem technischen Konto hinzugefügt werden!

    Um das Dialogfeld "Info"zu schließen, klicken Sie auf OK.

    2019-07-25_12-09-24

  5. Klicken Sie auf Öffentlichen Schlüssel herunterladen, um eine Public-Key-Datei (*.crt) auf Ihr lokales System herunterzuladen.

    HINWEIS

    Lassen Sie jetzt die Seite Technische Kontokonfiguration für Adobe IMS geöffnet; schließen Sie die Seite nicht und klicken Sie nicht auf Weiter. Sie kehren später in den Schritten zu dieser Seite zurück.

    2019-07-25_12-52-24

  6. Navigieren Sie mit einer neuen Browser-Registerkarte zur Adobe I/O Console.

  7. Klicken Sie auf der Seite Adobe I/O Console-Integrationen rechts oben auf Neue Integration.

  8. Vergewissern Sie sich, dass im Dialogfeld Neue Integration erstellen die Optionsschaltfläche Zugriff auf API ausgewählt ist, und klicken Sie dann auf Weiter.

    2019-07-25_13-04-20

  9. Aktivieren Sie auf der zweiten Seite von Neue Integration erstellen die Optionsschaltfläche Experience Platform Launch-API. Klicken Sie in der rechten unteren Ecke der Seite auf Weiter.

    2019-07-25_13-13-54

  10. Gehen Sie auf der dritten Seite von Neue Integration erstellen wie folgt vor:

    • Geben Sie im Feld Name einen beschreibenden Namen ein. Beispielsweise DynamicMediaViewersIO.

    • Geben Sie im Feld Beschreibung eine Beschreibung für die Integration ein.

    • Laden Sie im Bereich Public-Key-Zertifikate Ihre Public-Key-Datei (*.crt) hoch, die Sie in den Schritten zuvor heruntergeladen haben.

    • Wählen Sie unter der Überschrift Rolle für Experience Platform Launch-API auswählen die Option Admin.

    • Wählen Sie unter der Überschrift Ein oder mehrere Produktprofile für die Experience Platform Launch-API auswählen das Produktprofil Launch – <Name_Ihrer_Firma>.

    2019-07-25_13-49-18

  11. Klicken Sie auf Integration erstellen.

  12. Klicken Sie auf der Seite Integration erstellt auf Weiter zu Integrationsdetails.

    2019-07-25_14-16-33

  13. Es wird eine Seite mit Integrationsdetails (ähnlich der folgenden) angezeigt:

    HINWEIS

    Lassen Sie die Seite mit Integrationsdetails geöffnet. Sie benötigen in Kürze verschiedene Informationen aus den Registerkarten Übersicht und JWT.

    2019-07-25_14-35-30
    Seite „Integrationsdetails“

  14. Kehren Sie zur Seite Technische Kontokonfiguration für Adobe IMS zurück, die Sie zuvor offen gelassen haben. Klicken Sie in der rechten oberen Ecke der Seite auf Weiter, um die Seite Konto im Fenster Technische Kontokonfiguration für Adobe IMS zu öffnen.

    (Wenn Sie die Seite zuvor geschlossen haben, kehren Sie zum Autor des Experience Managers zurück und klicken Sie dann auf Tools > Sicherheit > Adobe IMS Konfigurationen. Klicken Sie auf Erstellen. Wählen Sie in der Dropdown-Liste Cloud-Lösung Experience Platform Launch. Wählen Sie in der Dropdown-Liste Zertifikat den Namen des zuvor erstellten Zertifikats aus.

    2019-07-25_20-57-50
    Technische Kontokonfiguration für Adobe IMS – Zertifikatsseite

  15. Die Seite Konto enthält fünf Felder, in denen Sie Informationen aus der Seite "Integrationsdetails"des vorherigen Schritts ausfüllen müssen.

    2019-07-25_20-42-45
    Technische Kontokonfiguration für Adobe IMS – Kontoseite

  16. Füllen Sie auf der Seite Konto die folgenden Felder aus:

    • Titel: Geben Sie einen beschreibenden Kontonamen ein.
    • Autorisierungs-Server: Kehren Sie zur Seite mit den Integrationsdetails zurück, die Sie zuvor geöffnet haben. Klicken Sie auf die Registerkarte JWT. Kopieren Sie den Server-Namen – ohne Pfad – wie unten hervorgehoben.

(Der Beispiel-Server-Name dient nur zu Veranschaulichungszwecken.) Kehren Sie zur Seite Konto zurück und fügen Sie den Namen in das entsprechende Feld ein.
Beispiel: https://ims-na1.adobelogin.com/(Der Beispiel-Server-Name dient nur zu Veranschaulichungszwecken.)

2019-07-25_15-01-53
Seite mit Integrationsdetails - Registerkarte „JWT“

  1. API-Schlüssel: Kehren Sie zur Seite „Integrationsdetails“ zurück. Klicken Sie auf die Registerkarte Übersicht und dann rechts neben dem Feld API-Schlüssel (Client-ID) auf Kopieren.

    Kehren Sie zur Seite Konto zurück und fügen Sie dann den Schlüssel in das entsprechende Feld ein.

    2019-07-25_14-35-333
    Seite „Integrationsdetails“

  2. Client-Geheimnis: Kehren Sie zur Seite „Integrationsdetails“ zurück. Klicken Sie auf der Registerkarte Übersicht auf Client-Geheimnis abrufen. Klicken Sie rechts neben dem Feld Client-Geheimnis auf Kopieren.

    Kehren Sie zur Seite Konto zurück und fügen Sie dann den Schlüssel in das entsprechende Feld ein.

  3. Payload: Kehren Sie zur Seite „Integrationsdetails“ zurück. Kopieren Sie auf der Registerkarte JWT im Feld „JWT-Payload“ den gesamten JSON-Objekt-Code.

    Kehren Sie zur Seite Konto zurück und fügen Sie den Code in das entsprechende Feld ein.

    2019-07-25_21-59-12
    Seite mit Integrationsdetails – Registerkarte „JWT“

    Die Seite "Konto"mit allen ausgefüllten Feldern sieht wie folgt aus:

    2019-07-25_22-08-30

  4. Tippen Sie oben rechts neben Konto auf Erstellen.

    Wenn Experience Manager-IMS konfiguriert ist, haben Sie jetzt ein neues IMSAccount unter Adobe IMS Konfigurationen aufgelistet.

    image2019-7-15_14-17-54

Konfigurieren der Experience Platform Launch Cloud für die Integration

  1. Klicken Sie im Experience Manager-Autor in der oberen linken Ecke auf das Extras-Symbol (Hammer) und dann auf Cloud Services > Experience Platform Launch Configurations.

    26.07.2019_12-10-38

  2. Wählen Sie auf der Seite Experience Platform Launch-Konfigurationen im linken Bereich eine Experience Manager-Site aus, für die Sie Ihre Experience Platform Launch-Konfiguration anwenden möchten.

    Die Site We.Retail ist im folgenden Screenshot nur zur Veranschaulichung ausgewählt.

    26.07.2019_12-20-06

  3. Klicken Sie links oben auf der Seite auf Erstellen.

  4. Füllen Sie auf der Seite Allgemein (1/3 Seiten) des Fensters Konfiguration des Experience Platform Launchs erstellen die folgenden Felder aus:

    • Titel – Geben Sie einen beschreibenden Konfigurationsnamen ein. Beispiel: We.Retail Launch cloud configuration.

    • Zugeordnete Adobe IMS-Konfiguration : Wählen Sie die IMS-Konfiguration aus, die Sie zuvor unter Experience Manager-IMS konfigurieren erstellt haben.

    • Firma – Wählen Sie aus der Dropdown-Liste Firma Ihre Experience Cloud-Firma aus. Die Liste wird automatisch ausgefüllt.

    • Eigenschaft : Wählen Sie in der Dropdown-Liste "Eigenschaft"die Eigenschaft "Experience Platform Launch"aus, die Sie zuvor erstellt haben. Die Liste wird automatisch ausgefüllt.

    Nachdem Sie alle Felder ausgefüllt haben, sieht Ihre Seite Allgemein wie folgt aus:

    image2019-7-15_14-34-23

  5. Klicken Sie links oben auf Weiter.

  6. Füllen Sie auf der Seite Staging (2/3 Seiten) des Fensters Konfiguration des Experience Platform Launchs erstellen das folgende Feld aus:

    Überprüfen Sie im Feld Bibliotheks-URI den Speicherort der Staging-Version Ihrer Experience Platform Launch-Bibliothek. Experience Manager füllt dieses Feld automatisch aus.

    Nur zu Veranschaulichungszwecken werden in diesem Schritt Experience Platform Launch-Bibliotheken verwendet, die in Adobe CDN bereitgestellt werden.

    HINWEIS

    Vergewissern Sie sich, dass der automatisch ausgefüllte Bibliotheks-URI (Uniform Resource Identifier) nicht fehlerhaft ist. Korrigieren Sie ihn ggf. so, dass der URI einen protokollrelativen URI darstellt. Das heißt, er beginnt mit einem doppelten Schrägstrich.

    Beispiel: //assets.adobetm.com/launch-xxxx.

    Ihre Staging-Seite wird wahrscheinlich ähnlich wie die folgende angezeigt. Die Optionen Archiv und Bibliothek asynchron laden sind nicht eingestellt:

    image2019-7-15_15-21-8

  7. Klicken Sie in der rechten oberen Ecke auf Weiter.

  8. Korrigieren Sie auf der Seite Produktion (3/3 Seiten) des Fensters Konfiguration des Experience Platform Launchs erstellen bei Bedarf den automatisch ausgefüllten Produktions-URI ähnlich dem auf der vorherigen Seite Staging.

  9. Klicken Sie in der rechten oberen Ecke auf Erstellen.

    Ihre neue Experience Platform Launch-Cloud-Konfiguration wird jetzt erstellt und neben Ihrer Website aufgelistet.

  10. Wählen Sie die neue Experience Platform Launch Cloud-Konfiguration aus (bei Auswahl wird links neben dem Konfigurationstitel ein Häkchen angezeigt). Klicken Sie in der Symbolleiste auf Veröffentlichen.

    image2019-7-15_15-47-6

Derzeit unterstützt der Experience Manager-Autor die Integration von Dynamic Media Viewern mit Experience Platform Launch nicht.

Sie wird jedoch vom Veröffentlichungsknoten des Experience Managers unterstützt. Bei Verwendung der Standardeinstellungen der Experience Platform Launch Cloud-Konfiguration verwendet die Veröffentlichung von Experience Managern die Umgebung der Produktion von Experience Platform Launch. Daher ist es erforderlich, während des Tests die Experience Platform Launch-Bibliotheksaktualisierungen von der Entwicklungsumgebung auf die Produktions-Umgebung zu verschieben.

Es ist möglich, diese Einschränkung zu umgehen. Geben Sie die Entwicklungs- oder Staging-URL der Experience Platform Launch-Bibliothek in der Experience Platform Launch Cloud-Konfiguration für die Veröffentlichung auf dem Experience Manager oben an. Dadurch verwendet der Veröffentlichungsknoten des Experience Managers die Entwicklungs- oder Staging-Version der Experience Platform Launch-Bibliothek.

Weitere Informationen zum Einrichten der Experience Platform Launch Cloud-Konfiguration finden Sie unter Experience Platform Launch und Experience Manager integrieren.

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now