Introducción para los desarrolladores get-started-developers
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:
- Implementación de SDK en aplicaciones móviles y web
- Envío de eventos desde las aplicaciones para la activación de recorridos
- Generación de puntos finales de API a los que Journey Optimizer puede llamar mediante acciones personalizadas
- Integración de Journey Optimizer con sus sistemas e infraestructura existentes
- Prueba y depuración de sus implementaciones
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:
* Comprensión de las API de RESTful y JSON
* Familiaridad con la programación asíncrona y las arquitecturas impulsadas por eventos
* Conocimiento de la arquitectura de aplicaciones de su organización
* Entorno de desarrollo con acceso al código base de su aplicación
* Herramientas de prueba como Postman para pruebas de API
* Herramientas para desarrolladores de explorador o herramientas de depuración móvil
* Esquemas XDM y definiciones de eventos de su Ingeniero de datos
* Requisitos y casos de uso de sus Expertos en marketing
Comprender los fundamentos técnicos technical-foundation
Antes de sumergirse en la implementación, familiarícese con los conceptos técnicos básicos:
-
Integración de Adobe Experience Platform: Journey Optimizer se ha creado de forma nativa en Adobe Experience Platform. Comprender la arquitectura subyacente le ayudará a crear implementaciones más efectivas. Más información sobre cómo funciona Journey Optimizer.
-
Modelos de datos XDM: Journey Optimizer utiliza el Modelo de datos de experiencia (XDM) para estructurar los datos de eventos y perfiles. Como desarrollador, tendrá que aprender cómo enviar datos que se ajusten a los esquemas configurados por su ingeniero de datos. Más información acerca de los esquemas XDM.
-
Autenticación y seguridad: todas las implementaciones requieren la autenticación adecuada. Obtenga información sobre cómo configurar la autenticación para SDK y API. Más información sobre la autenticación de API.
Configurar las integraciones de la aplicación móvil mobile-integration
Configurar el SDK móvil de Adobe Experience Platform
Para habilitar las notificaciones push, los mensajes en la aplicación y otras funciones móviles, integre Adobe Experience Platform Mobile SDK en sus aplicaciones móviles.
-
Instale y configure Mobile SDK: siga la documentación del SDK móvil de Adobe Experience Platform para comenzar a usar la integración de SDK.
-
Creación de una propiedad móvil: configure una propiedad móvil en Adobe Experience Platform Data Collection. Aprenda a crear y configurar una propiedad móvil.
-
Configuración de notificaciones push:
- Para aplicaciones de iOS: registre su aplicación con APNs (servicio de notificaciones push de Apple). Obtenga más información en la documentación de Apple.
- Para aplicaciones de Android: configure Firebase Cloud Messaging para su aplicación de Android. Obtenga más información en la Documentación de Google.
-
Pruebe su integración móvil: Use el flujo de trabajo de inicio rápido de la incorporación móvil para configurar y probar rápidamente su configuración móvil.
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)
Para la personalización nativa de aplicaciones móviles mediante experiencias basadas en código:
- Siga este tutorial para la implementación del SDK móvil
- Revise las implementaciones de muestra para iOS y Android
Implementación de experiencias web web-implementation
Configuración del SDK web de Adobe Experience Platform
En implementaciones basadas en la web, el SDK web es el punto de integración principal:
-
Instale el SDK web: siga la guía de implementación del SDK web para configurar el SDK en su sitio web.
-
Configure secuencias de datos: cree y configure una secuencia de datos en Adobe Experience Platform Data Collection con Journey Optimizer habilitado. Obtenga más información en la documentación de secuencias de datos.
-
Habilite notificaciones push en la web (opcional): configure la propiedad pushNotifications en la configuración de Web SDK y use el comando sendPushSubscription para registrar suscripciones push.
Implementar experiencias basadas en código (Web SDK)
Las experiencias basadas en código le permiten personalizar cualquier punto de contacto digital:
-
Elija su método de implementación: del lado del cliente, del lado del servidor o híbrido. Revise ejemplos de implementación para cada enfoque.
-
Defina superficies: identifique las ubicaciones de la aplicación en las que desea enviar contenido personalizado. Más información sobre la configuración de superficie.
-
Implemente el renderizado de contenido: utilice el SDK web para recuperar y aplicar contenido de personalización. Vea tutoriales de implementación basados en código.
-
Envío de eventos de visualización e interacción: realice un seguimiento de cuándo se muestra el contenido y cuándo los usuarios interactúan con él para realizar análisis y optimización.
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
Como desarrollador, implementará el código para enviar eventos que activen los recorridos. Su ingeniero de datos configurará los esquemas y las definicionesde eventos en Journey Optimizer.
-
Conozca la carga útil del evento: colabore con su ingeniero de datos para obtener el esquema de evento y la estructura de carga útil necesaria. La carga útil debe ajustarse al esquema XDM que él ha configurado. Obtenga información acerca de requisitos de esquema de eventos.
-
Implementar streaming de eventos: envíe eventos a Adobe Experience Platform mediante las API de ingesta de streaming. Conozca los pasos para enviar eventos.
-
Gestión de tipos de eventos:
- Eventos unitarios: implemente el envío de eventos para acciones específicas de la persona (por ejemplo, clic en el botón, finalización de la compra).
- Eventos empresariales: envíe eventos empresariales (por ejemplo, actualizaciones de inventario o cambios de precio)
-
Envío de eventos de prueba: compruebe que los eventos se reciben correctamente y que activan recorridos según lo esperado. Más información sobre la solución de problemas de eventos.
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
Las acciones personalizadas permiten que los recorridos llamen a sus API. Como desarrollador, creará los puntos finales de API que invocan las acciones personalizadas:
-
Cree su punto final de API: cree puntos finales de API RESTful a los que Journey Optimizer llamará durante la ejecución del recorrido. Su punto final debe:
- Aceptar cargas útiles JSON
- Autenticar solicitudes (OAuth, clave de API o JWT)
- Procesar solicitudes dentro de los límites de tiempo de espera adecuados
- Devolver respuestas en el formato esperado
-
Conozca las capacidades de acción personalizadas: las acciones personalizadas pueden conectarse a sistemas de terceros como Epsilon, Slack, Firebase o a sus propios servicios. Más información sobre las acciones personalizadas.
-
Trabaje con configuraciones de acción: Su administrador o ingeniero de datos configurará la acción personalizada en Journey Optimizer, definiendo la dirección URL del punto final de API, el método de autenticación y los parámetros. Les proporcionará su especificación de API. Obtenga información sobre la configuración de acciones personalizadas.
-
Devolver datos procesables: diseñe su API para devolver datos que se puedan usar en pasos de recorrido posteriores. Obtenga información acerca de respuestas de acción.
-
Implemente limitación de velocidad: asegúrese de que los puntos finales puedan asumir el volumen esperado. Journey Optimizer aplica un límite de 5000 llamadas/segundo, pero el sistema debe ser flexible. Obtenga información sobre límite y regulación.
Ejemplo de caso de uso: escritura de eventos de recorrido en Experience Platform mediante acciones personalizadas.
Trabajo con las API de Journey Optimizer apis
Journey Optimizer proporciona API de REST completas para el acceso mediante programación:
-
Comprenda las capacidades de la API: las API de Journey Optimizer le permiten crear, leer, actualizar y eliminar varios recursos mediante programación. Más información sobre las API de Journey Optimizer.
-
Autenticación: siga este tutorial para configurar la autenticación de API mediante Adobe Developer Console.
-
Explore referencias de API: examine la documentación completa de la API y pruebe las API directamente en la referencia de la API de Adobe Journey Optimizer.
-
Campañas activadas por API: cree mensajería transaccional con campañas activadas por API. Para escenarios de gran volumen (hasta 5000 TPS), explore el Modo de alto rendimiento (requiere licencia adicional).
-
API de gestión de decisiones: use API especializadas para la gestión y toma de decisiones de ofertas. Obtenga más información en la Guía de API de gestión de decisiones.
Pruebas y depuración testing
-
Implementación de SDK de depuración: use Adobe Experience Platform Assurance para inspeccionar eventos de SDK, validar la recopilación de datos y solucionar problemas de integración en tiempo real. Obtenga más información sobre Assurance.
-
Envío de eventos de prueba: verifique que los eventos de su aplicación son recibidos correctamente por Adobe Experience Platform y activan los recorridos según lo previsto. Monitorice la ingesta de eventos y valide la estructura de carga útil.
-
Validar integraciones de API: pruebe los puntos finales de acción personalizados para asegurarse de que administran correctamente las solicitudes de Journey Optimizer, responden dentro de los límites de tiempo de espera y devuelven los formatos de datos esperados.
-
Use el modo de prueba con perfiles de prueba: trabaje con su ingeniero de datos para obtener acceso a los perfiles de prueba y, a continuación, valide su implementación mediante el modo de prueba de recorrido. Aprenda a probar recorridos.
-
Supervise los registros de SDK: habilite el registro de depuración en la implementación de SDK para solucionar problemas durante el desarrollo:
- SDK móvil: habilite el registro para ver eventos de SDK y llamadas a la API
- Web SDK: utilice la consola del explorador para supervisar la actividad de SDK
-
Verifique la configuración de la secuencia de datos: asegúrese de que la secuencia de datos esté configurada correctamente para enviar datos a Journey Optimizer. Compruebe que los eventos fluyen a través de la secuencia de datos hasta los destinos correctos.
-
Consulte datos de recorrido para el análisis: use consultas SQL en el lago de datos para analizar eventos de pasos de recorrido, depurar problemas y supervisar el rendimiento de acciones personalizadas. Explore ejemplos de consultas para el análisis de recorrido, incluidos:
- Razones de entrada/salida del perfil y de descarte
- Métricas de rendimiento de acciones personalizadas (latencia, rendimiento, errores)
- Envío de eventos y patrones de error
- Estados de instancias de recorrido
Temas avanzados para desarrolladores advanced-topics
Uso de datos contextuales y enriquecimiento
- Iterar en matrices: use la sintaxis de Handlebars para mostrar listas dinámicas de eventos, respuestas de acciones personalizadas y búsquedas de conjuntos de datos en mensajes. Obtenga información acerca de iteración de datos contextuales.
- Búsqueda de conjuntos de datos: implemente búsquedas de conjuntos de datos para enriquecer los datos de recorrido de los conjuntos de datos de Adobe Experience Platform. Trabaje con su ingeniero de datos en la configuración. Obtenga información acerca de búsqueda de conjuntos de datos.
Uso del consentimiento y la gobernanza
Implementación de políticas de gobernanza de datos y consentimiento en las integraciones:
- Gobernanza de datos: aplique directivas de uso de datos a las acciones personalizadas. Más información sobre la gobernanza de los datos.
- Gestión del consentimiento: administre las preferencias de consentimiento del cliente en sus implementaciones. Más información sobre el consentimiento.
Optimización y prácticas recomendadas
- Límites y regulación: conozca los límites de velocidad e implemente una regulación adecuada. Más información sobre sistemas externos.
- Optimización de recorrido: siga las prácticas recomendadas para optimización de recorrido.
- Control de errores: implemente un control de errores sólido. Revise los códigos de error y las guías de solución de problemas.
Recursos adicionales additional-resources
- Developer Console: acceda a Adobe Developer Console para crear integraciones y administrar credenciales de API.
- Código de muestra: explore implementaciones de muestra en GitHub.
- Vídeos de tutorial: aprenda con tutoriales prácticos en Experience League.
- Comunidad de desarrolladores: conéctese con otros desarrolladores y obtenga asistencia en los foros de la comunidad de Adobe.
Colaboración entre funciones next-steps
El trabajo de implementación se intersecta con otros integrantes del equipo:
Colabore con ingenieros de datos en configuraciones de datos y eventos:
-
Obtenga los esquemas XDM y las estructuras de eventos que necesita implementar
-
Aprenda qué eventos debe enviar y su formato de carga útil requerido
-
Alinee los requisitos de recopilación de datos y los estándares de calidad de datos
-
Pruebe conjuntamente la entrega de eventos y la ingesta de datos
Colabore con administradores en el acceso y las configuraciones:
-
Proporcione especificaciones de API para las acciones personalizadas que configurarán
-
Solicite los permisos y credenciales de API necesarios
-
Coordine los requisitos de configuración de canal (por ejemplo, certificados push)
-
Alinear en entornos de prueba y estrategia de zona protegida
Colabore con expertos en marketing en los requisitos y pruebas de recorrido:
-
Aprenda qué interacciones de usuario deben activar eventos
-
Implementación del seguimiento para el rendimiento del contenido y la participación del usuario
-
Prueba de compatibilidad de recorridos con las funciones implementadas
-
Solución de problemas con el envío o la personalización de mensajes
Comenzar la implementación
¿Listo para comenzar a crear? Elija su primera área de implementación en las secciones anteriores:
- ¿Aplicación móvil? Comience con integración de SDK móvil
- ¿Sitio web? Comience con Configuración de Web SDK
- ¿Integración de API? Vaya a Trabajar con API
- ¿Sistema personalizado? Consulte Acciones personalizadas
Cada sección incluye vínculos a documentación técnica detallada, ejemplos de código y tutoriales que guiarán la implementación.