Activación de campañas mediante las API trigger-campaigns
Acerca de las campañas activadas por API about
Con Journey Optimizer, puede crear campañas y luego invocarlas desde un sistema externo basado en el déclencheur del usuario mediante la API de REST de ejecución de mensajes interactiva. Esto le permite cubrir diversas necesidades de marketing y mensajería transaccional, como restablecimientos de contraseña, token OTP, entre otros.
Para ello, primero debe crear una campaña activada por API en Journey Optimizer y luego iniciar su ejecución mediante una llamada de API.
Los canales disponibles para las campañas activadas por API son correo electrónico, SMS y mensajes push.
➡️ Descubra esta función en vídeo
Creación de una campaña activada por API create
Configuración y activación de la campaña create-activate
Para crear una campaña activada por API, siga los pasos a continuación. Encontrará información detallada sobre cómo crear una campaña en esta sección.
-
Cree una nueva campaña con el tipo activado por API.
-
Elija la categoría Marketing o Transaccional según el tipo de comunicación que desee enviar.
-
Elija uno de los canales admitidos y la configuración de canal asociada que se utilizará para enviar el mensaje y, a continuación, haga clic en Crear.
-
Especifique un título y una descripción para la campaña y luego haga clic en Editar contenido para configurar el mensaje que desea enviar.
note note NOTE Puede pasar datos adicionales en la carga útil de la API que puede aprovechar para personalizar su mensaje. Más información El uso de un gran número o de datos contextuales pesados en el contenido puede afectar al rendimiento. -
En la sección Audience, especifique el área de nombres que se utilizará para identificar a los individuos.
-
Si está creando una campaña del tipo transaccional, los perfiles de destino deben definirse en la llamada de API. La opción Crear nuevos perfiles le permite crear automáticamente perfiles que no existen en la base de datos. Obtenga más información sobre la creación de perfiles en la ejecución de la campaña
note note NOTE Una sola llamada de API admite hasta 20 destinatarios únicos. Cada destinatario debe tener un ID de usuario único, no se permiten ID de usuario duplicados. Obtenga más información en la documentación interactiva de la API de ejecución de mensajes -
Para las campañas del tipo marketing, haga clic en el botón Audiencia para elegir la audiencia a la que se dirigirá.
-
-
Configure las fechas de inicio y finalización de la campaña.
Si configura una fecha específica de inicio o finalización de una campaña, esta no se ejecutará fuera de estas fechas y las llamadas a la API fallarán si la campaña se activa mediante API.
-
Haga clic en Revisar para activar y comprobar que la campaña esté configurada correctamente y, a continuación, actívela.
Ya está listo para ejecutar la campaña desde las API. Más información
Ejecución de la campaña execute
Una vez activada la campaña, debe recuperar la solicitud cURL de muestra generada y utilizarla en la API para crear la carga útil y almacenar la campaña en déclencheur.
-
Abra la campaña y copie y pegue la solicitud de carga útil de la sección cURL request. Esta carga útil incluye todas las variables de personalización (perfil y contexto) utilizadas en el mensaje. Está disponible una vez que la campaña está activa.
-
Utilice esta solicitud de cURL en las API para crear la carga útil y almacenar en déclencheur la campaña. Para obtener más información, consulte la documentación interactiva de la API de ejecución de mensajes.
También hay ejemplos de llamadas API disponibles en esta página.
note note NOTE Si ha configurado una fecha específica de inicio o finalización al crear la campaña, esta no se ejecuta fuera de estas fechas y las llamadas a la API fallan.
Uso de atributos contextuales en campañas activadas por API contextual
Con las campañas activadas por API, puede pasar datos adicionales en la carga útil de la API y utilizarlos dentro de la campaña para personalizar el mensaje.
Veamos este ejemplo en el que los clientes desean restablecer su contraseña y usted desea enviarles una URL de restablecimiento de contraseña generada en una herramienta de terceros. Con las campañas activadas por API, puede pasar esta URL generada a la carga útil de la API y aprovecharla en la campaña para agregarla al mensaje.
Para utilizar estos datos en sus campañas, debe pasarlos a la carga útil de la API y añadirlos en su mensaje mediante el editor de personalización. Para ello, utilice la sintaxis {{context.<contextualAttribute>}}, donde <contextualAttribute> debe coincidir con el nombre de la variable en la carga útil de la API que contiene los datos que desea pasar.
La sintaxis {{context.<contextualAttribute>}} solo está asignada a un tipo de datos de cadena.
context.system está restringida únicamente al uso interno del Adobe y no debe usarse para pasar atributos contextuales.Tenga en cuenta que, por ahora, no hay ningún atributo contextual disponible para su uso en el menú del carril izquierdo. Los atributos deben escribirse directamente en la expresión personalizada, sin que Journey Optimizer realice ninguna comprobación.
Creación de perfiles en ejecución de campaña profile-creation
En algunos casos, es posible que deba enviar mensajes transaccionales a perfiles que no existen en el sistema. Por ejemplo, si un usuario desconocido intenta restablecer la contraseña en su sitio web.
Cuando un perfil no existe en la base de datos, Journey Optimizer le permite crearlo automáticamente al ejecutar la campaña para permitir el envío del mensaje a este perfil.
Para activar la creación de perfiles en la ejecución de la campaña, active la opción Crear nuevos perfiles en la sección Audiencia. Si esta opción está deshabilitada, los perfiles desconocidos se rechazarán para cualquier envío y la llamada de API fallará.
Vídeo explicativo video
Obtenga información sobre cómo crear una campaña y almacenarla en déclencheur desde un sistema externo basado en las interacciones del usuario, mediante la API de REST de ejecución de mensaje interactivo.