> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trackup.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Variáveis 

> Crie regras e automações inteligentes.

Sempre que um visitante interage com sua estrutura, o Trackup coleta dezenas de informações sobre aquela visita.

Essas informações ficam disponíveis dentro dos **acionadores** e podem ser utilizadas para definir **quando uma automação deve acontecer**.

Você pode utilizar essas informações para segmentar tráfego, identificar campanhas, separar visitantes e disparar eventos com muito mais precisão.

***

**Exemplo simples:**

```text theme={"dark"}
Se o usuário veio do Facebook
E
O evento for Start Checkout
↓
Disparar evento Purchase no Pixel
```

Toda lógica dos acionadores funciona a partir dessas variáveis.

***

# Como funcionam as variáveis?

Ao criar uma condição dentro de um acionador, você sempre escolhe 3 elementos:

```text theme={"dark"}
Variável -> Operador -> Valor
```

Exemplo:

```text theme={"dark"}
Tipo de Evento -> Igual -> purchase
```

Neste caso:

> O acionador só será executado quando o evento purchase acontecer.

***

# Variáveis de Evento

Utilize estas variáveis quando quiser criar regras baseadas em ações que aconteceram dentro do funil.

São as variáveis mais utilizadas para automações de pixels.

Variáveis disponíveis:

| Variável             | O que representa                                   | Exemplo de Eventos                              |
| :------------------- | :------------------------------------------------- | ----------------------------------------------- |
| **Tipo de Evento**   | Evento padrão registrado pelo Trackup              | page\_view ad\_click start\_checkout conversion |
| **Tipo Customizado** | Evento personalizado enviado pelo pixel do Trackup | play\_rate<br />sign\_up<br />view\_25\_vsl     |

***

Exemplo de uso:

```text theme={"dark"}
Se Tipo de Evento = start_checkout
↓
Disparar evento InitiateCheckout
```

***

# Variáveis UTM

As variáveis UTM permitem identificar **de qual campanha o visitante veio**.

São usadas para segmentar automações com base na origem do tráfego.

Variáveis disponíveis:

| Variável         | O que representa             |
| :--------------- | :--------------------------- |
| **UTM Source**   | Plataforma de origem         |
| **UTM Medium**   | Tipo de mídia                |
| **UTM Campaign** | Nome da campanha             |
| **UTM Term**     | Palavra-chave ou segmentação |
| **UTM Content**  | Criativo ou anúncio          |

***

### Exemplo real

```text theme={"dark"}
utm_source = facebook
```

ou

```text theme={"dark"}
utm_campaign = black-friday
```

Exemplo de uso:

```text theme={"dark"}
Se UTM Source = facebook
↓
Executar ação
```

***

# Variáveis Sub

As variáveis **Sub** servem para armazenar parâmetros extras enviados através dos links.

Normalmente são utilizadas para carregar dados personalizados da campanha.

Você pode utilizá-las livremente da forma que preferir.

Variáveis disponíveis:

```text theme={"dark"}
sub1
sub2
sub3
sub4
sub5
sub6
sub7
sub8
```

***

### Quando utilizar?

Exemplo:

```text theme={"dark"}
sub1 = produto-a
sub2 = criativo-3
```

ou

```text theme={"dark"}
sub1 = gestor-joao
```

Exemplo de uso:

```text theme={"dark"}
Se sub1 = produto-a
↓
Executar ação específica
```

***

# Variáveis de Tráfego

Estas variáveis analisam **como o visitante chegou até sua estrutura**.

São úteis para criar regras baseadas na origem técnica do acesso.

Variáveis disponíveis:

| Variável     | O que representa                |
| :----------- | :------------------------------ |
| **Rede**     | Plataforma de tráfego utilizada |
| **URL**      | Página acessada pelo visitante  |
| **Referrer** | Página anterior de origem       |

***

### Exemplos

```text theme={"dark"}
Rede = facebook
```

```text theme={"dark"}
Referrer = instagram.com
```

```text theme={"dark"}
URL = /checkout
```

Exemplo de uso:

```text theme={"dark"}
Se Referrer contém instagram.com
↓
Executar ação
```

***

# Combinação de Variáveis

As variáveis podem ser combinadas para criar regras muito mais inteligentes.

***

### Disparar evento apenas no Facebook

```text theme={"dark"}
Se UTM Source = facebook
↓
Disparar evento
```

***

### Disparar evento apenas quando iniciar checkout

```text theme={"dark"}
Se Tipo de Evento = start_checkout
↓
Executar ação
```

***

### Separar campanhas específicas

```text theme={"dark"}
Se UTM Campaign = black-friday
↓
Executar ação
```

***

### Criar regra para uma página específica

```text theme={"dark"}
Se URL contém /checkout

↓

Executar ação
```

***

# Dica importante

Você pode combinar múltiplas variáveis dentro do mesmo acionador.

Exemplo:

```text theme={"dark"}
UTM Source = facebook
E
Tipo de Evento = start_checkout
E
sub1 = produto-a
```

Quanto mais específica a regra, mais preciso será o disparo.
