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.
  • Reprise de Sessão.
  • Mapa de cliques.

• Transmissão de eventos de E-commerce:

  • 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.

Instalação e configuração do módulo

Primeiros passos

1. Se você ainda não possui uma tag do Yandex Metrica, crie uma. 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.

2. 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.

3. 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

Acesse o painel de administração do 1C-Bitrix, faça login e adicione o módulo usando um dos seguintes métodos:

Através do painel de administração

1. Abra Marketplace → Soluções instaladas e encontre o módulo com o nome "Yandex Metrica".
2. Clique no ícone e selecione Instalar agora.

Via 1C-Bitrix: Marketplace

1. Acesse o 1C-Bitrix: Marketplace e encontre o módulo com o nome "Yandex Metrica".
2. Abra o módulo e clique em Instalar.

Usando um arquivo ZIP

1. Baixe o arquivo ZIP de instalação com codificação UTF8 ou CP1251.
2. Acesse o painel de administração do 1C-Bitrix na página Conteúdo.
3. Selecione Arquivos e pastas → bitrix → seção módulos e abra a última página da lista de módulos.
4. Clique em Upload → Adicionar arquivo e selecione o arquivo ZIP com o módulo Yandex Metrica.
5. Clique em Salvar. O arquivo será transferido para o catálogo de módulos do seu servidor.
6. 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.
7. Abra Marketplace → Soluções instaladas e encontre o módulo com o nome "Yandex Metrica". Clique em e selecione Instalar.

Passo 2. Configurar o módulo

1. Acesse Configurações → Configurações do produto → Configurações do módulo → Yandex Metrica.
2. Selecione o site.
3. 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
4. Por padrão, a opção Reprise de Sessão está habilitada. Ela grava sessões dos usuários para que você possa analisar estatísticas em maior detalhe. Se necessário, você pode desativar a Reprise de Sessão a qualquer momento.
5. Salve as alterações.

Passo 3. Verificar se os dados estão sendo enviados

Para checar se os dados estão sendo enviados para o Yandex Metrica:

• Para dados de E-commerce, consulte Verificação de configurações de E-commerce.
• Para dados sobre sessões do site, consulte Verificação da tag.

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. Saiba mais sobre os relatórios.

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.

Configurações adicionais

Como preencher o campo "Propriedade da marca" nas configurações do módulo

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 que pode ser usado para determinar qual a marca mais popular entre os clientes ou qual gera mais lucro, entre outras coisas.

Para encontrar um valor de propriedade:

1. Acesse o painel de administração do 1C-Bitrix.
2. Acesse Conteúdo → Tipos de infoblocos → Catálogos e selecione um catálogo.
3. No lado direito, abra a aba Funcionalidades.
4. Na lista, encontre o campo para a marca.
5. Especifique o nome do campo nas configurações do módulo "Yandex Metrica".

Como transmitir informações sobre visualizações de produtos (propriedade detalhe)

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 é 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.

1. Faça login no site como administrador.

2. Na aba Site, ative o Modo de edição.

   Observação

   Se você já editou o modelo antes, pule para o passo 6 deste guia.

3. No site, abra o cartão do produto e passe o cursor sobre a área do componente catálogo para abrir o menu.

4. Clique em , selecione o catálogo e em seguida Copiar o modelo do componente.

5. No campo Copiar para o modelo do site, selecione atual e salve as alterações.

6. Encontre e abra o arquivo element.php. No código, encontre a linha que se parece com esta:

   $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.

7. 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.

   Exemplo de código

   ...
   $elementId = $APPLICATION->IncludeComponent('bitrix:catalog.element', 'bootstrap_v4', $componentElementParams,
   $component
   );
   $APPLICATION->IncludeComponent("yandex.metrika:detail", "", array("PRODUCT_ID" => $elementId), $component);
   ...
   

8. Clique em Salvar.

Como encontrar o arquivo element.php

1. Na aba Site, ative o Modo de edição.
2. No site, abra o cartão do produto e passe o cursor sobre a área do componente catálogo para abrir o menu.
3. Clique em , selecione o catálogo e em seguida Copiar o modelo do componente.
4. Confirme se o arquivo element.php é exibido na janela que se abre. O caminho para o arquivo é especificado no nome da janela.

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 ou no site do 1C-Bitrix (no canto inferior direito, clique em Suporte técnico).

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.

Contrato de licença

Leia o Contrato de licença de uso do módulo "Yandex Metrica" para 1C-Bitrix.

Atualização do módulo

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.
• Baixe o arquivo ZIP atualizado com codificação UTF8 ou CP1251 e siga as instruções para instalar o arquivo.

Fale conosco

---