Tealium
A Tealium é um hub de dados universal e uma plataforma de dados do cliente criada com EventStream, AudienceStream e iQ Tag Management que permite conectar dados móveis, da Web e de outros tipos de fontes de terceiros. A conexão do Tealium com o Braze permite um fluxo de dados de eventos personalizados, atributos de usuários e compras que o capacita a agir sobre seus dados em tempo real.
A integração do Braze e do Tealium permite rastrear seus usuários e encaminhar dados para vários provedores de análise de usuários. A Tealium permite que você:
- Sincronize o público do Tealium com o AudienceStream para o Braze para uso na personalização de campanhas e telas do Braze ou na criação de segmentos.
- Importar dados entre plataformas. A Braze oferece uma integração do SDK lado a lado para seus aplicativos para Android, iOS e Web e uma integração de servidor para servidor que pode ser usada em qualquer plataforma que possa relatar dados de eventos.
O Tealium EventStream é um hub de API e coleta de dados que fica no centro de seus dados. O EventStream lida com toda a cadeia de fornecimento de dados, desde a configuração e a instalação até a identificação, a validação e o aprimoramento dos dados de usuários recebidos. O EventStream realiza ações em tempo real com feeds e conectores de eventos. A seguir, estão os recursos que compõem o EventStream.
- Fontes de dados (instalação e coleta de dados)
- Eventos em tempo real (inspeção de dados em tempo real)
- Especificações e atribuições de eventos (requisitos e validação da camada de dados)
- Feeds de eventos (tipos de eventos filtrados)
- Conectores de eventos (ações do hub da API)
O Tealium AudienceStream é um mecanismo de segmentação de clientes omnicanal com atuação em tempo real. O AudienceStream utiliza os dados que fluem para o EventStream e cria perfis de visitantes que representam os atributos mais importantes do engajamento de seus clientes com sua marca. Consulte nosso artigo sobre o AudienceStream para obter as etapas de configuração.
O Tealium iQ permite disparar códigos em seus apps usando uma tag na interface de gerenciamento de tags do Tealium iQ. Essa tag coletará, controlará e fornecerá dados de eventos de plataformas móveis e da Web, permitindo que você configure uma implementação nativa do Braze sem adicionar código específico do Braze aos seus apps. Os usuários podem optar por integrar os comandos remotos móveis por meio do iQ Tag Management ou de arquivos de configuração JSON (abordagem recomendada da Tealium). Os usuários que usam o SDK para Web da Braze devem fazer a integração por meio da tag Web iQ.
Para saber mais sobre os prós e os contras de cada método, consulte a seguinte seção do gerenciador de tags Tealium iQ.
A Tealium oferece ações de conector em lote e sem lote. O conector sem lote deve ser usado quando as solicitações em tempo real forem importantes para o caso de uso e não houver preocupações quanto a atingir as especificações do limite de frequência da API do Braze. Entre em contato com suporte da Braze ou com seu gerente de sucesso do cliente se tiver alguma dúvida.
Para conectores em lote, as solicitações são colocadas em fila até que um dos seguintes limites seja atingido:
- Número máximo de solicitações: 75
- Tempo máximo desde a solicitação mais antiga: 10 minutos
- Tamanho máximo das solicitações: 1 MB
Por padrão, a Tealium não agrupa eventos de consentimento (preferências de inscrição) ou eventos de exclusão de usuários.
Pré-requisitos
| Requisito | Descrição |
|---|---|
| Conta Tealium | É necessário ter uma conta Tealium com acesso ao servidor e/ou ao lado do cliente para aproveitar essa parceria. |
| Código-fonte instalado e bibliotecas da fonte da Tealium | A origem de todos os dados enviados à Tealium, como apps móveis, sites ou servidores backend. É necessário instalar as bibliotecas em seu app, site ou servidor antes de poder configurar um conector Tealium com êxito. |
| Endpoint do Braze REST e do SDK | Seu URL do endpoint REST ou SDK. Seu endpoint dependerá da URL do Braze para sua instância. |
| Chave identificadora do app Braze (somente lado a lado) | A chave do identificador de seu app. Ela pode ser encontrada em Dashboard da Braze > Gerenciar configurações > Chave de API. |
| Versão do código (somente lado a lado) | Corresponde à versão do SDK e deve estar no formato major.minor (por exemplo, 3.2 e não 3.0.1). A versão do código deve ser 3.0 ou superior. |
| Chave da API REST (somente de servidor para servidor) | Uma chave da API REST da Braze com as permissões users.track e users.delete. Isso pode ser criado no Dashboard da Braze > Console de desenvolvedor > Chave da API REST > Criar nova chave de API. |
Escolha seu tipo de integração
| Integração | Informações |
|---|---|
| Lado a lado | Usa o SDK do Tealium para traduzir eventos em chamadas nativas do Braze, permitindo acesso a recursos mais profundos e uso mais abrangente do Braze do que a integração de servidor para servidor. Caso pretenda usar comandos remotos da Braze, observe que a Tealium não é compatível com todos os métodos da Braze (por exemplo, cartões de conteúdo). Para usar um método da Braze que não esteja mapeado por um comando remoto correspondente, será necessário invocar o método adicionando o código nativo da Braze à sua base de código. |
| De servidor para servidor | Encaminha dados do Tealium para os pontos de extremidade da API REST do Braze. Não oferece suporte aos recursos da interface do usuário do Braze, como envio de mensagens no app, cartões de conteúdo ou notificações por push. Também existem dados capturados automaticamente, como campos em nível de dispositivo, que não estão disponíveis por meio desse método. Considere uma integração lado a lado se quiser usar esses recursos. |
Integração lado a lado de SDK
Comandos remotos
Os comandos remotos são um recurso das bibliotecas Tealium para iOS e Android que permitem que você faça chamadas do SDK da Tealium - por meio dos servidores Braze - para o Braze. O módulo de comando remoto Braze instalará e criará automaticamente as bibliotecas Braze necessárias e cuidará de toda a renderização de mensagens e do rastreamento da análise de dados. Para usar o comando remoto móvel da Braze, você precisará das bibliotecas da Tealium instaladas nos seus apps.
A Tealium oferece duas maneiras de integrar o comando remoto móvel. Não há perda de funcionalidade entre os tipos de integração, e o código nativo subjacente é idêntico.
| Método de comando remoto móvel | Prós | Contras |
|---|---|---|
| Tag de comando remoto | Modifique facilmente os mapeamentos e os dados enviados ao comando remoto usando a interface do usuário do Tealium iQ. Isso nos permite enviar dados ou eventos adicionais a um SDK de terceiros depois que o aplicativo já estiver na loja de aplicativos, sem que o cliente precise atualizar o app. |
O módulo de gerenciamento de tags no app depende de uma visualização da Web oculta para processar JavaScript. |
| Arquivo de configuração JSON (Recomendado) |
O uso do método JSON elimina a necessidade de ter uma visualização da Web oculta no app e reduz muito o consumo de memória. O arquivo JSON pode ser hospedado de modo remoto, ou localmente no app do cliente. |
No momento, não há uma interface do usuário para gerenciar isso, então o processo é um pouco mais trabalhoso. Nota: A Tealium está trabalhando para adicionar uma interface de gerenciamento que resolverá esse problema e trará o mesmo nível de flexibilidade para os comandos remotos JSON que eles têm com a versão de gerenciamento do iQ Tag |
Use os mapeamentos de dados de comandos remotos do Braze mobile para definir atributos padrão de usuários e atributos personalizados e rastrear compras e eventos personalizados. Consulte a tabela a seguir para obter os métodos de Braze correspondentes.
| Comando remoto | Método Braze |
|---|---|
| atributo appendcustomarray | addToCustomAttributeArrayWithKey() |
| notificação por e-mail | setEmailNotificationSubscriptionType() |
| incrementcustomattribute | incrementCustomAttribute() |
| Initalizar | startWithApiKey() |
| logcustomevent | logCustomEvent() |
| logpurchase | logPurchase() |
| pushnotification | setPushNotificationSubscriptionType() |
| removeecustomattribute | setCustomAttributeWithKey() |
| setcustomattribute | setCustomAttributeArrayWithKey() |
| setcustomarrayattribute | setCustomAttributeArrayWithKey() |
| setlastknownlocation | setLastKnownLocationWithLatitude() |
| unsetcustomattribute | unsetCustomAttributeWithKey() |
| useralias | addAlias() |
| userattribute | ABKUser() |
| identificador de usuário | changeUser() |
Você pode encontrar mais detalhes sobre como configurar o comando remoto móvel do Braze e uma visão geral dos métodos suportados na documentação do desenvolvedor do Tealium:
Os comandos remotos móveis da Braze não são compatíveis com todos os métodos e canais de envio de mensagens da Braze (por exemplo, cartões de conteúdo). Para usar um método da Braze que não esteja mapeado por um comando remoto correspondente, será necessário invocar o método diretamente adicionando o código nativo da Braze à sua base de código.
Tag do SDK para Web da Braze
Use a tag Braze Web SDK para implantar o Braze Web SDK em seu site. O Tealium iQ Tag Management permite que os clientes adicionem a Braze como uma tag no dashboard da Tealium para rastrear a atividade dos visitantes. As tags são normalmente usadas por profissionais de marketing para entender a eficácia da publicidade on-line, do envio de e-mail marketing e da personalização de sites.
- Na Tealium, navegue até iQ > Tags > + Add Tag > Braze Web SDK (iQ > Tags> + Adicionar tag > SDK para Web da Braze).
- Na caixa de diálogo Configuração de tag, insira a Chave da API (sua chave de identificador do app Braze), o URL base (endpoint do SDK do Braze) e a versão do código do SDK do Braze Web. Também é possível ativar o registro para registrar informações no console da Web para fins de depuração.
- Na caixa de diálogo Load Rules (Regras de carregamento), escolha “Load on All Pages” (Carregar em todas as páginas) ou selecione Create Rule (Criar regra ) para determinar quando e onde carregar uma instância dessa tag em seu site.
- Na seção Mapeamentos de dados selecione Create Mappings (Criar mapeamentos) para mapear os dados do Tealium para o Braze. As variáveis de destinos para a tag Braze Web SDK são incorporadas à guia Data Mapping (Mapeamento de dados ) da tag. As tabelas a seguir listam as categorias de destinos disponíveis e descrevem cada nome de destino.
- Selecione Finish (Acabamento).
Recursos de integrações lado a lado
- Comando remoto do iOS: Documentação do Tealium, repositório GitHub do Tealium
- Comando remoto para Android: Documentação do Tealium, repositório GitHub do Tealium
- Tag do SDK para Web: Documentação da Tealium
Integração de servidor para servidor
Essa integração encaminha dados do Tealium para a API REST do Braze.
A integração servidor a servidor não oferece suporte aos recursos da interface do usuário do Braze, como envio de mensagens no app, cartões de conteúdo ou notificações por push. Também existem dados capturados automaticamente (como campos em nível de dispositivo) que não estão disponíveis por meio desse método.
Se quiser usar esses dados e recursos, considere nossa integração de SDK lado a lado.
Etapa 1: Configurar uma fonte
A Tealium exige que você configure primeiro uma fonte de dados válida para o conector.
- Na barra lateral da Tealium, em Server-Side (Lado do servidor), navegue até Sources > Data Sources > + Add Data Source (Origens > Origens de dados > + Adicionar fonte de dados).
- Localize a plataforma desejada nas categorias disponíveis e dê um nome à sua fonte; esse campo é obrigatório.
- Nas opções de Event Specifications (Especificações do evento ), escolha as especificações do evento que você gostaria de incluir. As especificações de eventos o ajudam a identificar os nomes dos eventos e as atribuições necessárias para rastreamento em sua instalação. Essas especificações serão aplicadas aos eventos recebidos.
Reserve algum tempo para pensar sobre quais dados são mais valiosos para você e quais especificações parecem mais apropriadas para o seu caso de uso. Também estão disponíveis especificações de eventos personalizados. - O próximo diálogo avança para a etapa Get Code. O código base e o código de rastreamento de eventos fornecidos aqui servem como guia de instalação. Baixe o PDF fornecido se quiser compartilhar essas instruções com sua equipe. Selecione Save & Continue quando terminar.
- Agora você poderá visualizar a fonte salva, bem como adicionar ou remover especificações de eventos.
Na visualização detalhada da fonte de dados, você pode executar as seguintes ações:- Visualizar e copiar a chave da fonte de dados
- Exibir instruções de instalação
- Retornar à página Obter código
- Adicionar ou remover especificações de eventos
- Navegue para visualizar eventos ao vivo relacionados a uma especificação de evento
- E mais…
- Por fim, selecione Save / Publish (Salvar / Publicar ) na parte superior da página. Se você não publicar sua fonte, não será possível encontrá-la ao configurar seu conector da Braze.
Consulte Fontes de dados para obter mais instruções sobre como configurar e editar sua fonte de dados.
Etapa 2: Criar um conector de eventos
Um conector é uma integração entre a Tealium e outro fornecedor usada para transmitir dados. Esses conectores contêm ações que representam as APIs suportadas por seus parceiros.
- Na barra lateral da Tealium, em Server-Side (Lado do servidor), navegue até EventStream > Event Connectors (EventStream > Conectores de evento).
- Selecione o botão azul + Add Connector (+ Adicionar conector) para examinar o marketplace de conectores. Na nova caixa de diálogo que aparece, use a busca por holofotes para encontrar o conector Braze.
- Para adicionar esse conector, clique no bloco do conector Braze. Em seguida, você verá o resumo da conexão e uma lista das informações necessárias, ações compatíveis e instruções de configuração. A configuração compreende três etapas: fonte, configuração e ação.
Origem
Depois que a fonte tiver sido configurada, volte à página do conector Braze em EventStream > Event Connectors > + Add Connector > Braze.
Em seguida, selecione a fonte de dados que você acabou de criar e, em Event Feed, selecione All Events (Todos os eventos) ou uma especificação de evento específica, a jornada recomendada para enviar apenas valores alterados para o Braze. Selecione Continuar.
Configuração
Em seguida, selecione Add Connector (Adicionar conector ) na parte inferior da página. Dê um nome ao seu conector e forneça seu endpoint da API do Braze e a chave da API REST do Braze aqui.
Se já tiver criado um conector anteriormente, você poderá usar um conector existente da lista de conectores disponíveis e modificá-lo para atender às suas necessidades com o ícone de lápis ou excluí-lo com o ícone de lixeira.
Ação
Em seguida, nomeie sua ação de conector e selecione um tipo de ação que enviará dados de acordo com o mapeamento a ser configurado. Aqui, você mapeará atribuições, eventos e compras do Braze para nomes de atributos, eventos e compras do Tealium.
Nem todos os campos oferecidos são obrigatórios.
Essa ação permite rastrear atributos de usuário, evento e compra, tudo em uma única ação.
| Parâmetros | Descrição |
|---|---|
| ID de usuário | Use esse campo para mapear o campo de ID do usuário do Tealium para seu equivalente no Braze. Mapeie uma ou mais atribuições de ID de usuário. Quando várias IDs são especificadas, o primeiro valor não em branco é escolhido com base na seguinte ordem de prioridade: ID externo, ID da Braze, nome do alias e etiqueta do alias. - A ID externa e a ID Braze não devem ser especificadas se estiver importando tokens por push. - Se estiver especificando um alias de usuário, o nome do alias e o rótulo do alias devem ser definidos. Para saber mais, confira o endpoint /users/track da Braze. |
| Atributos do usuário | Use os nomes de campo de perfil de usuário existentes no Braze para atualizar os valores de perfil de usuário no dashboard do Braze ou adicione seus próprios dados de atributos personalizados de usuário aos perfis de usuário. - Por padrão, novos usuários serão criados se não houver nenhum. - Ao definir Update Existing Only como true, somente os usuários existentes serão atualizados, e nenhum novo usuário será criado.- Se um atributo da Tealium estiver vazio, ele será convertido em nulo e removido do perfil de usuário da Braze. Os enriquecimentos devem ser usados se os valores nulos não devem ser enviados ao Braze para remover uma atribuição de usuário. |
| Modificar atributos do usuário | Use esse campo para incrementar ou decrementar certas atribuições do usuário - As atribuições de números inteiros podem ser incrementadas por números inteiros positivos ou negativos. - As atribuições das matrizes podem ser modificadas adicionando ou removendo valores das matrizes existentes. |
| Evento | Um evento representa uma única ocorrência de um evento personalizado por um usuário específico em um registro de data e hora. Use esse campo para rastrear e mapear atribuições de eventos como as do objeto de evento Braze. - O atributo de evento Name é necessário para cada evento mapeado.- O atributo de evento Time é automaticamente definido para a hora atual, a menos que seja explicitamente mapeado. - Por padrão, novos eventos serão criados se não houver nenhum. Ao definir Update Existing Only como true, somente os eventos existentes serão atualizados, e nenhum novo evento será criado.- Atribuições do tipo matriz de mapas para adicionar vários eventos. As atribuições do tipo matriz devem ter o mesmo comprimento. - Atributos de valor único podem ser usados e aplicados a cada evento. |
| Modelo de evento | Fornecer modelos de eventos a serem referenciados nos dados do corpo. Os modelos podem ser usados para transformar os dados antes de enviá-los ao Braze. Consulte o Guia de modelos da Tealium para saber mais. |
| Variável de modelo de evento | Forneça variáveis de modelo de evento como entrada de dados. Consulte o Guia de variáveis de modelo da Tealium para saber mais. |
| Compra | Use esse campo para rastrear e mapear as atribuições de compra do usuário, como as do objeto de compra Braze. - Os atributos de compra Product ID, Currency e Price são necessários para cada compra mapeada.- O atributo de compra Time é automaticamente definido para a hora atual, a menos que seja explicitamente mapeado.- Por padrão, novas compras serão criadas se não houver uma. Ao definir Update Existing Only como true, somente as compras existentes serão atualizadas, e nenhuma nova compra será criada.- Mapeie atribuições do tipo matriz para adicionar vários itens de compra. As atribuições do tipo matriz devem ter o mesmo comprimento. - Os atributos de valor único podem ser usados e se aplicarão a cada item. |
| Modelo de compra | Os modelos podem ser usados para transformar os dados antes de serem enviados ao Braze. - Defina um modelo de compra se você precisar de suporte a objetos aninhados. - Quando um modelo de compra é definido, a configuração definida na seção de compras da sua ação será ignorada. - Consulte o Guia de modelos da Tealium para saber mais. |
| Variável do modelo de compra | Forneça variáveis de modelo de produto como entrada de dados. Consulte o Guia de variáveis de modelo da Tealium para saber mais. |
Essa ação permite excluir usuários do dashboard do Braze.
| Parâmetros | Descrição |
|---|---|
| ID de usuário | Use esse campo para mapear o campo de ID de usuário do Tealium para seu equivalente no Braze. - Mapeie uma ou mais atribuições de ID de usuário. Quando várias IDs são especificadas, o primeiro valor não em branco é escolhido com base na seguinte ordem de prioridade: ID externo, ID da Braze, nome do alias e etiqueta do alias. - Ao especificar um alias de usuário, o nome do alias e a etiqueta do alias devem ser definidos. Para saber mais, consulte o endpoint /users/delete da Braze. |
Se quiser modificar as opções escolhidas, selecione Back (Voltar ) para editar ou Finish (Concluir ) para concluir.
Selecione Continuar.
Seu conector agora é exibido na lista de conectores na página inicial da Tealium. 
Certifique-se de selecionar Salvar / Publicar para seu conector quando terminar. As ações que você configurou passarão a ser acionadas quando as conexões do gatilho forem atendidas.
Etapa 3: Teste seu conector Tealium
Depois que o conector estiver instalado e funcionando, teste-o para garantir que esteja funcionando corretamente. A maneira mais simples de testar isso é usar a Tealium Trace Tool. Para começar a usar o Trace, confirme se adicionou a extensão de navegador Tealium Tools.
- Para iniciar um novo rastreamento, selecione Trace (Rastreamento) na barra lateral, em opções Server-Side. Selecione Iniciar e capture a ID do rastreamento.
- Abra a extensão do navegador e insira a ID do rastreamento no AudienceStream Trace.
- Examine o registro em tempo real.
- Verifique a ação que deseja validar selecionando a entrada Ações disparadas para expandir.
- Procure a ação que deseja validar e visualize o status do registro.
Consulte a documentação de rastreamento da Tealium para obter instruções mais detalhadas sobre a implementação da ferramenta de rastreamento da Tealium.
Demonstração da integração
Potenciais excedentes de pontos de dados
Há três maneiras principais de registrar acidentalmente pontos de dados desnecessários ao integrar o Braze por meio do Tealium:
Envio de dados duplicados - envie apenas deltas Braze de atribuições
O Tealium não envia deltas Braze de atribuições do usuário. Por exemplo, se você tiver uma ação EventStream que rastreia o nome, o e-mail e o número de telefone celular de um usuário, a Tealium enviará os três atributos à Braze sempre que a ação for disparada. A Tealium não procurará o que mudou ou foi atualizado e enviará apenas essas informações.
Solução:
Você pode verificar seu backend para avaliar se uma atribuição foi alterada ou não e, em caso afirmativo, chamar os métodos relevantes do Tealium para atualizar o perfil do usuário. Isso é o que os usuários que integram o Braze diretamente costumam fazer.
OU
Caso não armazene sua própria versão de um perfil de usuário no seu backend e não tenha como saber se os atributos mudam ou não, será possível usar p AudienceStream e
criar enriquecimentos para enviar atribuições do usuário somente quando os valores forem alterados. Consulte a documentação do Tealium sobre regras de enriquecimento.
Envio de dados irrelevantes ou substituição desnecessária de dados
Se você tiver vários EventStream que direcionam o mesmo feed de eventos, todas as ações ativadas para esse conector serão disparadas automaticamente sempre que uma única ação for disparada. Isso também pode fazer com que os dados sejam sobrescritos no Braze e registrar pontos de dados desnecessários.
Solução:
Configure uma especificação de evento ou feed separado para rastrear cada ação.
OU
Desative as ações (ou conectores) que você não deseja disparar usando os botões de alternância no dashboard do Tealium.
Inicialização do Braze muito cedo
Os usuários que se integram à Tealium usando a tag SDK para Web da Braze podem observar um aumento drástico no MAU. Se for inicializada no carregamento da página, a Braze criará um perfil anônimo sempre que um usuário da Web navegar no site pela primeira vez. Alguns podem querer rastrear o comportamento do usuário somente quando ele tiver concluído alguma ação, como “feito login” ou “assistido a um vídeo”, para reduzir a contagem de MAU.
Solução:
Configure regras de carregamento para determinar exatamente quando e onde uma tag é carregada em seu site.
Editar esta página no GitHub