# Estratégias de Atribuição

## Atribuição e Determinantes

### # Explicação do Modelo `UtmCase` para Profissionais de Marketing

\
**O que é `UtmCase`?**

`UtmCase` é um objeto que define um conjunto de parâmetros UTM (Urchin Tracking Module) e tag dos variadas plataformas de anúncio. Esses parâmetros são usados em URLs para rastrear a eficácia das campanhas de marketing online em fontes de tráfego e comportamentos do usuário. Quando um usuário acessa uma URL contendo esses parâmetros, as informações são registradas para análise posterior.

**Funcionamento**

Quando os parâmetros UTM definidos no `UtmCase` estão presentes na URL, eles registram informações como a fonte de onde o usuário veio (por exemplo, Google, e-mail, afiliados), o meio de marketing (por exemplo, CPC, banner, social), e detalhes específicos da campanha (nome, conteúdo, palavra-chave).

Todas as variáveis passadas na url são mantida no histórico até que uma [variável determinante](#variaveis-determinantes) seja listada. Quando uma variável determinante é listada na URL o histórico é "resetado". 

**Regra de 'Reset'**

Uma característica distinta do nosso modelo é que certos parâmetros quando presentes na URL, como `utm_source` ou `utm_term`, dentre outros, 'zeram' o histórico de parâmetros anteriores. Isso significa que sempre que um destes parâmetros determinantes aparece, começamos a coletar uma nova sessão de dados de rastreamento, ignorando os anteriores. 

**Benefícios**

1. **Precisão de Dados**: Ajuda a garantir que cada nova sessão significativa seja rastreada de forma isolada, proporcionando dados limpos e precisos.
2. **Segmentação de Campanha**: Permite diferenciar campanhas e estratégias individualmente para análise mais detalhada de desempenho.
3. **Insights Melhorados**: Com o 'reset' quando determinados parâmetros aparecem, é mais fácil identificar quais estratégias estão trazendo usuários 'novos' ou reiniciando a jornada do cliente.
4. **Personalização de Campanha**: Profissionais de marketing podem criar campanhas mais personalizadas sabendo que qualquer 'reset' fornecerá uma visão clara do comportamento do usuário desde aquele ponto de entrada.
5. **Atribuição Direta**: Torna a atribuição de conversões a esforços de marketing específicos mais direta e menos confusa.

### Estratégias

Existem 3 estratégias para considerar sobre o uso do histórico em seus eventos. É comum utilizar "any" e obter insights dos atributos `attr_dts` e `attr_dts_ts`, que são a estratégia utilizada sendo "now" ou "before" e o timestamp do registro.  Vamos entender mais sobre essas estratégias e variáveis as seguir. 

... em construção... 

### Variáveis determinantes

São as variáveis ou parâmetros de url (querystring) que zeram o histórico recente desses valores. 

**Para que serve o histórico?**

Garante que os dados de parametrização serão preservados mesmo quando o usuário acessar url's sem os parâmetros, exclusão acidental, a uma atualização de página, modelo de roteamento (ex.: webapp ou wpa) e/ou retorno direto ao site. Veja a sequência abaixo:

<figure><img src="https://2995894881-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBD2WDS4DaY1QhGFZ1hqU%2Fuploads%2FMIZNP6ibiGuI47mEDtJN%2FCaptura%20de%20Tela%202024-04-28%20a%CC%80s%209.32.53%20PM.png?alt=media&#x26;token=0a7ee02a-81ac-4d95-970e-ec232b49e143" alt=""><figcaption></figcaption></figure>

**Variáveis determinantes**

Essas são as variáveis determinantes que irão zerar o histórico todas as vezes que estiverem presentes na URL.&#x20;

<table><thead><tr><th width="257">Nome do Determinante</th><th>Descrição</th></tr></thead><tbody><tr><td><code>utm_source</code></td><td>Fonte dos leads, como redes sociais, e-mail, SMS, etc.</td></tr><tr><td><code>utm_medium</code></td><td>Tipo de mídia usada, como e-mail, cpc, social, banner, etc.</td></tr><tr><td><code>utm_campaign</code></td><td>Nome da campanha de marketing.</td></tr><tr><td><code>campaign_id</code></td><td>Identificador único da campanha.</td></tr><tr><td><code>utm_content</code></td><td>Identifica qual anúncio ou conteúdo trouxe o visitante.</td></tr><tr><td><code>utm_term</code></td><td>Palavra-chave usada na campanha de publicidade.</td></tr><tr><td><code>utm_adgroup</code></td><td>Grupo de anúncios dentro da campanha.</td></tr><tr><td><code>utm_id</code></td><td>Identificador geral para campanhas complexas que envolvem vários elementos.</td></tr><tr><td><code>ad_id</code></td><td>Identificador específico de um anúncio.</td></tr><tr><td><code>matchtype</code></td><td>Tipo de correspondência para palavras-chave em publicidade PPC.</td></tr><tr><td><code>utm_title</code></td><td>Título do anúncio usado na campanha.</td></tr><tr><td><code>utm_affiliate</code></td><td>Identifica a origem do tráfego de afiliados.</td></tr><tr><td><code>utm_product</code></td><td>Nome do produto em destaque na campanha.</td></tr><tr><td><code>utm_product_id</code></td><td>Identificador único do produto.</td></tr><tr><td><code>utm_category</code></td><td>Categoria do produto.</td></tr><tr><td><code>utm_subcategory</code></td><td>Subcategoria do produto.</td></tr><tr><td><code>gad_source</code></td><td>Fonte associada aos anúncios do Google.</td></tr><tr><td><code>gclid</code></td><td>Identificador exclusivo de clique do Google Ads.</td></tr><tr><td><code>msclkid</code></td><td>Identificador exclusivo de clique do Microsoft Advertising.</td></tr><tr><td><code>fbclid</code></td><td>Identificador exclusivo de clique do Facebook.</td></tr><tr><td><code>fbc</code></td><td>Identificador de clique do Facebook, geralmente usado para retargeting.</td></tr><tr><td><code>li_fat_id</code></td><td>Identificador exclusivo de clique do LinkedIn.</td></tr><tr><td><code>tbl_source</code></td><td>Fonte associada à plataforma Taboola.</td></tr><tr><td><code>taboola_click_id</code></td><td>Identificador exclusivo de clique do Taboola.</td></tr><tr><td><code>tblci</code></td><td>Outra forma de identificador de clique do Taboola.</td></tr><tr><td><code>mkt_tok</code></td><td>Token de rastreamento usado por Marketo.</td></tr><tr><td><code>apid</code></td><td>Identificador exclusivo de pixel do Agnostic.</td></tr><tr><td><code>acid</code></td><td>Identificador customizado do Agnostic.</td></tr><tr><td><code>apsid</code></td><td>Pseudo-identificador do Agnostic.</td></tr><tr><td><code>asuid</code></td><td>Identificador de sessão do Agnostic.</td></tr><tr><td><code>search</code></td><td>Termo de pesquisa usado pelo visitante.</td></tr><tr><td><code>term</code></td><td>Outro campo para termo de pesquisa.</td></tr></tbody></table>

### Configuração do Pixel de Rastreamento

**Introdução**

A configuração do pixel de rastreamento permite que estrategistas de marketing configurem e ativem a coleta de dados de eventos sem necessidade de inserção direta de códigos nas páginas web. Isso proporciona uma maior autonomia na gestão de campanhas e otimização de anúncios baseados em comportamento real dos usuários.

\
**Importância**

Configurar corretamente o pixel de rastreamento é crucial para:

* Capturar dados precisos de interações dos usuários.
* Permitir a personalização de campanhas publicitárias.
* Aumentar a eficiência do retorno sobre investimento (ROI) em campanhas de marketing.

**Autonomia do Estrategista de Marketing**

Esta configuração proporciona aos estrategistas de marketing:

* Flexibilidade total na seleção de eventos específicos para rastreamento.
* Filtragem de dados com base em URLs de destino específicas ou origens de tráfego.
* Filtragem baseada em parâmetros de url (UTM e variáveis)
* Testes e ajustes de estratégias em tempo real.

**Casos de Uso**

* **Otimização de Campanhas:** Ajuste de campanhas com base no desempenho de eventos específicos como visualizações de conteúdo, leads gerados ou compras concluídas.
* **Segmentação de Audiência:** Utilização de filtros para capturar tráfego de fontes específicas, melhorando a precisão da segmentação.
* **Análise de Desempenho:** Monitoramento da eficácia das campanhas em diferentes plataformas ou URLs.

<table><thead><tr><th width="267">Propriedade</th><th>Descrição</th></tr></thead><tbody><tr><td><code>access_token</code></td><td>Token de acesso para autenticar a API.</td></tr><tr><td><code>is_active</code></td><td>Define se a configuração do pixel está ativa (<code>true</code>) ou inativa (<code>false</code>).</td></tr><tr><td><code>api_version</code></td><td>Especifica a versão da API do Facebook, padrão é "v15.0".</td></tr><tr><td><code>id</code></td><td>Identificador único do pixel.</td></tr><tr><td><code>events</code></td><td>Lista de eventos a serem rastreados e seus respectivos mapeamentos. Se informado somente esses eventos irão ser enviados para a plataforma. Formato: <code>{eventoAgnosticData: eventoPlataforma}em uma lista como [{"view_content": "SamplesPageView"}, {"lead": "Lead"}, {"checkout_done": "Purchase"}].</code></td></tr><tr><td><del><code>test_event_code_active</code></del></td><td><del>Ativa (<code>true</code>) ou desativa (<code>false</code>) o uso de um código de evento de teste.</del></td></tr><tr><td><code>test_event_code</code> <em>(Atualizado: não requer definir nas configurações)</em></td><td><del>Código do evento de teste, usado quando <code>test_event_code_active</code> é <code>true</code></del>. O teste code foi atualizado e deve ser passado direto na url. Ex.: <code>http://meusite.com/?test_event_code=TEST1234</code></td></tr><tr><td><code>urls_allowed</code></td><td>URLs permitidas para rastreamento de eventos, com suporte para curingas. Digamos que o destino da campanha seja https://meusite.com.br você poderá passar uma lista como <code>["https://meusite.com.br/", "https://meusite.com.br/*", "https://meusite.com.br/path/*", "https://meusite.com.br/path"]</code>. O fato é que com <strong>"*"</strong> irá garantir todas as url abaixo e caso não tenha somente a url exata. </td></tr><tr><td><code>origin_allowed</code></td><td>Origens permitidas para enviar eventos, pode ser uma lista ou <code>*</code> para qualquer origem. Caso você só queira treinar a plataforma quando a origem for uol.com.br você precisará passar ["uol.com.br"].</td></tr><tr><td><code>utm_case_strategy</code></td><td>Estratégia para captura de parâmetros UTM: <code>any</code>, <code>before</code>, <code>now</code>.</td></tr><tr><td><code>utm_case_target</code></td><td>Filtros específicos para parâmetros UTM, como <code>utm_source</code> e <code>utm_medium</code>.</td></tr></tbody></table>

{% hint style="info" %}
**Lembre-se** que origin\_allowed depende da estratégia de atribuiçao configurada. Essa estratégia pode ser **last\_origin** ou **opened\_from\_type** ou **any**. Onde **last\_origin** irá buscar a última origem que trouxe o lead independente se essa visita o usuário fez acesso direto, pois o **last\_origin** está no *storage*.&#x20;

Você pode utilizar **opened\_from\_type** que somente verifica se o acesso atual foi realizada de uma referência externa, ou seja, caso o usuário tenha conhecido o site de uma referência externa mas faça um segundo acesso direto esse evento, para a estratégia **opened\_from\_type**, não trará a origin. Veja mais em "[Para que serve o histórico?](#variaveis-determinantes)" nesta página.&#x20;
{% endhint %}

### Trace id

**O que trace id?**&#x20;

é o código de retorno, ou identificador único, do evento enviado ao Facebook via API de conversões.&#x20;

**Quando é gerado?**

Quando enviamos uma evento para o Facebook/Meta ou Google Analytics via API de Conversões, os servidores do Facebook ou Google devolvem um código para identificar esse envio. Nota-se que o Google Analytics não envia um código de retorno único, neste caso, apenas uma resposta com um código padronizado 204 informando que o evento foi recebido com sucesso.&#x20;

Ambos os casos significa que o evento foi enviado corretamente a plataforma de anúncio em questão.&#x20;

Trace ID no AgnosticData é um atributo de contexto do evento chamado `ati (ads trace id)`. Esse campo de ati é abreviação de Ads Trace Id, sendo assim, todas as plataformas de Ads que retornam um código ou um status quando uma comunicação servidor (AgnosticData) para servidor (Plataforma) ocorre, será nele que essas informação serão armazenadas.&#x20;

&#x20;