Snowplow
A Snowplow é uma plataforma dimensionável e de código aberto para coleta de dados avançados, de alta qualidade e de baixa latência. A Snowplow foi projetada para coletar dados comportamentais completos e de alta qualidade para empresas.
Essa integração é mantida pela Snowplow.
Sobre a integração
A integração entre a Braze e o Snowplow permite encaminhar eventos do Snowplow para a Braze em tempo real usando a solução de encaminhamento de eventos (Event Forwarding) do Snowplow. Essa integração permite enviar eventos para a Braze com flexibilidade e controle. Especificamente, você pode:
- Filtrar e transformar eventos antes de enviá-los para a Braze.
- Mapear dados de eventos do Snowplow para atributos de usuário, eventos personalizados e compras na Braze.
- Manter todos os dados na sua nuvem privada até que você decida encaminhá-los.
- Implantar a solução por conta própria na sua conta existente do Snowplow na nuvem.
O Event Forwarding do Snowplow é um recurso complementar pago disponível para clientes do Snowplow. Para encaminhar eventos para a Braze sem esse complemento, use a integração do Snowplow com o Google Tag Manager Server-Side.
Alavanque os dados comportamentais avançados do Snowplow para impulsionar interações centradas no cliente na Braze e entregar mensagens personalizadas em tempo real.
Pré-requisitos
| Requisito | Descrição |
|---|---|
| Pipeline do Snowplow | Você precisa ter um pipeline do Snowplow em execução. |
| Acesso ao Snowplow Console | Você deve ter acesso ao Snowplow Console para configurar encaminhadores de eventos. |
| Chave da API REST da Braze | Uma chave da API REST da Braze com as seguintes permissões: users.track, users.alias.new, users.identify, users.export.ids, users.merge, users.external_ids.rename e users.alias.update. Você pode criar essa chave no dashboard da Braze em Configurações > Chaves de API. |
| Endpoint REST da Braze | URL do seu endpoint REST. Seu endpoint depende da URL da Braze para a sua instância. |
Casos de uso
Entrega personalizada baseada em ação
Use qualquer um dos diversos eventos avançados que o Snowplow coleta por padrão, ou defina seus eventos personalizados para criar jornadas do cliente ainda mais detalhadas que façam sentido para o seu negócio. Aproveite os dados comportamentais avançados do Snowplow para projetar funis de clientes e gerar valor para suas equipes de marketing e produto, ajudando-as a maximizar a conversão e o uso do produto por meio da Braze.
Segmentação dinâmica
Crie públicos dinâmicos na Braze com base nos dados comportamentais de alta qualidade do Snowplow: conforme os usuários realizam ações no seu produto, app ou website, você pode aproveitar os dados comportamentais em tempo real que o Snowplow coleta para adicionar ou remover automaticamente usuários de Segments relevantes na Braze.
Integração
Etapa 1: Configurar o destino no Snowplow Console
Para criar o encaminhador de eventos:
- No Snowplow Console, navegue até Destinations e selecione Create new destination.
- Ao configurar a conexão, selecione Braze como tipo de conexão.
- Insira sua chave de API da Braze e o endpoint da REST API.
- Salve a conexão.
Etapa 2: Configurar o encaminhador de eventos
Ao configurar o encaminhador, você pode escolher quais eventos do Snowplow encaminhar e mapeá-los para tipos de objetos da Braze:
- Atributos do usuário: Atualize dados do perfil de usuário e propriedades personalizadas do usuário.
- Eventos personalizados: Envie ações e comportamentos de usuários.
- Compras: Envie dados de transação com detalhes do produto.
Para cada tipo de objeto, você pode configurar mapeamentos de campos para especificar como os dados de eventos do Snowplow são mapeados para os campos da Braze. Consulte a documentação de criação de encaminhadores do Snowplow para instruções detalhadas de configuração e mapeamento de campos.
Etapa 3: Validar a integração
Confirme que os eventos estão chegando à Braze verificando as seguintes páginas na sua conta da Braze:
- Query Builder: Na Braze, navegue até Analytics > Query Builder. Você pode escrever consultas nas seguintes tabelas para visualizar os dados encaminhados do Snowplow:
USER_BEHAVIORS_CUSTOMEVENT_SHAREDeUSERS_BEHAVIORS_PURCHASE_SHARED. - Dashboard de uso da API: Na Braze, navegue até Configurações > APIs e identificadores para ver um gráfico de uso da API ao longo do tempo. Você pode filtrar especificamente pela chave de API que o Snowplow utiliza e ver tanto os sucessos quanto as falhas.
Enviando propriedades personalizadas
Você pode enviar propriedades personalizadas além dos campos padrão. A estrutura depende de qual tipo de objeto da Braze você está usando:
- Atributos de usuário: Adicione como campos de nível superior (por exemplo,
subscription_tier,loyalty_points) - Propriedades de evento: Aninhe dentro do objeto
properties(por exemplo,properties.plan_type,properties.feature_flag) - Propriedades de compra: Aninhe dentro do objeto
properties(por exemplo,properties.color,properties.size)
Para nomes de propriedades que contêm espaços, use a notação de colchetes (por exemplo, ["account type"] ou properties["campaign source"]).
Consulte a documentação do objeto de evento para mais detalhes sobre tipos de dados compatíveis, requisitos de nomenclatura de propriedades e limites de tamanho da carga útil.
Limitações
Limites de frequência: a Braze aplica um limite de frequência de 3.000 chamadas de API a cada três segundos para a API de rastreamento de usuários. Como o Snowplow não oferece suporte a envio em lote para encaminhadores de eventos, esse limite de frequência da API também funciona como limite de frequência de eventos. Se a taxa de entrada exceder 3.000 eventos a cada três segundos, você poderá enfrentar um aumento na latência.