Activación de campañas mediante las API

Acerca de las campañas activadas por API

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.

NOTA

Por ahora, el modo de envío rápido no es compatible con campañas activadas por API de notificaciones push.

Creación de una campaña activada por API

Configuración y activación de la campaña

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.

    NOTA

    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

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 ejemplo desde el Solicitud cURL sección.

  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.

    NOTA

    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

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.

NOTA

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.

IMPORTANTE

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

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.

IMPORTANTE

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

NOTA

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

En esta página