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:
- Tipo: web, aplicación móvil, atm, quiosco, tvcd, servicio etc.
- Propiedad: URL de página o paquete de aplicaciones
- 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
web://domain.com/path/page.html#element
mobileapp://com.vendor.bundle/activity#element
mobileapp://com.vendor.bundle/#element
Otros tipos de dispositivos
desktop://com.vendor.bundle/#element
tvcd://com.vendor.bundle/#element
service://servicename/#element
kiosk://location/screen#element
atm://location/screen#element
Superficies comodín
wildcard:web://domain.com/*#element
wildcard:web://*domain.com/*#element
Composición URI uri-composition
En Journey Optimizer, el canal de experiencia basado en código admite dos tipos de implementaciones de clientes:
- Basado en el SDK web de Adobe Experience Platform para sus sitios web o en el SDK móvil de Adobe Experience Platform para sus aplicaciones móviles;
- Lado del servidor o híbrido que usa API del servidor Edge Network de AEP.
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