CAPI ní ẹ̀rọ ìpèsè àti ìtọ́pa ìṣẹ̀lẹ̀

Ẹ kọjá adblocker àti ìdínà ITP nípa dídarí ìrìnnà MousePlayer nípasẹ̀ container GTM ní ẹ̀rọ ìpèsè ti ẹ̀yin fúnra yín, kí ẹ sì tọ́pa ìtúpalẹ̀ ìṣòwò ayélujára tó jinlẹ̀.

1. Àkótán ọ̀nà ìtọ́pa

MousePlayer V2 ń ṣàfihàn Event Router alágbára tó ń jẹ́ kí ẹ ṣàkóso bí dátà ṣe ń ṣàn láti aṣàwákiri olùlò yín sí ẹ̀rọ ìpèsè wa. Ẹ lè yan nínú ọ̀nà mẹ́ta ọ̀tọ̀:

  • Wẹ́ẹ̀bù nìkan (àkọ́kọ́): Ó ń ṣàn gbogbo dátà nípasẹ̀ WebSocket tààrà sí MousePlayer. Ó dára jù fún àwòrán tààrà àkókò gidi, ṣùgbọ́n adblocker alágbára lè dí i.
  • Ọ̀nà àpapọ̀: Àǹfààní méjèèjì. Ó ń fi ipò eku/yíyí ojú ìwé fẹ́ẹ́rẹ́fẹ́ ránṣẹ́ nípasẹ̀ WebSocket fún àwòrán tààrà tó rọrùn, nígbà tí a ń kó ìyípadà DOM tó wuwo àti ìṣẹ̀lẹ̀ tiyín jọ, tí a sì ń darí wọn láìléwu nípasẹ̀ GTM ní ẹ̀rọ ìpèsè yín lórí HTTP POST.
  • CAPI nìkan: Àkójọ HTTP POST 100%. Àṣírí tó pọ̀ jù, kò sí WebSocket, ti ẹni àkọ́kọ́ pátápátá. Àkíyèsí: àwòrán tààrà kò ṣiṣẹ́ ní ọ̀nà yìí.

2. Ètò Google Tag Manager (a dámọ̀ràn)

Ọ̀nà tó rọrùn jù láti ṣe ọ̀nà àpapọ̀ tàbí CAPI nìkan ni lílo GTM Community Template tí a fọwọ́ sí. Ẹ gba fáìlì .tpl ìsàlẹ̀ sílẹ̀, kí ẹ sì gbé wọn wọlé sínú àgbègbè iṣẹ́ GTM yín.

Ìgbésẹ̀ 1: ṣètò Client àti Tag ní ẹ̀rọ ìpèsè

Nínú container GTM ní ẹ̀rọ ìpèsè yín, ẹ gbé àpẹrẹ Ingest Client wọlé. Ẹ ṣètò rẹ̀ láti gbọ́ lórí ọ̀nà tiyín (bí /mp_capi). Lẹ́yìn náà ẹ gbé Connector Tag wọlé, ṣètò rẹ̀ láti ṣiṣẹ́ lórí ìṣẹ̀lẹ̀ mouseplayer_batch , kí ẹ sì fi container yín sílẹ̀.

Ìgbésẹ̀ 2: ṣètò Tag Web GTM

Nínú container Web GTM yín, ẹ gbé SDK Tag wọlé. Ẹ yan “Configuration & Initialization” gẹ́gẹ́ bí Tag Type, kọ Channel ID yín, yan Ọ̀nà àpapọ̀, kí ẹ sì lẹ ssGTM Endpoint URL yín (bí https://metrics.yourdomain.com/mp_capi).

3. Fífi sori ẹrọ fúnra yín (láìsí GTM)

Bí ẹ bá fẹ́ kọ síkírípù sínú kóòdù, ẹ gbọ́dọ̀ ṣàlàyé ohun window.mp_config kí ẹ tó mú snippet ìtọ́pa wọlé.

<!-- 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. Ìtọ́pa funnel ìṣòwò ayélujára

Ẹ tọ́pa gbogbo ìrìnàjò oníbàárà. Lílo orúkọ ìṣẹ̀lẹ̀ déédéé ń jẹ́ kí MousePlayer ṣẹ̀dá ìròyìn funnel ìṣòwò ayélujára tó lẹ́wà fúnra rẹ̀ nínú àgbègbè iṣẹ́ iṣẹ́ akanṣe yín. Gbogbo ìṣẹ̀lẹ̀ bá ọ̀nà CAPI àti Wẹ́ẹ̀bù nìkan mu pátápátá.

1. view_item

Ẹ mú ìṣẹ̀lẹ̀ yìí ṣiṣẹ́ nígbà tí olùlò bá wo ojú ìwé ọjà pàtó.

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

2. add_to_cart

Ẹ mú ìṣẹ̀lẹ̀ yìí ṣiṣẹ́ nígbà tí olùlò bá fi ohun kan sínú kẹ̀kẹ́ ọjà rẹ̀.

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

3. begin_checkout

Ẹ mú ìṣẹ̀lẹ̀ yìí ṣiṣẹ́ nígbà tí olùlò bá lọ sí ojú ìbòjú checkout.

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

4. purchase

Ẹ mú ìṣẹ̀lẹ̀ yìí ṣiṣẹ́ lẹ́yìn ìsanwó tó ṣàṣeyọrí tàbí ìmúdájú àṣẹ ọjà.

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

5. Ìṣẹ̀lẹ̀ tiyín àti gbígba ẹni tó lè rà

Ẹ kò ní ààlà sí ìṣòwò ayélujára. Ẹ tọ́pa fífi fọ́ọ̀mù ránṣẹ́, ìforúkọsílẹ̀ ìwé ìròyìn tàbí ìbáṣepọ̀ tiyín tó jẹ́ ti ètò wẹ́ẹ̀bù yín nìkan.

Gbígba ẹni tó lè rà (fífi fọ́ọ̀mù ránṣẹ́)

Ẹ mú ìṣẹ̀lẹ̀ yìí ṣiṣẹ́ nígbà tí olùlò bá fi fọ́ọ̀mù ìbánisọ̀rọ̀ ránṣẹ́ ní àṣeyọrí tàbí béèrè iye owó.

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

Ìbáṣepọ̀ UI tiyín

Ẹ lóye bí olùlò ṣe ń bá ohun tó díjú bí ẹ̀rọ ìṣirò, àpótí tàbí ṣọ́ọ̀ṣì táàbù ṣe ìbáṣepọ̀.

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

6. Ààlà parameter àti ìlànà

Ìpín irú dátà: MousePlayer ń rí irú parameter fúnra rẹ̀. Ẹ fi nọ́ńbà ránṣẹ́ gẹ́gẹ́ bí integer tàbí float (bí 150.00, kì í ṣe "150.00") láti mú àlẹ̀mọ́ nọ́ńbà tó jinlẹ̀ ṣiṣẹ́ (bí “Iye owó > 100”) nínú dashboard.

Òfin Àpèjúwe
Gígùn orúkọ ìṣẹ̀lẹ̀ Lẹ́tà 128 tó pọ̀ jù. Ẹ lo snake_case fún ìrọ̀rùn kíkà tó dára jù (bí user_signup).
Gígùn key parameter Lẹ́tà 64 tó pọ̀ jù fún orúkọ key kan (bí transaction_id).
Iye ọ̀rọ̀ A gé parameter ọ̀rọ̀ kúrú sí lẹ́tà 255 láti rí i dájú pé ibi ìpamọ́ dátà ṣiṣẹ́ dáadáa jù.
Àṣírí dátà Ẹ má fi Personally Identifiable Information (PII), bí àdírẹ́sì ímeèlì àìṣe àgbékalẹ̀, orúkọ gidi tàbí ọ̀rọ̀ aṣínà, ránṣẹ́ gẹ́gẹ́ bí parameter ìṣẹ̀lẹ̀.