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 utilizando API de REST de ejecución de mensaje interactivo. 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 Activado por API escriba.
-
Elija la Marketing o Transaccional categoría según el tipo de comunicación que desee enviar.
-
Elija uno de los canales admitidos y la superficie 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 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 el Audiencia , especifique el área de nombres que se utilizará para identificar a los individuos.
-
Si está creando un transaccional del tipo, los perfiles objetivo deben definirse en la llamada de API. El Creación de nuevos perfiles 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 campañas
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 de la API de ejecución de mensaje interactivo -
Para marketing Campañas de tipo, haga clic en Audiencia para elegir el público objetivo.
-
-
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.
-
Clic Revisar para activar para comprobar que la campaña está configurada correctamente, 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 del Solicitud cURL sección. 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 de la API de ejecución de mensaje interactivo.
Los ejemplos de llamadas de API también están 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 el {{context.<contextualAttribute>}}
sintaxis, donde <contextualAttribute>
debe coincidir con el nombre de la variable en la carga útil de API que contiene los datos que desea pasar.
El {{context.<contextualAttribute>}}
La sintaxis solo se asigna a un tipo de datos de cadena.
context.system
la sintaxis está restringida únicamente al uso interno del Adobe y no debe utilizarse 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 ninguna comprobación sea realizada por Journey Optimizer.
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, cambie el Creación de nuevos perfiles opción activada en la Audiencia sección. 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.