# Os eventos medidos

> Os 28 eventos que os conectores reportam: o que é reconhecido sem configuração, o que se ativa com um atributo e o que não é medido.

- Página original: https://server-side.datafirefly.com/pt/docs/events.html
- Idioma: pt
- Atualizado em: 2026-09-05
- Editor: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pt/

---

O que o conector reconhece sozinho, o que pode forçar e onde para a medição.

Os conectores reportam **28 eventos**. A maioria é reconhecida sem configuração; alguns ativam-se com um atributo, por falta de uma forma genérica fiável. Esta página diz quais, e porquê.

## Reconhecido sem configuração

- **O funil de compra**: `view_content`, `add_to_cart`, `remove_from_cart`, `view_cart`, `initiate_checkout`, `add_shipping_info`, `add_payment_info`, `purchase`, `refund`, `customize_product`.
- **O conteúdo**: `view_content` num artigo ou numa página, `view_item_list` numa lista (blogue, categoria, resultados), `select_item` na entrada aberta, `search` na página de resultados do seu motor interno.
- **Os contactos**: `lead` em qualquer formulário em POST que peça um e-mail. A pesquisa, o início de sessão e os comentários ficam excluídos pela sua função; um formulário em GET pelo seu método.
- **As extensões de formulários**: Contact Form 7, WPForms, Gravity Forms, Elementor e Ninja Forms são reconhecidas e o evento parte **no sucesso**, não no envio: um formulário recusado na validação não produziu um contacto.
- **A newsletter**: `subscribe` em Mailchimp for WordPress, Brevo, Newsletter e MailPoet, mais a forma genérica: um campo de e-mail e nada mais a preencher.
- **O contacto direto**: `contact` num clique `mailto:` ou `tel:`. O endereço em si não é transmitido.
- **Marcações, partilhas, testes**: `schedule` numa ligação Calendly, Cal.com, SavvyCal, HubSpot Meetings, Zcal, TidyCal ou YouCanBook.me; `share` nos URL de partilha padrão; `start_trial` numa ligação ou formulário de teste gratuito.
- **Candidaturas**: `submit_application` num formulário que peça um ficheiro *e* um endereço. Um campo de ficheiro sozinho é um avatar ou um anexo, não uma candidatura.
- **Início de sessão**: `login`, enviado a partir do servidor WordPress. É a única conversão que o navegador não pode constatar honestamente: sai do formulário antes de saber se a palavra-passe estava certa.

## Ativado por um atributo

Dois eventos não têm forma genérica fiável. Adivinhar teria produzido um donativo em cada clique num botão de etiqueta parecida, por isso ativam-se colocando um atributo, uma vez, no elemento em causa.

```
<a href="/donate" data-df-donate>Doar</a>
<a href="/stores" data-df-find-location>Encontrar uma loja</a>
```

## Forçar ou impedir uma deteção

A deteção automática engana-se raramente, mas o site é seu. Estes atributos têm a última palavra:

| Atributo | Efeito |
| --- | --- |
| `data-df-lead` | Trata este formulário como contacto, mesmo que não peça endereço. |
| `data-df-no-lead` | Nunca faz dele um contacto. Para um formulário interno ou de teste. |
| `data-df-subscribe` | Trata este formulário como subscrição da newsletter. |
| `data-df-register` | Trata este formulário como criação de conta. |
| `data-df-application` | Trata este formulário como candidatura. |
| `data-df-contact` | Conta um contacto num elemento que não é uma ligação `mailto:`. |
| `data-df-schedule` | Conta uma marcação numa ferramenta que não reconhecemos. |
| `data-df-share` | Conta uma partilha num botão próprio. |
| `data-df-trial` | Conta o início de um teste. |
| `data-df-wishlist` | Conta uma adição aos favoritos numa extensão que não reconhecemos. |

## O que não é medido

- **Não as pesquisas no Google.** `search` reporta apenas as pesquisas feitas no motor interno do seu site.
- **Nenhum dado pessoal em claro.** Um termo de pesquisa com um endereço ou um número é substituído por uma menção ocultada antes de qualquer registo, e os identificadores são cifrados antes de sair.
- **Nada sem consentimento.** Cada evento leva o estado decidido pelo seu banner; passar pelo servidor não contorna nada. Os webhooks de encomenda do Shopify são a exceção: não transmitem qualquer sinal de consentimento.

## Cookies colocados pelo conector

O conector não coloca nada antes do consentimento do visitante. Depois do consentimento, pode colocar dois tipos de cookies, a acrescentar à sua política de cookies:

- `_dfss_cid`, 90 dias: um número aleatório que permite ao Google Analytics contar as páginas de um visitante como as de uma única pessoa quando falta o cookie do Google. Só é colocado se o visitante aceitou a publicidade e não recusou a medição de audiência. É removido assim que recusar uma ou outra.
- `_dfss_gclid`, `_dfss_gbraid`, `_dfss_wbraid`, `_dfss_msclkid`, `_dfss_ttclid`, `_dfss_fbc`, `_dfss_oppref`, 90 dias: o identificador do clique num anúncio (Google, Microsoft, TikTok, Meta, OpenAI), guardado para ligar uma compra ao anúncio que a originou.

## O funil por visitantes (página Insights)

Esta função conta quantos dos seus visitantes chegam a cada etapa de uma compra. Está desligada por predefinição: ligá-la é uma decisão sua enquanto responsável pelo tratamento, e só um proprietário ou um administrador da sua conta o pode fazer, a partir da página Insights.

Abrimo-la site a site. Se o cartão «Funil por visitantes» não aparecer na sua página Insights, escreva para [support@datafirefly.com](mailto:support@datafirefly.com).

Para ligar as etapas de uma mesma visita, usamos uma chave pseudónima. Ela só existe para os visitantes que aceitaram o rastreio no seu banner, é guardada no máximo 48 horas e vê apenas números.

**O seu banner de consentimento** deve anunciar esta finalidade, por exemplo: «medir as visitas do site e o percurso de compra, sob a forma de estatísticas». Coloque esta frase na categoria que aciona o nosso rastreio (em geral «marketing» ou «medição de audiência»), não numa categoria que o visitante possa aceitar separadamente.

Ao ligá-la, confirma este ponto e aceita a linha que esta função acrescenta ao Anexo 1 do [Acordo de tratamento de dados (DPA)](https://server-side.datafirefly.com/pt/dpa.html), versão 1.1.

**Se um visitante lhe pedir os seus dados ou o apagamento deles**, pode responder que o identificador de visita é eliminado automaticamente no prazo de 48 horas e que depois só restam estatísticas que já não permitem reconhecê-lo.

## Nem todos os destinos aceitam tudo

O vocabulário de cada plataforma é fechado, exceto o da Microsoft. Um evento sem equivalente oficial **não** é enviado para esse destino: vai para os outros, sem erro. Cada página de destino publica a sua correspondência exata: [TikTok](https://server-side.datafirefly.com/pt/tiktok-events-api-server-side-tracking.html), [Pinterest](https://server-side.datafirefly.com/pt/pinterest-conversions-api-server-side-tracking.html), [Microsoft Advertising](https://server-side.datafirefly.com/pt/microsoft-ads-conversions-api-server-side-tracking.html).

Atualizado: 16 de novembro de 2026
