> For the complete documentation index, see [llms.txt](https://help.ticto.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.ticto.com.br/sou-produtor/trackeamento/configuracao-de-utm-no-wordpress-com-pixelyoursite.md).

# Configuração de UTM no WordPress com PixelYourSite

## Índice

* [UTM no WordPress](#utm-no-wordpress-com-pixelyoursite)
* [Pré-requisitos](#pre-requisitos)
* [Configurando UTMs no WordPress com PixelYourSite](#passo-a-passo-configuracao-no-wordpress)
* [Validando a configuração](#testar-a-configuracao)
* [Como o script funciona](#como-funciona-o-script)

***

### UTM no WordPress com PixelYourSite

Este guia explica como configurar parâmetros UTM em páginas WordPress usando o plugin **PixelYourSite**, garantindo que as informações de campanha cheguem corretamente ao checkout da TICTO.

***

### Pré-requisitos

Antes de começar, certifique-se de ter acesso administrativo ao WordPress e o plugin PixelYourSite instalado e ativo.

***

### Passo a Passo Configuração no Wordpress

{% stepper %}
{% step %}
Instalar o Plugin PixelYourSite no wordpress:

No menu lateral do WordPress, acesse **Plugins → Adicionar Novo**, pesquise por **PixelYourSite**, clique em **Instalar Agora** e, em seguida, em **Ativar**.

{% endstep %}

{% step %}
Acessar a Página a Ser Editada

No painel administrativo, vá até **Páginas** no menu lateral, localize a página onde deseja configurar os parâmetros UTM e clique em **Editar**.

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2F0D7tv0wIdt4xhSwXyejj%2Fimage.png?alt=media&amp;token=64eeb0d4-966d-48db-9e71-4e54715f232b" alt=""><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Localizar a Seção do PixelYourSite

Dentro do editor da página, role para baixo até encontrar a seção relacionada ao **PixelYourSite** e clique para expandir as opções de configuração.

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FyV3FjUqjqDtpVwARNNjL%2Fimage.png?alt=media&amp;token=b413fc76-c197-4fe4-92f7-e5247e7759c1" alt=""><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Inserir o Script no Footer

Na seção **Head & Footer Scripts**, localize o campo **Footer (any device type)** e cole o seguinte script:

{% hint style="danger" %}
**Atenção:** Substitua `https://payment.ticto.app/O3893D2XX` pela URL de checkout que você está utilizando antes de salvar.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FqsED8y6TtBANIVEZMBYi%2Fimage.png?alt=media&amp;token=ddeacdf4-029b-4411-9bce-f1524c58249f" alt=""><figcaption></figcaption></figure></div>

Copie este trecho de código.

{% code overflow="wrap" %}

```javascript
<script>
  (function() {
    const utmParamQueryString = new URLSearchParams(window.location.search);
    if (utmParamQueryString.toString()) {
      var navLinks = document.querySelectorAll('a');
      navLinks.forEach(function(item) {
        if (item.href.indexOf('https://payment.ticto.app/O3893D2XX') !== -1) {
          if (item.href.indexOf('?') === -1) {
            item.href += '?' + utmParamQueryString.toString();
          } else {
            item.href += '&' + utmParamQueryString.toString();
          }
        }
      });
    }
  })();
</script>
```

{% endcode %}
{% endstep %}

{% step %}
No botão da pagina que direciona para o checkout, informe o link da ofera/checkout e publique a pagina.

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FEvQ4SNU4y08L6hPksBhK%2Fimage.png?alt=media&amp;token=e5664d06-d543-4f7c-94b8-779a13b25139" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***

### Testar a Configuração

Com o script salvo, siga os passos abaixo para validar:

{% stepper %}
{% step %}
Gere uma URL com os parâmetros UTM desejados ( ferramentas indicadas : <https://ga-dev-tools.google/campaign-url-builder/>)

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FiXTBZLin1QrwxRQDSL4a%2Fimage.png?alt=media&amp;token=eb1d8bb4-6c54-496d-929d-f96f809c21cb" alt=""><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Ainda no construtor de urls, acesse o copie e acesse através do navegador.

{% hint style="info" %}
A url gerada pelo contrutor, pode ser usanda em campanhas de anúncios e divulgação.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FTINpT50IJhxEbiSkoBlM%2Fimage.png?alt=media&amp;token=14c701c2-5b2e-49b8-9b02-22d82f5f5d80" alt=""><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Acesse essa URL gerada pelo construtor.\
\
No navegador e passe o mouse sobre o botão de checkout e veja os parâmetros que estão sendo passados para o checkout.

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FIAIGY6W892kDpJYxSLez%2Fimage.png?alt=media&amp;token=6c9adde3-3900-4e94-afca-f465fe1b6caf" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Verifique na barra de status do navegador se os parâmetros UTM estão sendo adicionados corretamente ao link.

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2Fd9UnHYwn2EhFHv7sGdOA%2Fimage.png?alt=media&amp;token=8c9fd65f-4f11-4cd6-b689-94189513313a" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Realize uma compra teste e confirme se os parâmetros chegaram nos  detalhes da venda na guia rastreamento.<br>

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FyuQuU4ia4E5eHf8Sn74L%2Fimage.png?alt=media&amp;token=76c0f5f9-f87d-4f27-9365-98010a54f667" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
É possível acompanhar  também um consolidado das vendas aprovadas por tag em **relatórios da TICTO:** [Relatórios](/sou-produtor/relatorios.md#smart-source-report)
{% endhint %}

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FQkyOUCj4YzXmPAfraKTI%2Fimage.png?alt=media&amp;token=5646e0ed-b6e2-4a2d-af6e-f1da45428bd7" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***

### Como funciona o script

O script verifica se a URL atual da página contém parâmetros UTM. Se sim, ele percorre todos os links da página e, naqueles que apontam para o checkout da TICTO, adiciona automaticamente esses parâmetros — usando `?` se o link ainda não tiver nenhum parâmetro, ou `&` caso já tenha. Dessa forma, nenhuma informação de origem do tráfego se perde durante o redirecionamento.

***

{% hint style="info" %}
Após concluir a configuração, monitore os relatórios de rastreamento na TICTO para garantir que os dados de campanha estão chegando corretamente a cada nova venda.&#x20;
{% endhint %}
