Introducción para desarrolladores get-started-developers

En esta página: implemente los SDK, el streaming de eventos, los puntos finales de acciones personalizadas y las API que conectan sus aplicaciones a Adobe Journey Optimizer para que sus recorridos puedan ejecutarse en los datos activos.

Como desarrollador, es responsable de implementar e integrar Adobe Journey Optimizer en sus aplicaciones y sistemas. Puede comenzar a trabajar con Adobe Journey Optimizer una vez que la variable Administrador del sistema e Ingeniero de datos le conceda acceso y prepare su entorno.

Su función en el ecosistema de Journey Optimizer

Mientras que otros integrantes del equipo configuran Journey Optimizer a través de la interfaz de usuario, usted se centrará en:

Su ingeniero de datos se encargará de los esquemas de datos, las configuraciones de eventos y las fuentes de datos. Su administrador configurará permisos y configuraciones de canal. Los expertos en marketing diseñarán los recorridos y el contenido que usan sus implementaciones.

Esta guía describe los pasos esenciales de la implementación técnica para empezar a utilizar Journey Optimizer. Tanto si está creando aplicaciones móviles como experiencias web o integraciones de API, siga las secciones a continuación para configurar su implementación.

Requisitos previos prerequisites

Antes de iniciar la implementación, asegúrese de lo siguiente:

Comprender los fundamentos técnicos technical-foundation

Antes de sumergirse en la implementación, familiarícese con los conceptos técnicos básicos:

Configurar las integraciones de la aplicación móvil mobile-integration

Configurar el SDK móvil de Adobe Experience Platform

El SDK móvil es una colección de bibliotecas que puede incrustar directamente en la aplicación de iOS o Android. Actúa como la capa de comunicación entre la aplicación y Adobe Experience Platform: identifica a los usuarios, recopila eventos de comportamiento y envía instrucciones desde Journey Optimizer, incluidas notificaciones push, mensajes en la aplicación y contenido personalizado. Sin ella, Journey Optimizer no tiene visibilidad de lo que están haciendo los usuarios de la aplicación ni forma de llegar a ellos.

Los pasos detallados para configurar las notificaciones push están disponibles en esta página.

Implementación de experiencias basadas en código (SDK móvil)

Las experiencias basadas en código le permiten ofrecer contenido personalizado a cualquier superficie de su aplicación móvil nativa, desde pantallas de incorporación y páginas de detalles de productos hasta banners e indicadores de funcionalidades en la aplicación, sin necesidad de una nueva versión de la aplicación. Utilice el SDK móvil para recuperar y procesar contenido personalizado en tiempo de ejecución, lo que permite a su equipo un control total de la ubicación y la presentación:

Implementación de experiencias web web-implementation

Configuración del SDK web de Adobe Experience Platform

El SDK web (alloy.js) es una sola biblioteca de JavaScript que reemplaza el mosaico de etiquetas Adobe independientes que el sitio podría necesitar de otro modo. Recopila datos de comportamiento, los transmite a Adobe Experience Platform a través de una secuencia de datos que usted configura y recibe instrucciones de personalización de nuevo, todo en un solo recorrido de red. Una vez implementado, Journey Optimizer puede identificar visitantes, activar recorridos de sus acciones y ofrecer contenido personalizado a sus páginas inmediatamente.

Implementar experiencias basadas en código (Web SDK)

A diferencia de los canales visuales, donde los expertos en marketing controlan el diseño por completo, las experiencias basadas en código le proporcionan la propiedad total de cómo se procesa el contenido personalizado en la página. Journey Optimizer devuelve una carga útil JSON con los datos de personalización; su código decide dónde y cómo mostrarla. Este modelo funciona para cualquier superficie web (banners principales, carruseles de recomendaciones, clasificaciones de resultados de búsqueda y variantes de prueba A/B) sin necesidad de un editor visual o un flujo de trabajo de publicación de páginas.

Explore implementaciones de muestra en GitHub para ver las experiencias basadas en código en acción.

Más información sobre cómo empezar a usar las experiencias basadas en código.

Implementación de streaming de eventos event-streaming

Envío de eventos para la activación de recorridos

Recorridos que se ejecutan en eventos: un usuario inicia sesión, añade un elemento al carro de compras, completa una compra y abandona un formulario. Su trabajo consiste en emitir esos eventos desde su aplicación en el momento justo. Cada evento es una carga útil JSON estructurada por XDM enviada a la API de ingesta de streaming de Experience Platform; Journey Optimizer la recoge en milisegundos y enruta el perfil a cualquier recorrido coincidente. El esquema de eventos y la estructura de carga útil están definidos por el ingeniero de datos; coordínese con él antes de empezar a programar.

Implementación de ejemplo para enviar un evento a través de API:

POST https://{DATACOLLECTION_ENDPOINT}/collection/{DATASTREAM_ID}
Content-Type: application/json

{
  "header": {
    "datasetId": "{DATASET_ID}",
    "imsOrgId": "{ORG_ID}",
    "source": {
      "name": "Web SDK"
    }
  },
  "body": {
    "xdmMeta": {
      "schemaRef": {
        "id": "{SCHEMA_ID}"
      }
    },
    "xdmEntity": {
      "_id": "unique-event-id",
      "eventType": "purchase",
      "timestamp": "2024-01-01T12:00:00Z",
      // ... your event data
    }
  }
}

Más información acerca de cómo trabajar con eventos de recorrido.

Desarrollar puntos finales de acción personalizados custom-actions

Cuando un recorrido alcanza un paso de acción personalizada, Journey Optimizer realiza una llamada HTTP saliente a una URL que proporcione: su backend, un programa de administración de la relación con los clientes, una plataforma de lealtad, cualquier punto final REST. Su trabajo consiste en crear y exponer ese punto final: definir el contrato de solicitud (forma de carga útil, método de autenticación, formato de respuesta), implementar la lógica empresarial subyacente y asegurarse de que puede gestionar el volumen de llamadas que generará Journey Optimizer. A continuación, el administrador registra el punto final en Journey Optimizer para que los especialistas en marketing puedan utilizarlo como un paso en sus recorridos.

Ejemplo de caso de uso: escritura de eventos de recorrido en Experience Platform mediante acciones personalizadas.

Trabajo con las API de Journey Optimizer apis

No es necesario que todo ocurra a través de la interfaz de usuario de Journey Optimizer. A veces, debe activar una campaña desde su propio backend, suprimir una dirección de correo electrónico después de una solicitud de privacidad o sincronizar plantillas de contenido desde un CMS externo. Las API de REST de Journey Optimizer le proporcionan acceso mediante programación a las funciones principales de la plataforma. Todas las llamadas utilizan la autenticación de servidor a servidor OAuth (el método JWT más antiguo está obsoleto).

Pruebas y depuración testing

Antes de que la implementación se inicie, debe confiar en que los eventos se desencadenen en el momento adecuado, los recorridos se activen según lo esperado, las acciones personalizadas se comporten bajo una carga realista y el contenido personalizado se procese correctamente. Esta sección cubre las herramientas y técnicas para detectar problemas de forma temprana, desde el registro de SDK de bajo nivel hasta las ejecuciones de pruebas de recorrido de extremo a extremo con perfiles reales.

Temas avanzados para desarrolladores advanced-topics

Una vez que los SDK, los eventos y las API principales estén implementados, estos temas le ayudan a ir más allá: enriquecimiento de los datos de recorrido en tiempo de ejecución sin sobrecargar el perfil, administración de señales de consentimiento para que las exclusiones se propaguen a través de cada integración y ajuste de la implementación para el rendimiento y la fiabilidad que exige la escala de producción.

Uso de datos contextuales y enriquecimiento

Los recorridos suelen necesitar más datos que los que llegan en el evento de activación: un nombre de producto, un nivel de lealtad y una lista de elementos de línea de pedido. En lugar de precargar todo esto en cada perfil, el enriquecimiento contextual permite que el recorrido lo busque en tiempo de ejecución desde conjuntos de datos de AEP o lo transfiera desde una respuesta de acción personalizada. Los mensajes y las condiciones de las ramas pueden hacer referencia a esos datos sin que se almacenen de forma permanente en el perfil.

Uso del consentimiento y la gobernanza

Journey Optimizer aplica las directivas de consentimiento y gobernanza de datos en el nivel de plataforma, pero la integración también debe respetarlas. Cuando un cliente decide excluirse de las comunicaciones de marketing o cuando una etiqueta de uso de datos restringe cómo se puede utilizar un campo, esas reglas deben propagarse a través de las acciones personalizadas y las búsquedas de conjuntos de datos, no solo bloquear las acciones en la interfaz de usuario.

Optimización y prácticas recomendadas

Las implementaciones de producción de Journey Optimizer administran con regularidad millones de eventos y miles de ejecuciones de recorrido por segundo. Estos recursos le ayudan a ajustar la integración para esa escala: comprenda los límites de tasa antes de alcanzarlos, evite los escollos comunes del diseño de recorridos que pierden perfiles en silencio y genere un control de errores que se degrade de forma controlada, en lugar de fallar de manera opaca.

Llamada a las API de REST de Journey Optimizer rest-apis

Además de implementar los SDK y el streaming de eventos, también puede dirigir Journey Optimizer mediante programación desde sus propios sistemas. La referencia de la API completa, las especificaciones de OpenAPI y las muestras de código se encuentran en el Portal del desarrollador de Journey Optimizer.

Ejecución de campañas activadas mediante API api-triggered

Active mensajes transaccionales o de marketing de un sistema externo mediante la API de REST de ejecución de mensajes interactivos. Antes de llamar al punto final:

Referencia de la API · Muestras de código · Trabajo con campañas activadas por API

Límite y restricción para puntos finales externos capping-throttling

Cuando los recorridos llaman a sistemas externos mediante acciones personalizadas o fuentes de datos, las API de restricción y límite protegen esos sistemas de la sobrecarga. El límite rechaza las llamadas que superan el límite configurado; la restricción las pone en cola durante un máximo de seis horas (solo zonas protegidas de producción y acciones personalizadas).

Referencia de la API de límite · Trabajo con la API de límite · Trabajo con la API de restricción

Más API de REST more-rest-apis

Más allá de la mensajería y el límite, Journey Optimizer expone los puntos finales REST para la administración de supresión, la creación de plantillas de contenido, la recuperación de campañas, la revisión y la ejecución de campañas orquestadas. Utilícelos cuando necesite automatizar operaciones que, de lo contrario, requerirían pasos manuales en la interfaz de usuario, como la supresión masiva de direcciones después de una extracción de datos o la sincronización de plantillas de una canalización de contenido externo.

| Validación de conjuntos de datos y activación de la ejecución de campañas orquestadas | Validación de conjuntos de datos · Activación · Habilitación de conjuntos de datos |

Recursos adicionales additional-resources

Colaboración entre funciones next-steps

El trabajo de implementación se intersecta con otros integrantes del equipo:

Comenzar la implementación

¿Listo para comenzar a crear? Elija su primera área de implementación en las secciones anteriores:

Cada sección incluye vínculos a documentación técnica detallada, ejemplos de código y tutoriales que guiarán la implementación.

Otras guías de funciones other-role-guides

Volver a Información general sobre funciones y responsabilidades · Volver a Introducción