Integrieren von Dynamic Media Viewers mit Adobe Analytics und Experience Platform Tags integrating-dynamic-media-viewers-with-adobe-analytics-and-adobe-launch

Worum geht es bei der Integration von Dynamic Media Viewers mit Adobe Analytics und Experience Platform Tags? what-is-dynamic-media-viewers-integration-with-adobe-analytics-and-adobe-launch

Mit der Dynamic Media Viewers-Erweiterung für Experience Platform Tags und Dynamic Media Viewers 5.13 können Adobe Analytics- und Experience Platform Tags-Kunden ihrer Experience Platform Tags-Konfiguration für Dynamic Media Viewers spezifische Ereignisse und Daten verwenden.

Diese Integration ermöglicht es Ihnen, die Nutzung von Dynamic Media Viewers auf Ihrer Website mit Adobe Analytics zu verfolgen. Gleichzeitig können Sie die von den Viewern angezeigten Ereignisse und Daten mit jeder anderen Experience Platform Tags-Erweiterung von Adobe oder einem Drittanbieter verwenden.

Weitere Informationen zu Erweiterungen von Adobe oder Drittanbieterern finden Sie unter Adobe-Erweiterungen im Benutzerhandbuch zu Experience Platform Tags.

Dieses Thema richtet sich an: Site-Admins, Entwicklerinnen und Entwickler für die Experience Platform und Anwendende.

Einschränkungen der Integration limitations-of-the-integration

  • Die Experience Platform Tags-Integration für Dynamic Media Viewers funktioniert nicht im Experience Manager-Autorenmodus. Sie können kein Tracking für eine WCM-Seite anzeigen, bevor diese veröffentlicht wurde.
  • Die Experience Platform Tags-Integration für Dynamic Media Viewer wird nicht im Popup-Betriebsmodus unterstützt, bei dem die Viewer-URL über die Schaltfläche „URL“ auf der Seite „Asset-Details“ abgerufen wird.
  • Die Experience Platform Tags-Integration kann nicht gleichzeitig mit der Analytics-Integration älterer Viewer verwendet werden (mit dem 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 Viewers verwenden, nicht unterstützt. Die Speicherdauer muss auf Ohne eingestellt sein.

Anwendungsbeispiele für die Integration use-cases-for-the-integration

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

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

Ein sekundäres Anwendungsbeispiel, das die Integration unterstützt, sind 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 Tags-Bibliothek aus Experience Platform Tags ab und fügen Sie sie manuell zum Web-Seiten-Code hinzu.

Siehe Tracking von Dynamic Media-Viewern mit Einbettungs-Code.

Funktionsweise der Daten- und Ereignisverfolgung in der Integration how-data-and-event-tracking-works-in-the-integration

Die Integration nutzt zwei separate und unabhängige Typen des Tracking von Dynamic Media Viewers: Adobe Analytics und Adobe Analytics for Audio and Video.

Informationen zum Tracking mit Adobe Analytics about-tracking-using-adobe-analytics

Mit Adobe Analytics können Sie Aktionen verfolgen, die vom Endbenutzer bei der Interaktion mit Dynamic Media Viewers auf Ihrer Website ausgeführt werden. Mit Adobe Analytics können Sie außerdem Viewer-spezifische Daten verfolgen. Beispielsweise können Sie Ladeereignisse der Ansicht zusammen mit dem Asset-Namen, vorgenommenen Zoom-Aktionen und Videowiedergabeaktionen verfolgen und aufzeichnen.

In Experience Platform Tags arbeiten die Konzepte Datenelemente und Regeln zusammen, um das Adobe Analytics-Tracking zu erlauben.

Datenelemente in Experience Platform Tags about-data-elements-in-adobe-launch

Ein Datenelement in Experience Platform Tags ist eine benannte Eigenschaft, deren Wert entweder statisch definiert ist oder basierend auf dem Status einer Web-Seite bzw. von Dynamic Media Viewers-Daten dynamisch berechnet wird.

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

Für das Tracking mit Adobe Analytics müssen mehrere zusätzliche Erweiterungen wie unter Installation und Einrichtung von Erweiterungen beschrieben installiert werden. Die Dynamic Media Viewers-Erweiterung bietet die Möglichkeit, ein Datenelement zu definieren, dessen Wert ein Argument des Dynamic Media Viewers-Ereignisses ist. Beispielsweise können Sie auf den Viewer-Typ oder den Asset-Namen, der vom Viewer beim Laden gemeldet wird, auf den Zoom-Faktor, der beim Zoomen durch Endbenutzer gemeldet wird, und vieles mehr verweisen.

Die Dynamic Media Viewers-Erweiterung sorgt dafür, dass die Werte der Datenelemente automatisch auf dem neuesten Stand sind.

Nachdem Sie ein Datenelement definiert haben, können Sie es an anderen Stellen der Experience Platform Tags-Benutzeroberfläche verwenden. Nutzen Sie dazu das Widget zur Auswahl von Datenelementen. Insbesondere wird von der Aktion „Variablen festlegen“ der Adobe Analytics-Erweiterung in der Regel auf Datenelemente verwiesen, die für das Tracking von Dynamic Media Viewers definiert werden (siehe unten).

Siehe Datenelemente.

Info zu Regeln in Experience Platform Tags about-rules-in-adobe-launch

Eine Regel in Experience Platform Tags ist eine agnostische Konfiguration, die drei Bereiche definiert, aus denen eine Regel besteht: Ereignisse, Bedingungen und Aktionen:

  • Ereignisse: (wenn) teilen Experience Platform Tags mit, wann eine Regel ausgelöst werden soll.
  • Bedingungen: (wenn) teilen Experience Platform Tags mit, welche zusätzlichen Einschränkungen beim Auslösen einer Regel zulässig oder nicht zulässig sind.
  • Aktionen: (dann) teilen Experience Platform Tags mit, was zu tun ist, wenn eine Regel ausgelöst wird.

Die im Abschnitt „Ereignisse“, „Bedingungen“ und „Aktionen“ verfügbaren Optionen hängen von den Erweiterungen ab, die in der Experience Platform Tags-Eigenschaft installiert sind. Die Erweiterung Core ist vorinstalliert und in jeder Konfiguration standardmäßig verfügbar. Die Erweiterung bietet mehrere Optionen für Ereignisse, z. B. grundlegende Aktionen auf Browser-Ebene. Zu diesen Aktionen gehören Fokusänderung, Tastendruck und Formularübermittlung. 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 das Tracking mit Adobe Analytics müssen mehrere zusätzliche Erweiterungen wie unter Installation und Einrichtung von Erweiterungen beschrieben installiert werden. Insbesondere gilt:

  • Die Dynamic Media Viewers-Erweiterung erweitert die Liste der unterstützten Ereignisse auf Ereignisse, die für Dynamic Media Viewers 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.

Beim Tracking von Dynamic Media-Viewern ist es möglich, einen der folgenden Typen zu verwenden:

  • Ereignisse aus der Dynamic Media Viewers-Erweiterung, 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 Regeln.

Beispielkonfiguration sample-configuration

Die folgende Beispielkonfiguration in Experience Platform Tags zeigt, wie sich ein Asset-Name beim Laden des Viewers verfolgen lässt.

  1. Definieren Sie auf der Registerkarte Datenelemente ein Datenelement AssetName, das auf den asset-Parameter des LOAD-Ereignisses in der Dynamic Media Viewer-Erweiterung 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 Dynamic Media Viewers-Erweiterung-Erweiterung.

    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 about-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 Viewers 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 Dynamic Media Viewers-Erweiterung using-the-dynamic-media-viewers-extension

Wie unter Anwendungsbeispiele für die Integration erwähnt, ist es möglich, Dynamic Media Viewers sowohl mit der neuen Experience Platform Tags-Integration in Experience Manager Sites als auch mithilfe von Einbettungs-Code zu verfolgen.

Tracking von Dynamic Media-Viewern in Experience Manager Sites tracking-dynamic-media-viewers-in-aem-sites

Zum Tracking von Dynamic Media-Viewern in Experience Manager Sites müssen alle Schritte ausgeführt werden, die im Abschnitt Konfigurieren aller Integrationselemente aufgeführt sind. Insbesondere müssen Sie die IMS-Konfiguration und die Experience Platform Tags 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.

Tracking von Dynamic Media-Viewern mit Einbettungs-Code tracking-dynamic-media-viewers-using-embed-code

Kunden, die kein Experience Manager Sites verwenden oder Dynamic Media Viewers in Web-Seiten außerhalb von Experience Manager Sites einbetten (oder beides), können weiterhin die Experience Platform Tags-Integration nutzen.

Sie müssen die Konfigurationsschritte im Abschnitt Konfigurieren von Adobe Analytics und Konfigurieren von Experience Platform Tags ausführen. Experience Manager-bezogene Konfigurationsschritte sind jedoch nicht erforderlich.

Nach der ordnungsgemäßen Konfiguration können Sie Experience Platform Tags-Unterstützung zu einer Website mit einem Dynamic Media-Viewer hinzufügen.

Weitere Informationen zur Verwendung des Einbettungs-Codes für die Experience Platform Tags-Bibliothek finden Sie unter Hinzufügen von Einbettungs-Code für Experience Platform Tags.

Tracking von Dynamic Media-Viewern mit Einbettungs-Code:

  1. Verwenden Sie eine Website, die bereit zum Einbetten eines Dynamic Media-Viewers ist.
  2. Rufen Sie den Einbettungs-Code für die Experience Platform Tags-Bibliothek ab, indem Sie sich zuerst bei Experience Platform Tags anmelden (siehe Konfigurieren von Experience Platform Tags).
  3. Wählen Sie Eigenschaft und dann die Registerkarte Umgebungen aus.
  4. Wählen Sie die für die Umgebung der Web-Seite relevante Umgebungsebene aus. Klicken Sie dann in der Spalte Installieren auf das Feldsymbol.
  5. Kopieren Sie im Dialogfeld Web-Installationsanweisungen den vollständigen Einbettungs-Code der Experience Platform Tags-Bibliothek zusammen mit den zugehörigen <script/>-Tags.

Referenzhandbuch für die Dynamic Media Viewers-Erweiterung reference-guide-for-the-dynamic-media-viewers-extension

Über die Konfiguration von Dynamic Media Viewers about-the-dynamic-media-viewers-configuration

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

  • Das globale Objekt (_satellite) der Experience Platform Tags-Bibliothek befindet sich auf der Seite.

  • Die Funktion _dmviewers_v001() der Dynamic Media Viewers-Erweiterung ist für _satellite definiert.

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

Darüber hinaus gibt es eine Option, um die Experience Platform Tags-Integration im Viewer explizit zu deaktivieren, indem in der Viewer-Konfiguration der Parameter launch=0 angegeben wird. Der Standardwert dieses Parameters ist 1.

Konfigurieren der Dynamic Media Viewers-Erweiterung configuring-the-dynamic-media-viewers-extension

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

Wenn Sie diese Option aktivieren und die Erweiterung „Adobe Media Analytics for Audio and Video“ installiert sowie konfiguriert haben, werden Videowiedergabemetriken an die Lösung „Adobe Analytics for Audio and Video“ gesendet. Durch Deaktivieren dieser Option wird das Video-Tracking deaktiviert.

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

image2019-7-22_12-4-23

Datenelemente in der Dynamic Media Viewers-Erweiterung about-data-elements-in-the-dynamic-media-viewers-extension

Der einzige Datenelementtyp, den die Dynamic Media Viewers-Erweiterung 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 Dynamic Media Viewers-Erweiterung 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 Viewers-Ereignisses.

image2019-7-22_12-5-46

Eine Liste der unterstützten Ereignisse nach Viewer-Typ finden Sie im Dynamic Media Viewers-Referenzhandbuch. Konsultieren Sie den Abschnitt zum gewünschten Viewer und klicken Sie auf den Unterabschnitt „Support für Tracking mit Adobe Analytics“. Derzeit sind Ereignisargumente im Referenzhandbuch für Dynamic Media Viewers nicht dokumentiert.

Betrachten Sie nun den Lebenszyklus des Datenelements von Dynamic Media Viewers. Der Wert dieses Datenelements wird ausgefüllt, nachdem das entsprechende Dynamic Media-Viewer-Ereignis auf der Seite eintritt. Angenommen, das Datenelement verweist auf das Ereignis LOAD und das zugehörige „asset“-Argument. In solchen Fällen empfängt der Wert dieses Datenelements gültige Daten, nachdem der Viewer das LOAD-Ereignis zum ersten Mal ausgeführt hat. 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 dennoch immer dann aktualisiert, wenn ein Benutzer im Viewer einen Zoom ausführt.

Jeder Dynamic Media-Viewer verfügt auf der Website über eine eindeutige Kennung. Das Datenelement verfolgt den Wert selbst und auch 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 Experience Platform Tags-Erweiterung ausgelöst wurde. In diesem Fall kommt der Wert des Datenelements von dem Viewer, der dieses Datenelement zuletzt aktualisiert hat.

Betrachten Sie das folgende Beispiel:

  • 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 Tastendruckereignis der Experience Platform Tags-Core-Erweiterung als Auslöser.
    • 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 wählt schließlich eine Taste auf der Tastatur aus.

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 die Person in Viewer1 schwenkt. Dieser Aufruf sendet 50 % als Wert des ZoomScale-Datenelements, da das Datenelement weiß, dass die Regel von Viewer1 ausgelöst wird, und den entsprechenden Skalierungswert abruft.
  • 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 im Code der Experience Platform Tags-Bibliothek gespeichert, auch wenn der Viewer selbst auf der Web-Seite beendet wird. Diese Funktion bedeutet, dass das Datenelement den letzten bekannten Wert zurückgibt, wenn es eine Regel gibt, die nicht von einer Dynamic Media Viewers-Erweiterung ausgelöst wird und auf dieses Datenelement verweist. Das gilt auch, wenn der Viewer nicht mehr auf der Website vorhanden ist.

In jedem Fall werden Werte von Datenelementen, die von Dynamic Media Viewers gesteuert werden, nicht im lokalen Speicher oder auf dem Server gespeichert. Sie werden stattdessen nur in der Client-seitigen Experience Platform Tags-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 Viewers-Erweiterung verwenden, unterstützen jedoch als Speicherdauer nur die Option Ohne. 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 Dynamic Media Viewers-Erweiterung about-rules-in-the-dynamic-media-viewers-extension

Im Regeleditor werden mit der Erweiterung neue Konfigurationsoptionen für den Ereigniseditor hinzugefügt. Darüber hinaus gibt es im Editor eine Option zum manuellen Verweisen auf Ereignisparameter im Aktionseditor als schnelle Alternative zur Nutzung vorkonfigurierter Datenelemente.

Über den Ereigniseditor about-the-events-editor

Im Ereigniseditor wird mit der Dynamic Media Viewers-Erweiterung ein Ereignistyp namens Viewer-Ereignis hinzugefügt.

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 about-the-actions-editor

Mit der Dynamic Media Viewers-Erweiterung können Sie Ereignisparameter von Dynamic Media Viewers 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 Auswahlsymbol Datenelement (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 in 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 um den Namen Prozentzeichen (%) setzen. Beispiel:

%event.detail.dm.LOAD.asset%

image2019-7-12_19-2-35

Es gibt einen wichtigen Unterschied zwischen der Verwendung von Datenelementen und dem direkten Verweis auf ein Ereignisargument. Bei Datenelementen spielt es keine Rolle, welches Ereignis die Aktion „Variablen festlegen“ auslöst. Das Ereignis, das die Regel auslöst, muss nicht mit dem dynamischen Viewer verknüpft sein. Wählen Sie beispielsweise die Web-Seite aus der Core-Erweiterung aus. 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 configuring-all-the-integration-pieces

VORAUSSETZUNGEN

Adobe empfiehlt, dass Sie die gesamte Dokumentation vor diesem Abschnitt gründlich durchlesen, 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. Zwar kann die Dynamic Media Viewer-Erweiterung in Experience Platform Tags auch für andere Zwecke verwendet werden, doch werden solche Szenarien in dieser Dokumentation nicht behandelt.

Für die Konfiguration Ihrer Integration verwenden Sie die folgenden Adobe-Produkte:

  • Adobe Analytics – zum Konfigurieren von Tracking-Variablen und -Berichten.
  • Experience Platform Tags – zum Definieren einer Eigenschaft, einer oder mehrerer Regeln und eines oder mehrerer Datenelemente, um das Viewer-Tracking zu ermöglichen.

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

  • Adobe Developer Console: Die Integration wird für Experience Platform Tags erstellt.
  • Experience Manager-Autorenknoten – IMS-Konfiguration und Experience Platform Tags-Cloud-Konfiguration.

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

Konfigurieren von Adobe Analytics für die Integration configuring-adobe-analytics-for-the-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 Matrix 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.

Auswahl einer Report Suite selecting-a-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.

    Im folgenden Screenshot hat ein Benutzer eine Report Suite mit dem Namen DynamicMediaViewersExtensionDoc erstellt und aus der Dropdown-Liste ausgewählt. Der Name der Report Suite ist nur ein Beispiel. Sie entscheiden selbst, welchen Report Suite-Namen Sie auswählen.

    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 setting-up-adobe-analytics-variables

  1. Bestimmen Sie eine oder mehrere Adobe Analytics-Variablen, die Sie zum Tracking des Verhaltens von Dynamic Media Viewers auf der Website 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] und Konversion [eVar]) hängt von den spezifischen Anforderungen Ihrer Analytics-Implementierung ab.

    Siehe Übersicht über props und eVars.

    Für die Zwecke dieser Dokumentation wird nur eine Variable „Custom Traffic (props)“ verwendet, da diese in einem Analytics-Bericht innerhalb weniger Minuten nach dem Ausführen einer Aktion auf einer Web-Seite verfügbar ist.

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

  2. Wählen Sie auf der Seite Report Suite Manager den richtigen Bericht aus und navigieren Sie dann in der Symbolleiste zu Einstellungen bearbeiten > Traffic > Traffic-Variablen.

  3. Wählen Sie 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 setting-up-a-report

  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 ausreichend zu wissen, dass Custom Traffic-Berichte automatisch in Adobe Analytics verfügbar werden, nachdem Sie unter Einrichten von Adobe Analytics-Variablen Custom 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 Tags für die Integration configuring-adobe-launch-for-the-integration

Nachdem Sie Experience Platform Tags konfiguriert haben, werden für die Integration folgende Schritte vorgenommen:

  • 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 Experience Platform Tags für die Integration:

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

    Alternativ können Sie Experience Platform Tags direkt öffnen.

    image2019-7-8_15-38-44

Erstellen einer Eigenschaft in Experience Platform Tags creating-a-property-in-adobe-launch

Bei einer Eigenschaft in Experience Platform Tags handelt es sich um eine benannte Konfiguration, die alle Ihre 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 Tags-Eigenschaft.

  1. Wählen Sie unter Experience Platform Tags Neue Eigenschaft aus.

  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. Wählen Sie Speichern aus.

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

Installieren und Einrichten von Erweiterungen installing-and-setup-of-extensions

Alle verfügbaren Erweiterungen in Experience Platform Tags werden unter Erweiterungen > Katalog aufgeführt.

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-Dienst -Erweiterung.

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

Siehe Adobe Experience Cloud Identity Service-Erweiterung.

  • (Erforderlich) Adobe Analytics-Erweiterung

Um diese Erweiterung zu konfigurieren, benötigen Sie die Report Suite-ID aus Adobe Analytics, die Sie unter Admin > Report Suite unter der Spaltenüberschrift Report Suite-ID finden können.

(Die Report Suite-ID der Report Suite DynamicMediaViewersExtensionDoc wird in den folgenden Screenshots nur zu Demonstrationszwecken 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.

Wählen Sie Speichern aus.

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

Danach ist die Erweiterung Dynamic Media Viewer nur verfügbar, wenn die Experience Platform Tags-Eigenschaft für die Entwicklung erstellt wird.

Siehe Erstellen einer Eigenschaft in Experience Platform Tags.

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

image2019-7-22_12-7-36

Einrichten von Datenelementen und Regeln setting-up-data-elements-and-rules

Erstellen Sie in Experience Platform Tags Datenelemente und Regeln, die zum Tracking Dynamic Media-Viewern erforderlich sind.

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

Unter Beispielkonfiguration finden Sie eine Beispielkonfiguration in Experience Platform Tags, 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“.

Bibliothek veröffentlichen publishing-a-library

Um Änderungen an der Experience Platform Tags-Konfiguration vorzunehmen (einschließlich eingerichteter Eigenschaften, Erweiterungen, Regeln und Datenelemente), müssen Sie diese Änderungen veröffentlichen. Die Veröffentlichung in Experience Platform Tags erfolgt über die Registerkarte „Publishing“ unter der Eigenschaftskonfiguration.

Experience Platform Tags kann über mehrere Entwicklungsumgebungen, eine Staging-Umgebung und eine Produktionsumgebung verfügen. Standardmäßig verweist die Experience Platform Tags Cloud-Konfiguration in Experience Manager den Experience Manager-Autorenknoten auf die Staging-Umgebung von Experience Platform Tags. Der Experience Manager-Veröffentlichungsknoten verweist auf die Produktionsumgebung von Experience Platform Tags. Deshalb muss mit den Standardeinstellungen für Experience Manager die Experience Platform Tags-Bibliothek in der Staging-Umgebung veröffentlicht werden. Auf diese Weise kann die Bibliothek im Experience Manager-Autorenknoten verwendet werden. Sie können sie dann in der Produktionsumgebung veröffentlichen, damit sie im Veröffentlichungsknoten von Experience Manager verwendet werden kann.

Weitere Informationen zu Experience Platform Tags-Umgebungen finden Sie unter Umgebungen.

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.
  • Verschieben der Bibliothek durch die verschiedenen Umgebungsebenen (von „Entwicklung“ über „Staging“ zu „Produktion“)

Hinzufügen und Erstellen einer neuen Bibliothek adding-and-building-a-new-library

  1. Wenn Sie die Registerkarte „Publishing“ in Experience Platform Tags zum ersten Mal öffnen, ist die Bibliotheksliste 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 ist die Bibliothek erstellt und einsatzbereit.

    image2019-7-15_15-3-34

    note note
    NOTE
    Wenn Sie das nächste Mal Änderungen an Ihrer Experience Platform Tags-Konfiguration vornehmen, wechseln Sie zur Registerkarte Publishing unter der Konfiguration Eigenschaft und klicken Sie auf Ihre zuvor erstellte Bibliothek.
    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.

Verschieben einer Bibliothek durch Umgebungsebenen moving-a-library-up-through-environment-levels

  1. Nachdem Sie eine neue Bibliothek hinzugefügt haben, befindet sich diese in der Entwicklungsumgebung. 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, wählen Sie im Dropdown-Menü der Bibliothek Für Staging erstellen aus.

    image2019-7-15_15-54-37

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

    Wählen Sie zunächst im Dropdown-Menü Veröffentlichung genehmigen aus.

    image2019-7-15_16-7-39

  4. Wählen Sie im Dropdown-Menü Für Produktion erstellen und veröffentlichen aus.

    image2019-7-15_16-8-9

    Weitere Informationen zum Veröffentlichungsverfahren in Experience Platform Tags finden Sie unter Veröffentlichung.

Konfigurieren von Adobe Experience Manager für die Integration configuring-adobe-experience-manager-for-the-integration

Voraussetzungen:

  • Experience Manager führt sowohl die Autoren- als auch die Veröffentlichungsinstanz aus.
  • Der Experience Manager-Autorenknoten wird im Scene7-Ausführungsmodus von Dynamic Media (dynamicmedia_s7) eingerichtet.
  • WCM-Komponenten für Dynamic Media sind in Experience Manager Sites aktiviert.

Die Experience Manager-Konfiguration besteht aus den folgenden zwei Hauptschritten:

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

Experience Manager IMS konfigurieren configuring-aem-ims

  1. Klicken Sie im Experience Manager-Autorenknoten auf das Werkzeugsymbol (Hammer) und navigieren Sie dann zu Sicherheit > Adobe IMS-Konfigurationen.

    2019-07-25_11-52-58

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

  3. Wählen Sie auf der Seite Technische Kontokonfiguration für Adobe IMS in der Dropdown-Liste Cloud-Lösung die Option Experience Platform Tags aus.

  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, wird der öffentliche Schlüssel des neuen Zertifikats zum technischen Konto in Adobe Developer Console hinzugefügt!

    Um das Dialogfeld „Informationen“ zu schließen, klicken Sie auf OK.

    2019-07-25_12-09-24

  5. Um eine Datei mit öffentlichem Schlüssel (*.crt) in Ihr lokales System herunterzuladen, wählen Sie Öffentlichen Schlüssel herunterladen aus.

    note note
    NOTE
    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 werden in den späteren Schritten noch zu dieser Seite zurückkehren.

    2019-07-25_12-52-24

  6. Navigieren Sie in einer neuen Browser-Registerkarte zur Adobe Developer Console.

  7. Wählen Sie auf der Seite Adobe Developer Console-Integrationen rechts oben Neue Integration aus.

  8. Vergewissern Sie sich, dass im Dialogfeld Neue Integration erstellen das Optionsfeld 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 das Optionsfeld Experience Platform Tagd-API. Klicken Sie unten rechts auf der Seite auf Fortsetzen.

    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 Zertifikate mit öffentlichem Schlüssel Ihre Datei mit öffentlichem Schlüssel (*.cert) hoch, die Sie in den Schritten zuvor heruntergeladen haben.

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

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

    2019-07-25_13-49-18

  11. Wählen Sie Integration erstellen aus.

  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:

    note note
    NOTE
    Lassen Sie die Seite mit Integrationsdetails geöffnet. In wenigen Augenblicken benötigen Sie verschiedene Informationen aus den Registerkarten Übersicht und JWT.

    2019-07-25_14-35-30

    Seite mit 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 Experience Manager-Autorenknoten zurück und navigieren Sie zu Tools > Sicherheit > Adobe IMS-Konfigurationen. Wählen Sie Erstellen. Wählen Sie in der Dropdown-Liste Cloud-Lösung die Option Experience Platform Tags. 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 von der Seite „Integrationsdetails“ (vorheriger Schritt) 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.

    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 Server-Name ist nur ein Beispiel.)

    2019-07-25_15-01-53

    Seite mit Integrationsdetails – Registerkarte „JWT“

  17. API-Schlüssel: Kehren Sie zur Seite mit Integrationsdetails zurück. Klicken Sie auf die Registerkarte Überblick 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 mit Integrationsdetails.

  18. Client-Geheimnis: Kehren Sie zur Seite mit Integrationsdetails zurück. Klicken Sie auf der Registerkarte Überblick 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.

  19. 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 Kontoseite mit allen ausgefüllten Feldern sieht in etwa wie folgt aus:

    2019-07-25_22-08-30

  20. Klicken Sie oben rechts auf der Seite Konto auf Erstellen.

    Wenn Experience Manager IMS konfiguriert ist, befindet sich jetzt unter Adobe IMS-Konfigurationen ein neues IMS-Konto.

    image2019-7-15_14-17-54

Konfigurieren von Experience Platform Tags Cloud für die Integration configuring-adobe-launch-cloud-for-the-integration

  1. Klicken Sie im Experience Manager-Autorenknoten in der oberen linken Ecke auf das Werkzeugsymbol (Hammer), navigieren Sie dann zu Cloud Services > Experience Platform Tags-Konfigurationen.

    26.07.2019_12-10-38

  2. Wählen Sie auf der Seite Experience Platform Tags-Konfigurationen im linken Bereich eine Experience Manager-Website aus, auf die Sie Ihre Experience Platform Tags-Konfiguration anwenden möchten.

    Die Website 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 Experience Platform Tags-Konfiguration erstellen die folgenden Felder aus:

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

    • Zugewiesene Adobe IMS-Konfiguration – Wählen Sie die IMS-Konfiguration aus, die Sie zuvor unter Konfigurieren von Experience Manager IMS 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 zuvor erstellte Experience Platform Tags-Eigenschaft aus. 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 Experience Platform Tags-Konfiguration erstellen die folgenden Felder aus:

    Überprüfen Sie im Feld URI der Bibliothek (Uniform Resource Identifier) den Speicherort der Staging-Version Ihrer Experience Platform Tags-Bibliothek. Experience Manager füllt dieses Feld automatisch aus.

    Dieser Schritt verwendet nur zu Beispielzwecken Experience Platform-Tags-Bibliotheken, die auf Adobe CDN bereitgestellt werden.

    note note
    NOTE
    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 sieht in etwa wie folgt aus: Die Optionen Archiv und Bibliothek asynchron laden sind hier nicht festgelegt:

    image2019-7-15_15-21-8

  7. Klicken Sie rechts oben auf Weiter.

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

  9. Klicken Sie rechts oben auf Erstellen.

    Ihre neue Experience Platform Tags Cloud-Konfiguration wird jetzt erstellt und neben Ihrer Website aufgeführt, ähnlich wie im folgenden Beispiel:

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

    image2019-7-15_15-47-6

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

Sie wird jedoch im Experience Manager-Veröffentlichungsknoten unterstützt. Bei Verwendung der Standardeinstellungen der Experience Platform Tags Cloud-Konfiguration wird für den Experience Manager-Veröffentlichungsknoten die Produktionsumgebung von Experience Platform Tags verwendet. Daher müssen Experience Platform Tags-Bibliotheksaktualisierungen jedes Mal beim Test von der Entwicklungsumgebung in die Produktionsumgebung verschoben werden.

Es gibt eine Möglichkeit, diese Einschränkung zu umgehen. Geben Sie in der Experience Platform Tags Cloud-Konfiguration für den Experience Manager-Veröffentlichungsknoten oben die Entwicklungs- oder Staging-URL der Platform Tags-Bibliothek an. Dadurch verwendet der Experience Manager-Veröffentlichungsknoten die Entwicklungs- oder Staging-Version der Experience Platform Tags-Bibliothek.

Weitere Informationen zum Einrichten der Experience Platform Tags Cloud-Konfiguration finden Sie unter Integrieren von Experience Manager mit Experience Platform Tags über Adobe Developer Console.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2