DokumentationJourney OptimizerHandbuch für Journey Optimizer

Codebasierte Erlebnisoberflächen code-based-surface

Last update: Fri Nov 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Experte
  • Admin

Was ist eine Oberfläche? surface-definition

Ein code-basiertes Erlebnis Oberfläche ist eine Entität, die für Benutzer- oder Systeminteraktionen entwickelt wurde und durch einen URI eindeutig identifiziert wird. Die Oberfläche wird in der Implementierung der Anwendung angegeben und muss mit der in Ihrer code-basierten Konfiguration des Erlebniskanals 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).

Surface identifier surface-uri

Ein Oberflächen-URI dient als präziser Bezeichner, der 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 den Implementierungsvoraussetzungen finden Sie in diesem Abschnitt.

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

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

  • Web/Mobile SDK: Ihr Web-/Mobilentwickler muss 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 Standortzeichenfolge automatisch zu erstellen.

  • Edge Network-APIs: Der App-/Seitenentwickler muss 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-basierten 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 Plattformen web und mobile .

  • Wenn die Plattform Sonstige ist, müssen Sie den vollständigen Oberflächen-URI eingeben, wie in den Beispielen über beschrieben. Erfahren Sie mehr über die Konfiguration code-basierter Erlebnisse für andere Plattformen

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