CAPI n'akụkụ sava & nsuso ihe omume

Gafee ihe mgbochi mgbasa ozi na mmachi ITP site n'iduga okporo ụzọ MousePlayer n'ime container GTM n'akụkụ sava nke gị nke first-party, ma soro nyocha azụmahịa ịntanetị zuru ezu.

1. Nchịkọta ụdị nsuso

MousePlayer V2 na-ewebata ihe siri ike a na-akpọ Ihe na-eduzi ihe omume nke na-ahapụ gị ịchị otú data si esi n'ihe nchọgharị onye ọrụ gị gaa na sava anyị. Ị nwere ike ịhọrọ n'ime ụdị atọ dị iche iche:

  • Naanị webụ (Ndabara): Na-eziga data niile site na WebSocket ozugbo na MousePlayer. Kacha mma maka nlele ndụ ozugbo, mana nnukwu ihe mgbochi mgbasa ozi nwere ike igbochi ya.
  • Ụdị ngwakọ: Ihe kacha mma n'ụwa abụọ ahụ. Na-eziga ọnọdụ òké/ịtụgharị ibe dị mfe site na WebSocket maka nlele ndụ dị larịị, ebe a na-achịkọta nnukwu mgbanwe DOM na ihe omume nke gị n'ìgwè wee duga ha n'enweghị nsogbu site na GTM n'akụkụ sava gị na HTTP POST.
  • CAPI naanị: Ịchịkọta n'ìgwè HTTP POST 100%. Nzuzo kacha elu, enweghị WebSocket, first-party kpamkpam. Ndetu: a na-agbanyụ nlele ndụ n'ụdị a.

2. Ntọala Google Tag Manager (A na-atụ aro)

Ụzọ kachasị mfe iji mejuputa ụdị ngwakọ ma ọ bụ CAPI naanị bụ iji ndebiri obodo GTM nke anyị. Budata faịlụ .tpl ndị dị n'okpuru wee bubata ha n'oghere ọrụ GTM gị.

Budata ndebiri:

↓ Web GTM: Tag SDK MousePlayer

↓ Server GTM: Onye ahịa ntinye MousePlayer

↓ Server GTM: Tag njikọ MousePlayer

Nzọụkwụ 1: hazie onye ahịa na tag n'akụkụ sava

N'ime container GTM n'akụkụ sava gị, bubata ndebiri Onye ahịa ntinye . Setịpụ ya ka ọ gee ntị n'ụzọ nke gị (dịka, /mp_capi). Mgbe ahụ, bubata Tag njikọ, hazie ya ka ọ rụọ ọrụ na ihe omume mouseplayer_batch , wee wepụta container gị.

Nzọụkwụ 2: hazie tag Web GTM

N'ime container Web GTM gị, bubata Tag SDK. Họrọ “Configuration & Initialization” dịka ụdị tag, tinye Channel IDgị, họrọ Ụdị ngwakọ, wee tapawa URL ebe njedebe ssGTM gị (dịka, https://metrics.yourdomain.com/mp_capi).

3. Nrụnye aka (Enweghị GTM)

Ọ bụrụ na ị masịrị ide script ozugbo, ị ga-akọwa ihe window.mp_config tupu iburu iberibe koodu nsuso.

<!-- 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. Nsuso ọwara azụmahịa ịntanetị

Soro njem onye ahịa dum. Iji aha ihe omume ọkọlọtọ na-ahapụ MousePlayer ka ọ mepụta akụkọ ọwara azụmahịa ịntanetị mara mma na-akpaghị aka n'oghere ọrụ ngo gị. Ihe omume niile kwekọrọ kpamkpam na ụdị CAPI na naanị webụ.

1. view_item

Kpalite ihe omume a mgbe onye ọrụ lere ibe ngwaahịa a kapịrị ọnụ.

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

2. add_to_cart

Kpalite ihe omume a mgbe onye ọrụ tinyere ihe n'ụgbọ ihe ya.

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

3. begin_checkout

Kpalite ihe omume a mgbe onye ọrụ gara n'ihuenyo ịkwụ ụgwọ.

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

4. purchase

Kpalite ihe omume a mgbe ịkwụ ụgwọ gara nke ọma ma ọ bụ e kwadoro iwu.

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

5. Ihe omume nke gị & inweta ndị ahịa nwere mmasị

Ị bụghị naanị maka azụmahịa ịntanetị. Soro iziga fọm, ịdenye aha akwụkwọ akụkọ ma ọ bụ mmekọrịta nke gị nke pụrụ iche na ngwa webụ gị.

Inweta ndị ahịa nwere mmasị (Iziga fọm)

Kpalite ihe omume a mgbe onye ọrụ zigara fọm kọntaktị nke ọma ma ọ bụ rịọ ọnụahịa.

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

Mmekọrịta ihu nke gị

Ghọta otú ndị ọrụ si emekọrịta ihe dị mgbagwoju anya dịka ihe mgbako, modal ma ọ bụ mgba taabụ.

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

6. Oke paramita & ntuziaka

Ụdị data: MousePlayer na-achọpụta ụdị paramita na-akpaghị aka. Ziga nọmba dịka integer ma ọ bụ float (dịka, 150.00, ọ bụghị "150.00") iji nye ohere maka nzacha nọmba dị elu (dịka “Ọnụ ahịa > 100”) na bọọdụ nchịkwa.

Iwu Nkọwa
Ogologo aha ihe omume Kacha mkpụrụedemede 128. Jiri snake_case maka ịgụ dị mfe (dịka, user_signup).
Ogologo igodo paramita Kacha mkpụrụedemede 64 n'otu aha igodo (dịka, transaction_id).
Uru string A na-ebipụ paramita ederede ruo mkpụrụedemede 255 iji hụ na ebe nchekwa data na-arụ ọrụ kacha mma.
Nzuzo data Ekwela mgbe ọ bụla iziga ozi a pụrụ iji mata mmadụ (PII) dịka adreesị email mbụ, ezigbo aha ma ọ bụ okwuntughe dịka paramita ihe omume.