I-CAPI ngasohlangothini lweseva & ukulandelela izehlakalo

Dlula izivimbeli zezikhangiso nemikhawulo ye-ITP ngokuqondisa ithrafikhi ye-MousePlayer ngesiqukathi sakho se-GTM senkampani yokuqala ngasohlangothini lweseva, bese ulandelela ukuhlaziya okujulile kokuhweba nge-inthanethi.

1. Ukubuka konke kwamamodi okulandelela

I-MousePlayer V2 yethula i-Event Router enamandla ekuvumela ulawule indlela idatha ehamba ngayo isuka esipheqululini somsebenzisi iye kumaseva ethu. Ungakhetha amamodi amathathu ahlukene:

  • Iwebhu kuphela (okuzenzakalelayo): Isakaza yonke idatha ngama-WebSocket ngokuqondile ku-MousePlayer. Ilungele kakhulu ukubuka bukhoma ngesikhathi sangempela, kodwa ingavinjwa izivimbeli zezikhangiso ezinamandla.
  • Imodi yengxube: Okungcono kuzo zombili izindlela. Ithumela izixhumanisi zendawo zegundane/zokuskrola ezincane ngama-WebSocket ukuze ukubuka bukhoma kushelele, kuyilapho izinguquko ezisindayo ze-DOM nezehlakalo zangokwezifiso kuhlanganiswa ngamaqoqo kuthunyelwe ngokuphephile nge-GTM yakho yeseva nge-HTTP POST.
  • I-CAPI kuphela: Ukuhlanganisa ngamaqoqo kwe-HTTP POST ngo-100%. Ubumfihlo obuphezulu, awekho ama-WebSocket, konke kungokwenkampani yokuqala. Qaphela: ukubuka bukhoma kuvaliwe kule modi.

2. Ukusetha i-Google Tag Manager (kuyanconywa)

Indlela elula yokusebenzisa imodi yengxube noma ye-CAPI kuphela ukusebenzisa izifanekiso zethu ezisemthethweni zomphakathi ze-GTM. Landa amafayela e- .tpl angezansi bese uwangenisa ezindaweni zakho zokusebenzela ze-GTM.

Isinyathelo 1: setha iklayenti nethegi ngasohlangothini lweseva

Esiqukathini sakho se-GTM yeseva, ngenisa isifanekiso se- Ingest Client . Sisethe silalele indlela yangokwezifiso (isib. /mp_capi). Bese ungenisa i- Connector Tag, uyisethe isebenze esehlakalweni esithi mouseplayer_batch , bese ufaka isiqukathi sakho ukuthi sisebenze.

Isinyathelo 2: setha ithegi ye-Web GTM

Esiqukathini sakho se-Web GTM, ngenisa i- SDK Tag. Khetha “Ukusetha Nokuqalisa” njengohlobo lwethegi, ufake Channel ID, ukhethe Imodi Yengxube, bese unamathisela i-URL yesiphetho sakho se-ssGTM (isib. https://metrics.yourdomain.com/mp_capi).

3. Ukufaka ngesandla (ngaphandle kwe-GTM)

Uma ukhetha ukufaka umbhalo wohlelo ngokuqondile kukhodi, kufanele uchaze into ethi window.mp_config ngaphambi kokulayisha ucezu lwekhodi lokulandelela.

<!-- 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. Ukulandelela ifaneli yokuhweba nge-inthanethi

Landela lonke uhambo lwekhasimende. Ukusebenzisa amagama ezehlakalo ajwayelekile kuvumela i-MousePlayer ikhiqize ngokuzenzakalela imibiko emihle yamafaneli okuhweba nge-inthanethi endaweni yokusebenzela yephrojekthi yakho. Zonke izehlakalo zihambisana ngokuphelele namamodi e-CAPI nawewebhu kuphela.

1. view_item

Qalisa lesi sehlakalo lapho umsebenzisi ebuka ikhasi lomkhiqizo othile.

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

2. add_to_cart

Qalisa lesi sehlakalo lapho umsebenzisi efaka into enqoleni yakhe yokuthenga.

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

3. begin_checkout

Qalisa lesi sehlakalo lapho umsebenzisi eqhubekela esikrinini sokukhokha.

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

4. purchase

Qalisa lesi sehlakalo lapho inkokhelo iphumelela noma i-oda liqinisekiswa.

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

5. Izehlakalo zangokwezifiso & ukuthola amakhasimende angaba khona

Awukhawulelwe ekuhwebeni nge-inthanethi. Landela ukuthunyelwa kwamafomu, ukubhalisela izincwadi zezindaba noma ukuxhumana kwangokwezifiso okuhlukile ohlelweni lwakho lwewebhu.

Ukuthola amakhasimende angaba khona (ukuthumela ifomu)

Qalisa lesi sehlakalo lapho umsebenzisi ethumela ifomu lokuxhumana ngempumelelo noma ecela intengo.

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

Ukuxhumana kwesixhumi esibonakalayo kwangokwezifiso

Qonda indlela abasebenzisi abasebenzisa ngayo izici eziyinkimbinkimbi njengezibali, amawindi ezingxoxo noma ukushintsha amathebhu.

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

6. Imikhawulo yamapharamitha & imihlahlandlela

Izinhlobo zedatha: I-MousePlayer ithola izinhlobo zamapharamitha ngokuzenzakalela. Thumela izinombolo njengezinombolo eziphelele noma ezinedesimali (isib. 150.00, hhayi "150.00") ukuze kuvuleke ukuhlunga izinombolo okuthuthukile (isib. “Intengo > 100”) kudeshibhodi.

Umthetho Incazelo
Ubude begama lesehlakalo Izinhlamvu ezingu-128 kakhulu. Sebenzisa i-snake_case ukuze kufundeke kangcono (isib. user_signup).
Ubude bokhiye wepharamitha Izinhlamvu ezingu-64 kakhulu ngegama lokhiye (isib. transaction_id).
Amanani ombhalo Amapharamitha ombhalo anqanyulwa abe izinhlamvu ezingu-255 ukuze kuqinisekiswe ukusebenza kahle kwesizindalwazi.
Ubumfihlo bedatha Ungathumeli imininingwane ehlonza umuntu (PII) njengamakheli e-imeyili aluhlaza, amagama angempela noma amaphasiwedi njengamapharamitha ezehlakalo.