Pipes de Eventos

Nossos Pipes de Eventos são usados para coletar dados de todos os produtos em nossa plataforma. Você pode usar este recurso para acompanhar tudo o que pode causar um evento na BMS, desde campanhas até a criação de uma organização, permitindo que você organize os dados fornecidos como desejar.

Todos os pipes de eventos criados serão enviados para um Event Store ou você pode usar um webhook para enviar esses dados diretamente para sua ferramenta de gerenciamento de dados. Fornecemos modelos para cada evento que podemos rastrear, para que você possa escolher de qual deseja coletar dados.

Temos uma solução que pode ajudá-lo a entender como um webhook funciona. Confira este artigo aqui.

Criando um Pipe de Eventos

Para criar um pipe de eventos, clique em Create Event Pipe, e uma tela de criação aparecerá.

Criação de Pipe de Eventos
  • Nome: Defina um nome para seu Pipe de Eventos.

  • Tags: Crie tags para identificar melhor cada pipe de eventos.

Filtros

Para começar a configurar seu pipe de eventos, escolha um modelo de sua preferência na nossa aba Filtros, de acordo com suas necessidades.

  • Modelo de Evento de Amostra: Neste menu suspenso, serão fornecidos todos os modelos relacionados aos eventos que podemos rastrear.

Neste exemplo, criaremos um pipe de eventos para ADS - Delivered. Este evento rastreia cada Anúncio que está atualmente em uma campanha e entregando impressões. Uma vez que criarmos este pipe de eventos, todos os dados serão enviados para um Event Store ou um Webhook.

Pipe de Eventos para ADS - Ad Delivered

Uma vez que o modelo esteja selecionado, você pode verificar quais dados serão coletados ao criar o Pipe de Eventos correspondente.

Para coletar os dados, devemos inserir um filtro, clicando em Add Filter.

Adicionando Filtros
  • Caminho: Tag específica na qual você pode identificar o evento. Ex: id, type, source, data.accountId.

  • Operador: Regra que será usada neste filtro.

  • Valor: O valor específico que a tag deve conter.

Neste caso, coletaremos dados de eventos de anúncios entregues, então a configuração ficaria assim:

Configurações de Filtro do Pipe de Eventos

Especificamos o Caminho usando a tag "Type", escolhemos a opção de Operador "Contém" e adicionamos o Valor "Ad-delivered". Note que esses campos são sensíveis a maiúsculas e minúsculas, então os campos preenchidos devem corresponder ao modelo.

Depois de preencher todos os campos com as informações correspondentes com base no seu pipe de eventos, o teste de filtro deve ter um sinal de verificação Test Filters Checked confirmando que está funcionando corretamente. Se não estiver funcionando corretamente devido a informações ausentes ou um erro de digitação, ele será apresentado com um sinal de aviso Test Filters Warning.

Aviso de Teste de Filtro

Neste caso, nosso filtro falhou devido à verificação em nosso campo Valor. Esses campos são sensíveis a maiúsculas e minúsculas e devem corresponder às informações correspondentes.

Depois de adicionar seus filtros, clique em para salvar seu pipe de eventos.

Aba Destinos

Aqui você decidirá para onde enviar os dados: se serão enviados para um ou múltiplos event stores, um webhook ou uma Planilha Google.

Aba de Destinos do Pipe de Eventos

Para configurar um destino, clique em Add Target e preencha os detalhes de acordo com a opção de destino escolhida:

Enviar para Event Store

Você deve criar um event store antes de usá-lo como destino para seus pipes de eventos. Saiba mais sobre Event Stores.

Destinar para Event Store

Se você decidir enviar seus dados para um event store, basta nomear seu destino e escolher seu event store já criado.

  • Nomeie seu destino

  • Selecione "Enviar para um Event Store"

  • Selecione o Event Store que deseja usar.

Uma vez que estiver tudo configurado, clique em Save e seu pipe de eventos será listado.

Chamar Webhook

É possível enviar seus dados para um webhook fornecido por sua ferramenta de gerenciamento de dados. Selecione esta opção para usar a ferramenta de gerenciamento de dados de sua preferência e preencha os detalhes.

Destinar para Webhook
  • Dê um nome ao seu destino.

  • Selecione "Chamar Webhook".

  • Insira a URL do webhook da sua ferramenta de gerenciamento de dados.

Depois de configurar sua URL de webhook, use nossa aba Testar Webhook para confirmar a usabilidade. Selecione um dos modelos de evento de amostra e clique em Test Webhook.

Se o teste do seu webhook for bem-sucedido, o ícone será apresentado como Test Webhook Successful e as abas do seu teste serão preenchidas:

  • Payload: Informação que será enviada para o seu webhook.

  • Resultado: Status retornado e a latência.

  • Requisição: Requisição usada pela BMS para enviar as informações para este teste.

  • Resposta: Resposta recebida do seu webhook.

Após finalizar todas as configurações e testes, clique em para salvar seu destino.

Google Sheets

Você também pode enviar seus dados para o Google Sheets. Selecione esta opção e preencha os detalhes.

Destinar para Google Sheets
  • Dê um nome ao seu destino.

  • Selecione "Google Sheets".

  • Conecte-se com sua Conta Google para poder acessar a planilha.

Uma vez que estiver tudo configurado, clique em Save e seu pipe de eventos será listado.

Habilitando seu Pipe de Eventos

Para habilitar um pipe de eventos, simplesmente acione a chave seletora Toggle e ele será habilitado.

Pipe de Eventos Habilitado

Editando seu Pipe de Eventos

Para editar seu pipe de eventos, clique em Edit. Uma tela de edição aparecerá. Faça as alterações necessárias e clique em Save.

Tela de Edição de Pipes de Eventos

Ações em Massa

Ao selecionar dois ou mais pipes de eventos, as Ações em Massa serão habilitadas, permitindo que você realize ações em lote, como Arquivar e Excluir.

Ações em Massa - Pipes de Eventos

Arquivando e Desarquivando seu Pipe de Eventos

Para arquivar seu pipe de eventos, clique em Archive e ele será enviado para a lista de arquivados. Para desarquivar seu pipe de eventos, alterne a visualização para eventos arquivados clicando no botão de alternância Archived Toggle. Você verá a lista de eventos arquivados. Clique em Unarchive para desarquivar um pipe de eventos.

Excluindo seu Pipe de Eventos

Para excluir um pipe de eventos, clique em e uma confirmação será necessária.

Exclusão de Pipes de Eventos

Após clicar em Delete, seu pipe de eventos será excluído.

Aba de Métricas

Selecione um pipe de eventos para acessar suas métricas. Selecionar mais de um mostrará uma comparação entre eles. As métricas são preenchidas assim que você cria os pipes de eventos e eles estão habilitados e coletando dados.

Estas são todas as métricas para pipes de eventos:

Atualizado

Isto foi útil?