---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com.tr/support/metrica/en/ecommerce/wordpress.md
  - https://yandex.com.tr/support/metrica/es/ecommerce/wordpress.md
  - https://yandex.com.tr/support/metrica/pt/ecommerce/wordpress.md
  - https://yandex.com.tr/support/metrica/ru/ecommerce/wordpress.md
  - https://yandex.com.tr/support/metrica/tr/ecommerce/wordpress.md
title: Habilitação de plug-in do WordPress
description: Conectar um plug-in do WordPress.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/metrica/pt/llms.txt


# Habilitação de plug-in do WordPress

A equipe do Yandex Metrica desenvolveu um plug-in oficial gratuito para a instalação de uma tag de análise de dados da web em um site. O plug-in funciona no WordPress 5.2.9 ou superior.

Funcionalidades do plug-in "Yandex Metrica":

- Adição de novas tags do Yandex Metrica com as seguintes opções habilitadas por padrão:
    
    - [E-commerce](https://yandex.com.tr/support/metrica/pt/ecommerce/about.md)
    - [Reprise de Sessão](https://yandex.com.tr/support/metrica/pt/webvisor/info.md)
    - [Mapa de cliques](https://yandex.com.tr/support/metrica/pt/behavior/click-map.md).
    
- Transmissão de [eventos de E-commerce](https://yandex.com.tr/support/metrica/pt/ecommerce/data.md):
    - Visualização de perfil de um item.
    - Adição de um item à cesta.
    - Remoção de um item da cesta.
    - Realização de uma compra.
    
- Fornecimento de detalhes dos [dados transmitidos sobre o produto](https://yandex.com.tr/support/metrica/pt/ecommerce/data.md#product_data).

Para usar as funcionalidades de E-commerce, instale no seu site o [WooCommerce](https://en.wordpress.org/plugins/woocommerce/), um plug-in para lojas on-line.

## Primeiros passos {#start}

1. Se você ainda não possui uma tag do Yandex Metrica, [crie uma](https://yandex.com.tr/support/metrica/pt/quick-start.md). Confirme se a URL do site está especificada corretamente nas configurações da tag. Para conferir isso, acesse a página **Configurações** do Yandex Metrica. Preste atenção ao valor do campo **Endereço**: ele deve mostrar a URL do site onde você deseja instalar o plug-in.
1. <!-- source: pt/_includes/ecommerce/enabling/id-enabling/3.md -->
   Nas configurações da tag, habilite a opção **E-commerce**. Um contêiner para coletar dados do `dataLayer` será adicionado ao snippet de código por padrão.
   <!-- endsource: pt/_includes/ecommerce/enabling/id-enabling/3.md -->
    
1. Certifique-se de que nenhum plug-in semelhante que instale uma tag Yandex Metrica esteja ativado no WordPress. Para fazer essa verificação, acesse a página **Plug-ins** e procure algum plug-in com o nome "Yandex Metrica", "Metrica" ou "Metrika". Se encontrar algum, desative-o.

## Passo 1. Instalar o plug-in {#upload}

1. Acesse o painel de administração do WordPress e faça login.
1. Acesse a página **Plug-ins** e clique no botão **Adicionar novo**.
    ![](../_assets/wp-add-new.png){.border-yes}
    
1. Adicione o plug-in de uma das seguintes maneiras:
    
    {% list tabs %}
    
    - Procurando-o
    
      Encontre o plug-in chamado "Yandex Metrica" e clique no botão **Instalar agora**.
      ![](../_assets/wp-search.png){.border-yes}
    
    - Com o uso de um arquivo
    
      [Baixe um arquivo ZIP para instalação do plug-in](https://metrika-cms-plugins.s3.yandex.net/wordpress/wp-yandex-metrika.zip). Em seguida, na página **Adicionar plug-ins**, clique em **Fazer upload de plug-in**, escolha o arquivo ZIP e o instale.
      ![](../_assets/wp-upload.png){.border-yes}
    
    {% endlist %}
    
1. Acesse a página **Plug-ins** → **Plug-ins instalados** e encontre o plug-in Yandex Metrica. Ative-o.

## Passo 2. Configurar o plug-in {#set}

1. Acesse a página **Plug-ins** → **Plug-ins instalados** e encontre o plug-in Yandex Metrica.
1. Abra as configurações do plug-in.
1. Insira o número da tag instalada no seu site. Se o plug-in detectar uma tag do Yandex Metrica no site, os campos serão preenchidos automaticamente. Verifique se os valores estão corretos. [Como encontrar o número da tag](https://yandex.com.tr/support/metrica/pt/general/tag-id.md)
1. Por padrão, a opção **Reprise de Sessão** está habilitada. Ela [grava sessões dos usuários](https://yandex.com.tr/support/metrica/pt/webvisor/info.md) para que você possa analisar estatísticas em maior detalhe. Se necessário, você pode desativar a Reprise de Sessão a qualquer momento.
1. Insira o **Tipo de marca** para que as informações sobre suas marcas de produto sejam transmitidas corretamente para o Yandex Metrica e apareçam nos relatórios.
    - **Termo** — No campo **Taxonomia ou campo personalizado de marca**, especifique a taxonomia da marca.
    
      {% cut "Como descobrir a taxonomia da marca" %}
    
      No WordPress, acesse a página **Produtos** → **Marcas** e observe a URL na barra de endereços do navegador — o parâmetro `taxonomy` contém o nome taxonômico da marca. No exemplo, é `exemplo-marca`.
      ![](../_assets/wp-tax.png){.border-yes}
    
    
      {% endcut %}
    
    - **Campo personalizado** — No campo **Taxonomia ou campo personalizado de marca**, especifique o nome do campo para a marca.
    
      {% cut "Como descobrir o campo personalizado de marca" %}
    
      O campo pode ser definido usando um plug-in que será responsável pela funcionalidade de marcas no site. Se houver algum no seu site, você pode usar a documentação do plug-in ou entrar em contato com o serviço de suporte do desenvolvedor para determinar o nome do campo.
    
      Também é possível procurar campos personalizados de marca no banco de dados, caso o campo seja fornecido pelo seu tema WordPress.
    
      {% endcut %}
    
1. Salve as alterações.
    ![](../_assets/wp-set-counter.png){.border-yes}

Após a instalação e configuração do plug-in, confira o log de erros. Se tiver alguma dúvida, pergunte usando o [formulário abaixo](#form) ou acesse a página do plug-in Yandex Metrica no WordPress (clique em **Acessar Fórum de Suporte**).


{% cut "Visualização de erros comuns" %}


- A versão do WordPress está obsoleta. Verifique se há uma nova versão disponível e instale-a. Para isso, abra o painel de administração e acesse a página **Painel** → **Atualizações**.
- A taxonomia da marca especificada não está presente no site.
- O tema não possui o gancho necessário para o plug-in funcionar.
- O número da tag contém caracteres que não são dígitos.


{% endcut %}


## Passo 3. Verificar se os dados estão sendo enviados {#check}

Verifique se os seguintes dados estão sendo enviados para o Yandex Metrica:

- [E-commerce](https://yandex.com.tr/support/metrica/pt/ecommerce/check.md).
- [Sessões do site](https://yandex.com.tr/support/metrica/pt/general/check-counter.md).

Os dados de E-commerce aparecem no Yandex Metrica algumas horas depois de serem enviados pela primeira vez. Para visualizar os relatórios de e-commerce, acesse o Yandex Metrica e abra **Relatórios** → **E-commerce**.

[Relatórios de E-commerce](https://yandex.com.tr/support/metrica/pt/data/e-commerce-reports.md)

Os dados sobre sessões e visualizações de página aparecerão no Yandex Metrica depois das primeiras sessões no site após a instalação do plug-in. Para visualizar estatísticas, acesse o Yandex Metrica e abra **Relatórios**. Para mais informações sobre como trabalhar com relatórios, consulte [Configuração e visualização de relatório](https://yandex.com.tr/support/metrica/pt/reports/report-general.md).

## Atualização do plug-in {#update}

Quando uma nova versão do plug-in estiver disponível, uma mensagem informando da nova versão será exibida no painel de administração do WordPress. Você pode instalar uma atualização de uma das seguintes maneiras:
- Clique no link na mensagem.
- Selecione o plug-in na página **Plug-ins** → **Plug-ins instalados**.
- [Baixe um arquivo ZIP com atualizações](https://metrika-cms-plugins.s3.yandex.net/wordpress/wp-yandex-metrika.zip). Em seguida, na página **Adicionar plug-ins**, clique em **Fazer upload de plug-in**, escolha o arquivo ZIP e o instale.

## Perguntas e respostas {#qanda}


{% cut "Por que o plug-in não está enviando eventos "Visualizações de produto"?" %} {#form}

Muito provavelmente, o tema [Colibri](https://wordpress.org/themes/colibri-wp/) na página do produto está sem o gancho "woocommerce_before_single_product". Esse gancho é necessário para o plug-in funcionar direito. Recomendamos adicionar o gancho ao tema.

{% endcut %}

<!-- source: pt/_includes/buttons/chat-button.md -->
[Fale conosco](https://yandex.com.tr/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}

<!-- source: pt/_includes/styles/href-to-button.md -->

<!-- endsource: pt/_includes/styles/href-to-button.md -->
<!-- endsource: pt/_includes/buttons/chat-button.md -->

<!-- source: pt/_includes/reports/support-button.md -->
<div class="cut-button">

{% cut "Escrever um e-mail" %}

<!-- source: pt/_includes/popup/id-popup/wrong-sup.md -->
Observe, por gentileza, que nossa equipe de suporte jamais iniciará uma chamada com você. Se alguém ligar para você e se apresentar como a equipe de suporte do Yandex Metrica, não siga as instruções dessa pessoa.
<!-- endsource: pt/_includes/popup/id-popup/wrong-sup.md -->

<div style="padding: 15px;
     margin: 10px 0;
     background: #FFFFFF;
     border-radius: 10px;
     border: 1px solid var(--g-color-line-generic);">
  <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.com.tr/surveys/1705/?&iframe=1&lang=tr">
  </iframe>
</div>

{% endcut %}

</div>



<!-- source: pt/_includes/styles/cut-button.md -->

<!-- endsource: pt/_includes/styles/cut-button.md -->

<!-- source: pt/_includes/styles/href-to-button.md -->

<!-- endsource: pt/_includes/styles/href-to-button.md -->
<!-- endsource: pt/_includes/reports/support-button.md -->

<!-- source: pt/_includes/footer-links.md -->
- - -

<div class="borderless-table">

#|
||
Links úteis

- [Tag de demonstração](https://metrica.yandex.com.tr/r/dashboard?)
- [Adicionar uma tag](https://metrica.yandex.com.tr/add/)
- [Configuração gratuita de tag](https://yandex.com.tr/promo/freeservice/metrica?utm_source=help_metrica_tr&utm_medium=cpc&utm_campaign=1)
- [API do Yandex Metrica](https://tech.yandex.com.tr/metrika/)
- [Sugerir uma idea](https://yandex.com.tr/support/metrica/troubleshooting/idea.html)
- [Debater no Telegram](https://t.me/yandexmetrika)
|
Treinamento online

- [Obter um certificado do Yandex Metrica](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)


- [Fazer um curso](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)

||
|#

</div>

<!-- source: pt/_includes/styles/table-style.md -->

<!-- endsource: pt/_includes/styles/table-style.md -->
<!-- endsource: pt/_includes/footer-links.md -->