Integração com WordPress

Adicione o Zenovay Analytics ao seu site WordPress com uma simples tag de script.

Instalação

Opção 1: Adicionar ao Cabeçalho do Tema (Recomendado)

Adicione ao arquivo header.php do seu tema, antes de </head>:

<script
  defer
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>

Opção 2: Adicionar via functions.php

Adicione ao arquivo functions.php do seu tema:

function zenovay_tracking_script() {
    ?>
    <script
      defer
      data-tracking-code="YOUR_TRACKING_CODE"
      src="https://api.zenovay.com/z.js">
    </script>
    <?php
}
add_action('wp_head', 'zenovay_tracking_script');

Integração com WooCommerce

Rastreamento do WooCommerce (Configuração Manual)

Com os snippets abaixo:

• Visualizações de produto rastreadas automaticamente
• Eventos de adição ao carrinho
• Etapas do checkout
• Conclusão de compra
• Atribuição de receita

Configuração Manual do WooCommerce

Adicione ao arquivo functions.php do seu tema:

// Rastrear visualizações de produto
add_action('woocommerce_after_single_product', 'zenovay_track_product_view');
function zenovay_track_product_view() {
    global $product;
    ?>
    <script>
    if (window.zenovay) {
        zenovay('track', 'view_product', {
            product_id: '<?php echo esc_js($product->get_id()); ?>',
            product_name: '<?php echo esc_js($product->get_name()); ?>',
            price: <?php echo $product->get_price(); ?>,
            category: '<?php echo esc_js(wp_get_post_terms($product->get_id(), 'product_cat')[0]->name ?? ''); ?>'
        });
    }
    </script>
    <?php
}

// Rastrear adição ao carrinho
add_action('woocommerce_add_to_cart', 'zenovay_track_add_to_cart', 10, 6);
function zenovay_track_add_to_cart($cart_item_key, $product_id, $quantity, $variation_id, $variation, $cart_item_data) {
    $product = wc_get_product($product_id);
    ?>
    <script>
    if (window.zenovay) {
        zenovay('track', 'add_to_cart', {
            product_id: '<?php echo esc_js($product_id); ?>',
            product_name: '<?php echo esc_js($product->get_name()); ?>',
            price: <?php echo $product->get_price(); ?>,
            quantity: <?php echo $quantity; ?>
        });
    }
    </script>
    <?php
}

// Rastrear compra
add_action('woocommerce_thankyou', 'zenovay_track_purchase');
function zenovay_track_purchase($order_id) {
    if (!$order_id) return;

    $order = wc_get_order($order_id);

    // Verificar se já foi rastreado
    if ($order->get_meta('_zenovay_tracked')) return;

    $items = array();
    foreach ($order->get_items() as $item) {
        $product = $item->get_product();
        $items[] = array(
            'id' => $product->get_id(),
            'name' => $item->get_name(),
            'price' => $product->get_price(),
            'quantity' => $item->get_quantity()
        );
    }
    ?>
    <script>
    if (window.zenovay) {
        zenovay('revenue', <?php echo $order->get_total(); ?>, '<?php echo esc_js($order->get_currency()); ?>', {
            order_id: '<?php echo esc_js($order_id); ?>',
            items: <?php echo json_encode($items); ?>
        });
    }
    </script>
    <?php

    $order->update_meta_data('_zenovay_tracked', true);
    $order->save();
}

Rastreamento de Metas

Metas de Envio de Formulário

Rastreie o Contact Form 7:

add_action('wp_footer', 'zenovay_cf7_tracking');
function zenovay_cf7_tracking() {
    ?>
    <script>
    document.addEventListener('wpcf7mailsent', function(event) {
        if (window.zenovay) {
            zenovay('goal', 'contact_form', {
                form_id: event.detail.contactFormId
            });
        }
    });
    </script>
    <?php
}

Rastreie o Gravity Forms:

add_action('gform_after_submission', 'zenovay_gf_tracking', 10, 2);
function zenovay_gf_tracking($entry, $form) {
    ?>
    <script>
    if (window.zenovay) {
        zenovay('goal', 'form_submission', {
            form_id: '<?php echo $form['id']; ?>',
            form_name: '<?php echo esc_js($form['title']); ?>'
        });
    }
    </script>
    <?php
}

Cadastros em Newsletter

Rastreie o MailChimp for WordPress:

add_action('mc4wp_form_success', 'zenovay_mc4wp_tracking');
function zenovay_mc4wp_tracking() {
    ?>
    <script>
    if (window.zenovay) {
        zenovay('goal', 'newsletter_signup');
    }
    </script>
    <?php
}

Identificação de Usuário

Rastrear Usuários Logados

add_action('wp_footer', 'zenovay_identify_user');
function zenovay_identify_user() {
    if (!is_user_logged_in()) return;

    $user = wp_get_current_user();
    ?>
    <script>
    if (window.zenovay) {
        zenovay('identify', '<?php echo esc_js($user->ID); ?>', {
            email: '<?php echo esc_js($user->user_email); ?>',
            name: '<?php echo esc_js($user->display_name); ?>',
            role: '<?php echo esc_js($user->roles[0]); ?>'
        });
    }
    </script>
    <?php
}

Excluir Usuários Administradores

Excluindo administradores via configuração

Configure sua lista de papéis a excluir (por exemplo, via um plugin de gerenciamento de papéis ou código personalizado):

• Administrador
• Editor

Via Código

add_action('wp_head', 'zenovay_conditional_tracking');
function zenovay_conditional_tracking() {
    // Não rastreie administradores
    if (current_user_can('manage_options')) {
        return;
    }
    ?>
    <script
      defer
      data-tracking-code="YOUR_TRACKING_CODE"
      src="https://api.zenovay.com/z.js">
    </script>
    <?php
}

Suporte a Multisite

Em uma rede multissite do WordPress, cada site é uma propriedade separada no Zenovay, portanto, cada um precisa do seu próprio código de rastreamento. Crie um site separado no Zenovay para cada site na rede, depois coloque o código de rastreamento correspondente por site.

Configuração por Site

Se você adicionar o snippet de um plugin mu-network ativado (ou um tema compartilhado na rede), mapeie cada ID de blog para seu próprio código de rastreamento:

add_action('wp_head', 'zenovay_multisite_tracking');
function zenovay_multisite_tracking() {
    $codes = array(
        1 => 'TRACKING_CODE_FOR_SITE_1',
        2 => 'TRACKING_CODE_FOR_SITE_2',
        // Adicione uma entrada por ID de blog
    );
    $blog_id = get_current_blog_id();
    if (empty($codes[$blog_id])) {
        return;
    }
    ?>
    <script
      defer
      data-tracking-code="<?php echo esc_attr($codes[$blog_id]); ?>"
      src="https://api.zenovay.com/z.js">
    </script>
    <?php
}

Eventos Personalizados

Rastreamento de Clique em Botão

<button onclick="zenovay('track', 'cta_click', {button: 'hero'})">
  Começar
</button>

Profundidade de Rolagem

add_action('wp_footer', 'zenovay_scroll_tracking');
function zenovay_scroll_tracking() {
    ?>
    <script>
    let maxScroll = 0;
    window.addEventListener('scroll', function() {
        const scrollPercent = Math.round(
            (window.scrollY / (document.body.scrollHeight - window.innerHeight)) * 100
        );
        if (scrollPercent > maxScroll && scrollPercent % 25 === 0) {
            maxScroll = scrollPercent;
            if (window.zenovay) {
                zenovay('track', 'scroll_depth', { depth: scrollPercent });
            }
        }
    });
    </script>
    <?php
}

Compatibilidade com Cache

Plugins de Cache Populares

Funciona com:

• WP Super Cache
• W3 Total Cache
• WP Rocket
• LiteSpeed Cache
• Cloudflare

Exclusões de Cache

Se o rastreamento não funcionar:

1. Exclua o script do Zenovay da otimização
2. Não combine/adie o script se houver problemas

Para o WP Rocket:

add_filter('rocket_exclude_js', function($excluded) {
    $excluded[] = 'api.zenovay.com';
    return $excluded;
});

Solução de Problemas

Rastreamento Não Funcionando

Verifique:

• O script de rastreamento está presente no seu tema (header.php ou functions.php)
• O valor data-tracking-code corresponde ao código de rastreamento do seu site no Zenovay
• Você não está excluído por seu próprio código de exclusão de papéis
• O console do navegador para erros de script ou de rede

WooCommerce Não Rastreando

Verifique:

• Os snippets do WooCommerce estão adicionados ao functions.php do seu tema
• A página de agradecimento (pedido recebido) carrega corretamente
• O script não está bloqueado ou removido por um plugin de cache

Conflitos com Outros Plugins

Se houver conflitos:

• Desative outros plugins de analytics
• Verifique erros de JavaScript
• Teste com o tema padrão

Compatibilidade com Page Builders

Funciona com:

• Elementor
• Divi
• Beaver Builder
• Gutenberg
• WPBakery

Desempenho

Carregamento do Script

O script do Zenovay:

• Carrega de forma assíncrona (defer)
• Menos de 5KB
• Não bloqueia a renderização
• Entregue via CDN

Dicas de Otimização

• Não duplique o script
• Ative o cache

Próximos Passos

• Rastreamento de Receita no WooCommerce
• Integração com Shopify
• Configuração de Metas