Skip to main content

Gerenciamento de Campanhas

Esta seção da biblioteca implementa um sistema para gerenciar o registro de interações do usuários com campanhas de marketing no site, utilizando o objeto Ledger para armazenar e atualizar essas informações. Esse sistema permite capturar e registrar campanhas com base em parâmetros de URL, como o utm_campaign.

O registro​

Um registro de campanha contém as seguintes informações:

  • id: Identificador único da campanha, como uma referência utm_campaign.
  • count: Quantidade de vezes que o usuário converteu na mesma campanha.
  • lastCounted: Timestamp da última vez que a campanha foi contada ou registrada.

Registro de Campanhas​

A função register é a função principal que integra as funcionalidades de registro de campanhas:

  • Verifica se a campanha já foi registrada na lista.
  • Se não, chama addNewCampaign para adicioná-la.
  • Se a campanha foi registrada no mesmo dia, não faz alterações.
  • Se foi registrada em um dia diferente, chama updateCampaign para atualizar as informações.

register é exportada por essa seção da biblioteca, permitindo que seja utilizada no ciclo de vida do Ledger (ver Ciclo de Vida - Ledger). Ou seja, toda vez que o usuário interage com uma nova URL, o Ledger aciona esse sistema que irá verificar de forma automática se há uma campanha relacionada e essa URL. Se sim, irá registrá-la e contá-la.

1. Captura de Campanha UTM​

A função captureUTMCampaign é responsável por identificar e capturar o parâmetro utm_campaign da URL atual de navegação do usuário.

  • A URL atual da página é analisada;
  • O parâmetro da campanha (utm_campaign) é extraído da URL;
  • O UTM da campanha capturada é retornado.

2. Adicionar Nova Campanha​

Quando uma nova campanha é identificada (ou seja, ainda não foi registrada no Ledger), a função addNewCampaign registra essa nova campanha:

  • Cria um novo registro de campanha que inclui um ID, um contador (inicializado em 1) e a data do último registro dessa campanha no Ledger.
  • Retorna uma lista atualizada de campanhas que inclui a nova campanha.

3. Atualizar Campanha Existente​

Se o usuário já interagiu com a mesma campanha anteriormente, a função updateCampaign atualiza uma campanha já existente:

  • Encontra o registro correspondente da campanha na lista existente, através do ID (utm_campaign).
  • Remove a campanha da lista temporariamente para atualizar suas informações:
    • Incrementa a contagem de interações da campanha.
    • Atualiza a data e hora da última interação.
  • Adiciona novamente o registro atualizado à lista de campanhas.

4. Contar Campanha​

A função countCampaign incrementa o contador de uma campanha já registrada e atualiza a data do último registro.

Essas ações permitem que o sistema rastreie quantas vezes uma campanha foi acessada e a data da última vez que isso ocorreu.

Esse sistema garante que as interações dos usuários com as campanhas de marketing sejam corretamente registradas e gerenciadas, permitindo uma análise mais eficaz das estratégias de marketing.