Entrega desencadenada por API
Las campañas desencadenadas por API o campañas desencadenadas por servidor son ideales para casos de uso transaccionales más avanzados. Las campañas desencadenadas por API de Braze permiten a los especialistas en marketing gestionar el texto de la campaña, las pruebas multivariante y las reglas de reelegibilidad dentro del panel de Braze, mientras desencadenan la entrega de ese contenido desde sus propios servidores y sistemas. La solicitud de API para desencadenar el mensaje también puede incluir datos adicionales que se incorporan a la plantilla del mensaje en tiempo real.
Configurar una Campaign con desencadenamiento por API
Configurar una Campaign con desencadenamiento por API requiere algunos pasos. Primero, crea una nueva Campaign multicanal o de un solo canal (con pruebas multivariante).
A continuación, configura tu texto y notificaciones de la misma forma que lo harías normalmente para notificaciones programadas y selecciona API-Triggered Delivery. Para obtener más información sobre cómo desencadenar estas Campaigns desde tu servidor, consulta este artículo sobre envío de Campaigns con desencadenamiento por API.
Reducir el retraso entre la activación de la API y el envío
Si los mensajes tardan más de lo esperado en enviarse después de llamar al endpoint de activación, comprueba si el perfil de usuario está listo en el momento de la activación.
De forma predeterminada, send_to_existing_only es true en /campaigns/trigger/send. Braze envía solo a usuarios existentes y no crea perfiles nuevos en esa llamada. Para crear o actualizar un usuario y enviar en la misma solicitud, establece send_to_existing_only en false e incluye un objeto attributes en cada destinatario.
Para Campaigns de correo electrónico, incluye también email (y cualquier otro campo de entrega obligatorio) dentro de attributes. Si el perfil no tiene una dirección de correo electrónico cuando activas el envío, Braze reintenta durante aproximadamente 2 horas mientras espera a que lleguen los datos del perfil. Incluir email en la misma llamada evita ese retraso.
Para ver los parámetros completos de la solicitud, ejemplos y el comportamiento de reintentos, consulta Enviar Campaigns activadas por API y el objeto recipients.
Esta guía se aplica a Campaigns activadas por API (/campaigns/trigger/send). El endpoint de correo transaccional usa una estructura de solicitud diferente (recipient, singular) y no admite send_to_existing_only. Para crear un usuario de forma integrada con envíos transaccionales, pasa attributes en el objeto recipient.
Uso del contenido con plantilla incluido en una solicitud de API
Además de desencadenar el mensaje, también puedes incluir contenido con la solicitud de API para que se aplique como plantilla en el mensaje dentro del objeto trigger_properties. Se puede hacer referencia a este contenido en el cuerpo del mensaje.
Usa exactamente dos llaves por cada etiqueta de Liquid en trigger_properties y en el texto del mensaje. Un ejemplo es: {{api_trigger_properties.${your_property}}}. Una { o } adicional es una causa común de fallos de personalización activada por API.
Consulta el siguiente ejemplo de notificación social para más contexto.
Reelegibilidad con Campaigns activadas por API
La cantidad de veces que un usuario recibe una Campaign activada por API se puede limitar mediante la configuración de reelegibilidad. Esto significa que el usuario recibe la Campaign solo una vez o una vez en un periodo determinado, independientemente de cuántas veces se active el desencadenador de API.
Por ejemplo, supongamos que estás usando una Campaign activada por API para enviar al usuario una Campaign sobre un artículo que vio recientemente. En este caso, puedes limitar la Campaign para que envíe un máximo de un mensaje al día, independientemente de cuántos artículos haya visto, mientras se activa el desencadenador de API para cada artículo. Si tu Campaign activada por API es transaccional, asegúrate de que el usuario reciba la Campaign cada vez que realice la transacción configurando el retraso en cero minutos.
