ဆာဗာဘက် CAPI နှင့် ဖြစ်ရပ်ခြေရာခံမှု

MousePlayer ဝင်ရောက်မှုကို ကိုယ်ပိုင်ပထမပါတီ ဆာဗာဘက် GTM ကွန်တိန်နာမှ ပို့၍ ကြော်ငြာပိတ်ကိရိယာနှင့် ITP ကန့်သတ်ချက်များကို ကျော်လွှားပြီး အွန်လိုင်းအရောင်းခွဲခြမ်းစိတ်ဖြာမှုကို နက်ရှိုင်းစွာ ခြေရာခံပါ။

1. ခြေရာခံမုဒ်များ အကျဉ်းချုပ်

MousePlayer V2 က စွမ်းရည်မြင့်သော Event Router ကို မိတ်ဆက်၍ အသုံးပြုသူဘရောက်ဇာမှ ဆာဗာများသို့ ဒေတာစီးဆင်းပုံ ထိန်းချုပ်နိုင်စေသည်။ မတူသောမုဒ်သုံးခုမှ ရွေးနိုင်သည်:

  • ဝဘ်သာ (မူလ): ဒေတာအားလုံးကို WebSocket မှ MousePlayer သို့ တိုက်ရိုက်ထုတ်လွှင့်သည်။ အချိန်နှင့်တစ်ပြေးညီ တိုက်ရိုက်မြင်ကွင်းအတွက် အကောင်းဆုံးဖြစ်သော်လည်း အားကောင်းသောကြော်ငြာပိတ်ကိရိယာများက တားနိုင်သည်။
  • ပေါင်းစပ်မုဒ်: နှစ်ဖက်၏အကောင်းဆုံးအရာများ။ ချောမွေ့သောတိုက်ရိုက်မြင်ကွင်းအတွက် ပေါ့ပါးမောက်စ်/စာမျက်နှာရွှေ့ကိုဩဒိနိတ်များကို WebSocket မှပို့ပြီး ကြီးမား DOM ပြောင်းလဲမှုနှင့် စိတ်ကြိုက်ဖြစ်ရပ်များကို အသုတ်ဖွဲ့၍ HTTP POST မှ ဆာဗာဘက် GTM ဖြင့် လုံခြုံစွာပို့သည်။
  • CAPI သက်သက်: 100% HTTP POST အသုတ်လိုက်လုပ်ဆောင်မှု။ အများဆုံးကိုယ်ရေးလုံခြုံမှု၊ WebSocket လုံးဝမရှိ၊ အပြည့်အဝပထမပါတီ။ မှတ်ချက်: ဤမုဒ်တွင် တိုက်ရိုက်မြင်ကွင်း ပိတ်ထားသည်။

2. Google Tag Manager သတ်မှတ်ခြင်း (အကြံပြုသည်)

ပေါင်းစပ် သို့မဟုတ် CAPI သက်သက်မုဒ် ထည့်သွင်းရန် အလွယ်ဆုံးနည်းမှာ တရားဝင် GTM ကွန်မြူနတီနမူနာများ သုံးခြင်းဖြစ်သည်။ အောက်ပါဖိုင်များကို ဒေါင်းလုဒ်လုပ်ပါ: .tpl ၊ ထို့နောက် GTM အလုပ်နေရာများထဲ တင်သွင်းပါ။

နမူနာများ ဒေါင်းလုဒ်လုပ်ရန်:

↓ ဝဘ် GTM: MousePlayer SDK တံဆိပ်

↓ ဆာဗာ GTM: MousePlayer Ingest Client

↓ ဆာဗာ GTM: MousePlayer ချိတ်ဆက်ကိရိယာတံဆိပ်

အဆင့် 1: ဆာဗာဘက် ကလိုင်းယင့်နှင့် တံဆိပ် သတ်မှတ်ပါ

ဆာဗာဘက် GTM ကွန်တိန်နာတွင် တင်သွင်းပါ: Ingest Client နမူနာ။ စိတ်ကြိုက်လမ်းကြောင်းတွင် နားထောင်ရန် သတ်မှတ်ပါ (ဥပမာ /mp_capi)။ ထို့နောက် တင်သွင်းပါ: ချိတ်ဆက်ကိရိယာတံဆိပ်၊ အောက်ပါဖြစ်ရပ်တွင် အစပျိုးရန် သတ်မှတ်ပါ: mouseplayer_batch ၊ ကွန်တိန်နာ ထုတ်ဝေပါ။

အဆင့် 2: ဝဘ် GTM တံဆိပ် သတ်မှတ်ပါ

ဝဘ် GTM ကွန်တိန်နာတွင် တင်သွင်းပါ: SDK တံဆိပ်။ တံဆိပ်အမျိုးအစားအဖြစ် “Configuration & Initialization” ရွေးပြီး အောက်ပါတန်ဖိုး ထည့်ပါ: Channel ID၊ ထို့နောက် ရွေးပါ: ပေါင်းစပ်မုဒ်၊ ssGTM အဆုံးမှတ် URL ကူးထည့်ပါ (ဥပမာ https://metrics.yourdomain.com/mp_capi)။

3. ကိုယ်တိုင်ထည့်သွင်းခြင်း (GTM မပါ)

စခရစ်ကို ကုဒ်တွင် တိုက်ရိုက်ထည့်လိုပါက သတ်မှတ်ရမည့်အရာမှာ window.mp_config အရာဝတ္ထုဖြစ်ပြီး ခြေရာခံကုဒ်အပိုင်း မတင်မီ သတ်မှတ်ရမည်။

<!-- 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. အွန်လိုင်းအရောင်းဖန်နယ် ခြေရာခံခြင်း

ဖောက်သည်ခရီးစဉ်အပြည့် ခြေရာခံပါ။ စံသတ်မှတ်ဖြစ်ရပ်အမည်များ သုံးခြင်းက ပရောဂျက်အလုပ်နေရာတွင် လှပသောအွန်လိုင်းအရောင်းဖန်နယ်အစီရင်ခံစာများ အလိုအလျောက်ဖန်တီးနိုင်စေသည်။ ဖြစ်ရပ်အားလုံးသည် CAPI နှင့် ဝဘ်သာမုဒ်များနှင့် အပြည့်အဝကိုက်ညီသည်။

1. view_item

အသုံးပြုသူက သီးခြားကုန်ပစ္စည်းစာမျက်နှာ ကြည့်သောအခါ ဤဖြစ်ရပ် အစပျိုးပါ။

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

2. add_to_cart

အသုံးပြုသူက ဈေးခြင်းထဲ ကုန်ပစ္စည်းထည့်သောအခါ ဤဖြစ်ရပ် အစပျိုးပါ။

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

3. begin_checkout

အသုံးပြုသူက ငွေရှင်းမျက်နှာပြင်သို့ ဆက်သွားသောအခါ ဤဖြစ်ရပ် အစပျိုးပါ။

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

4. purchase

ငွေပေးချေမှုအောင်မြင် သို့မဟုတ် အော်ဒါအတည်ပြုသောအခါ ဤဖြစ်ရပ် အစပျိုးပါ။

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

5. စိတ်ကြိုက်ဖြစ်ရပ်များနှင့် စိတ်ဝင်စားဖောက်သည်ရရှိမှု

အွန်လိုင်းအရောင်းတွင်သာ မကန့်သတ်ပါ။ ဖောင်ပို့မှု၊ သတင်းလွှာစာရင်းသွင်းမှု သို့မဟုတ် ဝဘ်အက်ပ်သီးသန့် စိတ်ကြိုက်အပြန်အလှန်လုပ်ဆောင်မှုများ ခြေရာခံပါ။

စိတ်ဝင်စားဖောက်သည်ရရှိမှု (ဖောင်ပို့ခြင်း)

အသုံးပြုသူက ဆက်သွယ်ဖောင် အောင်မြင်စွာပို့ သို့မဟုတ် စျေးနှုန်းတောင်းသောအခါ ဤဖြစ်ရပ် အစပျိုးပါ။

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

စိတ်ကြိုက် UI အပြန်အလှန်လုပ်ဆောင်မှု

အသုံးပြုသူများ တွက်ချက်ကိရိယာ၊ ဒိုင်ယာလော့ဂ် သို့မဟုတ် တက်ဘ်ပြောင်းကိရိယာကဲ့သို့ ရှုပ်ထွေးအစိတ်အပိုင်းများကို သုံးပုံ နားလည်ပါ။

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

6. ပါရာမီတာကန့်သတ်ချက်များနှင့် လမ်းညွှန်များ

ဒေတာအမျိုးအစားသတ်မှတ်ခြင်း: MousePlayer က ပါရာမီတာအမျိုးအစား အလိုအလျောက်သိရှိသည်။ ဂဏန်းများကို ကိန်းပြည့် သို့မဟုတ် ဒဿမကိန်းအဖြစ် ပို့ပါ (ဥပမာ 150.00၊ အောက်ပါမဟုတ်ပါ: "150.00")၊ ဒက်ရှ်ဘုတ်တွင် အဆင့်မြင့်ဂဏန်းစစ်ထုတ်မှု (ဥပမာ “စျေးနှုန်း > 100”) ရရှိစေရန်ဖြစ်သည်။

စည်းမျဉ်း ဖော်ပြချက်
ဖြစ်ရပ်အမည်အရှည် အများဆုံး အက္ခရာ 128 လုံး။ ဖတ်ရလွယ်ရန် snake_case သုံးပါ (ဥပမာ user_signup)။
ပါရာမီတာသော့အရှည် သော့အမည်တစ်ခုလျှင် အများဆုံး အက္ခရာ 64 လုံး (ဥပမာ transaction_id)။
စာသားတန်ဖိုးများ ဒေတာဘေ့စ်စွမ်းဆောင်ရည် အကောင်းဆုံးဖြစ်ရန် စာသားပါရာမီတာများကို အက္ခရာ 255 လုံးအထိ ဖြတ်သည်။
ဒေတာကိုယ်ရေးလုံခြုံမှု ပို့ခြင်းကို လုံးဝမလုပ်ပါနှင့် ၊ မူရင်းအီးမေးလ်လိပ်စာ၊ အမည်အစစ် သို့မဟုတ် စကားဝှက်ကဲ့သို့ လူတစ်ဦးကိုဖော်ထုတ်နိုင်သောအချက်အလက် (PII) ကို ဖြစ်ရပ်ပါရာမီတာအဖြစ်။