DocumentaçãoExperience PlatformTags

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

Last update: Thu Dec 07 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Developer

Braze O é uma plataforma de engajamento do cliente que promove interações centradas no cliente entre consumidores e marcas em tempo real. Usar 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 variável Braze Track Events API encaminhamento de eventos permite que você aproveite os dados capturados na Rede de borda da Adobe Experience Platform e os envie para Braze na forma de eventos do lado do servidor usando o Braze User Track API.

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 um encaminhamento de eventos regra.

Casos de uso

Essa extensão deve ser usada se você quiser usar dados da Rede de borda no Braze para aproveitar os recursos de análise e direcionamento do cliente.

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. Uso de vários tag regras, esses dados são enviados para a Rede de borda em tempo real. A partir daqui, o Braze a extensão de encaminhamento de eventos envia automaticamente eventos relevantes para o Braze do lado do servidor.

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

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

Você deve ter um Braze para utilizar as 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 inicie o processo de criação de conta.

Medidas de proteção de API

A extensão usa dois de BrazeAs APIs do 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 guia em Braze Limites da API para obter mais informações sobre os limites que impõem.

Pontos de dados faturáveis

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

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

Para conectar a rede de borda ao Braze, as seguintes entradas são necessárias:

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

Criar um segredo

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

Instale e configure o Braze extensão install

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

Selecionar Extensões no painel de navegação esquerdo. No Catálogo selecione Instalar no cartão para o Braze extensão.

Instale o Braze extensão.

Na tela seguinte, insira valores de configuração que você coletou anteriormente Braze:

  • URL de Ponto de Extremidade Rest Brasileiro: Você pode inserir o valor de seu Braze rest endpoint URL como texto sem formatação na entrada fornecida.
  • Chave de API: selecione a variável elemento de dados secreto que você criou anteriormente, e que contém seu Braze Chave da API.

Selecione Salvar ao concluir.

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

Criar um Send Event regra tracking-rule

Depois de instalar a extensão, crie um novo encaminhamento de eventos regra e configure suas condições conforme desejado. Ao configurar as ações para a regra, selecione a variável Braze e selecione Enviar evento para o tipo de ação.

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

Identificação do 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 convenção de nomenclatura de ID de usuário sugerida.
ID de usuário do Braze
Identificador de usuário brasileiro.
Alias do 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 a ID de usuário externo ou o campo Identificador de usuário brasileiro ou a variável Alias do usuário seção.

Dados do evento

Entrada
Descrição
Obrigatório
Nome do evento ​
Nome do evento.
Sim
Hora do Evento
Data e hora como string em ISO 8601 ou em yyyy-MM-dd'T'HH:mm:ss:SSSZ formato.
Sim
Identificador do aplicativo
O Identificador do 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 o Tipos de identificador de API.
​ Propriedades do evento
Um objeto JSON que contém propriedades personalizadas do evento.
NOTE
A variável Evento de envio do Braze uma ação requer somente um Nome do evento e Hora do Evento para ser especificado, mas você deve incluir o máximo de informações possível no campo de propriedades personalizadas. Para obter detalhes sobre a Braze objeto de evento, consulte o documentação oficial.

Atributos do 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
Sexo
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 sequência de caracteres em ISO-3166-1 alfa-2 formato.
Idioma
Idioma como uma cadeia de caracteres em ISO-639-1 formato.
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 de 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 um Send Purchase Event regra purchase-rule

Depois de instalar a extensão, crie um novo encaminhamento de eventos regra e configure suas condições conforme desejado. Ao configurar as ações para a regra, selecione a variável Braze e selecione Enviar evento de compra para o tipo de ação.

Adicione uma configuração de ação de regra de encaminhamento de eventos do tipo de ação Desenvolver compra.

Identificação do 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 convenção de nomenclatura de ID de usuário sugerida.
ID de usuário do Braze
Identificador de usuário brasileiro.
Alias do 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 a ID de usuário externo , a variável Identificador de usuário brasileiro ou o campo Alias do usuário seção.

Dados de compra

Entrada
Descrição
Obrigatório
​ da ID do produto
Identificador da compra. (por exemplo, Nome do produto ou Categoria do produto)
Sim
Tempo de Compra
Data e hora como string em ISO 8601 ou em yyyy-MM-dd'T'HH:mm:ss:SSSZ formato.
Sim
​ de moeda
Moeda como sequência de caracteres em ISO 4217 Formato alfabético de código monetário.
Sim
​ de 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 do 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 o Tipos de identificador de API.
Propriedades de compra ​
Um objeto JSON que contém propriedades personalizadas da compra.
NOTE
A variável Evento de envio do Braze uma ação requer somente um Nome do evento e Hora do Evento para ser especificado, mas você deve incluir o máximo de informações possível no campo de propriedades personalizadas. Para obter detalhes sobre a Braze objeto de evento, consulte o documentação oficial.

Atributos do 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
Sexo
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 sequência de caracteres em ISO-3166-1 alfa-2 formato.
Idioma
Idioma como uma cadeia de caracteres em ISO-639-1 formato.
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 de 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 no Braze validate

Se a coleção de eventos e a Adobe Experience Platform integração foram bem-sucedidas, você verá eventos no Braze console quando exibição de perfis de usuário. Especificamente, os novos dados do evento enviados para o Braze é refletida na variável Purchases de um usuário específico guia visão geral.

Próximas etapas

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

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

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