CAPI នៅម៉ាស៊ីនមេ និងការតាមដានព្រឹត្តិការណ៍

ឆ្លងកាត់ឧបករណ៍ទប់ពាណិជ្ជកម្ម និងការរឹតបន្តឹង ITP ដោយបញ្ជូនចរាចរ MousePlayer តាមកុងតឺន័រ GTM នៅម៉ាស៊ីនមេភាគីទីមួយផ្ទាល់ ហើយតាមដានការវិភាគពាណិជ្ជកម្មអេឡិចត្រូនិកលម្អិត។

1. ទិដ្ឋភាពទូទៅរបៀបតាមដាន

MousePlayer V2 ណែនាំមុខងារដ៏មានសមត្ថភាព ឧបករណ៍បញ្ជូនព្រឹត្តិការណ៍ ដែលអនុញ្ញាតឱ្យគ្រប់គ្រងលំហូរទិន្នន័យពីកម្មវិធីរុករកអ្នកប្រើទៅម៉ាស៊ីនមេយើង។ អាចជ្រើសរបៀបបីផ្សេងគ្នា៖

  • តែវេប (លំនាំដើម)៖ បញ្ជូនទិន្នន័យទាំងអស់តាម WebSockets ដោយផ្ទាល់ទៅ MousePlayer។ ល្អបំផុតសម្រាប់ទិដ្ឋភាពផ្ទាល់តាមពេលវេលាពិត ប៉ុន្តែងាយរងឧបករណ៍ទប់ពាណិជ្ជកម្មខ្លាំង។
  • របៀបកូនកាត់៖ រួមអត្ថប្រយោជន៍ទាំងពីរ។ ផ្ញើកូអរដោនេកណ្តុរ/រំកិលស្រាលតាម WebSockets សម្រាប់ទិដ្ឋភាពផ្ទាល់រលូន ខណៈការផ្លាស់ប្តូរ DOM ធ្ងន់ និងព្រឹត្តិការណ៍ផ្ទាល់ខ្លួនត្រូវបានដាក់ជាបាច់ ហើយបញ្ជូនសុវត្ថិភាពតាម GTM នៅម៉ាស៊ីនមេដោយ HTTP POST។
  • Pure CAPI៖ ការបញ្ជូនបាច់ HTTP POST 100%។ ឯកជនភាពអតិបរមា គ្មាន WebSockets ជាភាគីទីមួយទាំងស្រុង។ ចំណាំ៖ ទិដ្ឋភាពផ្ទាល់ត្រូវបានបិទក្នុងរបៀបនេះ។

2. ការដំឡើង Google Tag Manager (បានណែនាំ)

វិធីងាយបំផុតក្នុងការដាក់ប្រើរបៀបកូនកាត់ ឬ Pure CAPI គឺប្រើគំរូសហគមន៍ GTM ផ្លូវការរបស់យើង។ ទាញយកឯកសារ .tpl ខាងក្រោម ហើយនាំចូលទៅកន្លែងធ្វើការ GTM។

ជំហាន 1៖ កំណត់រចនាសម្ព័ន្ធម៉ាស៊ីនភ្ញៀវ និងស្លាកនៅម៉ាស៊ីនមេ

ក្នុងកុងតឺន័រ GTM នៅម៉ាស៊ីនមេ នាំចូលគំរូ Ingest Client ។ កំណត់ឱ្យស្តាប់លើផ្លូវផ្ទាល់ខ្លួន (ឧ. /mp_capi)។ បន្ទាប់មកនាំចូល Connector Tagកំណត់ឱ្យដំណើរការលើព្រឹត្តិការណ៍ mouseplayer_batch ហើយដាក់ប្រើកុងតឺន័រ។

ជំហាន 2៖ កំណត់រចនាសម្ព័ន្ធស្លាក Web GTM

ក្នុងកុងតឺន័រ Web GTM នាំចូល SDK Tag។ ជ្រើស “Configuration & Initialization” ជាប្រភេទស្លាក បញ្ចូល Channel IDជ្រើស របៀបកូនកាត់ហើយបិទភ្ជាប់ URL ចំណុចបញ្ចប់ ssGTM (ឧ. 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. ការតាមដានចីវលោពាណិជ្ជកម្មអេឡិចត្រូនិក

តាមដានដំណើរអតិថិជនទាំងមូល។ ការប្រើឈ្មោះព្រឹត្តិការណ៍ស្តង់ដារអនុញ្ញាតឱ្យ MousePlayer បង្កើតរបាយការណ៍ចីវលោពាណិជ្ជកម្មអេឡិចត្រូនិកច្បាស់ដោយស្វ័យប្រវត្តិក្នុងកន្លែងធ្វើការគម្រោង។ ព្រឹត្តិការណ៍ទាំងអស់ត្រូវគ្នាពេញលេញនឹងរបៀប 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) ដូចជាអាសយដ្ឋានអ៊ីមែលដើម ឈ្មោះពិត ឬពាក្យសម្ងាត់ជាប៉ារ៉ាម៉ែត្រព្រឹត្តិការណ៍។