---
metadata:
- name: generator
content: Diplodoc Platform v5.54.1
alternate:
- https://yandex.com.tr/support/metrica/en/ecommerce/bitrix.md
- https://yandex.com.tr/support/metrica/es/ecommerce/bitrix.md
- https://yandex.com.tr/support/metrica/pt/ecommerce/bitrix.md
- https://yandex.com.tr/support/metrica/ru/ecommerce/bitrix.md
- https://yandex.com.tr/support/metrica/tr/ecommerce/bitrix.md
- href: pt/ecommerce/bitrix.md
type: text/markdown
title: Markdown version
- href: ../llms.txt
type: text/markdown
title: llms.txt
title: Habilitação de módulo 1C-Bitrix
description: Conectar um módulo 1C-Bitrix.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/metrica/pt/llms.txt
# Habilitação de módulo 1C-Bitrix
A equipe do Yandex Metrica desenvolveu um módulo oficial, sem custo, para a instalação de uma tag de análise de dados da web em um site. O módulo roda com 1C-Bitrix versão 18.0 ou superior e é compatível com todas as edições do "1C-Bitrix: Gerenciamento de Sites".
Funcionalidades do módulo "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).
## Instalação e configuração do módulo {#general}
### 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 módulo.
1.
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.
1. Confirme se não há nenhum módulo semelhante, que instala uma tag do Yandex Metrica, ativado no 1C-Bitrix. No painel de administração, abra **Marketplace** → **Soluções instaladas** e procure pelos módulos chamados "Yandex Metrica", "Metrica" ou "Metrika". Se ele estiver ali, delete-o.
### Passo 1. Instalar o módulo {#upload}
Acesse o painel de administração do 1C-Bitrix, faça login e adicione o módulo usando um dos seguintes métodos:
{% cut "Através do painel de administração" %}
1. Abra **Marketplace** → **Soluções instaladas** e encontre o módulo com o nome "Yandex Metrica".
1. Clique no ícone e selecione **Instalar agora**.
{% endcut %}
{% cut "Via 1C-Bitrix: Marketplace" %}
1. Acesse o [1C-Bitrix: Marketplace](http://marketplace.1c-bitrix.ru/solutions) e encontre o módulo com o nome "Yandex Metrica".
1. Abra o módulo e clique em **Instalar**.
{% endcut %}
{% cut "Usando um arquivo ZIP" %} {#zip}
1. Baixe o arquivo ZIP de instalação com codificação [UTF8](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/yandex.metrika.utf8.zip) ou [CP1251](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/yandex.metrika.cp1251.zip).
1. Acesse o painel de administração do 1C-Bitrix na página **Conteúdo**.
1. Selecione **Arquivos e pastas** → **bitrix** → seção **módulos** e abra a última página da lista de módulos.
1. Clique em **Upload** → **Adicionar arquivo** e selecione o arquivo ZIP com o módulo Yandex Metrica.
1. Clique em **Salvar**. O arquivo será transferido para o catálogo de `módulos` do seu servidor.
1. Descompacte o arquivo: ache-o na lista de módulos, clique em , e selecione **Descompactar**. Verifique se o catálogo do `yandex.metrica` aparece na lista.
1. Abra **Marketplace** → **Soluções instaladas** e encontre o módulo com o nome "Yandex Metrica". Clique em  e selecione **Instalar**.
{% endcut %}
### Passo 2. Configurar o módulo {#set}
1. Acesse **Configurações** → **Configurações do produto** → **Configurações do módulo** → **Yandex Metrica**.
1. Selecione o site.
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. Salve as alterações.
{% note tip %}
O campo **Propriedade da marca** não é obrigatório. [Preencha-o](#brand) caso você queira rastrear estatísticas sobre a marca do produto no Yandex Metrica. Qual marca é a mais popular entre os clientes, por exemplo.
Além disso, para obter estatísticas mais detalhadas sobre produtos (quais produtos os usuários visualizam com maior frequência, por exemplo), [configure o evento detalhe](#detail).
{% endnote %}
### 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 quando ocorrerem as primeiras sessões no site após a instalação do módulo. 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).
## Configurações adicionais {#func}
### Como preencher o campo "Propriedade da marca" nas configurações do módulo {#brand}
Você pode enviar informações sobre as marcas que possui em sua loja online para o Yandex Metrica. Com base nesses dados, o Yandex Metrica [gera um relatório](https://yandex.com.tr/support/metrica/pt/reports/popular-brands.md) que pode ser usado para determinar qual a marca mais popular entre os clientes ou qual gera mais lucro, entre outras coisas.
{% note info %}
Os modelos do 1C-Bitrix podem ter vários catálogos de produtos. Nas configurações do módulo Yandex Metrica, só são exibidas as propriedades das marcas de diretórios ativos. Recomendamos preencher todos os campos disponíveis em **Propriedade da Marca** para garantir que os dados sejam enviados adequadamente para o Yandex Metrica.
{% endnote %}
Para encontrar um valor de propriedade:
1. Acesse o painel de administração do 1C-Bitrix.
1. Acesse **Conteúdo** → **Tipos de infoblocos** → **Catálogos** e selecione um catálogo.
1. No lado direito, abra a aba **Funcionalidades**.
1. Na lista, encontre o campo para a marca.
1. Especifique o nome do campo nas configurações do módulo "Yandex Metrica".
### Como transmitir informações sobre visualizações de produtos (propriedade detalhe) {#detail}
Você pode enviar dados de visualização de produtos para o Yandex Metrica para que os relatórios de E-commerce apresentem informações mais detalhadas. O [relatório Itens Populares](https://yandex.com.tr/support/metrica/pt/reports/popular-goods.md) é formado dessa maneira, por exemplo.
Para configurar eventos de visualização de produto, é preciso fazer alterações no código do arquivo `element.php` relativo ao modelo do componente `bitrix:catalog` no seu site.
{% note alert %}
O caminho para o arquivo `element.php` pode diferir em modelos de diferentes sites.
{% endnote %}
1. Faça login no site como administrador.
1. Na aba **Site**, ative o **Modo de edição**.
{% note info %}
Se você já editou o modelo antes, pule para o passo 6 deste guia.
{% endnote %}
1. No site, abra o cartão do produto e passe o cursor sobre a área do componente catálogo para abrir o menu.
1. Clique em , selecione o catálogo e em seguida **Copiar o modelo do componente**.
1. No campo **Copiar para o modelo do site**, selecione **atual** e salve as alterações.
1. [Encontre](#found-element) e abra o arquivo `element.php`. No código, encontre a linha que se parece com esta:
```php
$elementId = $APPLICATION->IncludeComponent('bitrix:catalog.element', 'bootstrap_v4', $componentElementParams,
$component
);
```
Caso não veja `"$elementId = "` antes do componente `bitrix:catalog.element`, adicione a variável ao código manualmente.
1. Depois disso, adicione `$APPLICATION->IncludeComponent("yandex.metrika:detail", "", array("PRODUCT_ID" => $elementId), $component);`.
Verifique para que o código `detail` utilize maiúsculas e minúsculas iguais às do arquivo `element.php` nas variáveis e funções.
{% cut "Exemplo de código" %}
```php
...
$elementId = $APPLICATION->IncludeComponent('bitrix:catalog.element', 'bootstrap_v4', $componentElementParams,
$component
);
$APPLICATION->IncludeComponent("yandex.metrika:detail", "", array("PRODUCT_ID" => $elementId), $component);
...
```
{% endcut %}
1. Clique em **Salvar**.
{% cut "Como encontrar o arquivo element.php" %} {#found-element}
1. Na aba **Site**, ative o **Modo de edição**.
1. No site, abra o cartão do produto e passe o cursor sobre a área do componente catálogo para abrir o menu.
1. Clique em , selecione o catálogo e em seguida **Copiar o modelo do componente**.
1. Confirme se o arquivo `element.php` é exibido na janela que se abre. O caminho para o arquivo é especificado no nome da janela.
{% endcut %}
Após a instalação e configuração do módulo, consulte o log de erros. Para isso, abra o módulo no painel de administração do 1C-Bitrix. Você pode tirar dúvidas através do [formulário abaixo](#form) ou no site do 1C-Bitrix (no canto inferior direito, clique em **Suporte técnico**).
{% cut "Visualização de erros comuns" %}
- Versão desatualizada do 1C-Bitrix. Verifique se há uma nova versão disponível e instale-a. Para isso, abra o painel de administração e acesse **Marketplace** → **Atualização da plataforma**.
- A propriedade de marca que você especificou não está no site.
- O número da tag contém caracteres que não são dígitos.
{% endcut %}
## Contrato de licença {#licens}
Leia o [Contrato de licença](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/LICENSE.txt) de uso do módulo "Yandex Metrica" para 1C-Bitrix.
## Atualização do módulo {#update}
Quando houver uma nova versão do módulo, uma mensagem será exibida no painel de administração do 1C-Bitrix. Você pode instalar uma atualização de uma das seguintes maneiras:
- Clique no link na mensagem.
- Selecione o módulo na página **Marketplace** → **Soluções instaladas**.
- Na página [1C-Bitrix: Marketplace](https://marketplace.1c-bitrix.ru/).
- Baixe o arquivo ZIP atualizado com codificação [UTF8](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/yandex.metrika.utf8.zip) ou [CP1251](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/yandex.metrika.cp1251.zip) e [siga as instruções para instalar o arquivo](#zip).
[Fale conosco](https://yandex.com.tr/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}
- - -
#|
||
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)
||
|#