Introducción para desarrolladores get-started-developers

En esta página: Implemente los SDK, el flujo de eventos, los extremos 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

Mobile SDK 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 ponerse en contacto con 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 y indicadores de funcionalidades en la aplicación, sin necesidad de realizar un nuevo lanzamiento de la aplicación. Utilice Mobile SDK 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

Web SDK (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 un conjunto 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, déclencheur 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 especialistas 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 mostrarlo. Este modelo funciona para cualquier superficie web (banners de pantalla completa, carruseles de recomendaciones, clasificaciones de resultados de búsqueda y variantes de prueba A/B) sin necesidad de un editor visual o flujo de trabajo de publicación de página.

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, agrega 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 transmisión 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ínelos antes de empezar a codificar.

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 dirección URL que proporcione: su back-end, un CRM, una plataforma de fidelidad, cualquier extremo 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 llamada que generará Journey Optimizer. A continuación, el administrador registra el extremo 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 almacenar en déclencheur una campaña desde su propio servidor, 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 ponga en marcha, debe confiar en que los eventos se activan en el momento adecuado, los recorridos entran en déclencheur según lo esperado, las acciones personalizadas se comportan bajo una carga realista y el contenido personalizado se procesa correctamente. Esta sección cubre las herramientas y técnicas para detectar problemas de forma temprana, desde el inicio de sesión 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 políticas 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 Production Journey Optimizer administran regularmente 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 sueltan perfiles en silencio y genere un control de errores que se degrade correctamente en lugar de fallar en forma opaca.

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

Además de implementar los SDK y la transmisión de eventos, también puede dirigir Journey Optimizer mediante programación desde sus propios sistemas. La referencia de API completa, las especificaciones de OpenAPI y ejemplos de código se encuentran en Journey Optimizer developer portal.

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

Almacene en déclencheur mensajes transaccionales o de marketing de un sistema externo mediante la API de REST de ejecución de mensajes interactivos. Antes de llamar al extremo:

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

Límite y restricción para extremos 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 6 horas (solo zonas protegidas de producción y acciones personalizadas).

Referencia de API de límite · Trabajar con la API de límite · Trabajar con la API de limitació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 organizadas. 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.

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 Resumen de funciones y responsabilidades · Volver a Introducción