Guia de ajuda do BigQuery

Siga estas etapas para conectar seus dados do AccuRanker ao Google BigQuery.

Pré-requisitos

Para conectar o BigQuery ao AccuRanker, você precisa de:

• Uma assinatura do AccuRanker de 20 mil palavras-chave ou superior.
• Entrar em contato com o suporte ao cliente do AccuRanker com uma solicitação para ativar o Big Query.
• Uma conta do Google Cloud com uma instância do Google BigQuery.
• Faturamento ativado no Google BigQuery.
• Permissões para atribuir funções específicas a uma conta de serviço do Google.

Guia passo a passo para configurar o acesso ao BigQuery

1. Criar conta de serviço

Siga a documentação do Google Criar uma chave de conta de serviço para configurar a autenticação da chave de conta de serviço.

2. Configurar permissões da conta de serviço

Suportamos três cenários de permissão diferentes para conceder as permissões necessárias à conta de serviço. Se ainda não tiver configurado as permissões, leia a documentação Gerir o acesso às contas de serviço da Google.

Pode conceder acesso ao projeto ou a um único conjunto de dados.

| Permissões Tipo | Função | Recurso | |------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------| | Função de administrador do BigQuery | Administrador do BigQuery | Projeto ou conjunto de dados já criado | Proprietário de dados do BigQuery e usuário do trabalho do BigQuery | Proprietário de dados do BigQuery

BigQuery Job User | Projeto ou Dataset já criado | | Funções IAM personalizadas | bigquery.tables.create

bigquery.tables.get

bigquery.tables.update

bigquery.tables.updateData

bigquery.tables.delete

bigquery.jobs.create | Projeto ou conjunto de dados já criado

Criar chaves de conta de serviço

Para usar o fluxo da conta de serviço, é necessário fornecer o arquivo JSON da sua conta de serviço.

1. Crie uma nova chave selecionando o formato JSON.
2. Clique em Criar.
3. Baixe o arquivo JSON para um local seguro; esse arquivo é essencial para se conectar ao BigQuery.

Concluir a configuração do BigQuery

1. Vá para o domínio que deseja conectar ao BigQuery.
2. Na visão geral, clique em "Integrações", onde você pode encontrar a integração do BigQuery.
3. Dê um nome à conexão e especifique um local para o conjunto de dados.

• Se não tiver a certeza da localização, pode ler sobre as diferentes localizações aqui.

1. Carregue a chave JSON da conta de serviço e clique em "Conectar".

• Se já tiver criado um conjunto de dados, certifique-se de que a localização do conjunto de dados corresponde ao conjunto de dados já criado.Em seguida, testaremos a conexão e avisaremos quando a conexão tiver sido testada com êxito.

(Opcional) Preenchimento de dados históricos

Agora você pode ir para as configurações do seu domínio e iniciar um backfill dos dados do AccuRanker se precisar de dados históricos.

Como atualizamos o BigQuery e os dados de backfill

Garantimos que os nossos dados do BigQuery são actualizados diariamente para refletir as alterações mais recentes. Todos os dias, anexamos novos dados do dia anterior. Essa abordagem garante que todos os conjuntos de dados críticos permaneçam atualizados, preservando os registros históricos para análise.

Processo de atualização diária

O processo de atualização centra-se nos seguintes conjuntos de dados:

Todas as classificações dee Classificações* próprias de*

• Estes conjuntos de dados são actualizados diariamente através da inclusão de novos dados.
• Mantêm um registo abrangente e atualizado das classificações.

Metadados de palavras-chave* e metadados de concorrentes*

• Estes conjuntos de dados são aumentados sempre que necessário.
• São incorporados novos registos ou os existentes são actualizados para garantir que os metadados permanecem exactos e completos.

Ciclo de atualização mensal

Para além das actualizações diárias, os conjuntos de dados Searchvolume* e AI*search_volume são geridos num ciclo mensal.

• Calendário de atualização: No dia 15 de cada mês, estas tabelas são truncadas e substituídas pelos dados mais recentes do Planeador de palavras-chave do Google (GKP) e por métricas de volume de pesquisa actualizadas.
• Objetivo: Este processo assegura que estão disponíveis as informações mais exactas e recentes.
• Dados históricos: Estes conjuntos de dados incluem dados de backfill que abrangem os últimos quatro anos, fornecendo uma perspetiva histórica robusta para a análise de tendências.

Dados de backfill

Após uma ligação bem sucedida, pode optar por preencher os seus dados. Veja como isso funciona:

• Âmbito: Decida até que ponto pretende efetuar o backfill. Pode fazer o backfill de dados até à data da sua primeira classificação.
• Restrições: Para evitar comportamentos maliciosos, só é possível fazer backfill uma vez. Se precisar fazer backfill novamente, é necessário solicitar isso por meio do suporte ao cliente.

Guia de esquema do BigQuery

A convenção de nomenclatura para as tabelas será

accuranker{schemaname}{ourinternaldomainslug}

Os nomes dos esquemas estão listados abaixo e cada esquema pode ser descarregado em formato JSON.

• palavra-chave_metadados
• metadados_concorrentes
• próprios_ranks
• todos_ramos
• volume_de_pesquisa
• *AIvolume*de pesquisa

Descrições das tabelas

| Nome da tabela | Descrição | |-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | all_ranks | Esta tabela contém todas as informações sobre a classificação de palavras-chave, incluindo classificações dinâmicas e concorrentes. | Esta tabela contém todas as informações sobre as classificações de palavras-chave que você acompanha. | Esta tabela contém detalhes das palavras-chave rastreadas atualmente, incluindo tags e configurações específicas de domínio. | Esta tabela contém detalhes dos concorrentes rastreados atualmente, incluindo configurações para concorrentes. | Esta tabela contém o volume de pesquisa mensal para cada palavra-chave. Se a palavra-chave tiver um local, ela mostra os volumes de pesquisa específicos do local e no nível do país. Se nenhum local for especificado, o volume de pesquisa é o mesmo para ambos. | Esta tabela contém o volume de pesquisa mensal do AI para cada palavra-chave. Ela inclui a pesquisavolume* para um tipo de pesquisa específico e a pesquisa*volume_total para ambos os tipos de pesquisa combinados. |