Loop
O Track by Loop é o produto de rastreamento da Loop para clientes de eCommerce. Ele acompanha pacotes entre operadoras, normaliza os status de fulfillment e envia esses eventos para a Braze para envio de mensagens.
Essa integração é mantida pelo Track by Loop.
Sobre a integração
Quando ocorre um evento de envio (por exemplo, remessa criada, em trânsito, saiu para entrega, entregue ou parada), o Track by Loop chama a REST API da Braze para disparar uma Campaign acionada por API ou um Canvas acionado por API. Cada chamada inclui propriedades da remessa e do pedido que você pode usar para personalização com Liquid. A Braze continua sendo o sistema de registro para elegibilidade, limite de frequência e entrega de mensagens em todos os canais que você configurar.
Casos de uso
- Envie atualizações de envio como “seu pedido está a caminho”, “saiu para entrega” e “entregue”, com número de rastreamento, operadora, previsão de entrega e um URL de rastreamento com a sua marca.
- Dispare Canvas para envios parados ou erros de entrega, para que as equipes de suporte e retenção possam responder a chamados do tipo “onde está meu pedido?”.
- Promova reposição de produtos, avaliações ou produtos relacionados quando um pacote for entregue ou estiver prestes a chegar.
- Coloque usuários em um Canvas a partir do mesmo evento do Track by Loop e crie ramificações para e-mail, SMS ou push com base no status de inscrição.
Pré-requisitos
Antes de começar, você precisa do seguinte:
| Pré-requisito | Descrição |
|---|---|
| Uma conta Track by Loop | É necessário ter uma conta Track by Loop para essa integração. |
| Uma chave da API REST da Braze | Uma chave da API REST da Braze com as permissões campaigns.trigger.send, canvas.trigger.send ou ambas. Crie essa chave no dashboard da Braze em Configurações > APIs e identificadores > Chaves de API. Para saber mais, consulte Criação de chaves da API REST. |
| Um endpoint REST da Braze | O endpoint REST do seu espaço de trabalho (apenas a origem), por exemplo https://rest.iad-01.braze.com. O host deve corresponder ao seu cluster da Braze (*.braze.com ou *.braze.eu). Para saber mais, consulte Endpoints da REST API. |
Integração
Etapa 1: Criar Campaigns ou Canvas acionados por API na Braze
- Na Braze, crie uma Campaign ou um Canvas para cada momento de fulfillment em que você planeja enviar mensagens (por exemplo, Entregue).
- Defina a entrega como Acionada por API. Para saber mais, consulte Entrega acionada por API.
- Crie o texto da mensagem com personalização em Liquid para dados de pedido, rastreamento e consumidor, incluindo um deep link para a página de rastreamento. Faça referência às propriedades do disparo com
{{api_trigger_properties.${your_property}}}. - Copie o identificador de API dessa Campaign ou desse Canvas. Você vai inserir esse valor no Track by Loop em uma etapa posterior.
Etapa 2: Conectar as credenciais no Track by Loop
- No Track by Loop, acesse Settings > Integrations > Braze.
- Insira seu endpoint REST (apenas a origem), por exemplo
https://rest.iad-01.braze.com. - Cole sua chave da API REST.
- Selecione Save credentials.
Etapa 3: Mapear eventos de fulfillment
Em Event mappings, cada linha é um evento de fulfillment do Track by Loop. São os mesmos eventos que o Track by Loop usa em outras integrações de marketing.
Para cada evento:
- Selecione Campaign ou Canvas.
- Cole o identificador de API da Braze referente à Campaign ou ao Canvas que você criou.
- Salve a linha.
Personalização
Escolha uma Campaign ou um Canvas por evento
Use uma Campaign quando uma única mensagem for suficiente. Use um Canvas quando precisar de postergações, fallback de canal ou ramificações (por exemplo, enviar SMS se o consumidor não estiver inscrito para receber e-mails). O Track by Loop armazena um mapeamento por evento, que pode ser uma Campaign ou um Canvas.
Usando esta integração
O Track by Loop direciona cada evento a um único destinatário:
- Se houver um ID de cliente da Shopify, o Track by Loop define
external_user_idno objeto do destinatário com esse ID como string. Isso corresponde aos clientes que definem oexternal_idda Braze como o ID de cliente da Shopify. - Se não houver ID de cliente disponível, o Track by Loop define
emailno objeto do destinatário e usa a priorização de e-mail da Braze: primeirounidentifiede depoismost_recently_updated.
O consumidor já precisa ter um perfil na Braze que possa ser encontrado por esse identificador.
Teste a conexão
Na página de configurações da integração com a Braze no Track by Loop, envie um evento de teste para confirmar o mapeamento da sua campanha ou do seu Canvas.
- Em Test connection, selecione Campaign ou Canvas.
- Cole o identificador de API de uma campanha ou Canvas ativo e disparado por API.
- Insira um e-mail de destinatário de teste de um usuário da Braze que já exista e que possa receber mensagens nesse canal.
- Selecione Send test trigger.