Stape

O que são os webhooks e seu uso no rastreamento do lado do servidor

Publicado
4 de jan de 2023
Também disponível

Há muitas maneiras de automatizar seu negócio. Entre elas, gostaríamos de distinguir os webhooks. Ao configurar os webhooks, você pode agilizar os processos que normalmente dependem da entrada manual, economizando tempo e energia. 

Neste post do blog, explicaremos o que são os webhooks, por que eles são a escolha perfeita para sua flexibilidade, como funcionam e seu uso no rastreamento do lado do servidor.

O que são os webhooks?Copiar link para esta secção

Em poucas palavras, um webhook é um código de programa. Ele normalmente consiste de duas partes - uma variável e os próprios dados. 

Webhooks são mensagens automáticas enviadas de aplicações web para outras aplicações web. É uma ferramenta poderosa que permite aos desenvolvedores informar múltiplos serviços de conteúdo atualizado ou dados do usuário. Isto permite que as páginas web permaneçam em sincronia, pois os webhooks permitem aos desenvolvedores conectar dois serviços web rapidamente e transferir automaticamente informações entre eles em tempo real. Os Webhooks podem ser usados para quase tudo, incluindo notificações push quando um item é enviado ou envio de informações de pagamento quando uma compra é feita. Os Webhooks proporcionam facilidade e conveniência sem necessidade de entrada manual ou software middleware, tornando o desenvolvimento web mais suave do que nunca.

Como funcionam os WebhooksCopiar link para esta secção

Para começar com os webhook do lado do servidor, você deve primeiro decidir qual aplicativo você quer ativar e qual aplicativo irá recebê-los. Normalmente, o aplicativo de envio é referido como a 'fonte' enquanto o aplicativo de recebimento é referido como o 'destino'. Uma vez escolhidos os dois aplicativos, o próximo passo é configurar as configurações da webhook de cada um deles. 

O webhook é ativado quando um evento ocorre em seu site, CRM, chatbot, ou outros sistemas. Por exemplo, uma pessoa escreveu um comentário ou adicionou um novo produto ao sistema de contabilidade do produto. Quando este evento ocorre, o servidor cria uma solicitação HTTP e a envia para o endereço especificado pelo cliente para receber os webhooks. O cliente recebe novos dados a tempo - o cliente está feliz. O usuário pode configurar webhooks para que eventos em alguns sites disparem ações em outros sites. Por exemplo, uma pessoa cria um pedido na loja on-line → o sistema envia um webhook para o aplicativo do proprietário → o aplicativo notifica o proprietário e envia à pessoa um valor estimado.

Webhoks e rastreamento do lado do servidorCopiar link para esta secção

O uso de webhook no rastreamento do lado do servidor é surpreendentemente simples. Com o webhooks, os dados podem ser enviados automaticamente para o container do Google Tag Manager do servidor toda vez que um evento ou ação ocorre em seu website. 

O caso mais comum de uso do webhook no rastreamento do lado do servidor é o envio de webhoks a partir do CRM ou CMS. Por exemplo, sempre que um usuário é criado, atualizado, feito um pedido, etc., você pode enviar estes dados para o servidor GTM. 

Por que você deve usar webhooks para a etiquetagem do lado do servidorCopiar link para esta secção

Com a ajuda de webhooks, você pode rastrear eventos que não acontecem em seu site ou aplicativo. Coisas como vendas em lojas offline ou leads telefônicos - todos estes dados podem ser enviados para plataformas de publicidade usando webhooks e tagging do lado do servidor. 

Imagine este cenário: um usuário tropeça em seu anúncio on-line, clica e chega em seu website. Depois de algumas explorações, eles tinham dúvidas sobre o produto, então eles decidiram ligar para você. Os representantes de atendimento ao cliente responderam a todas as perguntas, e um usuário fez um pedido por telefone.

Neste caso, uma campanha em particular é responsável pelo pedido, mas como você pode rastreá-lo? A maneira mais óbvia é perguntar aos clientes como eles encontraram seu website. Eles podem dizer algo como um anúncio online ou dizer à plataforma onde eles o viram. Mas estas informações não ajudarão a entender qual campanha ou conjunto de anúncios foi responsável pela conversão. 

O rastreamento de tais pedidos é possível com a ajuda de webhooks e da etiquetagem do lado do servidor. Sempre que um novo pedido por telefone é criado no CRM, você pode enviar um webhook ao servidor Google Tag Manager com todos os detalhes do pedido e do cliente. Após o servidor GTM receber estes dados, você pode distribuí-los para a rede de publicidade. Se a rede de anúncios puder combinar um usuário que fez uma compra offline com um usuário que viu seu anúncio, este pedido será refletido como uma conversão offline para uma campanha correspondente. 

Na próxima seção, vamos mergulhar em alguns detalhes sobre como configurar webhooks e acionar conversões com base nos webhooks. 

Como configurar webhooks para sGTMCopiar link para esta secção

A razão pela qual o uso de webhooks na sGTM pode ajudar a rastrear as conversões com mais precisão e melhorar a atribuição das conversões é óbvia. Portanto, vamos mergulhar em detalhes sobre como configurar os webhooks na sGTM. 

1. Como enviar webhooks para a sGTM

Verifique seu CRM ou CMS para obter um plugin ou funcionalidade nativa que suporta webhooks. O mais popular suporta. Uma vez encontrado, crie um webhook para o evento que você deseja rastrear. Nas configurações do webhook, adicione seu URL de etiquetagem do lado do servidor com o trajeto que irá distinguir seu webhook. 

No meu caso:

https://ss.wp-demo.stape.io - é a URL de etiquetagem do lado do servidor 

/order_created - é um trajeto que diferencia meu webhook que envia dados sempre que um pedido é feito. 

how to send webhooks to server gtm

2. Como ver os dados do webhook na sGTM

O envio de dados de webhook a partir de CRM ou CMS é relativamente fácil. Entretanto, é necessário ver os dados do webhook no depurador sGTM para configurar as tags com precisão. As chances de que se possa configurar tags sem usar um debugger são baixas. 

Por padrão, não é possível ver os dados do webhook no sGTM. Para torná-los visíveis, precisamos usar a funcionalidade Preview HTTP header no depurador sGTM e no stape. 

Para ativar o cabeçalho de pré-visualização sGTM, abra seu servidor Google Tag Manager container -> clique em pré-visualização -> clique nos três pontos no canto superior direito -> clique em enviar pedidos manualmente -> copie o cabeçalho X-Gtm-Server-Preview HTTP.

sgtm preview header
send requests manually in google tag manager

Acesse sua conta stape.io, abra o container sGTM, vá até Power-Ups e clique em Use HTTP Header Config. 

Cole o cabeçalho Preview HTTP que você copiou do servidor Google Tag Manager debugger e clique em Save (Salvar). 

Os passos acima permitirão que você veja os dados do webhook no debugger do servidor Google Tag Manager. Após ter feito a configuração, remova o cabeçalho Preview Header dos stape sGTM power-ups. Nosso sistema remove automaticamente o Preview Header 1 hora após você tê-lo habilitado. 

3. Como processar os dados do webhook no servidor Google Tag Manager

A última etapa de preparação antes que você possa eventualmente enviar dados do webhook para a plataforma publicitária ou analítica é processar os dados do webhook na sGTM. Faremos isso com a ajuda do stape’s Data Client

Na sGTM, os clientes são responsáveis por reclamar solicitações e processar dados de solicitações para dados de eventos. 

Importar dados do Data Client para seu container da sGTM. O primeiro passo seria baixar os dados do Data Client da GitHub. Depois, vá até o container sGTM, abra as seções Templates e clique em New client. 

Data client in server Google tag manager

Clique nos três pontos e depois em Importar. Em seguida, selecione o modelo do Data Client que você baixou do GitHub e salve-o.

data client tag in google tag manager

Vá até a aba Clientes e crie um novo Cliente. Selecione Tipo de cliente - Data Client, adicione o nome do cliente e role até Accepted Path Settings (Configurações de trajeto aceitas). Adicione um trajeto que diferencie seu webhook. No meu caso, é /order_created e clique em save. 

data client configuration in google tag manager

Uma vez feito, abra o sGTM e teste que o webhook foi enviado e o Data Client processou as solicitações com sucesso. 

4. Como usar os dados do webhook para definir as tags sGTM

Esta etapa depende muito de seus objetivos e da sua tecnologia. Por exemplo, você pode enviar eventos offline para o Facebook ou para o Google Ads. Ou você pode notificar seu departamento de vendas ou marketing sobre novos pedidos usando a tag Slack ou Telegramas para sGTM.

ConclusãoCopiar link para esta secção

Webhooks oferecem uma maneira fácil e conveniente de receber atualizações de notificações em tempo real para atividades baseadas na web, permitindo que as empresas respondam e atuem sobre essas notificações com o mínimo de esforço rápido. Além disso, os Webhooks são uma forma segura de compartilhar informações com outros serviços web como plataformas de marketing ou de análise, pois não exigem que desenvolvedores ou programadores forneçam aos usuários credenciais de acesso ou dados sensíveis.

Se você se sentir confuso - não hesite em entrar em contato com o suporte stape. Ficaremos mais do que felizes em ajudá-lo. 

Precisa de algo?

Por favor, responda a algumas perguntas simples. Clique Obter assistência, preencher o formulário, e enviar-lhe-emos um orçamento.

Obter assistência
Tagged with:gtm serverWebhook

Aloje o seu servidor GTM no Stape