Entrega acionada por API

Campanhas acionadas por API ou campanhas acionadas por servidor são ideais para casos de uso transacionais mais avançados. As campanhas acionadas por API da Braze permitem que os profissionais de marketing gerenciem o texto da campanha, testes multivariados e regras de re-eligibilidade dentro do painel da Braze, enquanto acionam a entrega desse conteúdo a partir de seus próprios servidores e sistemas. A solicitação da API para acionar a mensagem também pode incluir dados adicionais a serem modelados na mensagem em tempo real.

Configurando uma campanha acionada por API

Configurar uma campanha acionada por API leva algumas etapas. Primeiro, crie uma nova campanha multicanal ou de canal único (com testes multivariados).

Em seguida, configure seu texto e notificações da mesma forma que você normalmente faria para notificações agendadas e selecione Entrega Acionada por API. Para mais informações sobre o acionamento dessas campanhas a partir do seu servidor, confira este artigo sobre envio de campanha acionada por API.

!

Usando o conteúdo modelado incluído com uma solicitação de API

Além de acionar a mensagem, você também pode incluir conteúdo com a solicitação da API para ser modelado na mensagem dentro do objeto trigger_properties. Esse conteúdo pode ser referenciado no corpo da mensagem. Por exemplo, você pode incluir: {{ api_trigger_properties.${ some_value_included_with_request }}}. Veja o seguinte exemplo de notificação social para contexto adicional:

!A propriedade de gatilho mencionada incluída na mensagem para preencher automaticamente o nome do usuário seguido do texto: “gostou da sua foto! Clique aqui para ver o que eles têm feito.”.

Re-eligibilidade com campanhas acionadas por API

O número de vezes que um usuário recebe uma campanha acionada por API pode ser limitado usando configurações de re-eligibilidade. Isso significa que o usuário receberá a campanha apenas uma vez ou uma vez em uma determinada janela, independentemente de quantas vezes o gatilho da API for acionado.

Por exemplo, digamos que você está usando uma campanha acionada por API para enviar ao usuário uma campanha sobre um item que ele visualizou recentemente. Nesse caso, você pode limitar a campanha a enviar no máximo uma mensagem por dia, independentemente de quantos itens eles visualizaram enquanto acionavam o gatilho da API para cada item. Por outro lado, se sua campanha acionada por API for transacional, você vai querer garantir que o usuário receba a campanha toda vez que realizar a transação, definindo o atraso para zero minutos.

!