WordPress-Integration

Fügen Sie Zenovay-Analytics mit einem einfachen Script-Tag zu Ihrer WordPress-Website hinzu.

Installation

Option 1: Zum Theme-Header hinzufügen (Empfohlen)

Fügen Sie Folgendes in die header.php Ihres Themes vor </head> ein:

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

Option 2: Über functions.php hinzufügen

Fügen Sie Folgendes in die functions.php Ihres Themes ein:

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');

WooCommerce-Integration

WooCommerce-Tracking (manuelle Einrichtung)

Mit den folgenden Snippets:

• Produktaufrufe werden automatisch erfasst
• Warenkorb-Ereignisse
• Checkout-Schritte
• Kaufabschluss
• Umsatzzuordnung

Manuelle WooCommerce-Einrichtung

Fügen Sie Folgendes in die functions.php Ihres Themes ein:

// Produktaufrufe tracken
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
}

// Warenkorb-Hinzufügung tracken
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
}

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

    $order = wc_get_order($order_id);

    // Prüfen, ob bereits getrackt
    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();
}

Ziel-Tracking

Formularübermittlungs-Ziele

Contact Form 7 tracken:

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
}

Gravity Forms tracken:

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
}

Newsletter-Anmeldungen

MailChimp for WordPress tracken:

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

Benutzeridentifikation

Angemeldete Benutzer tracken

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
}

Admin-Benutzer ausschließen

Admins per Konfiguration ausschließen

Konfigurieren Sie Ihre Liste auszuschließender Rollen (z. B. über ein Plugin zur Rollenverwaltung oder eigenen Code):

• Administrator
• Redakteur

Über Code

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

Multisite-Unterstützung

In einem WordPress-Multisite-Netzwerk ist jede Website eine separate Eigenschaft in Zenovay, daher benötigt jede Website ihren eigenen Tracking-Code. Erstellen Sie eine separate Website in Zenovay für jede Website im Netzwerk und geben Sie dann den entsprechenden Tracking-Code pro Website aus.

Konfiguration pro Website

Wenn Sie das Snippet über ein netzwerkaktiviertes Mu-Plugin (oder ein Theme, das im gesamten Netzwerk freigegeben ist) hinzufügen, ordnen Sie jede Blog-ID ihrem eigenen Tracking-Code zu:

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',
        // Fügen Sie einen Eintrag pro Blog-ID hinzu
    );
    $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
}

Benutzerdefinierte Ereignisse

Klick-Tracking für Schaltflächen

<button onclick="zenovay('track', 'cta_click', {button: 'hero'})">
  Jetzt starten
</button>

Scroll-Tiefe

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
}

Cache-Kompatibilität

Beliebte Cache-Plugins

Kompatibel mit:

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

Cache-Ausnahmen

Falls das Tracking nicht funktioniert:

1. Zenovay-Skript von der Optimierung ausschließen
2. Nicht kombinieren/verzögern, falls Probleme auftreten

Für WP Rocket:

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

Fehlerbehebung

Tracking funktioniert nicht

Prüfen Sie:

• Das Tracking-Skript ist in Ihrem Theme vorhanden (header.php oder functions.php)
• Der data-tracking-code-Wert entspricht dem Tracking-Code der Website in Zenovay
• Sie werden nicht durch Ihren eigenen Rollen-Ausschluss-Code ausgeschlossen
• Die Browser-Konsole auf Script- oder Netzwerkfehler

WooCommerce trackt nicht

Überprüfen Sie:

• Die WooCommerce-Snippets sind in die functions.php Ihres Themes eingefügt
• Die Danke-Seite (Bestellungsbestätigung) wird ordnungsgemäß geladen
• Das Skript wird nicht durch ein Cache-Plugin blockiert oder entfernt

Konflikte mit anderen Plugins

Bei Konflikten:

• Deaktivieren Sie andere Analytics-Plugins
• Überprüfen Sie auf JavaScript-Fehler
• Testen Sie mit dem Standard-Theme

Kompatibilität mit Page Buildern

Kompatibel mit:

• Elementor
• Divi
• Beaver Builder
• Gutenberg
• WPBakery

Leistung

Script-Laden

Das Zenovay-Skript:

• Lädt asynchron (defer)
• Unter 5 KB
• Kein Render-Blocking
• Über CDN ausgeliefert

Optimierungstipps

• Skript nicht doppelt einbinden
• Caching aktivieren

Nächste Schritte

• WooCommerce-Umsatz-Tracking
• Shopify-Integration
• Ziele einrichten