Rastreamento de Indicações para o Gravity Forms

Como ativo o *plugin*?

Após adquirir o Referral Source Tracking para Gravity Forms, instale-o em seu site WordPress.

Passo 1: Instalação

Inicie sessão no seu site WordPress e navegue até Plugins → Adicionar plugin → Enviar plugin → Instale o ficheiro zip e ative-o.

Passo 2: Registar o Plugin

Na barra de navegação à esquerda, acesse Formulários → Configurações → Rastreamento de Referências.

Insira sua chave de licença e ative-a.

Passo 3: Ativar o recurso

Após ativar sua licença, uma aba Geral será exibida. Clique nela e marque a caixa. Ativar por padrão (“Ative o rastreamento da fonte de referência em todos os formulários por padrão”) e clique em Salvar alterações.

Deixar essa caixa desmarcada faz com que o rastreamento fique incorreto em todos os lugares. Em vez disso, você pode habilitá-lo formulário por formulário em Configurações do Formulário → Opções do Formulário.

Pronto! Com a opção "Ativar por padrão" ativada, o rastreamento da origem de referência fica ativo em todos os formulários existentes e em todos os novos que você criar.

Detalhes da funcionalidade

Fontes que ele detecta

Capturamos o URL de referência quando disponível e o armazenamos na entrada. Para plataformas comuns, também adicionamos um rótulo amigável para facilitar a leitura do código-fonte.

Uma origem é rotulada como "Anúncios" somente quando a visita contém o ID de clique de anúncio da própria plataforma (gclid, msclkid, li_fat_id, ttclid, oppref etc.). Uma plataforma conhecida que chega sem um ID de clique de anúncio é rotulada como "Orgânica". Facebook e Instagram são exceções: o Meta adiciona o fbclid a cada clique, portanto, essas plataformas são classificadas como "Anúncios" quando o fbclid chega com qualquer parâmetro UTM.

Segue a lista de fontes que são rotuladas quando detectadas:

• Google: Google Ads, Google Orgânico. Tráfego Gemini marcado. utm_source=gemini Está identificado como Google Organic; não existe um selo Gemini separado.
• Microsoft/Bing: Anúncios do Bing, Bing Orgânico
• Facebook: Anúncios do Facebook, Publicidade Orgânica do Facebook
• Instagram: Anúncios do Instagram, Instagram Orgânico
• LinkedIn: Anúncios do LinkedIn, resultados orgânicos do LinkedIn
• X (Twitter): X Orgânico
• Reddit: Anúncios do Reddit, Reddit Orgânico
• TikTok: Anúncios do TikTok, TikTok Orgânico
• Pinterest: Anúncios do Pinterest, Pinterest Orgânico
• Snapchat: Anúncios do Snapchat, Snapchat Orgânico
• YouTube: YouTube orgânico. Um clique em um anúncio do YouTube que gera resultados. gclid é registrado como Google Ads, a menos que o URL também esteja marcado. utm_source=youtube, que grava anúncios do YouTube.
• Outros mecanismos de busca: Yahoo, DuckDuckGo, Yandex
• Assistentes de IA/LLMs: Anúncios do ChatGPT, ChatGPT Orgânico, Perplexity, Copilot, Claude, Grok, DeepSeek
• Plataformas de e-mail (rastreamento de campanhas): Mailchimp, Constant Contact, Pardot (rotulados) Salesforce), HubSpot
• Direto e Desconhecido São utilizados quando apropriado.
• Personalizado As fontes podem ser definidas em Fontes Personalizadas para tráfego de parceiros, afiliados e campanhas.

Parâmetros UTM que ele captura

• utm_source
• utm_medium
• utm_campaign
• utm_term
• utm_content
• utm_id

IDs de cliques capturados

Capturamos cada ID de clique abaixo no campo ID de Clique e atribuímos a visita à sua plataforma, a menos que a linha indique o contrário.

Fontes personalizadas

A detecção de origem integrada já abrange os principais mecanismos de busca, plataformas sociais, assistentes de IA e ferramentas de marketing por e-mail. As Origens Personalizadas permitem adicionar suas próprias regras com rótulos. Use-as para sites parceiros, indicações de afiliados, campanhas com nomes específicos, encurtadores de links personalizados, links de funcionários e qualquer outro item onde o rótulo padrão "Indicação" ou um link bruto não sejam relevantes. utm_source O valor não é específico o suficiente.

Encontre-os em Formulários → Definições → Acompanhamento de Recomendações no Fontes personalizadas seção. Cada linha representa uma regra.

Como uma regra é avaliada

A cada visita, o plugin verifica suas Fontes Personalizadas. antes Detecção integrada. A primeira regra que corresponder será aplicada: o plugin define a origem do visitante para a regra correspondente. Rótulo e ignora a detecção integrada para essa visita. Se nada corresponder, a detecção integrada funciona normalmente (Google, Facebook, Direct, etc.).

Os campos, um por um

• Rótulo – O texto salvo como a fonte da visita (por exemplo,. Partner: Acme, Email: Newsletter, Campaign: Spring Sale). É exatamente isso que aparece na entrada, no {pb_ref_source} A tag de mesclagem está na guia Relatórios e em qualquer mapeamento do CRM. Escolha algo que você reconheça facilmente em uma tela de entradas com muitas informações.
• Campo de jogo – Onde procurar:
  • Host de referência – o domínio no referenciador do navegador (por exemplo, corresponde a acme.com quando alguém chega de https://www.acme.com/blog/post).
  • UTM Origem / Meio / Campanha / Termo / Conteúdo – o correspondente ?utm_*= parâmetro na URL de destino.
• Tipo de correspondência – O que procurar:
  • Contém – O valor do campo inclui o seu Valor de Correspondência em qualquer lugar dentro dele. Não diferencia maiúsculas de minúsculas. Bom para detectar variações como acme.com, blog.acme.com, partner.acme.com Com uma única regra.
  • Igual a – O valor do campo é exatamente o seu Valor de Correspondência (sem distinção entre maiúsculas e minúsculas). Mais rigoroso, portanto, use-o quando precisar de uma correspondência precisa, como utm_source exatamente igual a newsletter.
• Valor correspondente – O texto a procurar. Sem aspas, sem asteriscos, apenas a sequência literal.
• Prioridade – Um número que controla a ordem. Primeiro, as corridas mais altas, portanto, onde as regras se sobrepõem, a de maior prioridade prevalece. O padrão é 10; aumentar para 20 ou 50 Para regras que precisam superar suas configurações padrão, desça para 5 para categorias gerais.

Exemplos práticos

Identifique um site parceiro por meio do referenciador.

Qualquer pessoa que chegue de qualquer subdomínio de acme.com está rotulado Partner: Acme em vez do genérico Referral.

Identifique uma campanha de newsletter com tags

Use isso quando você controlar o URL do seu lado (por exemplo, links dentro do seu e-mail semanal). ?utm_source=newsletter).

Identifique uma campanha paga pelo seu nome UTM.

Capturas ?utm_campaign=spring-sale-2026, ?utm_campaign=spring-sale-google-ads, e variantes semelhantes em uma única regra.

Substitua a detecção integrada do Google para um afiliado específico.

Uma alta prioridade garante que esta regra prevaleça sobre a regra integrada. utm_source=google → Google Ads Rotulando sempre que a fonte marcada for recebida.

“Adicionar rótulos orgânicos/anúncios” com fontes personalizadas

As fontes integradas sempre aparecem como Google Ads, Facebook Organic, etc. O Adicionar rótulos orgânicos/anúncios (fontes personalizadas) A caixa de seleção (também em Formulários → Configurações → Rastreamento de Referências) controla se seus rótulos personalizados recebem o mesmo sufixo.

• Verificado (padrão) – uma regra personalizada rotulada Partner: Acme torna-se Partner: Acme Organic sobre o tráfego de referência e Partner: Acme Ads se a visita contiver um ID de clique pago, como o gclid.
• Não verificado – seus rótulos personalizados são exibidos exatamente como você os digitou, e o plugin não adiciona nenhum sufixo.

Escolha a opção que melhor se adequa aos seus relatórios. A maioria das equipes deseja o sufixo para poder comparar o tráfego pago com o tráfego orgânico de parceiros, mas se você estiver usando o próprio rótulo para transmitir a identidade completa, desative-o.

Adicionando regras programaticamente

Se você estiver criando um complemento ou quiser regras sob controle de versão, o pb_gforms_referral_tracking_custom_sources O filtro aceita o mesmo formato da interface administrativa e o mescla com ele. O plugin classifica as regras de ambos os locais por prioridade antes que o front-end as avalie.

campos espelhados

Nossos campos de rastreamento são adicionados dinamicamente ao seu formulário no momento da renderização. Eles não fazem parte da lista de campos salvos do formulário. Isso mantém seus formulários organizados, mas alguns complementos de CRM, marketing por e-mail e webhook criam seus menus suspensos de mapeamento de campos apenas a partir de campos salvos, portanto, não conseguem "enxergar" nossos campos dinâmicos.

Os campos espelhados resolvem isso. Em Formulários → [seu formulário] → Configurações → Opções do formulário, clique em Adicionar campos espelhados O plugin adiciona um conjunto paralelo de campos ocultos visíveis ao editor no seu formulário. Os campos de rastreamento originais permanecem como a fonte de verdade; o plugin copia os valores capturados para os campos espelhados quando a entrada é criada, permitindo que seu complemento os mapeie a partir do menu suspenso de campos normal. O bloco de campos espelhados só aparece quando a opção de rastreamento de referência do formulário está ativada.

Se o seu complemento suporta uma opção de mapeamento de "Valor Personalizado", você não precisa de campos espelhados. Basta mapear nossas tags de mesclagem diretamente (por exemplo, {pb_ref_source}, {pb_ref_utm_source}, {pb_ref_clid}).

Gerenciando campos espelhados:

• Adicionar campos espelhados – cria o conjunto visível para o editor.
• Adicionar N campos de espelho ausentes – aparece sempre que um formulário possui alguns, mas não todos os campos espelhados atuais, e indica a quantidade. Isso acontece se alguém excluir campos manualmente e também depois de ativar a atribuição de último toque, que adiciona um novo conjunto de definições. O plugin deixa os IDs dos campos restantes intactos, para que os mapeamentos salvos continuem funcionando.
• Remova 2 campos espelhados duplicados. – Aparece apenas quando existem duplicados e indica a contagem. Mantém a primeira ocorrência de cada um.
• Remover campos espelhados – Exclui o conjunto (com confirmação). Os valores já salvos em entradas anteriores permanecem no banco de dados, mas os complementos não os verão mais por meio de pesquisas de ID de campo.

Quando a atribuição de último toque está ativada, os campos espelhados também podem incluir o conjunto de último toque. Formulários que já possuíam o conjunto de primeiro toque não o capturarão automaticamente: use Adicionar N campos de espelho ausentes em cada um para completar.

Relatórios

Encontre relatórios em Formulários → Definições → Acompanhamento de Referências → Relatórios. A aba visualiza todas as entradas rastreadas que ocorreram durante o período selecionado, discriminadas por origem, dimensão UTM e referenciador. Entradas enviadas antes da ativação do plugin, entradas em formulários com rastreamento desativado e entradas excluídas ou marcadas como spam não são contabilizadas; portanto, esses totais podem ser inferiores à sua contagem de entradas do Gravity Forms. Os intervalos abrangem dias inteiros e terminam na última entrada concluída. UTC meia-noite, então as comparações de período permanecem as mesmas. Dependendo da distância entre o fuso horário do seu site e o UTC, esse limite pode cair no meio do dia local.

Visão geral dos gráficos

• Análise da fonte – Gráfico de rosca mostrando a porcentagem de envios por fonte identificada (Google Orgânico, Anúncios do Facebook, suas Fontes Personalizadas, Direto, etc.).
• Entradas ao longo do tempo – Gráfico de linhas do total de entradas por intervalo. Ao passar o cursor sobre um ponto, a dica de ferramenta divide o total por origem. Em janelas mais longas (90 e 365 dias), os intervalos são organizados por mês para que o eixo permaneça legível; na janela de 30 dias, o gráfico exibe um rótulo de data a cada 7 dias para evitar aglomeração.
• Fonte UTM principal / Meio / Campanha – Gráficos de barras horizontais dos valores com maior número de entradas em cada dimensão UTM.
• Principais fontes de referência – Gráfico de barras horizontais dos domínios de referência que geram o maior número de envios. O plugin armazena o tráfego direto com o respectivo referenciador. Direct, portanto, aparece aqui como uma barra própria em vez de um domínio.

Filtros

• Forma – Selecione “Formulário único” ou deixe “Todos os formulários” ativado para visualizar todo o site.
• Intervalo de datas – Janelas predefinidas (Últimos 7, 30, 90 e 365 dias).
• Comparar com o período anterior – Mostra o total do período com sua variação percentual em relação ao período anterior equivalente (últimos 7 vs. os 7 anteriores, últimos 30 vs. os 30 anteriores, etc.) e sobrepõe esse período anterior como uma linha tracejada no gráfico de tempo. Os gráficos de barras UTM e de referência não são comparados.
• Ocultar sem atribuição – Oculta os buckets Não Definido e Desconhecido para que você possa se concentrar nas fontes atribuídas. Permanece direto.

O plugin memoriza suas escolhas de intervalo de datas, período de comparação e ocultação de dados não atribuídos para cada usuário, para que você não precise configurá-las novamente na sua próxima visita.

Desempenho e armazenamento em cache

O plugin gera relatórios a partir das suas entradas do Gravity Forms e armazena o resultado em cache, para que os carregamentos repetidos sejam rápidos. Novas entradas invalidam esse cache automaticamente, protegido por um bloqueio de 60 segundos para que formulários de alto volume não o sobrecarreguem. Os desenvolvedores podem ajustar o período de bloqueio (ou desativá-lo completamente) com o pb_gforms_rt_invalidate_debounce Filtro. Veja Ganchos abaixo.

Resumo por e-mail

Se preferir receber os destaques de atribuição em vez de abrir o painel de controle, ative o resumo por e-mail em Formulários → Configurações → Rastreamento de Indicações → Relatórios por E-mail. O dia e a hora que você escolher são avaliados no fuso horário do seu site, mas o período relatado em si é medido integralmente. UTC dias, terminando na última meia-noite UTC completa antes do envio do e-mail. Em locais distantes do UTC, o intervalo coberto é deslocado em relação aos seus dias locais.

Cadência e tempo

• Semanal – Selecione o dia da semana (de domingo a sábado) e a hora em que o e-mail será enviado.
• Mensalmente – Selecione o dia do mês (com limite até o dia 28 para que o e-mail sempre chegue, mesmo em fevereiro) e a hora.
• O cronograma de envio segue o seu fuso horário do site (WordPress → Configurações → Geral), e a página de configurações mostra a hora atual ao lado do seletor de Hora. O período de relatório em si ainda é medido em dias UTC.

Destinatários

Um endereço de e-mail por linha. Deixe o campo em branco e o resumo será enviado automaticamente para o endereço fornecido. E-mail do administrador do site no momento do envio. Isso é útil quando o e-mail do administrador pode mudar posteriormente e você deseja que o resumo seja atualizado automaticamente.

O Envie-me um email de teste agora O botão fornece o mesmo corpo de digestão usando o seu salvo configurações. Duas coisas diferem de um envio agendado: o assunto é prefixado [TEST], e ignora Ignorar resumos vazios, Assim, um teste realizado durante um período de inatividade ainda chega, enquanto o resumo real teria permanecido em silêncio. O botão desativa automaticamente enquanto houver alterações não salvas; salve primeiro e depois teste.

Opções de conteúdo

• Ignorar resumos vazios – Não envie o e-mail se o total do resumo para o período for zero. Em um formulário com poucos dados, isso evita um resumo vazio em semanas tranquilas. Ocultar sem atribuição Além disso, esse total ignora as entradas "Não Definido" e "Desconhecido", portanto, um período que contenha apenas entradas sem atribuição é considerado vazio e é ignorado.
• Comparar com o período anterior – Exibir a variação percentual em relação ao período equivalente anterior na parte superior do e-mail (semana passada versus semana anterior, mês passado versus mês anterior, etc.).
• Ocultar sem atribuição – Omitir os valores "Não definido" e "Desconhecido" das tabelas de e-mail para que o foco permaneça nas fontes atribuídas.

Campos de fusão

{pb_ref_source} – valor armazenado no campo oculto “Origem” (com valor padrão “Desconhecido” quando a visita não pôde ser classificada).

{pb_ref_params} – sequência completa dos parâmetros de referência capturados (UTMs e outras variáveis de consulta que mantemos juntas).

{pb_ref_referrer} – o URL de referência da visita. Este é o referenciador efetivo, não o valor bruto do navegador. Quando um ID de clique ou um reconhecido utm_source Identifica a plataforma, mas o plugin armazena o URL canônico da plataforma. Como resultado, um gclid registros de visitas https://www.google.com/ mesmo quando o clique veio de um e-mail. Registro de visitas do mesmo domínio e sem referenciador Direct. A ausência da tag de mesclagem expõe o referenciador do navegador intacto.

{pb_ref_utm_id} – utm_id.

{pb_ref_utm_source} – utm_source.

{pb_ref_utm_medium} – utm_medium.

{pb_ref_utm_campaign} – utm_campaign.

{pb_ref_utm_term} – utm_term.

{pb_ref_utm_content} – utm_content.

{pb_ref_clid} – primeiro ID de clique detectado para a visita (gclid, fbclid, msclkid e outros IDs de clique da plataforma).

{pb_ref_custom_source} – sua própria etiqueta para a visita, escrita por pb_gforms_referral_tracking_source_label filtro (consulte Hooks). A tag só existe quando esse filtro possui um callback associado. O plugin armazena a origem detectada separadamente e nunca a altera.

tags de mesclagem de último toque

Quando a atribuição de último toque está ativada, o plugin adiciona um conjunto paralelo:

• {pb_ref_last_source}
• {pb_ref_last_referrer}
• {pb_ref_last_params}
• {pb_ref_last_clid}
• {pb_ref_last_utm_source}
• {pb_ref_last_utm_medium}
• {pb_ref_last_utm_campaign}
• {pb_ref_last_utm_term}
• {pb_ref_last_utm_content}
• {pb_ref_last_utm_id}
• {pb_ref_last_custom_source}

Cada um espelha seu equivalente de primeiro contato, mas armazena a fonte mais recente antes do envio. {pb_ref_last_custom_source} também precisa do pb_gforms_referral_tracking_source_label filtro, igual à sua contraparte de primeiro toque.

Envio de dados para o Google Analytics

O Rastreamento de Origem de Referência nunca contata o Google por conta própria. Tudo o que ele captura permanece no seu formulário do Gravity Forms. Se você ativar a configuração do GA4, sua própria tag do Google enviará o evento.

A partir da versão 1.6.0, você pode optar por participar de um evento do Google Analytics 4 (GA4). Ative o GA4/Gerenciador de tags em Formulários → Configurações → Rastreamento de referências → Geral. Após a confirmação, o plugin envia um evento personalizado com o nome pb_referral_submit (Renomeie na mesma configuração) com a origem, o referenciador, o ID do clique e os parâmetros UTM, além dos valores do último toque quando este estiver ativado. Uma validação com falha não é enviada. Confirmações de redirecionamento e de agradecimento da página exigem a versão 1.7.1.

Verifique o GA4 em tempo real ou no DebugView para o evento. Você não precisa de um acionador do Gerenciador de tags. Sua própria tag do Google faz o envio; o plugin nunca entra em contato com o Google.

Opcional: você também pode passar tags de mesclagem em uma string de consulta de confirmação de redirecionamento (abaixo) se já estiver convertendo parâmetros de campanha na URL de agradecimento. Isso é separado do evento personalizado.

O que o evento representa

As chaves dos parâmetros correspondem aos nomes das tags de mesclagem. Valores vazios são completamente omitidos da carga útil, e o evento é disparado no máximo uma vez por visualização de página.

Opcional: passe valores na URL de agradecimento.

1. Abra as confirmações do seu formulário em Formulários → [seu formulário] → Configurações → Confirmações, depois edite (ou adicione) um Redirecionar confirmação.
2. No URL de redirecionamento No campo, insira o URL da sua página de agradecimento seguido por uma string de consulta criada a partir das tags de mesclagem de rastreamento:

https://yoursite.com/thank-you/?gclid={pb_ref_clid}&utm_source={pb_ref_utm_source}&utm_medium={pb_ref_utm_medium}&utm_campaign={pb_ref_utm_campaign}&utm_term={pb_ref_utm_term}&utm_content={pb_ref_utm_content}

O Gravity Forms preenche e codifica cada valor em URL no momento do envio, de modo que um visitante que chegou por meio de um clique em um anúncio do Google Ads seja direcionado para uma URL como:

https://yoursite.com/thank-you/?gclid=EAIaIQ...&utm_source=google&utm_medium=cpc&utm_campaign=spring-sale

Sua configuração do GA4 ou do Google Tag Manager na página de agradecimento lê esses parâmetros da mesma forma que lê qualquer URL de campanha, disparando seu evento de conversão ou lead com a origem, a campanha e o ID do clique capturados. Os valores que não foram capturados para uma determinada visita são exibidos em branco.

Você pode usar qualquer uma das tags de mesclagem de rastreamento aqui. Veja Campos de fusão para a lista completa. (Se preferir, o Passar dados de campo por meio de string de consulta A opção na mesma confirmação de redirecionamento aceita essas mesmas tags de mesclagem.)

Por que usar tags de mesclagem em vez de seus próprios campos ocultos?

Se você já está enviando dados de campanha para sua página de agradecimento a partir de seus próprios campos ocultos, aponte a string de consulta para nossas tags de mesclagem. Tanto o valor salvo na entrada quanto o valor enviado para o GA4 vêm da mesma fonte capturada, portanto, os dois não divergem. A entrada e o GA4 sempre mostram a mesma campanha. Isso também significa um conjunto de campos a menos para manter.

Uma observação sobre IDs de cliques

{pb_ref_clid} Contém o primeiro ID de clique detectado na visita, independentemente da plataforma de origem: gclid para o Google, mas também msclkid (Microsoft), fbclid (Meta) e outros. Se você estiver mapeando especificamente para um gclid= Para o parâmetro do Google Ads, uma visita que não seja do Google colocaria seu ID de clique nesse campo. Se você quiser que o ID de clique seja incluído apenas em visitas do Google Ads, adicione lógica condicional à confirmação para que... gclid= O parâmetro é enviado somente quando o Fonte é Google Ads.

Verificando se funciona

Você pode confirmar toda a cadeia em quatro etapas:

1. Adicione parâmetros de teste a qualquer URL de página de destino (por exemplo, ?gclid=TEST123&utm_source=google&utm_medium=cpc), em seguida, envie o formulário.
2. Na página de agradecimento, verifique a barra de endereços: seus valores devem estar presentes na URL.
3. Abra as ferramentas de desenvolvedor do seu navegador e acesse o Rede guia e filtro para collect. A solicitação ao Google deve incluir o seu gclid e utm valores.
4. Confirme o recebimento no GA4. DebugView ou Em tempo real relatório.

Faça o teste em uma janela anônima ou após sair da sessão. Enquanto você estiver conectado como administrador, o plugin é executado intencionalmente em modo de sessão única, gravando cookies sem prazo de validade, de forma que a janela de atribuição não possa ser reproduzida a partir de uma sessão administrativa.

Esses quatro passos verificam o método opcional de string de consulta. Para o evento personalizado integrado, envie o formulário e, na página de confirmação ou agradecimento, abra Ferramentas de Desenvolvedor → Rede e filtre por g/collect, e procure por en=pb_referral_submit (ou o nome do seu evento). Ou use o GA4 DebugView. Se o evento estiver na guia Rede, mas não no GA4, a lacuna é a sua tag do Google. Se não estiver na guia Rede, o plugin não foi acionado.

Enviando o evento para GA4

A partir da versão 1.6.0, você pode enviar a origem de dados já presente na entrada do Gravity Forms para o Google Analytics 4 como um evento personalizado. Essa opção está desativada por padrão. Sua própria tag do Google realiza o envio — o plugin nunca entra em contato com o Google diretamente. Verifique o Google Analytics 4 em tempo real ou no DebugView para encontrar o evento. Você não precisa de um gatilho do Gerenciador de tags.

Ir para Formulários → Definições → Acompanhamento de Recomendações → Geral. Marcação Enviar os parâmetros capturados para o GA4 como um evento personalizado na confirmação do formulário.. Deixe o nome do evento como pb_referral_submit A menos que você tenha um motivo para alterá-lo, clique em Salvar alterações.

Traduções

Este plugin está pronto para tradução e inclui traduções para:

1. Árabe (ar)
2. Bengali (bn_BD)
3. Filipino (fil)
4. Alemão (de_DE)
5. Espanhol (es_ES)
6. Espanhol (es_MX)
7. Francês (fr_FR)
8. Hindi (hi_IN)
9. Indonésio (id_ID)
10. Italiano (it_IT)
11. Japonês (ja)
12. Português (pt_BR)
13. Russo (ru_RU)
14. Urdu (ur)
15. Chinês Simplificado (zh_CN)
16. Chinês Tradicional (zh_HK)

Idioma padrão: inglês (en_US)

Se o seu idioma não estiver listado em Traduções Como mencionado acima, você ainda pode traduzir o plugin por conta própria. Ele já está pronto para tradução. Use a versão gratuita. Plugin Loco Translate Para criar uma tradução para o idioma/localidade do seu site. Novo no Loco Translate? Aqui está um tutorial para iniciantes.

Perguntas Frequentes

Posso exportar os dados?

Sim. Os valores de rastreamento são salvos em cada entrada do Gravity Forms, portanto, aparecem nas exportações das entradas.

O que exatamente o plugin captura?

Capturamos os campos de atribuição comuns e os armazenamos na entrada do Gravity Forms. Isso inclui: parâmetros UTM (fonte, meio, campanha, termo, conteúdo), IDs de clique (gclid, msclkid, gbraid/wbraid, etc.), o URL de referência original, e o contexto da página de destino relacionada, para que você possa ver de onde veio cada lead.

Posso adicionar fontes personalizadas?

Sim. Adicione regras em Formulários → Configurações → Rastreamento de Referências → Fontes Personalizadas Para rotular sites parceiros, tráfego de afiliados, campanhas de marca e visitas semelhantes por nome. Cada regra corresponde ao host de referência ou a um parâmetro UTM e aplica um rótulo de sua escolha. Veja o Fontes personalizadas seção para o guia campo a campo e exemplos práticos.

Meu complemento de CRM/e-mail/webhook não está reconhecendo os campos de rastreamento no menu suspenso de mapeamento. O que devo fazer?

Nossos campos de rastreamento são adicionados dinamicamente ao seu formulário no momento da renderização, e não são salvos na lista de campos do formulário. Portanto, complementos que criam seus menus suspensos apenas a partir de campos salvos não podem vê-los. Você tem duas opções. Se o seu complemento tiver um mapeamento de "Valor Personalizado", mapeie nossas tags de mesclagem diretamente ({pb_ref_source}, {pb_ref_utm_source}, {pb_ref_clid}, e assim por diante). Se suportar apenas um menu suspenso de campo, abra Configurações do Formulário → Opções do Formulário → Espelhar campos e clique em Adicionar campos espelhados. Isso adiciona campos ocultos visíveis ao editor, e o plugin os preenche. Consulte a seção "Espelhar campos" para obter o passo a passo completo.

Onde os dados de referência são armazenados?

No seu banco de dados WordPress, dentro dos seus formulários Gravity Forms. O plugin nunca envia esses dados para nenhum outro lugar por conta própria. Se você quiser que os valores capturados sejam enviados para o Google Analytics 4 (GA4), ative a configuração do GA4. O plugin continua sendo a fonte dos dados; o envio é feito pela sua própria tag do Google.

Trata-se de atribuição de primeiro ou último contato?

Ambos. Por padrão, utiliza a atribuição de primeiro clique, armazenando o referenciador original e os parâmetros da campanha que trouxeram o visitante ao seu site pela primeira vez (dentro do período de atribuição). Há uma caixa de seleção para ignorar visitas de retorno diretas, de modo que o último clique mantenha o anúncio ou a referência anterior. Os IDs de clique de visitas de retorno são armazenados apenas no ID de clique (último clique). Isso fornece um conjunto paralelo de {pb_ref_last_*} Mescle tags, colunas da lista de entradas e colunas de exportação CSV. A guia Relatórios inclui uma opção Primeiro/Último que alterna cada gráfico entre as duas visualizações.

Por quanto tempo o sistema armazena os dados de atribuição de um visitante?

O período de atribuição é definido por padrão como 7 dias, e você pode alterá-lo em Formulários → Configurações → Rastreamento de Referências. Se um visitante enviar um formulário dentro desse período da sua primeira visita rastreada, essa entrada manterá os valores de atribuição originais do primeiro contato.

Funciona com cache/CDNs?

Geralmente, sim. O rastreamento é executado no lado do cliente, então a maioria das configurações de cache/CDN funciona bem. Se você usar otimização de script agressiva (minificação ou adiamento), marque a opção. Proteja os scripts contra otimização. Em Formulários → Configurações → Rastreamento de Referências → Avançado, limpe o cache. Isso marca os scripts do plugin para que sejam ignorados e os adiciona automaticamente às listas de exclusão do WP Rocket, LiteSpeed Cache, SG Optimizer, Autoptimize e Cloudflare Rocket Loader. Se você usa o Breeze ou outro minificador que não está nessa lista, exclua manualmente os dois arquivos abaixo e limpe o cache da CDN após uma atualização.

Para qualquer otimizador que essa configuração não cubra, exclua esses dois arquivos manualmente e teste o envio:

• /wp-content/plugins/pb-gforms-referral-tracking/assets/js/front-end.js
• /wp-content/plugins/pb-gforms-referral-tracking/assets/dist/js.cookie.min.js

Funciona com o Gravity Forms habilitado para AJAX?

Sim. Funciona com formulários AJAX e envios padrão (não AJAX). Redirecionamentos e confirmações de agradecimento na página em Gravity Forms 2.9+ exigem a versão 1.7.1 para o evento GA4.

Posso acompanhar mais de um formulário?

Sim. Funciona em todos os seus formulários do Gravity Forms. Cada envio salva seus próprios valores de atribuição para aquela entrada.

Isso substitui o GA4 / acompanhamento de conversões do Google Ads?

Não. É uma fonte de dados, não um pixel de conversão, e nunca dispara pixels nem contata o Google diretamente. Se você deseja a atribuição dentro do GA4, a configuração opcional do GA4/Gerenciador de tags a envia como um evento personalizado por meio da sua própria tag do Google na confirmação do formulário.

Coleta dados pessoais?

Por padrão, ele captura dados de atribuição (UTMs, gclid, URLs de referência). Isso faz não Por padrão, capturamos informações pessoais adicionais. Os campos do seu formulário e quaisquer parâmetros incluídos nos URLs são controlados pelas configurações do seu site e de marketing.

Está em conformidade com o GDPR/CCPA?

Se você precisar de consentimento antes que quaisquer dados de atribuição sejam coletados, habilite o controle de consentimento opcional. Ele armazena os dados do primeiro contato no navegador até que o visitante conceda o consentimento por meio do seu banner de cookies (via um sinalizador de janela, retorno de chamada ou evento), e então os aplica.

Funciona com uma rede WordPress Multisite?

Resumindo:

• Licença ilimitada: Ative o Modo de Rede uma vez; uma única tecla pode gerenciar tudo. todos os / cada Configurações e suporte do subsite.
• Ativado pela rede: Todos os sub-sites executam o rastreamento de referências e recebem atualizações imediatamente.
• Plano limitado / sem licença para subsite: O rastreamento está inativo nesse subsite. Nenhum campo de rastreamento, tag de mesclagem ou dado de entrada é capturado até que uma chave seja ativada ou o Modo de Rede envie uma.
• O suporte segue a licença: Os sites abrangidos pela chave ativa são elegíveis.

Sim, assim que cada subsite for licenciado e ativado. A ativação em rede instala o plugin em todos os lugares e as atualizações são gerenciadas em toda a rede, mas um subsite precisa de sua própria licença ativada (ou uma chave ilimitada enviada a ele via Modo de Rede) antes que o plugin adicione quaisquer campos de rastreamento ou capture quaisquer valores. Depois disso, ative a opção "Habilitar por padrão" nesse subsite ou habilite o rastreamento por formulário.

Se você possui uma licença ilimitada, pode ativar o Modo de Rede no site principal e enviar essa chave única para todos os subsites em lote (com acompanhamento em tempo real). Esses subsites herdam automaticamente as configurações e o suporte gerenciados pela licença.

Referência de configurações

Tudo abaixo vive sob Formulários → Definições → Acompanhamento de Recomendações, na aba indicada em cada cabeçalho.

Dados e Privacidade

Avançado

Portão de consentimento

Não há caixa de seleção para esta opção. O controle de consentimento é uma ativação opcional do desenvolvedor: definir consentRequired através do pb_gforms_referral_tracking_js_config filtro. O script de rastreamento armazena dados do primeiro contato em sessionStorage até que o consentimento seja obtido, então promove-se o armazenamento duradouro.

add_filter( 'pb_gforms_referral_tracking_js_config', function( $config ) {
    $config['consentRequired'] = true;
    return $config;
} );

Dê seu consentimento por meio do banner de cookies, escolhendo uma destas três maneiras que lhe convier:

• Definir window.PBReferralTrackingConsent = true.
• Despachar o evento: window.dispatchEvent( new Event( 'pb-ref-tracking:consent-granted' ) ).
• Atribua um consentGranted Função de retorno de chamada que retorna verdadeiro assim que o consentimento for obtido.

Ganchos

Ações

pb_gforms_referral_tracking_loaded

É acionado assim que o plugin estiver totalmente inicializado: classes carregadas, hooks registrados e API pronta. Este é o ponto de inicialização confiável para complementos ou plugins adicionais que estendem o Rastreamento de Origem de Referência.

Parâmetros:

• $plugin (Plugin) – A instância do plugin.

add_action( 'pb_gforms_referral_tracking_loaded', function( $plugin ) {
    // Safe to interact with the plugin's classes and filters here.
    // Example: register your own add-on after the plugin is ready.
    if ( class_exists( 'MyReferralAddon' ) ) {
        new MyReferralAddon( $plugin );
    }
} );

Filtros

pb_gforms_referral_tracking_enabled

Defina se o rastreamento de referências está ativado para um formulário específico. Retorne `true` para forçar o rastreamento a ser ativado e `false` para forçá-lo a ser desativado, independentemente da configuração específica do formulário ou do padrão global.

Parâmetros:

• $enabled (bool) – Se o rastreamento está ativado no momento.
• $form_id (int) – O ID do formulário atual.
• $form (array|nulo) – O array de metadados do formulário, ou nulo se não estiver disponível.

// Disable tracking on a specific form (e.g. an internal staff-only form).
add_filter( 'pb_gforms_referral_tracking_enabled', function( $enabled, $form_id, $form ) {
    $excluded_form_ids = [ 12, 27 ];
    if ( in_array( $form_id, $excluded_form_ids, true ) ) {
        return false;
    }
    return $enabled;
}, 10, 3 );

pb_gforms_referral_tracking_field_definitions

Filtra a matriz de definições de campos de rastreamento ocultos antes que o plugin os insira no formulário. Use isso para adicionar, remover ou modificar qualquer campo de rastreamento individual.

Parâmetros:

• $fields (variedade) – Matriz de matrizes de definição de campos.
• $form (variedade) – O formulário meta atual.

// Remove the Referral Parameters field from all forms.
add_filter( 'pb_gforms_referral_tracking_field_definitions', function( $fields, $form ) {
    return array_filter( $fields, function( $field ) {
        return ! isset( $field['cssClass'] ) || $field['cssClass'] !== 'pb-ref-tracking-ref-params';
    } );
}, 10, 2 );

pb_gforms_referral_tracking_form

Filtre o array completo do formulário depois que o plugin tiver adicionado todos os seus campos de rastreamento. O objeto de formulário final é seu para modificar antes de ser renderizado.

Parâmetros:

• $form (variedade) – O formulário com os campos de rastreamento já adicionados.
• $field_definitions (variedade) – As definições de campo que foram utilizadas.

// Log which forms have tracking fields injected (useful for debugging).
add_filter( 'pb_gforms_referral_tracking_form', function( $form, $field_definitions ) {
    error_log( 'Referral tracking fields added to form ID: ' . $form['id'] );
    return $form;
}, 10, 2 );

pb_gforms_referral_tracking_merge_tag_map

Modifique o mapa de tags de mesclagem que define quais tags de mesclagem estão disponíveis e a quais IDs de campo elas correspondem. Use isso para adicionar tags de mesclagem totalmente personalizadas ou renomear as existentes.

Parâmetros:

• $map (variedade) – Matriz associativa de tag => [ 'label' => string, 'field_id' => string ].
• $base_id (corda) – O prefixo do ID do campo base.
• $constants (Constantes) – A instância das constantes do plugin.

// Rename the "Source" merge tag label as it appears in the GF dropdown.
add_filter( 'pb_gforms_referral_tracking_merge_tag_map', function( $map, $base_id, $constants ) {
    if ( isset( $map['pb_ref_source'] ) ) {
        $map['pb_ref_source']['label'] = 'Traffic Source';
    }
    return $map;
}, 10, 3 );

pb_gforms_referral_tracking_value

Filtre o valor bruto de um campo de rastreamento antes que o plugin o formate e o utilize para substituir uma tag de mesclagem em uma notificação ou confirmação. Este é o local para higienizar ou transformar um valor específico.

Parâmetros:

• $value (corda) – O valor bruto do campo.
• $tag (corda) – A chave da tag de mesclagem (ex: pb_ref_source).
• $data (variedade) – Os metadados da tag de mesclagem (rótulo, id_do_campo).
• $entry (variedade) – A entrada atual.
• $form (variedade) – O formulário atual.

// Truncate long referrer URLs in merge tag output.
add_filter( 'pb_gforms_referral_tracking_value', function( $value, $tag, $data, $entry, $form ) {
    if ( $tag === 'pb_ref_referrer' && strlen( $value ) > 100 ) {
        return substr( $value, 0, 100 ) . '…';
    }
    return $value;
}, 10, 5 );

pb_gforms_referral_tracking_formatted_value

Filtre o valor da tag de mesclagem totalmente formatada depois que o Gravity Forms executar seu próprio pipeline de formatação (escape, codificação de URL, etc.).

Parâmetros:

• $formatted (corda) – A string de saída formatada.
• $tag (corda) – A chave da tag de mesclagem.
• $data (variedade) – Os metadados da tag de mesclagem.
• $entry (variedade) – A entrada atual.
• $form (variedade) – O formulário atual.
• $url_encode (bool)
• $esc_html (bool)
• $nl2br (bool)
• $format (corda)

// Wrap the source value in a bold tag in HTML-format notifications.
add_filter( 'pb_gforms_referral_tracking_formatted_value', function( $formatted, $tag, $data, $entry, $form, $url_encode, $esc_html, $nl2br, $format ) {
    if ( $tag === 'pb_ref_source' && $format === 'html' && ! $url_encode ) {
        return '<strong>' . $formatted . '</strong>';
    }
    return $formatted;
}, 10, 9 );

pb_gforms_referral_tracking_default_value

Substitui o valor de fallback usado quando um campo de rastreamento está vazio no momento do envio. O padrão é "Desconhecido".

Parâmetros:

• $default (corda) – O valor padrão atual (“Desconhecido”).
• $key (corda) – Chave de contexto: source, referrer ou front_end.

// Use "Direct" instead of "Unknown" for the source field fallback.
add_filter( 'pb_gforms_referral_tracking_default_value', function( $default, $key ) {
    if ( $key === 'source' ) {
        return 'Direct';
    }
    return $default;
}, 10, 2 );

pb_gforms_referral_tracking_js_config

Substitua todo o objeto de configuração JavaScript do front-end antes que o plugin o passe para o script de rastreamento. Seu callback controla as configurações de cookies e os mapas de origem (utmSourceMap e utmReferrerMap), fontes conhecidas e o paidClickIds lista que define quais parâmetros de consulta comprovam um clique pago.

Parâmetros:

• $config (variedade) – O array de configuração JS completo.

As chaves, com seus valores padrão:

sourcePatterns está deliberadamente ausente dessa lista. Suas entradas precisam de JavaScript ativo. RegExp objetos, e tudo o que um callback do PHP retorna chega como uma string assim que a configuração é codificada em JSON, o que gera um erro no momento da correspondência. Para estender os padrões de referência, atribua a window.PBReferralTrackingConfig a partir do JavaScript, antes da execução do script de rastreamento.

// Extend cookie lifetime to 30 days and add a custom paid medium.
add_filter( 'pb_gforms_referral_tracking_js_config', function( $config ) {
    // Extend the first-touch attribution window to 30 days.
    $config['cookieExpiry'] = 30;

    // Turn on the cookieless localStorage fallback for visitors who block cookies.
    $config['fallbackStorage'] = 'local';

    return $config;
} );

pb_gforms_referral_tracking_custom_sources

Injetar programaticamente regras de origem personalizadas que são executadas em conjunto com as regras configuradas na interface de administração. O plugin mescla as regras deste filtro com as regras da interface salvas, classifica o conjunto combinado por prioridade e o envia para o front-end.

Parâmetros:

• $sources (variedade) – Matriz vazia. Retorna uma matriz de matrizes de regras para adicionar.

Cada regra deve ter: rótulo, campo de correspondência (referrer, utm_source, utm_medium, utm_campaign, utm_term, utm_content), tipo de correspondência (contém ou é igual a), valor de correspondência e, opcionalmente, prioridade (padrão 10, prioridades maiores são executadas primeiro).

As regras adicionadas por meio deste filtro também podem usar referrer_url como o campo `matchField`, que compara a URL de referência completa, incluindo seu caminho e consulta, em vez de apenas o host. A interface de administração não oferece essa opção, portanto, ela está disponível apenas aqui.

// Add partner and affiliate sources without touching the admin UI.
add_filter( 'pb_gforms_referral_tracking_custom_sources', function( $sources ) {
    $sources[] = [
        'label'      => 'Partner: Acme Corp',
        'matchField' => 'referrer',
        'matchType'  => 'contains',
        'matchValue' => 'acme.com',
        'priority'   => 20,
    ];
    $sources[] = [
        'label'      => 'Campaign: Spring Sale',
        'matchField' => 'utm_campaign',
        'matchType'  => 'contains',
        'matchValue' => 'spring-sale',
        'priority'   => 10,
    ];
    return $sources;
} );

pb_gforms_referral_tracking_source_label

Insira seu próprio rótulo em um campo "Origem Personalizada" separado no momento do envio. A Origem detectada nunca é alterada, portanto, a entrada mantém ambas: o que o plugin identificou e o que você retornou. Útil quando um CRM precisa de um rótulo simplificado ou interno e você não quer perder a origem real. Desde a versão 1.6.0.

A vinculação de um callback é o que ativa o recurso. Sem nada vinculado, os campos de Origem Personalizada e suas tags de mesclagem não existem. Adicione um callback e o plugin começará a adicionar um campo de Origem Personalizada aos seus formulários, além de um campo de Origem Personalizada (Último toque) quando a atribuição de último toque estiver ativada. Retorne uma string vazia para deixar o campo em branco para uma determinada visita; ele não usará o rótulo detectado como padrão.

Parâmetros:

• $label (corda) – O rótulo da fonte detectada, por exemplo Google Ads.
• $key (corda) – Qual toque está sendo rotulado: source ou last_source.
• $form (variedade) – O objeto de formulário atual.

// Roll the detected source up into a few buckets for the CRM.
add_filter( 'pb_gforms_referral_tracking_source_label', function( $label, $key, $form ) {
    if ( 0 === strpos( $label, 'Google' ) || 0 === strpos( $label, 'Bing' ) ) {
        return 'Search';
    }
    if ( 0 === strpos( $label, 'Facebook' ) || 0 === strpos( $label, 'Instagram' ) ) {
        return 'Social';
    }

    // Anything else: leave the Custom Source field empty.
    return '';
}, 10, 3 );

pb_gforms_referral_tracking_enqueue_assets

Controla se os recursos de front-end do plugin (biblioteca de cookies e script de rastreamento) são enfileirados. Retorne falso para desativar completamente o carregamento em uma página ou condição.

Parâmetros:

• $enqueue (bool) – Indica se os recursos devem ser enfileirados. O padrão é verdadeiro.

// Disable tracking assets on the homepage only.
add_filter( 'pb_gforms_referral_tracking_enqueue_assets', function( $enqueue ) {
    if ( is_front_page() ) {
        return false;
    }
    return $enqueue;
} );

pb_gforms_referral_tracking_inline_css

Substitua o CSS embutido que oculta os campos de rastreamento no front-end e na pré-visualização do editor de blocos. O CSS padrão oculta os elementos de rastreamento, o rastreador legado do Google Ads e os campos espelhados, além de direcionar para... .gform_wrapper .gfield com os prefixos de classe pb-ref-tracking-, pb-gads-tracking- e pb-ref-mirror-.

Parâmetros:

• $css (corda) – A string CSS embutida.

// Replace the default hide rule with a more specific selector.
add_filter( 'pb_gforms_referral_tracking_inline_css', function( $css ) {
    return '.my-theme .gform_wrapper .gfield[class*="pb-ref-tracking-"] { display: none !important; }';
} );

pb_gforms_rt_invalidate_debounce

Ajuste (ou desative) o intervalo de debounce para invalidação do cache de relatórios. Após a entrada de um novo dado, o cache de relatórios é reconstruído no máximo uma vez a cada determinado número de segundos, para evitar que formulários com alto volume de acessos o sobrecarreguem. O padrão é 60 segundos; retorne 0 para invalidar imediatamente a cada entrada.

Parâmetros:

• $seconds (int) – A janela de debounce em segundos. O padrão é 60.

// Rebuild Reports data immediately on every new entry (no debounce).
add_filter( 'pb_gforms_rt_invalidate_debounce', function( $seconds ) {
    return 0;
} );

pb_gforms_referral_tracking_mirror_field_definitions

Personalize as definições de campos espelhados persistentes criadas quando campos espelhados são adicionados a um formulário. label é a parte que você pode trocar sem problemas.

Sair cssClass sozinho. No momento do envio, o plugin lê a chave de rastreamento canônica de volta, tudo depois disso. pb-ref-mirror-, Para encontrar o valor a ser copiado, renomeie a classe e o campo espelhado será enviado vazio todas as vezes.

Parâmetros:

• $fields (variedade) – Matriz de matrizes de definição de campo espelhado.
• $form (variedade) – O formulário meta atual.

// Prefix every mirror field label so they're easy to spot in the editor.
add_filter( 'pb_gforms_referral_tracking_mirror_field_definitions', function( $fields, $form ) {
    foreach ( $fields as &$field ) {
        $field['label'] = 'Tracking: ' . $field['label'];
    }
    return $fields;
}, 10, 2 );

pb_gforms_referral_tracking_docs_url

Reatribua o link "Saiba mais na documentação" exibido na tela de configurações. Útil em instalações de marca branca ou agências que mantêm sua própria documentação.

Parâmetros:

• $url (corda) – O URL da documentação. Insira o seu próprio para substituí-lo.

// Point the settings-screen docs link at our own handbook.
add_filter( 'pb_gforms_referral_tracking_docs_url', function( $url ) {
    return 'https://example.com/handbook/referral-tracking/';
} );