Superficies de la experiencia basada en código

Última actualización: 5 de diciembre de 2024

Creado para:

  • Experimentado
  • Administrador

¿Qué es una superficie?

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

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

TipoURIDescripción
Webweb://domain.com/path/page.html#elementRepresenta 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 iOSmobileapp://com.vendor.bundle/activity#elementRepresenta un elemento específico dentro de una actividad, como un botón u otro elemento de vista.
Aplicación de Androidmobileapp://com.vendor.bundle/#elementRepresenta un elemento específico dentro de una aplicación nativa.

Otros tipos de dispositivos

TipoURIDescripción
Escritoriodesktop://com.vendor.bundle/#elementRepresenta un elemento específico dentro de una aplicación, como un botón, un menú, un banner principal, etc.
Aplicación de TVtvcd://com.vendor.bundle/#elementRepresenta un elemento específico en una TV inteligente o TV conectado a una aplicación de dispositivo: ID de paquete.
Servicioservice://servicename/#elementRepresenta un proceso del lado del servidor u otra entidad manual.
Quioscokiosk://location/screen#elementEjemplo de posibles tipos de superficie adicionales que se pueden añadir fácilmente.
ATMatm://location/screen#elementEjemplo de posibles tipos de superficie adicionales que se pueden añadir fácilmente.

Superficies comodín

TipoURIDescripción
Web comodínwildcard:web://domain.com/*#elementSuperficie comodín: representa un elemento individual en cada una de las páginas bajo un dominio específico.
Web comodínwildcard:web://*domain.com/*#elementSuperficie 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

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

Página anteriorProtecciones y requisitos previos
Página siguienteEjemplos de métodos de implementación

Journey Optimizer