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.

NOTE
Por ahora, el modo de envío rápido no es compatible con campañas activadas por API de notificaciones 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.

  1. Cree una nueva campaña con Activado por API escriba.

  2. Elija la Marketing o Transaccional categoría según el tipo de comunicación que desee enviar.

  3. 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.

  4. 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.
  5. En el Audiencia , especifique el área de nombres que se utilizará para identificar a los individuos.

  6. 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.

  7. 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.

  1. 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.

  2. 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.

NOTE
A diferencia de los eventos habilitados para perfiles, los datos contextuales pasados en la API de REST se utilizan para una comunicación única y no se almacenan en el perfil. Como máximo, el perfil se crea con los detalles del área de nombres, si se ha encontrado que falta.

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 expresiones. 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.

IMPORTANT
Los atributos contextuales pasados a la solicitud no pueden superar los 50 KB y siempre se consideran de tipo cadena.
El 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.

IMPORTANT
En el caso de los mensajes transaccionales, esta función se proporciona para creación de perfiles de volumen muy pequeño en un caso de uso de envío transaccional de gran volumen, con un grueso de perfiles ya existentes en platform.

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á.

NOTE
Los perfiles desconocidos se crean en Conjunto de datos del perfil de mensajería interactiva AJO , en tres áreas de nombres predeterminadas (correo electrónico, teléfono y ECID) respectivamente para cada canal saliente (correo electrónico, SMS y push). Sin embargo, si utiliza un área de nombres personalizada, la identidad se crea con el mismo área de nombres personalizada.

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.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76