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 accionáveis.

Integrar a E-goi ao Looker Studio é a chave para transformar os seus dados de marketing em insights accionáveis. Deixe-me explicar.

Já imaginou pilotar um avião sem velocímetro, altímetro ou qualquer outro instrumento, apenas confiando na intuição? Eu tentei fazê-lo nos meus tempos do Flight Simulator 95, e o resultado costumava ser uma “aterragem” muito “suave” em meio a um emaranhado de prédios achatados.

É exactamente assim que imagino um profissional de marketing sem um painel de controlo de dados: a voar sem saber se a sua campanha está a subir, a descer ou a aproximar-se de uma tempestade de métricas confusas.

A primeira coisa que faço todos os dias quando chego à E-goi é ligar a TV da Equipa de Marketing, onde temos os nossos Dashboards.

Se 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 (sem custos).

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

Quer ter um dashboard com dados (em tempo real) das leads captadas numa landing page específica? Gráficos com o número de clientes mais envolvidos ou até um funil de conversão? Aperte os cintos e venha daí!

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 monitorizar no seu dashboard. Por exemplo: “Inscritos nos últimos 60 dias na Landing Page XPTO que possuem e-mail corporativo”.

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

Além do ID do segmento, também necessitará do ID da lista onde ele foi criado. Para descobrir o ID da lista, basta ir ao menu Contactos 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, precisa gerar uma API Key específica para essa integração na sua conta E-goi. Siga este tutorial para criar a sua API Key. Copie a chave gerada, pois irá utilizá-la no passo 3.

OBS: Por motivos de segurança, recomendo que edite as permissões da sua API Key de forma a dar acesso apenas aos pedidos do tipo “Get ….”.

Passo 3 – Script no Google Sheets

• Crie uma nova folha de cálculo no Google Sheet. Pode atribuir-lhe o nome “API Data” (ou qualquer outro que prefira).
• Vá a Extensões e clique em App Script.
  

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

Nota: A célula A1 não deve ser usada para armazenar dados, pois não guarda informações de forma confiável. Recomendo utilizar outras células para garantir o armazenamento adequado dos dados.

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 A2 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. Em seguida, verifique se o Registo de Execução indica que está tudo “ok”.

Se funcionar corretamente, no campo Total Items surgirá o número de subscritores do segmento inserido no código. Por exemplo, no segmento de teste que utilizei (imagem abaixo), aparecem 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.

Depois de clicar em “Rever Autorizações”, vai pedir para fazer login com a sua conta Google.

A seguir ao login, vai aparecer uma mensagem que diz que a Google não validou a app. Clique em “Avançadas” e a seguir em “Acessar a Nome_do_Projeto” como na imagem abaixo:

Por último, ative as permissões para que o Projeto seja executado como na imagem abaixo. Pronto, o script vai ser executado!

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

Para que os dados se mantenham sempre actualizados, é necessário criar uma rotina para executar o script automaticamente. No Apps Script, selecione 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 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 deseja que o script seja executado (por exemplo, “A cada 12 horas”).

Passo 6 – Adicionar dados no Looker Studio

Agora que dispõe de um Google Sheet com dados do seu segmento E-goi, actualizados automaticamente, o último passo consiste em adicionar essa Folha de Cálculo como Origem de dados no Looker Studio e utilizá-la nos widgets que quiser.

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, 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 🙂