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.
Configuración de una Campaign activada por API
Configurar una Campaign activada 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 manera que lo harías normalmente para las notificaciones programadas y selecciona API-Triggered Delivery. Para obtener más información sobre cómo activar estas Campaigns desde tu servidor, consulta este artículo sobre el envío de Campaigns activadas por API.
Reducir el retraso entre el desencadenamiento por API y el envío
Si los mensajes tardan más de lo esperado en enviarse después de llamar al endpoint de desencadenamiento, comprueba si el perfil de usuario está listo en el momento del desencadenamiento.
De forma predeterminada, send_to_existing_only es true en /campaigns/trigger/send. Braze solo envía 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 requerido) dentro de attributes. Si el perfil no tiene una dirección de correo electrónico cuando desencadenas 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 todos los parámetros de solicitud, ejemplos y el comportamiento de reintentos, consulta Enviar Campaigns desencadenadas por API y el objeto de destinatarios.
Esta guía se aplica a Campaigns desencadenadas por API (/campaigns/trigger/send). El endpoint de correo transaccional utiliza 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. Este contenido puede referenciarse 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
El número 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 utilizando 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 estableciendo el retraso en cero minutos.
