DokumentationJourney OptimizerHandbuch für Journey Optimizer

Code-basierte Erlebnisoberflächen code-based-surface

Last update: Thu Dec 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Experte
  • Admin

Was ist eine Oberfläche? surface-definition

Eine Code-basierte Erlebnisoberfläche ist jede Entität, die für Benutzer- oder Systeminteraktionen entwickelt wurde. Sie ist durch einen URI eindeutig gekennzeichnet. Die Oberfläche wird in der Implementierung der Anwendung angegeben und muss mit der in der Code-basierten Erlebniskanalkonfiguration referenzierten Oberfläche übereinstimmen.

Eine Oberfläche kann als Container auf jeder Hierarchieebene mit einer vorhandenen Entität (Touchpoint) betrachtet werden.

  • Dabei kann es sich um eine Webseite, eine Mobile App, eine Desktop-App, einen bestimmten Inhaltsspeicherort innerhalb einer größeren Entität (z. B. eine div) oder ein nicht standardmäßiges Anzeigemuster (z. B. ein Kiosk oder ein Desktop-Programm-Banner) handeln.

  • Für Nicht-Anzeigen oder abstrakte Anzeigen (z. B. für Dienste bereitgestellte JSON-Blobs) kann sie auch auf bestimmte Teile von Inhalts-Containern erweitert werden.

  • Es kann sich auch um eine Platzhalteroberfläche handeln, die einer Vielzahl von Client-Oberflächendefinitionen entspricht (z. B. kann die Position eines Hero-Bilds auf jeder Seite Ihrer Website in einen Oberflächen-URI wie web://mydomain.com/*#hero_image übersetzt werden).

Oberflächenkennung surface-uri

Ein Oberflächen-URI dient als präzise Kennung, die innerhalb einer Anwendung zu unterschiedlichen Benutzeroberflächen-Elementen oder -Komponenten führt. Grundsätzlich besteht ein Oberflächen-URI aus mehreren Abschnitten:

  1. Typ: Web, Mobile App, ATM, Kiosk, tvcd, Dienst
  2. Eigenschaft: Seiten-URL oder App-Paket
  3. Container: Speicherort auf der Seite/App-Aktivität

In der folgenden Tabelle sind einige beispielhafte Definitionen eines Oberflächen-URI für verschiedene Geräte aufgeführt.

Web und Mobil

Typ
URI
Beschreibung
Web
web://domain.com/path/page.html#element
Stellt ein einzelnes Element innerhalb einer bestimmten Seite einer bestimmten Domain dar, bei dem ein Element wie in den folgenden Beispielen eine Bezeichnung sein kann: hero_banner, top_nav, menu, footer.
iOS-App
mobileapp://com.vendor.bundle/activity#element
Stellt ein bestimmtes Element innerhalb der Aktivität einer nativen App dar, z. B. eine Schaltfläche oder ein anderes Ansichtselement.
Android-App
mobileapp://com.vendor.bundle/#element
Stellt ein bestimmtes Element in einer nativen App dar.

Andere Gerätetypen

Typ
URI
Beschreibung
Desktop
desktop://com.vendor.bundle/#element
Stellt ein bestimmtes Element in einer Anwendung dar, z. B. eine Schaltfläche, ein Menü, ein Hero-Banner usw.
TV-App
tvcd://com.vendor.bundle/#element
Stellt ein bestimmtes Element in einer mit einem Smart TV- oder TV-Gerät verbundenen Geräteanwendung dar – Bundle-ID.
Service
service://servicename/#element
Stellt einen Server-seitigen Prozess oder eine andere manuelle Entität dar.
Kiosk
kiosk://location/screen#element
Beispiel potenzieller zusätzlicher Oberflächentypen, die leicht hinzugefügt werden können.
ATM
atm://location/screen#element
Beispiel potenzieller zusätzlicher Oberflächentypen, die leicht hinzugefügt werden können.

Platzhalteroberfläche

Typ
URI
Beschreibung
Platzhalter-Web
wildcard:web://domain.com/*#element
Platzhalteroberfläche – stellt ein einzelnes Element auf jeder Seite unter einer bestimmten Domain dar.
Platzhalter-Web
wildcard:web://*domain.com/*#element
Platzhalteroberfläche – stellt ein einzelnes Element auf jeder Seite unter allen Domains dar, die auf „domain.com“ enden.

URI-Komposition uri-composition

In Journey Optimizer unterstützt der Code-basierte Erlebniskanal zwei Arten von Kundenimplementierungen:

NOTE
Weitere Informationen zu Implementierungsvoraussetzungen finden Sie in diesem Abschnitt.

Mithilfe Code-basierter Erlebnisse können Sie Inhalte an granularen Speicherorten ändern, die Journey Optimizer anhand von Oberflächen-URIs eindeutig identifiziert werden.

Diese Oberflächen-URIs werden je nach Implementierungsmethode zusammengestellt und verarbeitet:

  • Web-/Mobile-SDK: Die Web-/Mobile-Entwicklerinnen bzw. -entwickler müssen diese granularen Speicherorte als einfache Zeichenfolgen definieren, da das Web-/Mobile-SDK in der Lage ist, den Oberflächen-URI basierend auf der aktuellen URL/App-ID und der Speicherortzeichenfolge automatisch zu erstellen.

  • Edge Network-APIs: Die App-/Seitenentwicklerinnen bzw. -entwickler müssen vollständige Oberflächen-URIs definieren, die den vollständigen Pfad und Speicherort enthalten, an dem der Inhalt verwendet wird, da die vollständigen URIs für diese Art der Implementierung erforderlich sind.

Daher haben Sie beim Erstellen einer Code-basierte Erlebniskanalkonfiguration zwei Möglichkeiten, die Oberfläche entsprechend der ausgewählten Plattform anzugeben:

  • Bei den Plattformen Web, iOS und Android müssen Sie die URL/App-ID und einen Speicherort oder Pfad eingeben, um die Oberfläche zusammenzustellen. Erfahren Sie mehr über die Konfiguration Code-basierter Erlebnisse für die Plattformen Web und Mobile.

  • Wenn die Plattform unter Sonstige fällt, müssen Sie den vollständigen Oberflächen-URI eingeben, wie in den Beispielen oben dargestellt. Erfahren Sie mehr über die Konfiguration Code-basierter Erlebnisse für sonstige Plattformen

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76