Configuración de la experiencia basada en código code-based-configuration

Antes de crear su experiencia, debe crear una configuración de experiencia basada en código en la que defina dónde se enviará y consumirá el contenido dentro de su aplicación.

Una configuración de experiencia basada en código debe hacer referencia a la superficie, que es básicamente la ubicación donde desea procesar los cambios. Según la plataforma seleccionada, se debe introducir una ubicación/ruta o el URI de superficie completo. Más información

Cree una configuración de experiencia basada en código create-code-based-configuration

Para crear una configuración de canal de experiencia basada en código, siga estos pasos:

  1. Acceda al menú Canales > Configuración general > Configuraciones de canal y luego haga clic en Crear configuración de canal.

  2. Introduzca un nombre y una descripción (opcional) para la configuración.

    note note
    NOTE
    Los nombres deben comenzar por una letra (A-Z). Solo puede contener caracteres alfanuméricos. También puede utilizar caracteres de guion bajo _, punto. y guión -.
  3. Para asignar etiquetas de uso de datos principales o personalizadas a la configuración, puedes seleccionar Administrar acceso. Más información sobre el Control de acceso de nivel de objeto (OLAC)

  4. Seleccione Acciones de marketing para asociar directivas de consentimiento a los mensajes que usan esta configuración. Todas las políticas de consentimiento asociadas con la acción de marketing se aprovechan para respetar las preferencias de los clientes. Más información

  5. Seleccione el canal Experiencia basada en código.

  6. Seleccione la plataforma para la que se aplicará la experiencia basada en código:

    note note
    NOTE
    Puede seleccionar varias plataformas. Al elegir varias plataformas, el contenido se envía a todas las páginas o aplicaciones seleccionadas.
  7. Elija el formato que espera la aplicación para esta ubicación en particular. Se utilizará al crear la experiencia basada en código en campañas y recorridos.

  8. Haga clic en Enviar para guardar los cambios.

Ahora puede seleccionar esta configuración al crear una experiencia basada en código en sus campañas y recorridos.

NOTE
El equipo de implementación de la aplicación es responsable de realizar llamadas explícitas de API o SDK para recuperar contenido para las superficies definidas en la configuración de experiencia basada en código seleccionada. Obtenga más información sobre las diferentes implementaciones de clientes en esta sección.

Plataformas web web

Para definir los ajustes de configuración de la experiencia basada en código para las plataformas web, siga los pasos a continuación.

  1. Seleccione una de las siguientes opciones:

    • Página individual: si desea aplicar los cambios a una sola página exclusivamente, escriba una URL de página.

    • Regla de coincidencia de páginas: para segmentar varias direcciones URL que coincidan con la misma regla, genere una o más reglas. Más información

      Por ejemplo, si desea editar elementos que se muestran en todas las páginas de productos femeninas del sitio web de Luma, seleccione Dominio > Comienza con > luma y Página > Contiene > women.

  2. Lo siguiente se aplica a la URL de vista previa:

    • Si se introduce una dirección URL de una sola página, se utilizará para la vista previa; no es necesario introducir otra dirección URL.

    • Si se selecciona páginas que coinciden con la regla, debe introducir una URL de creación y vista previa predeterminada que se utilizará para obtener una vista previa de la experiencia en el explorador. Más información

  3. El campo Ubicación en la página especifica el destino exacto dentro de la página a la que desea que accedan los usuarios. Puede ser una sección en particular de una página dentro de la estructura de navegación del sitio, como "banner a pantalla completa" o "carril del producto".

Plataformas móviles (iOS y Android) mobile

Para definir los ajustes de configuración de la experiencia basada en código para las plataformas móviles, siga los pasos a continuación.

  1. Escriba su ID de aplicación. Esto permite una identificación y configuración precisas dentro del entorno operativo de la aplicación y garantiza una integración y funcionalidad sin problemas.

  2. Proporcione la ubicación o ruta de acceso dentro de la aplicación. Este campo especifica el destino exacto dentro de la aplicación a la que desea que accedan los usuarios. Puede ser una sección en particular o una página en la estructura de navegación de la aplicación, como un banner a pantalla completa o un carril del producto.

  3. Rellene el campo URL de vista previa para habilitar las vistas previas en el dispositivo. Esta dirección URL informa al servicio de vista previa de la dirección URL específica que se debe utilizar al activar la vista previa en el dispositivo. Más información

    La URL de vista previa es un vínculo profundo configurado por el desarrollador de la aplicación dentro de la aplicación. Esto garantiza que cualquier dirección URL que coincida con el esquema de vínculos profundos se abra en la aplicación en lugar de en un explorador web móvil. Póngase en contacto con el desarrollador de su aplicación para obtener el esquema de vínculos profundos configurado para su aplicación.

Los siguientes recursos pueden ayudarle a configurar vínculos profundos para la implementación de su aplicación
NOTE
Si encuentra problemas al obtener una vista previa de la experiencia, consulte esta documentación.

Otras plataformas other

Para definir los ajustes de configuración de experiencias basadas en código para otras plataformas (como consolas de vídeo, dispositivos conectados a TV, televisores inteligentes, quioscos, cajeros automáticos, asistentes de voz, dispositivos IoT, etc.), siga los pasos a continuación.

  1. Seleccione Other como plataforma si la implementación no es para web, iOS o Android, o si necesita direccionar URI específicos.

  2. Escriba el URI de superficie. Un URI de superficie es un identificador único correspondiente a la entidad en la que desea ofrecer su experiencia. Más información

    note caution
    CAUTION
    Asegúrese de introducir un URI de superficie que coincida con el utilizado en su propia implementación. De lo contrario, no se podrán entregar los cambios.
  3. Agregue otro URI de superficie si es necesario. Se pueden añadir hasta 10 URI.

    note note
    NOTE
    Al añadir varios URI, el contenido se envía a todos los componentes enumerados.

¿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, que se identifica de forma exclusiva mediante un URI. La superficie se especifica en la implementación de la aplicación y debe coincidir con la superficie a la que se hace referencia en la configuración del canal de experiencia basado 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).

Al crear una configuración de canal de experiencia basada en código, tiene dos formas de especificar la superficie según la plataforma seleccionada:

  • Para las plataformas Web, iOS y Android, debe especificar una ubicación o ruta para componer la superficie.

  • Si la plataforma es Other, debes ingresar el URI de superficie completo, como en los ejemplos siguientes.

Un URI de superficie sirve como identificador preciso que dirige a elementos o componentes distintos 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".
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76