Superficies de experiencia basadas en código code-based-surface

¿Qué es una superficie? surface-definition

Una experiencia basada en código surface es cualquier entidad diseñada para la interacción de usuarios o sistemas, identificada de forma exclusiva por un URI. La superficie está especificada en la implementación de aplicación y debe coincidir con la superficie a la que se hace referencia en la configuración de canal de experiencia basada en código.

Una superficie puede verse como un contenedor en cualquier nivel de jerarquía con una entidad (punto de contacto) que existe.

  • Puede ser una página web, una aplicación móvil, una aplicación de escritorio o una ubicación de contenido específica dentro de una entidad más grande (por ejemplo, una div) o un patrón de visualización no estándar (por ejemplo, un quiosco o un titular de aplicación de escritorio).

  • También se puede ampliar a fragmentos específicos de contenedores de contenido para fines de no visualización o de visualización abstracta (por ejemplo, blobs JSON entregados a servicios).

  • También puede ser una superficie comodín que coincida con una variedad de definiciones de superficie de cliente (por ejemplo, una ubicación de imagen principal en cada página del sitio web podría traducirse en un URI de superficie como: web://mydomain.com/*#hero_image).

Identificador de superficie surface-uri

Un URI de superficie sirve como identificador preciso que dirige a distintos elementos o componentes de la interfaz de usuario dentro de una aplicación. Básicamente, un URI de superficie está compuesto por varias secciones:

  1. Tipo: web, aplicación móvil, atm, quiosco, tvcd, servicio etc.
  2. Propiedad: URL de página o paquete de aplicaciones
  3. Contenedor: ubicación en la actividad de la página/aplicación

En la tabla siguiente se muestran algunos ejemplos de definiciones de URI de superficie para varios dispositivos.

Web y móvil

Tipo
URI
Descripción
Web
web://domain.com/path/page.html#element
Representa un elemento individual dentro de una página específica de un dominio específico, donde un elemento puede ser una etiqueta como en los ejemplos siguientes: hero_banner, top_nav, menu, footer, etc.
Aplicación iOS
mobileapp://com.vendor.bundle/activity#element
Representa un elemento específico dentro de una actividad, como un botón u otro elemento de vista.
Aplicación de Android
mobileapp://com.vendor.bundle/#element
Representa un elemento específico dentro de una aplicación nativa.

Otros tipos de dispositivos

Tipo
URI
Descripción
Escritorio
desktop://com.vendor.bundle/#element
Representa un elemento específico dentro de una aplicación, como un botón, un menú, un banner principal, etc.
Aplicación de TV
tvcd://com.vendor.bundle/#element
Representa un elemento específico en una TV inteligente o TV conectado a una aplicación de dispositivo: ID de paquete.
Servicio
service://servicename/#element
Representa un proceso del lado del servidor u otra entidad manual.
Quiosco
kiosk://location/screen#element
Ejemplo de posibles tipos de superficie adicionales que se pueden añadir fácilmente.
ATM
atm://location/screen#element
Ejemplo de posibles tipos de superficie adicionales que se pueden añadir fácilmente.

Superficies comodín

Tipo
URI
Descripción
Web comodín
wildcard:web://domain.com/*#element
Superficie comodín: representa un elemento individual en cada una de las páginas bajo un dominio específico.
Web comodín
wildcard:web://*domain.com/*#element
Superficie comodín: representa un elemento individual en cada una de las páginas bajo todos los dominios que acaba con "domain.com".

Composición URI uri-composition

En Journey Optimizer, el canal de experiencia basado en código admite dos tipos de implementaciones de clientes:

NOTE
Obtenga más información sobre los requisitos previos de implementación en esta sección.

Con experiencias basadas en código, puede modificar el contenido en ubicaciones granulares que han sido identificadas de forma exclusiva por Journey Optimizer mediante URI de superficie.

Estos URI de superficie se componen y gestionan según el método de implementación:

  • SDK web/móvil: El desarrollador web/móvil debe definir estas ubicaciones granulares como cadenas simples, ya que el SDK web/móvil es capaz de componer automáticamente el URI de superficie en función de la URL/ID de aplicación actuales y la cadena de ubicación.

  • API de Edge Network: el desarrollador de aplicaciones/páginas debe definir URI de superficie completos que incluyan la ruta de acceso completa y la ubicación donde se consumirá el contenido, ya que los URI completos son necesarios en este tipo de implementación.

Por este motivo, al crear una configuración de canal de experiencia basada en código, tiene dos maneras de especificar la superficie según la plataforma seleccionada:

  • Para las plataformas Web, iOS y Android, debe introducir la URL/ID de aplicación y una ubicación o ruta para componer la superficie. Más información sobre cómo configurar experiencias basadas en código para las plataformas web y móvil

  • Si la plataforma es Other, debes ingresar el URI de superficie completo, como en los ejemplos anteriores. Más información sobre cómo configurar experiencias basadas en código para otras plataformas

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