CAPI dhinaca seerfarka iyo dabagalka dhacdooyinka

Ka gudub adblockers iyo xayiraadaha ITP adigoo taraafikada MousePlayer marinaya konteenarkaaga GTM ee dhinaca seerfarka iyo first-party ah, kuna dabagal falanqayn qoto dheer oo ganacsi elektaroonig ah.

1. Dulmarka hababka dabagalka

MousePlayer V2 wuxuu soo bandhigayaa Event Router awood leh oo kuu oggolaanaya inaad maamusho sida xogtu uga socoto biraawsarka isticmaalahaaga una gaarto seerfarradayada. Waxaad ka dooran kartaa saddex hab oo kala duwan:

  • Web oo keliya (caadiga): Xogta oo dhan wuxuu WebSockets ugu gudbiyaa si toos ah MousePlayer. Wuxuu ugu fiican yahay Muuqaalka Tooska ah ee waqtiga dhabta ah, laakiin waxaa xannibi kara adblockers xooggan.
  • Habka Hybrid: Labada dhinacba waxa ugu fiican. Wuxuu isku-duwayaasha fudud ee jiirka/rogista ku diraa WebSockets si Muuqaalka Tooska ahi u simnaado, halka isbeddellada culus ee DOM iyo Dhacdooyinka Gaarka ah la isu geeyo oo si ammaan ah HTTP POST loogu mariyo GTM-gaaga dhinaca seerfarka.
  • Pure CAPI: Isu-geynta HTTP POST oo 100% ah. Asturnaan ugu badan, WebSockets ma jiraan, si buuxda first-party ah. Fiiro: Muuqaalka Tooska ahi habkan wuu ka dansan yahay.

2. Dejinta Google Tag Manager (lagu talinayo)

Habka ugu fudud ee loo hirgeliyo Hybrid ama Pure CAPI waa adeegsiga GTM Community Templates-keena rasmiga ah. Soo deji faylalka .tpl ee hoose oo ku soo geli goobahaaga shaqada GTM.

Soo deji templates:

↓ Web GTM: MousePlayer SDK Tag

↓ Server GTM: MousePlayer Ingest Client

↓ Server GTM: MousePlayer Connector Tag

Tallaabada 1: deji Client-ka iyo Tag-ga dhinaca seerfarka

Konteenarkaaga GTM ee dhinaca seerfarka, ku soo geli template-ka Ingest Client . U deji inuu dhegaysto waddo gaar ah (tusaale, /mp_capi). Ka dib ku soo geli Connector Tag, u deji inuu ku shaqeeyo dhacdada mouseplayer_batch oo daahfur konteenarkaaga.

Tallaabada 2: deji Tag-ga Web GTM

Konteenarkaaga Web GTM, ku soo geli SDK Tag. Dooro “Dejinta iyo Bilowga” sida Nooca Tag-ga, geli Channel ID, dooro Habka Hybrid oo ku dheji URL-ka endpoint ssGTM (tusaale, https://metrics.yourdomain.com/mp_capi).

3. Rakibidda gacanta (GTM la'aan)

Haddii aad doorbidayso inaad iskribtiga si toos ah koodhka ugu qorto, waa inaad qeexdaa walaxda window.mp_config ka hor rarista snippet-ka dabagalka.

<!-- 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. Dabagalka funnel-ka ganacsiga elektaroonigga ah

Dabaggal safarka macmiilka oo dhan. Adeegsiga magacyada dhacdooyinka ee la mideeyay wuxuu MousePlayer u oggolaanayaa inuu si otomaatig ah uga soo saaro warbixinno qurux badan oo Funnel Ganacsi Elektaroonig ah goobtaada shaqada mashruuca. Dhammaan dhacdooyinku si buuxda ayay ula jaanqaadaan hababka CAPI iyo Web-Only.

1. view_item

Kici dhacdadan marka isticmaale daawado bog badeecad oo gaar ah.

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

2. add_to_cart

Kici dhacdadan marka isticmaale shay ku daro dambiishiisa wax-iibsiga.

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

3. begin_checkout

Kici dhacdadan marka isticmaale u gudbo shaashadda checkout.

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

4. purchase

Kici dhacdadan marka lacag-bixin guulaysato ama dalab la xaqiijiyo.

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

5. Dhacdooyin gaar ah iyo helidda macaamiil iman kara

Kuma xaddidnid ganacsi elektaroonig ah. Dabaggal dirista foomamka, isdiiwaangelinta warsidaha ama falgallada gaarka ah ee app-kaaga webka.

Helidda macmiil iman kara (dirista foomka)

Kici dhacdadan marka isticmaale si guul leh u diro foom xiriir ama codsado qiimeyn.

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

Falgal UI oo gaar ah

Faham sida isticmaalayaashu ula falgalaan walxo adag sida xisaabiyeyaal, daaqado wada-hadal ama beddelidda tababka.

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

6. Xadadka iyo tilmaamaha halbeegyada

Noocaynta xogta: MousePlayer si otomaatig ah ayuu u ogaadaa noocyada halbeegyada. Tirooyinka u dir integer ama float ahaan (tusaale, 150.00, ma aha "150.00") si aad dashboard-ka uga hawlgeliso shaandhayn tirooyin oo horumarsan (tusaale, “Qiime > 100”).

Xeer Sharaxaad
Dhererka magaca dhacdada Ugu badnaan 128 xaraf. Adeegso snake_case si akhrisku ugu fududaado (tusaale, user_signup).
Dhererka furaha halbeegga Ugu badnaan 64 xaraf magaca fure kasta (tusaale, transaction_id).
Qiimayaasha qoraalka Halbeegyada qoraalka waxaa loo soo gaabiyaa 255 xaraf si loo hubiyo waxqabadka ugu fiican ee kaydka xogta.
Asturnaanta xogta Ha dirin Xogta Qof Lagu Aqoonsan Karo (PII) sida cinwaanno iimayl ceeriin ah, magacyo dhab ah ama erayo sir ah halbeegyo dhacdo ahaan.