Skip to content

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 campaña desencadenada por API

Configurar una campaña desencadenada por API requiere algunos pasos. Primero, crea una nueva campaña 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 notificaciones planificadas y selecciona Entrega desencadenada por API. Para más información sobre cómo desencadenar estas campañas desde tu servidor, consulta este artículo sobre envío de campañas desencadenadas por API.

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 incorporarlo como plantilla en el mensaje dentro del objeto trigger_properties. Este contenido puede referenciarse en el cuerpo del mensaje. Por ejemplo, puedes incluir: {{ api_trigger_properties.${ some_value_included_with_request }}}. Consulta el siguiente ejemplo de notificación social para contexto adicional:

La propiedad de desencadenamiento mencionada anteriormente incluida en el mensaje para autocompletar el nombre del usuario seguido del texto: "liked your photo! Click here to see what they've been up to.".

Reelegibilidad con campañas desencadenadas por API

El número de veces que un usuario recibe una campaña desencadenada por API puede limitarse mediante la configuración de reelegibilidad. Esto significa que el usuario recibirá la campaña solo una vez o una vez en una ventana determinada, independientemente de cuántas veces se active el desencadenador de API.

Por ejemplo, supongamos que estás usando una campaña desencadenada por API para enviar al usuario una campaña sobre un artículo que vio recientemente. En este caso, puedes limitar la campaña para enviar 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. Por otro lado, si tu campaña desencadenada por API es transaccional, querrás asegurarte de que el usuario reciba la campaña cada vez que realice la transacción, estableciendo el retraso en cero minutos.

New Stuff!