Integração com Google Tag Manager

Visão Geral

A integração com Google Tag Manager consiste em:

1. Criação de Tag: Adição de uma tag HTML personalizada com o script da Rybená
2. Configuração de Acionamento: Definição do gatilho para carregar a tag em todas as páginas
3. Publicação: Envio e publicação das alterações no GTM

Pré-requisitos

Antes de começar, certifique-se de que:

• Você tem acesso ao painel do Google Tag Manager
• O container do GTM já está instalado no seu site
• Você tem permissões para criar e publicar tags

Instalação

<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js"></script>

Verificação do Protocolo

Exemplo para HTTP:

<script type="text/javascript" src="http://cdn.rybena.com.br/dom/master/latest/rybena.js"></script>

Customização

Você pode customizar o comportamento da Rybená adicionando parâmetros ao script. Para mais detalhes, consulte a documentação de customização.

Exemplo de customização:

<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js?positionPlayer=right&size=300"></script>

Configurações Avançadas

Acionamento Condicional

Se você deseja carregar a Rybená apenas em páginas específicas:

1. Crie um novo acionador (trigger) personalizado
2. Defina as condições para o acionamento (ex: URL contém "/blog")
3. Selecione esse acionamento na configuração da tag

Exemplo de acionamento para páginas específicas:

// Acionador: Páginas do Blog
// Tipo: Visualização de Página
// Condição: Page Path contém "/blog"

Variáveis Dinâmicas

Você pode usar variáveis do GTM para customizar a Rybená dinamicamente:

<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js?lang={{Language Variable}}"></script>

Prioridade de Carregamento

Para garantir que a Rybená carregue no momento correto:

1. Configure a prioridade da tag (se necessário)
2. Use o acionamento "Initialization - All Pages" para carregar o mais cedo possível
3. Evite acionamentos que dependam de outros eventos

Múltiplas Tags

Se você precisa de múltiplas configurações da Rybená:

1. Crie tags separadas para cada configuração
2. Use acionamentos diferentes para cada tag
3. Certifique-se de que não há conflitos entre as configurações

Debugging

Modo de Visualização

Para testar a tag antes de publicar:

1. Clique no botão Visualizar no painel do GTM
2. Abra o site em uma nova aba
3. Verifique se a tag está sendo disparada corretamente

Verificação no Console

Para verificar se o script está carregando corretamente:

1. Abra o site em um navegador
2. Pressione F12 para abrir as ferramentas de desenvolvedor
3. Vá para a aba Console
4. Procure por erros relacionados ao script da Rybená

Tag Assistant

Use o Google Tag Assistant para verificar:

1. Se a tag está sendo disparada
2. Se há erros na configuração
3. Se o script está carregando corretamente

Solução de Problemas

Melhores Práticas

Organização de Tags

• Use nomes descritivos para as tags (ex: "Rybená - Script Principal")
• Agrupe tags relacionadas em pastas
• Documente o propósito de cada tag

Versionamento

• Use descrições claras ao publicar alterações
• Mantenha um histórico das alterações
• Use o modo de visualização antes de publicar

Monitoramento

• Use o Google Analytics para monitorar o carregamento da Rybená
• Configure alertas para erros
• Revise regularmente o desempenho das tags

Segurança

• Limite o acesso ao GTM apenas a usuários autorizados
• Use aprovações para alterações críticas
• Revise regularmente as permissões dos usuários

Recursos Adicionais

• Documentação de customização
• Documentação de API
• Suporte técnico
• Documentação do Google Tag Manager

Conteúdo Relacionado