Como configurar a integração do Tableau para análises

Leve suas análises do Vista Social para o Tableau e crie seus próprios painéis. O Tableau busca seus dados diretamente no Vista Social e pode atualizá-los conforme uma programação, para que seus painéis estejam sempre atualizados.

O que você pode exportar

• Publicações: uma linha por publicação, com a data, o perfil, a rede, o tipo de publicação e métricas como impressões, engajamento, curtidas, comentários, compartilhamentos e reproduções.
• Dados diários do perfil: uma linha por perfil por dia, com métricas como seguidores, impressões, engajamento, alcance e o número de publicações feitas naquele dia.

Antes de começar

• A integração com o Tableau faz parte do complemento Premium integrations.
• Sua conta precisa ter API access, que também é um complemento. Se você não encontrar Generate API key em Settings → Integrations, entre em contato com nossa equipe de suporte para adicioná-lo.
• Você precisa de uma chave de API do Vista Social. Acesse Settings → Integrations e clique em Generate API key se ainda não tiver uma. Mantenha a chave em sigilo: qualquer pessoa que a tenha pode ler os dados da sua conta.
• Você pode usar o Tableau Cloud, o Tableau Desktop 2023.3 ou versões posteriores, ou o Tableau Server 2026.1 ou versões posteriores. O Tableau Cloud já vem com o conector REST API. O Tableau Desktop e o Tableau Server precisam de uma instalação única do driver (consulte Using Tableau Desktop or Tableau Server abaixo).

Etapa 1: encontre o ID do seu grupo de perfis

Cada exportação inclui um grupo de perfis. Para ver seus grupos de perfis e os respectivos IDs:

1. No Tableau, clique em New → Published Data Source, abra a guia Connectors e escolha REST API.
2. Na guia General, insira este endereço em REST API URL, defina Response Format como JSON e Authentication como No Authentication:

https://vistasocial.com/api/integration/tableau/groups

3. Na guia Advanced, digite sua chave de API em HTTP Headers neste formato: x-api-key: YOUR_API_KEY

4. Clique em Sign In. Você verá o Id, o Name e o Type de cada grupo de perfis ao qual tem acesso. Copie o Id do grupo sobre o qual quer criar relatórios.

Etapa 2: Conecte o Tableau aos seus dados

1. Clique novamente em New → Published Data Source → Connectors → REST API.
2. Na guia General, preencha:
   • REST API URL: seu endereço de exportação (consulte Monte seu endereço de exportação abaixo)
   • Response Format: CSV, com CSV Delimiter definido como ,
   • Authentication: No Authentication
3. Na guia Advanced, insira x-api-key: YOUR_API_KEY em HTTP Headers, da mesma forma que na Etapa 1.
4. Clique em Sign In. O Tableau carrega seus dados e lista os campos.
5. Confira os tipos de campo. Date deve exibir o ícone de calendário. Se Published At exibir Abc, clique no ícone e escolha Date & Time.

6. Clique em Publish As, dê um nome à fonte de dados e publique-a.

Sempre que possível, mantenha sua chave de API em HTTP Headers, pois os endereços da web costumam ser salvos em registros e no histórico do navegador.

Monte seu endereço de exportação

Comece com este endereço e substitua GROUP_ID pelo ID da Etapa 1:

https://vistasocial.com/api/integration/tableau/data?group=GROUP_ID&export_type=post&format=csv&days=90

Em seguida, ajuste as opções:

• export_type: post para uma linha por publicação ou daily para uma linha por perfil por dia.
• format: mantenha csv para o Tableau. Sem essa opção, os dados serão retornados em JSON.
• days: de 1 a 360. É um período móvel que termina hoje e avança a cada atualização.
• date_from e date_to: um intervalo fixo no formato YYYY-MM-DD, de até 360 dias. Use essas opções em vez de days. Se você adicionar as duas, days será usado.

Veja alguns exemplos:

• Publicações dos últimos 30 dias: &export_type=post&format=csv&days=30
• Dados diários do perfil dos últimos 90 dias: &export_type=daily&format=csv&days=90
• Dados diários do perfil do primeiro semestre do ano: &export_type=daily&format=csv&date_from=2026-01-01&date_to=2026-06-30

Para criar relatórios sobre publicações e dados diários do perfil, crie uma fonte de dados para cada um.

Etapa 3: mantenha seus dados atualizados

O Tableau armazena uma cópia dos seus dados, chamada extração. Para atualizá-la automaticamente:

1. Abra a fonte de dados publicada no Tableau.
2. Acesse Extract Refreshes e crie uma programação de atualização, por exemplo, todos os dias às 6h.

Com days no endereço, cada atualização busca os dados mais recentes dos últimos dias.

Usando o Tableau Desktop ou o Tableau Server

As configurações de conexão são as mesmas da Etapa 2. Primeiro, instale o driver REST API uma única vez:

1. Baixe o driver REST API (JDBC) na página de download de drivers do Tableau.
2. Mova o arquivo .jar para a pasta de drivers do Tableau:
   • Windows: C:\Program Files\Tableau\Drivers
   • macOS: ~/Library/Tableau/Drivers
   • Linux: /opt/tableau/tableau_driver/jdbc
3. Reinicie o Tableau.
4. No Tableau Desktop, acesse Connect → To a Server → REST API e preencha as guias General e Advanced como na Etapa 2.

No Tableau Server, o administrador do servidor instala o driver no servidor para que os extratos publicados possam ser atualizados automaticamente conforme uma programação.

Observações importantes

• O Tableau define o tipo de cada coluna quando você cria a fonte de dados pela primeira vez. Se uma métrica não tinha valores naquele momento, como as métricas de stories de um grupo que ainda não tinha stories, o Tableau pode tratá-la como texto. Clique no ícone de tipo do campo e escolha Number (whole) ou Number (decimal).
• As datas e os horários das publicações usam o fuso horário de cada publicação, exibido na coluna Timezone.
• Os dados diários do perfil incluem alguns campos de lista, como Hourly, Hashtags e Page Fans Country. Eles são recebidos como texto e é melhor não incluí-los nos gráficos.
• Uma exportação abrange até 360 dias. Para consultar um histórico mais longo, crie uma fonte de dados para cada período.
• Gerar uma nova chave de API desativa a antiga. Edite a fonte de dados e insira a nova chave no cabeçalho x-api-key, ou as atualizações deixarão de funcionar.

Solução de problemas

• Chave de API inválida: confira se o cabeçalho x-api-key contém sua chave atual em Settings → Integrations.
• Não é permitido acessar este grupo de perfis: confira o ID do grupo da Etapa 1. Você só pode exportar grupos aos quais tem acesso.
• date_from e date_to são obrigatórios, no formato YYYY-MM-DD: adicione days ao seu endereço ou informe as duas datas no formato YYYY-MM-DD.
• Limite as consultas a 360 dias por vez: reduza o intervalo de datas para 360 dias ou menos.
• Sua assinatura não oferece integrações: o acesso à API não está ativo na sua conta. Entre em contato com nossa equipe de suporte para adicioná-lo.
• Sua assinatura não inclui o complemento de integrações premium: o complemento de integrações premium não está ativo na sua conta. Entre em contato com nossa equipe de suporte para adicioná-lo.
• Muitas solicitações: as conexões do Tableau têm um limite por minuto próprio. Atualize novamente após um minuto e evite atualizar várias fontes de dados ao mesmo tempo.

Perguntas frequentes

Q: De qual versão do Tableau preciso?

A: O Tableau Cloud funciona imediatamente. O Tableau Desktop 2023.3 ou posterior e o Tableau Server 2026.1 ou posterior também funcionam após a instalação única do driver REST API.

Q: Posso exportar mais de um grupo de perfis?

A: Cada fonte de dados abrange um grupo de perfis. Crie uma fonte de dados para cada grupo sobre o qual deseja gerar relatórios.

Q: Os dados são os mesmos dos relatórios do Vista Social?

A: Sim. O Tableau lê os mesmos dados de publicações e de perfis diários que o Vista Social usa nos seus relatórios, para que você possa combiná-los e criar gráficos da maneira que preferir.

Precisa de ajuda?

Entre em contato com nossa equipe de suporte. Será um prazer ajudar.

Leitura relacionada:

Como configurar a integração com o Looker Studio para análise de dados

Como configurar a integração com o Power BI para análise de dados

Inscreva-se agora e experimente o Vista Social por 14 dias, grátis!