Conectar o Google Analytics ao Power BI Data Connector

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Neste artigo, saiba como estabelecer uma conexão perfeita entre o Power BI e o Azure DevOps usando o Data Connector. Essa integração permite extrair informações valiosas de seus dados de DevOps do Azure e criar relatórios atraentes no Power BI. O Power BI Data Connector usa modos de exibição do Google Analytics.

Importante

As vistas do Analytics suportam apenas dados do Azure Boards (itens de trabalho). As vistas do Analytics não suportam outros tipos de dados, como pipelines. As vistas fornecem uma lista plana de itens de trabalho e não suportam hierarquias de itens de trabalho. Neste ponto, não temos planos para atualizar o conector para suportar outros tipos de dados. Para obter informações sobre outras abordagens, consulte Acerca da integração do Power BI.

Pré-requisitos

• Familiarize-se com O que é o Google Analytics e a base de dados de conhecimento dos artigos do Power BI.
• Instale a Atualização de outubro de 2018 do Power BI Desktop ou uma versão mais recente.
• Certifique-se de que é membro do projeto. Se não estiver, seja adicionado agora. Qualquer pessoa com acesso ao projeto, exceto as partes interessadas, pode visualizar as visualizações do Google Analytics.
• Certifique-se de que o Boards está ativado. Caso contrário, as visualizações do Google Analytics não serão exibidas. Para reativar painéis, consulte Ativar ou desativar um serviço de DevOps do Azure.
• Verifique se você tem as permissões necessárias para acessar o Google Analytics. Se você for membro do grupo de Colaboradores do projeto, terá permissão.
• Crie um modo de exibição do Google Analytics que você deseja criar um relatório do Power BI.

Importante

O Azure DevOps não dá suporte à autenticação de Credenciais Alternativas. Se você ainda estiver usando Credenciais Alternativas, recomendamos que mude para um método de autenticação mais seguro.

Conectar-se a uma visualização do Google Analytics

1. Abra Power BI Desktop.

2. Inicie sessão no serviço. O acesso pela primeira vez requer que inicie sessão e tenha as suas credenciais autenticadas. O Power BI Desktop salva suas credenciais para que você só precise fazer isso uma vez.

   Nota

   O Azure DevOps não oferece suporte a cenários entre locatários usando OAuth. Em vez disso, use entidades de serviço e identidades gerenciadas.

3. Selecione Conectar após a verificação de suas credenciais.

   

4. Selecione Obter Serviços de Dados>Online e, em seguida, selecione Azure DevOps (somente Painéis) para serviços de nuvem ou selecione Servidor de DevOps do Azure (somente Painéis) para local. Selecione Ligar. As visualizações do Google Analytics suportam apenas consultas em itens de trabalho e casos de teste.

   

5. Especifique os parâmetros básicos para se conectar aos seus dados.

   

   Importante

   Não confunda o nome da equipe com o nome do projeto, que é um erro comum. Por exemplo, se a URL que você usa for http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/Device, Fabrikam-Fiber-Git é o nome do projeto e Device é o nome da equipe.

   Após a entrada bem-sucedida, o Power BI verifica se suas credenciais de usuário têm permissões para acessar o projeto especificado. Se surgirem erros, consulte as Perguntas frequentes para obter soluções para os problemas mais comuns.

Selecione a visualização do Google Analytics

1. Expanda a pasta Vistas Partilhadas , selecione uma vista do Analytics e, em seguida, selecione Carregar. O Conector de Dados apresenta uma lista de visualizações disponíveis do Google Analytics. Cada modo de exibição representa um conjunto de dados que você pode extrair para o Power BI. Também pode criar vistas personalizadas do Analytics.

   A imagem a seguir mostra as visualizações padrão do Google Analytics. Sua lista de exibições pode diferir com base no modelo de processo usado para criar seu projeto. Todos os modos de exibição listados, exceto os modos de exibição anexados com "Hoje", fornecem dados de tendências históricas.

   No exemplo a seguir, selecionamos Histórias - Últimos 30 dias, que filtra os itens da lista de pendências do produto.

   

   Nota

   Como você verificou o modo de exibição na seção anterior, o modo de exibição deve ser carregado. Se a exibição não carregar, é mais provável que seja porque o conjunto de dados é muito grande. Regresse à vista na vista do Analytics no portal Web e ajuste os filtros para diminuir o tamanho do conjunto de dados.

2. Selecione a vista.

   

   Nota

   A pré-visualização apresentada para quaisquer vistas selecionadas no navegador pode ser truncada dependendo do número de campos selecionados e do tamanho do conjunto de dados. Os dados são truncados apenas para a visualização e não afetarão a atualização completa dos dados.

   • Selecione a tabela Itens de Trabalho - Hoje e aguarde o carregamento da visualização. Ele representa o estado atual de todos os itens de trabalho no projeto.
   • Marque a caixa de seleção ao lado da tabela Itens de Trabalho - Hoje e selecione Carregar.

   Nota

   As exibições do Google Analytics não aplicam filtros definidos usando o Power BI no servidor. Todos os filtros aplicados no Power BI limitam os dados mostrados aos usuários finais, mas não reduzem a quantidade de dados recuperados do Google Analytics. Se o filtro se destinar a reduzir o tamanho do conjunto de dados, aplique-o personalizando a exibição.

3. Aguarde até que os dados sejam carregados. Você pode observar seu progresso observando as mensagens de status, que aparecem diretamente sob o nome da tabela. Se vir algum erro, consulte a secção Perguntas frequentes para obter soluções para os problemas mais comuns.

   

4. Analise o modelo de dados. Enquanto o modelo é carregado, revise o design do conjunto de dados para o Power BI Data Connector.

Criar um relatório

Crie um relatório com base nos dados carregados. Após a conclusão da operação de carregamento, você pode explorar os dados criando relatórios personalizados. Para obter exemplos de relatórios comuns, consulte Data Connector - Exemplos de relatórios.

FAQs

Encontre respostas para perguntas comuns sobre o Power BI Data Connector e mensagens de erro do Analytics.

P: Como devo ler as mensagens de erro provenientes do conector?

R: Você pode se sentir desafiado a ler mensagens de erro provenientes do conector porque elas geralmente contêm informações contextuais extras. Se a operação de carregamento falhar, a mensagem começa com "Falha ao salvar modificações no servidor...". Quando você vê-lo, procure por [DataSource.Error] Azure DevOps...:. O exemplo a seguir mostra a mensagem de erro retornada do conector. A parte mais importante da mensagem de erro é "O resultado da consulta excede o tamanho máximo. Reduza o número de registros aplicando filtros adicionais."

P: Como resolvo o "O resultado da consulta excede o tamanho máximo. Reduzir o número de registros aplicando filtros adicionais" erro?

R: Você receberá o seguinte erro se o número de registros recuperados do Google Analytics exceder 250.000:

"Falha ao salvar modificações no servidor. Erro retornado: 'Erro OLE DB ou ODBC: [DataSource.Error] VSTS: Falha na solicitação: O servidor remoto retornou um erro: (400) Solicitação incorreta. (O resultado da consulta excede o tamanho máximo. Reduza o número de registros aplicando filtros adicionais).'"

Este erro normalmente ocorre quando seu projeto tem um grande número de itens de trabalho. Reduza o tamanho do conjunto de dados personalizando a exibição. Faça esta etapa antes de usá-lo no Power BI.

P: Como resolvo o erro "o utilizador não foi autorizado"?

R: Poderá obter este erro se tentar aceder a um projeto para o qual não tem permissões. Você também pode vê-lo se o Power BI não reconhecer suas credenciais. Para verificar suas permissões, consulte Definir permissões para acessar as visualizações do Google Analytics e do Google Analytics. Se for um problema de credencial, trabalhe com o administrador para ver se ele pode ajudar a resolver o problema. Para obter mais informações, consulte Segurança do Power BI, autenticação de usuário e Solução de problemas de entrada para o Power BI.

Nota

O Power BI usa a ID do Microsoft Entra para autenticar usuários que entram no serviço do Power BI e, por sua vez, usa as credenciais de entrada do Power BI sempre que um usuário tenta acessar recursos que exigem autenticação. Os usuários entram no serviço do Power BI usando o endereço de email usado para estabelecer sua conta do Power BI. O Power BI usa esse email de entrada como o nome de usuário efetivo, que é passado para os recursos sempre que um usuário tenta se conectar aos dados. O nome de usuário efetivo é então mapeado para um nome principal de usuário e resolvido para a conta de domínio do Windows associada, contra a qual a autenticação é aplicada.

P: Como resolvo o erro "O acesso ao recurso é proibido"?

R: Você pode receber esse erro se tiver acesso a um projeto específico, mas não tiver as permissões de análise de exibição. Trabalhe com o administrador do projeto para obter essas permissões. Para obter mais informações sobre o modelo de segurança, consulte Segurança do Google Analytics.

P: Como resolvo o erro "O projeto 'X' não existe ou você não tem permissões para acessá-lo"?

R: Este erro indica que o valor que introduziu para o nome do projeto não corresponde a nenhum projeto. Um erro comum que os usuários cometem é confundir o nome do projeto com um nome de equipe.

Por exemplo, se a URL usada for https://dev.azure.com/fabrikam-fiber-inc/Fabrikam-Fiber-Git/Device, Fabrikam-Fiber-Git é o nome do projeto e deve ser usado no parâmetro. Device é o nome da equipa.

Conteúdos relacionados

• Definir permissões para aceder às vistas do Analytics e do Analytics
• Sobre a integração do Power BI
• Definir permissões para aceder às vistas do Analytics e do Analytics
• Utilizar tokens de acesso pessoal
• Estrutura do conjunto de dados de vistas do Analytics
• Exemplos de relatórios baseados em visualizações do Google Analytics