Palvelinpuolen CAPI ja tapahtumaseuranta

Ohita mainosestot ja ITP-rajoitukset reitittämällä MousePlayer-liikenne oman ensimmäisen osapuolen palvelinpuolen GTM-säilön kautta ja seuraa verkkokaupan syvällistä analytiikkaa.

1. Seurantatilojen yleiskuva

MousePlayer V2 esittelee tehokkaan tapahtumareitittimen, jolla hallitaan tiedon kulkua käyttäjän selaimesta palvelimillemme. Valittavana on kolme tilaa:

  • Vain verkko (oletus): Siirtää kaikki tiedot WebSocketeilla suoraan MousePlayeriin. Paras reaaliaikaiseen näkymään, mutta altis tehokkaille mainosestoille.
  • Hybriditila: Molempien parhaat puolet. Kevyet hiiri- ja vierityskoordinaatit kulkevat WebSocketeilla sujuvaa reaaliaikaista näkymää varten, kun taas raskaat DOM-muutokset ja mukautetut tapahtumat kootaan eriin ja reititetään turvallisesti palvelinpuolen GTM:n kautta HTTP POST -pyynnöillä.
  • Puhdas CAPI: 100-prosenttisesti HTTP POST -eriä. Paras yksityisyys, ei WebSocketeja, täysin ensimmäisen osapuolen toteutus. Huomaa: reaaliaikainen näkymä ei ole käytössä tässä tilassa.

2. Google Tag Managerin määritys (suositus)

Helpoin tapa ottaa käyttöön hybridi- tai puhdas CAPI -tila on käyttää virallisia GTM-yhteisömallejamme. Lataa alla olevat .tpl-tiedostot ja tuo ne GTM-työtiloihin.

Lataa mallit:

↓ Verkko-GTM: MousePlayer SDK -tunniste

↓ Palvelin-GTM: MousePlayerin vastaanottoasiakas

↓ Palvelin-GTM: MousePlayerin yhdistintunniste

Vaihe 1: määritä palvelinpuolen asiakas ja tunniste

Tuo palvelinpuolen GTM-säilöön malli Vastaanottoasiakas. Määritä se kuuntelemaan mukautettua polkua (esim. /mp_capi). Tuo sitten Yhdistintunniste, määritä se laukeamaan tapahtumasta mouseplayer_batch ja julkaise säilö.

Vaihe 2: määritä verkko-GTM:n tunniste

Tuo verkko-GTM-säilöön SDK-tunniste. Valitse tunnistetyypiksi ”Määritys ja alustus”, anna Channel ID, valitse Hybriditila ja liitä ssGTM-päätepisteen URL (esim. https://metrics.yourdomain.com/mp_capi).

3. Asennus käsin (ilman GTM:ää)

Jos skripti kovakoodataan, määritä objekti window.mp_config ennen seurantakoodikatkelman lataamista.

<!-- MousePlayer Config & SDK --> <script> window.mp_config = { channel: 'YOUR_UNIQUE_ID_HERE', mode: 'hybrid', // 'web_only', 'hybrid', or 'pure_capi' capi_endpoint: 'https://metrics.yourdomain.com/mp_capi' }; window.mp = window.mp || function() { (window.mp.q = window.mp.q || []).push(arguments); }; (function(w, d, s) { var f = d.getElementsByTagName(s)[0], j = d.createElement(s); j.async = true; j.src = 'https://www.mouseplayer.com/mp.js'; f.parentNode.insertBefore(j, f); })(window, document, 'script'); </script>

4. Verkkokaupan suppiloseuranta

Seuraa koko asiakaspolkua. Vakioidut tapahtumanimet antavat MousePlayerin luoda automaattisesti näyttäviä verkkokaupan suppiloraportteja projektin työtilaan. Kaikki tapahtumat sopivat täysin CAPI- ja Vain verkko -tiloihin.

1. view_item

Laukaise tämä tapahtuma käyttäjän katsoessa tiettyä tuotesivua.

mp('event', 'view_item', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', item_category: 'Electronics', price: 299.99 });

2. add_to_cart

Laukaise tämä tapahtuma käyttäjän lisätessä tuotteen ostoskoriin.

mp('event', 'add_to_cart', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', price: 299.99, quantity: 1 });

3. begin_checkout

Laukaise tämä tapahtuma käyttäjän siirtyessä kassalle.

mp('event', 'begin_checkout', { cart_value: 299.99, currency: 'USD', total_items: 1 });

4. purchase

Laukaise tämä tapahtuma onnistuneen maksun tai tilausvahvistuksen yhteydessä.

mp('event', 'purchase', { transaction_id: 'T_1002938', value: 299.99, tax: 24.00, shipping: 0.00, currency: 'USD', coupon_used: 'FREESHIP' });

5. Mukautetut tapahtumat ja liidien hankinta

Toiminta ei rajoitu verkkokauppaan. Seuraa lomakelähetyksiä, uutiskirjetilauksia tai verkkosovellukselle ominaisia vuorovaikutuksia.

Liidien hankinta (lomakkeen lähetys)

Laukaise tämä tapahtuma käyttäjän lähettäessä yhteydenottolomakkeen tai tarjouspyynnön onnistuneesti.

mp('event', 'generate_lead', { form_name: 'B2B Contact Form', industry: 'Software Development', company_size: '50-200' });

Mukautettu käyttöliittymätoiminto

Ymmärrä käyttäjien vuorovaikutusta monimutkaisten elementtien, kuten laskurien, modaalien tai välilehtivaihtojen kanssa.

mp('event', 'calculator_used', { loan_amount: 50000, duration_months: 48, interest_rate: 7.5 });

6. Parametrirajat ja ohjeet

Tietotyypit: MousePlayer tunnistaa parametrityypit automaattisesti. Lähetä luvut kokonais- tai liukulukuina (esim. 150.00, ei "150.00"), jotta koontinäytössä voi käyttää edistynyttä numeerista suodatusta (esim. ”Hinta > 100”).

Sääntö Kuvaus
Tapahtumanimen pituus Enintään 128 merkkiä. Käytä snake_case-muotoa luettavuuden vuoksi (esim. user_signup).
Parametriavaimen pituus Enintään 64 merkkiä avainnimeä kohti (esim. transaction_id).
Merkkijonoarvot Tekstiparametrit katkaistaan 255 merkkiin tietokannan optimaalisen suorituskyvyn varmistamiseksi.
Tietosuoja Henkilötietoja ei saa lähettää tapahtumaparametreina, kuten selväkielisiä sähköpostiosoitteita, oikeita nimiä tai salasanoja.