Configurando conta OAuth

Alimentar um dashboard com dados de Meta, Google Ads ou GA4 são dois passos: primeiro você autoriza a plataforma via OAuth, depois ativa quais contas daquela plataforma viram fonte de dados. Já dentro do dashboard, cada página vincula as contas que usa. A fonte do próprio TagServer (o card "Regras" no drawer de fontes) são os dados do seu rastreamento e não passa por OAuth nem pela página Fonte de dados.

Autorizar a plataforma

A autorização OAuth fica na tela Minha conta, no card "Conexões". Para chegar lá, abra o dropdown Meu perfil e clique em Minha conta.

A conexão é pessoal: ela acompanha você em todos os workspaces. As contas que você ativa depois, na página Fonte de dados, pertencem ao workspace.

Cada plataforma tem uma linha no card, com o status "Conectado" ou "Não conectado". Numa linha ainda não conectada, "Conectar" dispara o fluxo OAuth oficial da plataforma. Uma linha já conectada oferece "Reconectar" e "Desconectar"; ao clicar em "Desconectar", o modal "Desconectar conta" pede confirmação.

O fluxo OAuth não abre em pop-up: é um redirecionamento de página inteira para a plataforma. Ao terminar, o navegador volta para Minha conta.

Aviso

O card lista cinco plataformas: Google Ads, Meta Ads, Google Analytics, LinkedIn Ads e Google Ads (Conversões). LinkedIn Ads e Google Ads (Conversões) servem para envio de conversões: conectá-las não traz dados para nenhum dashboard.

Ativar as contas como fonte de dados

Com a plataforma autorizada, falta escolher quais contas alimentam os dashboards. Você faz isso na página Fonte de dados ou no drawer que aparece enquanto monta um dashboard.

Pela página Fonte de dados

Abra Fonte de dados pela barra lateral, no grupo "Análise". Se a página inteira mostrar "Análise não está no seu plano", o seu plano não inclui o recurso: a página pede que você contrate o plano Tag Pro para conectar as fontes de dados e montar dashboards.

No cabeçalho da página, o botão "Conectar fonte de dados" abre um menu:

"Conectar nova conta" leva para Minha conta, já rolada até o card "Conexões", onde você autoriza uma plataforma nova.
O grupo "Conectadas" tem uma linha por plataforma. Se a conexão é sua, a linha diz "Gerenciar contas do ", com a legenda "Conectada por você · N conta(s) ativa(s)". Se outro membro do workspace conectou, ela diz "Ver contas do ", com "Conectada por · só leitura": você usa essas contas nos dashboards, mas só lê. Uma plataforma só aparece no grupo se você a conectou ou se ela já tem fontes ativas.

Cada linha abre o drawer "Contas do ", com a busca "Buscar conta…". É nele que você ativa ou pausa as contas daquela plataforma.

O corpo da página tem dois cards. "Fontes ativas" é a tabela das contas que alimentam os dashboards, com as colunas Plataforma, Conta, Responsável e Status; a chave "Mostrar inativas" inclui as contas inativas na tabela, e o menu de cada linha oferece "Pausar", "Reativar" e "Remover conta". "Jobs recentes" é a tabela dos jobs de coleta, onde você confere se a coleta está rodando (veja Solução de problemas).

Enquanto monta um dashboard

O mesmo trabalho aparece no drawer "Configuração de fontes de dados" ("Selecione a plataforma e vincule a organização e as contas."). Para abri-lo, use a seção "Dados" da paleta de widgets, que fica sempre visível: clique no item "Fonte de Dados" (tooltip "Configurar fonte de dados"), sob o subtítulo "Selecione a fonte de dados".

O drawer não tem abas. Ele começa com uma grade de cards de plataforma em duas colunas: Google Analytics, Google ADS, Meta ADS e Regras (este com a marca do TagServer). Clicar num card abre um segundo painel lateral com o formulário daquela plataforma; no desktop, a grade dá lugar a um trilho vertical de ícones.

As fontes que você escolhe aqui ficam salvas na página ativa do dashboard, então cada página tem as suas.

Aviso

Se a página já tem widgets, trocar a organização no passo 1 desvincula todos eles das contas atuais (veja Tier 1 e Tier 2).

Escolha a organização (Tier 1) no dropdown: "Selecione a Business Manager (BM)" (Meta), "Selecione a conta MCC" (Google Ads), "Selecione a conta Analytics" (GA4) ou "Selecione a conta TagServer" (Site). O dropdown lista apenas organizações com contas ativas; se estiver vazio, ative contas na página Fonte de dados.
Sob "Contas Ativas", clique no botão "Selecionar contas…" para abrir o popover. A busca fica dentro dele, no campo "Buscar conta…". Cada conta traz checkbox, nome e "ID: "; a seleção é múltipla e, sem resultados, aparece "Nenhuma conta encontrada".
As contas marcadas passam para o bloco colapsável "Fontes Ativas (N)", expandido por padrão, com remoção item a item.

No card Regras (a plataforma do TagServer), o formulário fala de sites em vez de contas: o rótulo é "Sites", o botão é "Selecionar sites…", a busca é "Buscar site…" e o vazio mostra "Nenhum site encontrado".

Ver as fontes da página

Quando a página tem fontes, a linha de filtros do dashboard mostra, no extremo direito, o badge "Fontes:" seguido da marca de cada plataforma. Passe o mouse sobre uma marca para ver a conta no formato " · ".

Na visualização, o badge é só leitura. Em modo de edição, cada marca vira um botão que reabre o drawer "Configuração de fontes de dados", o mesmo da paleta de widgets.

Tier 1 e Tier 2

A ativação tem dois níveis. O Tier 1 é a organização: o Business Manager no Meta, o MCC no Google Ads, a Conta Analytics no GA4 e, no Site, o próprio workspace TagServer. O Tier 2 são as contas individuais que carregam os dados para os widgets; no Site, são os servidores registrados. Você escolhe primeiro o Tier 1 e, dentro dele, as contas Tier 2.

Aviso

Numa página que já tem widgets, trocar o Tier 1 desvincula todos eles das contas atuais. O app abre a confirmação "Os widgets desta página vão perder a fonte de dados", e a troca só acontece se você clicar em "Trocar de organização". Os widgets continuam na página, com as métricas e o layout que você montou, mas ficam sem dados até você ativar contas da nova organização.

Solução de problemas

Conectou à conta errada: desconecte a plataforma no card "Conexões" em Minha conta e refaça a autorização com a conta certa.
O dropdown de organização está vazio: nenhuma organização daquela plataforma tem contas ativas. Ative as contas na página Fonte de dados e volte ao drawer.
Os dados pararam de atualizar: na página Fonte de dados, abra "Jobs recentes" e confira o status de cada job de coleta. O período padrão é dos últimos 30 dias; amplie o seletor de período para ver jobs mais antigos. Sem jobs no período, a tabela mostra "Nenhum job de coleta ainda". Num job com falha, use "Tentar novamente" no menu "…" da linha para reprocessar a coleta (exige permissão de escrita no workspace). Se a falha persistir, entre em contato com o suporte.

Veja também

OAuth e hierarquia de contas: por que a autorização e as contas se organizam em dois níveis.
Configurar widgets: adicionar métricas depois de ativar as contas.
Relatórios e métricas: referência dos dados disponíveis.