Snowplow

O Snowplow é uma plataforma dimensionável para coleta de dados avançados, de alta qualidade e de baixa latência. O Snowplow foi projetado 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 o Braze e o Snowplow o capacita a encaminhar eventos do Snowplow para o Braze em tempo real usando a solução Event Forwarding do Snowplow. Essa integração permite que você envie eventos para o Braze, oferecendo flexibilidade e controle. Especificamente, você pode:

• Filtrar e transformar eventos antes de enviá-los ao Braze.
• Mapeie os dados de eventos do Snowplow para atributos de usuários, eventos personalizados e compras do Braze.
• Mantenha todos os dados em sua nuvem privada até que você decida encaminhá-los.
• Implante você mesmo a solução em sua conta de nuvem Snowplow existente.

O encaminhamento de eventos da Snowplow é um recurso complementar pago disponível para os clientes da Snowplow. Para encaminhar eventos para o Braze sem esse complemento, use a integração lado a lado do servidor do Google Tag Manager do Snowplow.

Aproveite os ricos dados de comportamento da Snowplow para promover interações poderosas centradas no cliente no Braze e enviar mensagens personalizadas em tempo real.

Pré-requisitos

Requisito	Descrição
Pipeline da Snowplow	Você precisa de um pipeline de Snowplow em funcionamento.
Acesso ao console do Snowplow	Você deve ter acesso ao Console do Snowplow para configurar os encaminhadores de eventos.
Chave da API REST do Braze	Uma chave da API REST do 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 isso no dashboard do Braze em Configurações > Chaves de API.
Endpoint REST do Braze	Sua URL de endpoint REST. Seu endpoint depende do URL do Braze para sua instância.

Casos de uso

Entrega personalizada e baseada em ação

Use qualquer um dos inúmeros eventos avançados que a Snowplow coleta por padrão ou defina seus eventos personalizados para moldar jornadas de clientes ainda mais granulares que façam sentido para sua empresa. Aproveite os ricos dados de comportamento da Snowplow para projetar funis de clientes e liberar valor para suas equipes de marketing e de produtos, ajudando-as a maximizar a conversão e o uso do produto por meio do Braze.

Segmentação dinâmica

Crie públicos dinâmicos no Braze com base nos dados comportamentais de alta qualidade da Snowplow: À medida que os usuários realizam ações em seu produto, app ou site, é possível aproveitar os dados de comportamento em tempo real coletados pela Snowplow para adicionar ou remover automaticamente usuários de segmentos relevantes no Braze.

Integração

Etapa 1: Configure o destino no console do Snowplow

Para criar o encaminhador de eventos:

1. No Console do Snowplow, navegue até Destinos e selecione Criar novo destino.
2. Ao configurar a conexão, selecione Braze para o tipo de conexão.
3. Digite sua chave de API do Braze e o ponto de extremidade da API REST.
4. 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 os tipos de objetos do Braze:

1. Atribuições do usuário: Atualize os dados do perfil do usuário e as propriedades personalizadas do usuário.
2. Eventos personalizados: Envie ações e comportamentos do usuário.
3. Compras: Enviar dados de transação com detalhes do produto.

Para cada tipo de objeto, você pode configurar mapeamentos de campo para especificar como os dados de eventos do Snowplow são mapeados para os campos do Braze. Consulte a documentação do Creating forwarders do Snowplow para obter instruções detalhadas de instalação e configuração de mapeamento de campo.

Etapa 3: Validar a integração

Confirme se os eventos estão chegando ao Braze verificando as seguintes páginas em sua conta Braze:

1. Criador de consultas: No Braze, navegue até Análise de dados > Query Builder. Você pode escrever consultas nas tabelas a seguir para ter uma prévia dos dados encaminhados pela Snowplow: USER_BEHAVIORS_CUSTOMEVENT_SHARED e USERS_BEHAVIORS_PURCHASE_SHARED.
2. Dashboard de uso da API: No Braze, navegue até Configurações > APIs e Identificadores para ver um gráfico do uso da API ao longo do tempo. Você pode filtrar especificamente a chave de API que a Snowplow usa e ver os sucessos e os fracassos.

Envio de propriedades personalizadas

Você pode enviar propriedades personalizadas além dos campos padrão. A estrutura depende do tipo de objeto Braze que você está usando:

• Atribuições do usuário: Adicione como campos de nível superior (por exemplo, subscription_tier, loyalty_points)
• Propriedades do evento: Aninhar-se no objeto properties (por exemplo, properties.plan_type, properties.feature_flag)
• Propriedades de compra: Aninhar-se no objeto properties (por exemplo, properties.color, properties.size)

Para nomes de propriedades que contenham espaços, use a notação de colchetes (por exemplo, ["account type"] ou properties["campaign source"]).

Consulte a documentação do Event Object para obter detalhes sobre os tipos de dados suportados, os requisitos de nomenclatura de propriedades e os limites de tamanho da carga útil.

Limitações

Limites de frequência: O Braze impõe 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 lotes para encaminhadores de eventos, esse limite de frequência da API também funciona como o limite de frequência do evento. Se a taxa de transferência de entrada exceder 3.000 eventos por três segundos, a latência poderá aumentar.