Extensão de encaminhamento de eventos da Braze Track Events API

Braze é uma plataforma de envolvimento do cliente que possibilita interações centradas no cliente entre consumidores e marcas em tempo real. Usando o Braze, você pode fazer o seguinte:

  • Forneça dados (como mensagens de marketing) para usuários direcionados com base em sua preferência de idioma, preferência de local e muito mais, para aumentar as taxas de conversão e oferecer suporte às principais metas de negócios.
  • Envie mensagens personalizadas aos clientes por vários canais, incluindo email, notificações por push e mensagens no aplicativo, na hora certa e nos idiomas de sua preferência.
  • Direcione usuários específicos para campanhas de marketing e promocionais para aumentar o número de clientes recorrentes.
  • Estudar o comportamento e os padrões do usuário para direcionar públicos específicos com mensagens personalizadas, o que pode ajudar a aumentar a receita.

A extensão Braze Track Events API encaminhamento de eventos permite aproveitar os dados capturados no Edge Network do Adobe Experience Platform e enviá-los para Braze na forma de eventos do lado do servidor usando a API Braze User Track.

Este documento aborda os casos de uso da extensão, como instalá-la nas bibliotecas de encaminhamento de eventos e como empregar seus recursos em uma regra de encaminhamento de eventos.

Casos de uso

Essa extensão deve ser usada se você quiser usar dados do Edge Network em Braze para aproveitar seus recursos de análise e direcionamento de clientes.

Por exemplo, considere uma organização de varejo que tenha uma presença multicanal (site e celular) e esteja capturando entradas transacionais ou conversacionais como dados do evento do site e das plataformas móveis. Usando várias regras de tag, esses dados são enviados para o Edge Network em tempo real. Daqui, a extensão de encaminhamento de eventos do Braze envia automaticamente eventos relevantes do lado do servidor para o Braze.

Depois que os dados forem enviados, as equipes de análise da organização poderão aproveitar os recursos do Braze’s para processar os conjuntos de dados e obter insights comerciais para gerar gráficos, painéis ou outras visualizações para informar as partes interessadas. Consulte a página Braze clientes para obter mais detalhes sobre os vários casos de uso da plataforma.

Braze pré-requisitos e medidas de proteção prerequisites

É necessário ter uma conta Braze para usar suas tecnologias. Se você não tiver uma conta, navegue até a Página Introdução em Braze para se conectar a Braze Sales e iniciar o processo de criação da conta.

Medidas de proteção de API

A extensão usa duas APIs de Braze e seus limites são descritos abaixo:

API
Limites de taxa
User Track
50.000 solicitações por minuto
Consulte a User Track documentação da API para obter detalhes.
User Identify
20.000 solicitações por minuto
Consulte a User Identify documentação da API para obter detalhes.
NOTE
Consulte o manual sobre Braze limites de API para obter mais detalhes sobre os limites impostos.

Pontos de dados faturáveis

Enviar atributos personalizados adicionais para Braze pode aumentar seu consumo de ponto de dados de Braze. Consulte seu gerente de conta do Braze antes de enviar outros atributos personalizados. Consulte a documentação Braze em pontos de dados faturáveis para obter mais informações.

Coletar detalhes de configuração necessários configuration-details

Para conectar o Edge Network a Braze, as seguintes entradas são necessárias:

Tipo de chave
Descrição
Exemplo
Braze Instância
O ponto de extremidade REST associado à conta Braze. Consulte a documentação Braze em instâncias para obter orientação.
https://rest.iad-03.braze.com
Chave de API
A Chave de API Braze associada à conta Braze.
Consulte a documentação Braze sobre a chave da API REST para obter orientação.
YOUR-BRAZE-REST-API-KEY

Criar um segredo

Crie um novo segredo de encaminhamento de eventos e defina o valor para sua Braze Chave de API. Ele será usado para autenticar a conexão com sua conta, mantendo o valor seguro.

Instalar e configurar a extensão Braze install

Para instalar a extensão, crie uma propriedade de encaminhamento de eventos ou escolha uma propriedade existente para editar.

Selecione Extensões na navegação à esquerda. Na guia Catálogo, selecione Instalar no cartão para a extensão Braze.

Instalar a extensão Braze.

Na próxima tela, insira os valores de configuração a seguir, coletados anteriormente de Braze:

  • Resumir URL do Ponto de Extremidade: Você pode inserir o valor da sua URL do ponto de extremidade Braze como texto sem formatação na entrada fornecida.
  • Chave de API: selecione o elemento de dados secreto criado anteriormente, que contém sua chave de API Braze.

Selecione Salvar ao concluir.

A página de configuração de extensão Braze.

Criar uma regra Send Event tracking-rule

Após instalar a extensão, crie uma nova regra para o encaminhamento de eventos e configure suas condições conforme desejado. Ao configurar as ações para a regra, selecione a extensão Braze e selecione Enviar evento para o tipo de ação.

Adicionar uma configuração de ação de regra de encaminhamento de eventos.

Identificação de usuário

Entrada
Descrição
ID de Usuário Externo
UUID ou GUID longo, aleatório e bem distribuído. Se você escolher um método diferente para nomear suas IDs de usuário, elas também deverão ser longas, aleatórias e bem distribuídas. Saiba mais sobre a convenção de nomenclatura de ID de usuário sugerida.
Braze ID de Usuário
Identificador de usuário brasileiro.
Alias de usuário
Um alias serve como um identificador de usuário exclusivo alternativo. Use aliases para identificar usuários em dimensões diferentes da ID de usuário principal.

O objeto alias do usuário consiste em duas partes: um alias_name para o próprio identificador e um alias_label indicando o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas somente um alias_name por alias_label.
NOTE
Para vincular o evento a um usuário, é necessário preencher o campo ID de Usuário Externo, o campo Identificador de Usuário Brasileiro ou a seção Alias de Usuário.

Dados do evento

Entrada
Descrição
Obrigatório
Nome do Evento ​
Nome do evento.
Sim
Hora do Evento
Data e hora como cadeia de caracteres no formato ISO 8601 ou yyyy-MM-dd'T'HH:mm:ss:SSSZ.
Sim
Identificador do aplicativo
O Identificador de Aplicativo ou app_id é um parâmetro que associa uma atividade a um aplicativo específico no seu grupo de aplicativos. Ele designa com qual aplicativo do grupo de aplicativos você está interagindo. Saiba mais sobre os tipos de identificador de API.
Propriedades do Evento ​
Um objeto JSON que contém propriedades personalizadas do evento.
NOTE
A ação Enviar Evento do Brasil exige que apenas um Nome do Evento e um Horário do Evento sejam especificados, mas você deve incluir o máximo possível de informações no campo de propriedades personalizadas. Para obter detalhes sobre o objeto de evento Braze, consulte a documentação oficial.

Atributos de usuário

Os atributos do usuário podem ser um objeto JSON que contém campos que criarão ou atualizarão um atributo com o nome e o valor fornecidos no perfil do usuário especificado. As seguintes propriedades são compatíveis:

Atributo do usuário
Descrição
Nome
Sobrenome
Telefone
Email
Gênero
Uma das seguintes sequências de caracteres: "M", "F", "O" (outro), "N" (não aplicável), "P" (prefere não dizer).
Cidade
Country
País como uma cadeia de caracteres no formato ISO-3166-1 alpha-2.
Idioma
Idioma como uma cadeia de caracteres no formato ISO-639-1.
Data de nascimento
Sequência de caracteres no formato "AAAA-MM-DD" (por exemplo, 1980-12-21).
Fuso Horário
Nome do fuso horário do Banco de Dados de Fuso Horário IANA (por exemplo, 'América/Nova_York' ou 'Hora do Leste (EUA e Canadá)').
Facebook
Hash que contém qualquer um de id (cadeia de caracteres), curtidas (matriz de cadeias de caracteres), num_friends (inteiro).
Twitter
Hash que contém qualquer um de id (inteiro), screen_name (sequência de caracteres, identificador de Twitter), seguidores_count (inteiro), friends_count (inteiro), statuses_count(inteiro).

Criar uma regra Send Purchase Event purchase-rule

Após instalar a extensão, crie uma nova regra para o encaminhamento de eventos e configure suas condições conforme desejado. Ao configurar as ações para a regra, selecione a extensão Braze e selecione Enviar Evento de Compra para o tipo de ação.

Adicionar uma configuração de ação de regra de encaminhamento de eventos do tipo de ação de compra brasileira.

Identificação de usuário

Entrada
Descrição
ID de Usuário Externo
UUID ou GUID longo, aleatório e bem distribuído. Se você escolher um método diferente para nomear suas IDs de usuário, elas também deverão ser longas, aleatórias e bem distribuídas. Saiba mais sobre a convenção de nomenclatura de ID de usuário sugerida.
Braze ID de Usuário
Identificador de usuário brasileiro.
Alias de usuário
Um alias serve como um identificador de usuário exclusivo alternativo. Use aliases para identificar usuários em dimensões diferentes da ID de usuário principal.

O objeto alias do usuário consiste em duas partes: um alias_name para o próprio identificador e um alias_label indicando o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas somente um alias_name por alias_label.
NOTE
Para vincular o evento a um usuário, você deve concluir o campo ID de Usuário Externo, o campo Identificador de Usuário Brasileiro ou a seção Alias de Usuário.

Dados de compra

Entrada
Descrição
Obrigatório
ID do produto ​
Identificador da compra. (por exemplo, Nome do produto ou Categoria do produto)
Sim
Tempo de Compra
Data e hora como cadeia de caracteres no formato ISO 8601 ou yyyy-MM-dd'T'HH:mm:ss:SSSZ.
Sim
Moeda ​
Moeda como cadeia de caracteres no formato de Código de Moeda Alfabético ISO 4217.
Sim
Preço ​
Preço.
Sim
Quantidade ​
Se não for fornecido, o valor padrão será 1. O valor máximo deve ser inferior a 100.
Identificador do aplicativo
O Identificador de Aplicativo ou app_id é um parâmetro que associa uma atividade a um aplicativo específico no seu grupo de aplicativos. Ele designa com qual aplicativo do grupo de aplicativos você está interagindo. Saiba mais sobre os tipos de identificador de API.
Comprar Propriedades ​
Um objeto JSON que contém propriedades personalizadas da compra.
NOTE
A ação Enviar Evento do Brasil exige que apenas um Nome do Evento e Tempo do Evento sejam especificados, mas você deve incluir o máximo possível de informações no campo de propriedades personalizadas. Para obter detalhes sobre o objeto de evento Braze, consulte a documentação oficial.

Atributos de usuário

Os atributos do usuário podem ser um objeto JSON que contém campos que criarão ou atualizarão um atributo com o nome e o valor fornecidos no perfil do usuário especificado. As seguintes propriedades são compatíveis:

Atributo do usuário
Descrição
Nome
Sobrenome
Telefone
Email
Gênero
Uma das seguintes sequências de caracteres: "M", "F", "O" (outro), "N" (não aplicável), "P" (prefere não dizer).
Cidade
Country
País como uma cadeia de caracteres no formato ISO-3166-1 alpha-2.
Idioma
Idioma como uma cadeia de caracteres no formato ISO-639-1.
Data de nascimento
Sequência de caracteres no formato "AAAA-MM-DD" (por exemplo, 1980-12-21).
Fuso Horário
Nome do fuso horário do Banco de Dados de Fuso Horário IANA (por exemplo, 'América/Nova_York' ou 'Hora do Leste (EUA e Canadá)').
Facebook
Hash que contém qualquer um de id (cadeia de caracteres), curtidas (matriz de cadeias de caracteres), num_friends (inteiro).
Twitter
Hash que contém qualquer um de id (inteiro), screen_name (sequência de caracteres, identificador de Twitter), seguidores_count (inteiro), friends_count (inteiro), statuses_count(inteiro).

Validar dados em Braze validate

Se a coleção de eventos e a integração do Adobe Experience Platform tiverem sido bem-sucedidas, você verá eventos no console do Braze ao exibir perfis de usuário. Especificamente, os novos dados do evento enviados para Braze são refletidos na seção Purchases da guia de visão geral de um usuário específico.

Próximas etapas

Este guia abordou como enviar eventos de conversão para Braze usando o encaminhamento de eventos. Para obter mais detalhes sobre aplicativos downstream para dados de eventos enviados para Braze, consulte a documentação oficial.

Para obter mais informações sobre os recursos de encaminhamento de eventos do Experience Platform, consulte a visão geral do encaminhamento de eventos.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743