Integração E-goi + Looker Studio – Um vôo seguro

Este artigo demonstra de forma prática como integrar a E-goi ao Looker Studio, mostrando como transformar dados brutos em insights acionáveis.

Integrar a E-goi ao Looker Studio é a chave para transformar seus dados de marketing em insights acionáveis. Deixa eu te explicar.

Já imaginou pilotar um avião sem velocímetro, altímetro ou qualquer outro instrumento, só com o “feeling”? Eu já tentei nos meus tempos de Flight Simulator 95, e o resultado era sempre um pouso “suave” em um emaranhado de prédios achatados.

É exatamente assim que imagino um profissional de marketing sem um dashboard de dados: voando sem saber se a sua campanha está subindo, caindo ou indo direto para uma tempestade de métricas confusas.

A primeira coisa que faço diariamente quando chego à E-goi é ligar a TV da Equipe de Marketing com os nossos Dashboards. 

Se você trabalha com campanhas, geração de leads e automação, sabe que os dados são o combustível do nosso avião. É aqui que entra o Looker Studio: um copiloto poderoso que transforma dados em insights visuais (e sem custos).

Por isso, hoje vou explicar como integrar a sua conta E-goi com o Looker Studio da Google (antigo Data Studio), de forma gratuita, sem conhecimentos técnicos (só CTRL+C / CTRL+V) para criar dashboards com base em segmentos da Plataforma. 

Quer ter um Dashboard com dados (em tempo real) das leads que foram captadas em uma landing page específica? Ter gráficos com o número de clientes mais engajados ou com um funil de conversão? Aperte os cintos e vem com o tio 🙂

Passo a Passo da Integração E-goi + Locker Studio

Passo 1 – Segmento E-goi

O primeiro passo é criar, na sua conta E-goi, os segmentos com todas as condições que você deseja monitorar no seu dashboard. Por exemplo: “Inscritos nos últimos 60 dias na Landing Page XPTO que possuem e-mail corporativo”. ´

Anote o ID (número de identificação) desse segmento, pois você precisará dele no passo 3. Se você ainda não sabe como criar segmentos, confira este tutorial detalhado.

Além do ID do segmento, você também precisará do ID da lista onde ele foi criado. Para encontrar o ID da lista, basta ir ao menu “Contatos” e verificar o número ao lado do nome da sua lista. No exemplo abaixo, o ID da lista é “9”:

Passo 2 – API Key

Agora, você precisa gerar uma API Key específica para essa integração na sua conta E-goi. Siga este tutorial para criar sua API Key. Copie a chave gerada, pois ela será usada no passo 3.

OBS: Por questões de segurança, recomendo que você edite as permissões da sua API Key e para dar acesso apenas para pedidos do tipo “Get ….”.

Passo 3 – Script no Google Sheets

• Vá nas extensões e clique em “App Script”.
  
• Crie um novo Google Sheet. Pode nomea-lo como “API Data” (ou qualquer nome de sua preferência).

• Na tela do script, adicione o seguinte código, personalizando os dados que estão em negrito com as suas informações da E-goi

function nomedafunçãoquequiser() {    // 1. Endpoint (ajuste os parâmetros offset/limit conforme sua necessidade)   const url = ‘https://api.egoiapp.com/lists/ID_lista_E-goi/contacts/segment/ID_Segmento_E-goi?offset=0&limit=10&show_removed=false’;   // 2. Configurações da requisição   const options = {      method: ‘GET’,     muteHttpExceptions: true,  // Permite continuar mesmo que retorne 4XX ou 5XX    headers: {        // Sua chave de API gerada no painel da E-goi       ‘Apikey’: ‘Colar_aqui_a_API_Key_da_conta_E-goi‘     }   };     try {    // 3. Executa a chamada à API    const response = UrlFetchApp.fetch(url, options);        // 4. Verifica o código de status HTTP     const statusCode = response.getResponseCode();     Logger.log(‘Status HTTP: ‘ + statusCode);        // 5. Converte o corpo da resposta em objeto JSON     const data = JSON.parse(response.getContentText());          // 6. Lê o valor de total_items     const totalItems = data.total_items;     Logger.log(‘Total Items: ‘ + totalItems);         // 7. (Opcional) Escreve na célula A1 da planilha “API Data”     //    – Você pode mudar o nome da planilha e a célula conforme desejar     const ss = SpreadsheetApp.getActiveSpreadsheet();     let sheet = ss.getSheetByName(‘API Data’);         // Se a planilha “API Data” não existir, você pode criar automaticamente     if (!sheet) {       sheet = ss.insertSheet(‘API Data’);    }         sheet.getRange(‘Em_qual_célula_do_Google_Sheets_quer_o_resultado‘).setValue(totalItems);       } catch (error) {     Logger.log(‘Erro ao buscar total_items: ‘ + error.message);   } }

Passo 4 – Testar o Script

Clique no botão “Executar” para testar a função. Verifique se a resposta no “Registro de Execução” indica que tudo está “ok”.

Se funcionar corretamente, vai obter no campo Total Items o número de subscritores do segmento que inseriram no código. Por exemplo, no segmento de teste que usei (imagem abaixo), há 1604 subscritores.

OBS: Na primeira vez que executar, vai pedir para autorizar a sua conta Google para que o Google a tenha acesso a tudo que necessita para executar a função.

Passo 5 – Criar uma rotina de atualização de dados.

Para que seus dados estejam sempre atualizados, precisamos criar uma rotina para que o script seja executado automaticamente. No “Apps Script”, vá em “Acionadores” (no menu lateral esquerdo) e adicione um novo acionador.

Configure o acionador da seguinte forma:

• Escolha qual função executar: nomedafunçãoquequiser (ou o nome que você deu à sua função)
• Escolha a implantação: Head
• Selecionar origem do evento: Baseado no tempo
• Selecionar o tipo de gatilho baseado em tempo: Contador de horas
• Selecione o intervalo: Defina o intervalo de tempo que você deseja que o script seja executado (por exemplo, “A cada 12 horas”).

Passo 6 – Adicionar dados no Looker Studio

Agora que você tem um Google Sheet com dados atualizados automaticamente do seu segmento E-goi, o último passo é adicionar este Sheet como uma “Origem de dados” no Looker Studio e utilizá-lo nos widgets que você desejar. 

Se tiver dúvidas sobre como adicionar uma nova “Origem de Dados” no Looker a partir do Sheets, veja esse tutorial.

Conclusão

Neste guia, você adquiriu o conhecimento para integrar E-goi e Looker Studio, e poderá transformar dados brutos em insights acionáveis.

Comente aqui embaixo se tiver dúvidas ou se conseguiu finalizar o processo com sucesso!  Se deu certo, compartilhe fotos do Cockpit (Dashboard) do seu avião 🙂