Integração com WordPress

Adicione análises focadas em privacidade ao seu site WordPress. Rastreie visitantes, entenda o comportamento e expanda seu público sem comprometer a privacidade.

---

Início rápido

---

Método 1: Theme Header (Recomendado)

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

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

Esta é a instalação mais simples. Funciona em todos os temas que têm um arquivo header.php e a tag </head> visível no template.

---

Método 2: Hook em functions.php

Para mais controle (excluir usuários admin, carregamento condicional, etc.), adicione ao functions.php do seu tema:

/**
 * Add Zenovay Analytics tracking script
 */
function zenovay_tracking_script() {
    // Don't track admin users (optional)
    if (current_user_can('manage_options')) {
        return;
    }

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

---

Método 3: wp_enqueue_script

Para gerenciamento adequado de scripts seguindo as convenções do WordPress:

/**
 * Enqueue Zenovay Analytics script
 */
function zenovay_enqueue_scripts() {
    if (current_user_can('manage_options')) {
        return;
    }

    wp_enqueue_script(
        'zenovay-analytics',
        'https://api.zenovay.com/z.js',
        array(), // No dependencies
        null,    // No version (external script)
        false    // Load in header
    );

    add_filter('script_loader_tag', function($tag, $handle) {
        if ('zenovay-analytics' === $handle) {
            return str_replace(' src', ' defer data-tracking-code="YOUR_TRACKING_CODE" src', $tag);
        }
        return $tag;
    }, 10, 2);
}
add_action('wp_enqueue_scripts', 'zenovay_enqueue_scripts');

---

Rastreamento com WooCommerce

Rastreie visualizações de produto, adição ao carrinho e compras na sua loja WooCommerce. Adicione ao functions.php do seu tema:

/**
 * Zenovay WooCommerce Event Tracking
 */

// Track product views
function zenovay_track_product_view() {
    if (!is_product()) return;

    global $product;
    ?>
    <script>
    document.addEventListener('DOMContentLoaded', function() {
        if (window.zenovay) {
            window.zenovay('track', 'product_viewed', {
                product_id: '<?php echo esc_js($product->get_id()); ?>',
                product_name: '<?php echo esc_js($product->get_name()); ?>',
                price: <?php echo $product->get_price(); ?>,
                currency: '<?php echo get_woocommerce_currency(); ?>',
                category: '<?php echo esc_js(wc_get_product_category_list($product->get_id())); ?>'
            });
        }
    });
    </script>
    <?php
}
add_action('wp_footer', 'zenovay_track_product_view');

// Track add to cart
function zenovay_track_add_to_cart($cart_item_key, $product_id, $quantity) {
    $product = wc_get_product($product_id);
    ?>
    <script>
    if (window.zenovay) {
        window.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; ?>,
            currency: '<?php echo get_woocommerce_currency(); ?>'
        });
    }
    </script>
    <?php
}
add_action('woocommerce_add_to_cart', 'zenovay_track_add_to_cart', 10, 3);

// Track purchases on thank you page
function zenovay_track_purchase($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Only track once
    if ($order->get_meta('_zenovay_tracked')) return;
    $order->update_meta_data('_zenovay_tracked', true);
    $order->save();

    $items = array();
    foreach ($order->get_items() as $item) {
        $items[] = array(
            'product_id' => $item->get_product_id(),
            'name' => $item->get_name(),
            'price' => $item->get_total(),
            'quantity' => $item->get_quantity()
        );
    }
    ?>
    <script>
    document.addEventListener('DOMContentLoaded', function() {
        if (window.zenovay) {
            window.zenovay('track', 'purchase', {
                transaction_id: '<?php echo esc_js($order->get_order_number()); ?>',
                revenue: <?php echo $order->get_total(); ?>,
                currency: '<?php echo $order->get_currency(); ?>',
                tax: <?php echo $order->get_total_tax(); ?>,
                shipping: <?php echo $order->get_shipping_total(); ?>,
                items: <?php echo json_encode($items); ?>
            });
        }
    });
    </script>
    <?php
}
add_action('woocommerce_thankyou', 'zenovay_track_purchase');

---

Rastreamento de formulários de contato

Contact Form 7

function zenovay_track_cf7_submission($contact_form, $result) {
    if ($result['status'] !== 'mail_sent') return;
    ?>
    <script>
    if (window.zenovay) {
        window.zenovay('track', 'form_submitted', {
            form_id: '<?php echo esc_js($contact_form->id()); ?>',
            form_name: '<?php echo esc_js($contact_form->title()); ?>'
        });
    }
    </script>
    <?php
}
add_action('wpcf7_mail_sent', 'zenovay_track_cf7_submission', 10, 2);

Ou use o evento JavaScript:

document.addEventListener('wpcf7mailsent', function(event) {
    if (window.zenovay) {
        window.zenovay('track', 'form_submitted', {
            form_id: event.detail.contactFormId,
        });
    }
});

Gravity Forms

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

WPForms

function zenovay_track_wpforms_submission($fields, $entry, $form_data) {
    ?>
    <script>
    if (window.zenovay) {
        window.zenovay('track', 'form_submitted', {
            form_id: '<?php echo esc_js($form_data['id']); ?>',
            form_name: '<?php echo esc_js($form_data['settings']['form_title']); ?>'
        });
    }
    </script>
    <?php
}
add_action('wpforms_process_complete', 'zenovay_track_wpforms_submission', 10, 3);

---

Identifique usuários logados

Identifique usuários do WordPress para rastreamento entre sessões:

function zenovay_identify_user() {
    if (!is_user_logged_in()) return;

    $user = wp_get_current_user();
    ?>
    <script>
    document.addEventListener('DOMContentLoaded', function() {
        if (window.zenovay) {
            window.zenovay('identify', {
                userId: '<?php echo esc_js($user->ID); ?>',
                email: '<?php echo esc_js($user->user_email); ?>',
                name: '<?php echo esc_js($user->display_name); ?>'
            });
        }
    });
    </script>
    <?php
}
add_action('wp_footer', 'zenovay_identify_user');

---

Configuração de rastreamento first-party

Contorne bloqueadores de anúncios fazendo proxy pelo seu domínio. Consulte o Guia de Rastreamento First-Party para a configuração multiplataforma. Regras de reescrita específicas para WordPress:

/**
 * Add rewrite rules for Zenovay first-party proxy
 */
function zenovay_add_rewrite_rules() {
    add_rewrite_rule('^_z/script\.js$', 'index.php?zenovay_proxy=script', 'top');
    add_rewrite_rule('^_z/event$', 'index.php?zenovay_proxy=event', 'top');
}
add_action('init', 'zenovay_add_rewrite_rules');

function zenovay_query_vars($vars) {
    $vars[] = 'zenovay_proxy';
    return $vars;
}
add_filter('query_vars', 'zenovay_query_vars');

function zenovay_proxy_handler() {
    $proxy = get_query_var('zenovay_proxy');
    if (!$proxy) return;

    if ($proxy === 'script') {
        header('Content-Type: application/javascript');
        echo file_get_contents('https://api.zenovay.com/z.js');
        exit;
    }

    if ($proxy === 'event') {
        $response = wp_remote_post('https://api.zenovay.com/e/' . $_GET['tracking_code'], [
            'body' => file_get_contents('php://input'),
            'headers' => ['Content-Type' => 'application/json']
        ]);

        header('Content-Type: application/json');
        echo wp_remote_retrieve_body($response);
        exit;
    }
}
add_action('template_redirect', 'zenovay_proxy_handler');

Depois atualize seu script de rastreamento para usar o proxy:

<script defer
    data-tracking-code="YOUR_TRACKING_CODE"
    data-api-url="/_z/"
    src="/_z/script.js">
</script>

Após adicionar as regras de reescrita, vá em Settings → Permalinks e clique em Save Changes para limpar o cache de reescrita.

---

Compatibilidade com plugins de cache

Exclua as rotas first-party do Zenovay do seu plugin de cache para que os eventos sejam enviados corretamente.

WP Super Cache

Adicione ao wp-content/wp-cache-config.php:

$cache_rejected_uri = array(
    '/_z/',
);

W3 Total Cache

Vá em Performance → Page Cache e adicione /_z/ em Never cache the following pages.

LiteSpeed Cache

LiteSpeed Cache → Cache → Excludes → Do Not Cache URIs:

/_z/

WP Rocket

Settings → WP Rocket → Advanced Rules → Never Cache URL(s):

/_z/(.*)

WP Fastest Cache

WP Fastest Cache → Exclude → Exclude Pages — adicione /_z/.

---

Configuração Multisite

Para redes WordPress Multisite, o script de rastreamento fica no header.php ou functions.php do seu tema e funciona por site conforme configurado. Para usar um único código de rastreamento em toda a rede:

/**
 * Use a single tracking code across the multisite network
 */
function zenovay_network_tracking_code() {
    return 'YOUR_NETWORK_TRACKING_CODE';
}
add_filter('zenovay_tracking_code', 'zenovay_network_tracking_code');

Caso contrário, configure um código de rastreamento diferente por site, codificando-o diretamente no tema de cada site.

---

Notas de desempenho

O rastreador do Zenovay é:

• Diferido — não bloqueia a renderização da página
• Leve — < 23 KB comprimido
• Entregue via CDN — armazenado em cache globalmente na borda

Carregamento condicional

Pule o rastreamento em páginas específicas:

function zenovay_conditional_loading() {
    if (is_admin()) return;
    if (is_page(array('privacy-policy', 'terms'))) return;
    ?>
    <script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
    <?php
}
add_action('wp_head', 'zenovay_conditional_loading');

---

Solução de problemas

Script não carregando

1. Visualize o código-fonte da página (Cmd/Ctrl+U) e procure por <script defer data-tracking-code=...> entre <head> e </head>
2. Verifique se o código de rastreamento corresponde ao valor no painel do Zenovay
3. Abra o console do navegador e verifique erros de JavaScript
4. Desative temporariamente o cache para testar
5. Verifique se um plugin de segurança (Wordfence, iThemes Security, etc.) está bloqueando scripts externos para api.zenovay.com

Visualizações de página duplicadas

• Certifique-se de ter adicionado o snippet apenas uma vez (não cole em header.php E em um hook de functions.php)
• Verifique se conteúdo carregado via AJAX está re-acionando o rastreamento
• Revise a configuração do plugin de cache

Compras no WooCommerce ausentes

• Verifique se o snippet carrega na página de agradecimento
• Verifique o fluxo de checkout do WooCommerce (múltiplas páginas vs. página única) — alguns checkouts ignoram o hook padrão woocommerce_thankyou
• Certifique-se de que o modo de compatibilidade jQuery não está interferindo

Problemas de cache

• Exclua as rotas /_z/ do cache de páginas (veja Compatibilidade com plugins de cache acima)
• Limpe todos os caches após mudanças de configuração
• Teste em modo anônimo/navegação privada

---

Considerações de segurança

Content Security Policy

Se o seu site usa um cabeçalho CSP, permita o Zenovay:

script-src 'self' https://api.zenovay.com;
connect-src 'self' https://api.zenovay.com;

Com o proxy first-party, apenas 'self' é necessário.

Excluindo páginas sensíveis

function zenovay_should_track() {
    if (is_admin()) return false;
    if (is_page(array('my-account', 'checkout'))) return false;
    if (current_user_can('manage_options')) return false;
    return true;
}

---

Conformidade de privacidade

Para rastreamento sem cookies, adicione data-cookieless="true":

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

Neste modo, nenhum cookie ou entrada de armazenamento local é definido — os IDs de visitante existem apenas para a aba atual. Consulte o Guia de Conformidade de Privacidade para todos os detalhes.

Integração com plugins de consentimento de cookies

Com plugins de consentimento populares:

// CookieYes — load tracking after consent
document.addEventListener('cookieyes_consent_update', function(e) {
    if (e.detail.accepted.includes('analytics')) {
        var s = document.createElement('script');
        s.defer = true;
        s.src = 'https://api.zenovay.com/z.js';
        s.dataset.trackingCode = 'YOUR_TRACKING_CODE';
        document.head.appendChild(s);
    }
});

// Complianz — same pattern
document.addEventListener('cmplz_fire_statistics', function() {
    var s = document.createElement('script');
    s.defer = true;
    s.src = 'https://api.zenovay.com/z.js';
    s.dataset.trackingCode = 'YOUR_TRACKING_CODE';
    document.head.appendChild(s);
});

Consulte o Guia de Conformidade GDPR para configuração detalhada.

---

Recursos relacionados

• Rastreamento First-Party
• Eventos Personalizados
• Funis de Conversão
• Conformidade GDPR
• Artigo de ajuda sobre integração com WordPress

---

Precisa de ajuda? Entre em contato pelo [email protected] ou visite nossa Central de Ajuda.