Introducción para los desarrolladores get-started-developers
Como desarrollador, eres responsable de implementar e integrar Adobe Journey Optimizer en tus aplicaciones y sistemas. Puede comenzar a trabajar con Adobe Journey Optimizer una vez que el Administrador del sistema y el Ingeniero de datos le hayan concedido acceso y preparado 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 a los recorridos de déclencheur
- Creando extremos de API a los que Journey Optimizer puede llamar mediante acciones personalizadas
- Integrar 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 especialistas en mercadotecnia diseñarán los recorridos y el contenido que usan sus implementaciones.
Esta guía cubre 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 evento de sus Requisitos y casos de uso del Ingeniero de datos
* de sus Especialistas en marketing
Comprender la base técnica technical-foundation
Antes de sumergirse en la implementación, familiarícese con los conceptos técnicos principales:
-
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ás que entender cómo enviar datos que se ajusten a los esquemas configurados por tu ingeniero de datos. Obtenga información sobre 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.
Configuración de integraciones de aplicaciones móviles mobile-integration
Configuración de Adobe Experience Platform Mobile SDK
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 de Adobe Experience Platform Mobile SDK para comenzar a usar la integración con SDK.
-
Crear una propiedad móvil: Configure una propiedad móvil en Adobe Experience Platform Data Collection. Aprenda a crear y configurar una propiedad móvil.
-
Configurar notificaciones push:
- Para aplicaciones de iOS: registre su aplicación con APNS (servicio de notificaciones push de Apple). Obtenga más información en Documentación de Apple.
- Para aplicaciones de Android: configure Firebase Cloud Messaging para su aplicación de Android. Obtenga más información en 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 (Mobile SDK)
Para la personalización nativa de aplicaciones móviles mediante experiencias basadas en código:
- Seguir este tutorial para la implementación de Mobile SDK
- Revise las implementaciones de muestra para iOS y Android
Implementación de experiencias web web-implementation
Configuración de Adobe Experience Platform Web SDK
En implementaciones basadas en la web, Web SDK es el punto de integración principal:
-
Instale Web SDK: Siga la guía de implementación de Web SDK para configurar SDK en su sitio web.
-
Configurar flujos de datos: cree y configure un flujo de datos en Adobe Experience Platform Data Collection con Journey Optimizer habilitado. Obtenga más información en la documentación de flujos de datos.
-
Habilitar 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.
-
Definir superficies: identifique las ubicaciones de la aplicación en las que desea enviar contenido personalizado. Obtenga información acerca de configuración de superficie.
-
Implementar la representación de contenido: Utilice Web SDK para recuperar y aplicar contenido de personalización. Ver tutoriales de implementación basados en código.
-
Enviar eventos de visualización e interacción: realiza 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 flujo de eventos event-streaming
Envío de eventos a los recorridos de déclencheur
Como desarrollador, implementará el código para enviar eventos que almacenen en déclencheur los recorridos. Su ingeniero de datos configurará los esquemas de eventos y las definiciones en Journey Optimizer.
-
Comprenda 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 han configurado. Obtenga información acerca de requisitos de esquema de eventos.
-
Implementar flujo de eventos: Envíe eventos a Adobe Experience Platform mediante las API de ingesta de transmisión. Conozca los pasos para enviar eventos.
-
Controlar 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ía 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 los recorridos de déclencheur son los esperados. Obtenga información acerca de 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 extremos 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 extremo de API: cree extremos de API RESTful a los que Journey Optimizer llamará durante la ejecución del recorrido. Su punto final debe:
- Aceptar cargas 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
-
Comprenda 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 extremo de API, el método de autenticación y los parámetros. Les proporcionará su especificación de API. Obtenga información acerca de configuración de acción personalizada.
-
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.
-
Implementar limitación de velocidad: Asegúrese de que los extremos puedan controlar 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:
-
Comprender 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.
-
Explorar 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 mensajes transaccionales con campañas activadas por API. Para escenarios de gran volumen (hasta 5000 TPS), explore Modo de alto rendimiento (requiere licencia adicional).
-
API de administración de decisiones: use API especializadas para la administración y toma de decisiones de ofertas. Obtenga más información en la Guía de API de administración de decisiones.
Pruebas y depuración testing
-
Implementación de Debug SDK: 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. Más información sobre Assurance.
-
Envío de eventos de prueba: compruebe que Adobe Experience Platform y los recorridos de déclencheur reciben correctamente los eventos de su aplicación según lo esperado. Monitorice la ingesta de eventos y valide la estructura de carga útil.
-
Validar integraciones de API: pruebe los extremos 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.
-
Supervisar 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
-
Verificar configuración del flujo de datos: Asegúrese de que el flujo de datos esté configurado correctamente para enviar datos a Journey Optimizer. Compruebe que los eventos fluyen por el flujo de datos hasta los destinos correctos.
-
Consultar 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. Explorar 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)
- Entrega 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 repetir 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
Implementar 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 gobernanza de datos.
- Administración de consentimiento: Administre las preferencias de consentimiento del cliente en sus implementaciones. Más información sobre consentimiento.
Optimización y prácticas recomendadas
- Límite y regulación: Comprenda los límites de velocidad e implemente un límite adecuado. 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 códigos de error y guías de solución de problemas.
Recursos adicionales additional-resources
- Developer Console: accede 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:
Colaborar con ingenieros de datos en configuraciones de datos y eventos:
-
Obtenga los esquemas XDM y las estructuras de eventos que necesita implementar
-
Comprender 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
-
Prueba conjunta de la entrega de eventos y la ingesta de datos
Colaborar con administradores en el acceso y las configuraciones:
-
Proporcionar especificaciones de API para las acciones personalizadas que configurarán
-
Solicite los permisos y credenciales de API necesarios
-
Coordinar los requisitos de configuración de canal (por ejemplo, certificados push)
-
Alinear en entornos de prueba y estrategia de zona protegida
Colaborar con especialistas en mercadotecnia en los requisitos y pruebas de recorrido:
-
Comprender qué interacciones de usuario deben almacenar eventos en déclencheur
-
Implementar el 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 implementación
¿Listo para empezar a construir? Elija su primera área de implementación en las secciones anteriores:
- ¿Aplicación móvil ? comienza con integración de SDK móvil
- ¿Sitio web de ? Comience con Configuración de Web SDK
- ¿Integración de API ? Ir a Trabajar con API
- ¿Sistema personalizado? Desproteger 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.