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 mediante el API de REST de ejecución de mensajes interactivos. Esto le permite cubrir diversas necesidades operativas y de mensajería transaccional, como los restablecimientos de contraseña, el token OTP, etc.

Para ello, primero debe crear una campaña activada por API en Journey Optimizer y, a continuación, iniciar su ejecución mediante una llamada a la API.

Los canales disponibles para las campañas activadas por API son correo electrónico, SMS y mensajes push.

Creación de una campaña activada por API

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

El proceso para crear campañas activadas por API sigue siendo el mismo que las campañas programadas, excepto para la selección de audiencias que se realiza en la carga útil de API. Encontrará información detallada sobre cómo crear una campaña en esta sección.

Para crear una campaña desencadenada por API, siga estos pasos:

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

  2. Seleccione el canal y la superficie del canal que desea utilizar para enviar el mensaje y, a continuación, haga clic en Crear.

  3. Especifique un título y una descripción para la campaña y, a continuación, configure el mensaje que desea enviar.

    NOTA

    Puede pasar datos adicionales a la carga útil de la API que puede aprovechar para personalizar el mensaje. Más información

    El uso de un gran número o de datos contextuales pesados en el contenido puede afectar al rendimiento.

  4. En el Audiencia , especifique el área de nombres que se utilizará para identificar a las personas del segmento.

    La variable Crear 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

  5. Configure las fechas de inicio y finalización de la campaña.

    Si configura una fecha de inicio y/o finalización específica para una campaña, no se ejecutará fuera de estas fechas y las llamadas a la API fallarán si la campaña se activa mediante API.

  6. Haga clic en Revisar para activar para comprobar que la campaña está correctamente configurada, actívela.

Ya está listo para ejecutar la campaña desde las API de . Más información

Ejecución de la campaña

Una vez activada la campaña, debe recuperar la solicitud cURL de ejemplo generada y utilizarla en la API para crear la carga útil y el déclencheur de la campaña.

  1. Abra la campaña y copie y pegue la solicitud de ejemplo desde el petición cURL para obtener más información.

  2. Utilice esta solicitud cURL en las API para crear la carga útil y el déclencheur de la campaña. Para obtener más información, consulte Documentación de la API de ejecución de mensajes interactivos.

    NOTA

    Si ha configurado una fecha de inicio y/o finalización específica al crear la campaña, esta no se ejecutará fuera de estas fechas y las llamadas a la API no se completarán.

Utilizar atributos contextuales en campañas activadas por API

Con las campañas activadas por API, puede pasar datos adicionales en la carga útil de API y utilizarlos dentro de la campaña para personalizar su mensaje.

Veamos este ejemplo, en el que los clientes desean restablecer su contraseña y desea enviarles una URL de restablecimiento de contraseña que se genera en una herramienta de terceros. Con las campañas activadas por API, puede pasar esta URL generada a la carga útil de API y aprovecharla en la campaña para añadirla al mensaje.

NOTA

A diferencia de los eventos habilitados para perfiles, los datos contextuales pasados en la API de REST se utilizan para comunicaciones únicas y no se almacenan en el perfil. Como máximo, el perfil se crea con los detalles del área de nombres, si se encontró que falta.

Para utilizar estos datos en sus campañas, debe pasarlos a la carga útil de la API y añadirlos en el 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.

La variable {{context.<contextualAttribute>}} la sintaxis de se asigna únicamente a un tipo de datos de cadena.

IMPORTANTE

Los atributos contextuales pasados a la solicitud no pueden superar los 50 kb.

La variable context.system la sintaxis está restringida únicamente al uso interno de Adobe y no debe utilizarse para pasar atributos contextuales.

Tenga en cuenta que, por ahora, no hay ningún atributo contextual disponible para usar en el menú del carril izquierdo. Los atributos deben escribirse directamente en la expresión de personalización, sin que la comprobación la realice Journey Optimizer.

Creación de perfiles en la ejecución de la campaña

En algunos casos, es posible que tenga que enviar mensajes transaccionales a perfiles que no existen en el sistema. Por ejemplo, si un usuario desconocido intenta restablecer la contraseña en el 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 enviar el mensaje a este perfil.

IMPORTANTE

Esta función está prevista para creación de perfiles de muy pequeño volumen en un caso de uso de envío transaccional de gran volumen, con la mayoría de los perfiles ya existentes en platform.

Para activar la creación de perfiles en la ejecución de la campaña, active la opción Crear nuevos perfiles en la Audiencia para obtener más información.

NOTA

Los perfiles desconocidos se crean en la variable Conjunto de datos del perfil de mensajería interactiva AJO conjunto de datos, en tres área de nombres predeterminada (correo electrónico, teléfono y ECID) respectivamente para cada canal saliente (correo electrónico, SMS y push).

En esta página