ਸਰਵਰ ਪਾਸੇ ਦੀ CAPI ਅਤੇ ਇਵੈਂਟ ਟਰੈਕਿੰਗ

MousePlayer ਆਵਾਜਾਈ ਆਪਣੇ ਹੀ ਪਹਿਲੀ-ਪਾਰਟੀ ਸਰਵਰ ਪਾਸੇ ਦੇ GTM ਕੰਟੇਨਰ ਰਾਹੀਂ ਭੇਜ ਕੇ ਇਸ਼ਤਿਹਾਰ ਬਲੌਕਰਾਂ ਅਤੇ ITP ਪਾਬੰਦੀਆਂ ਤੋਂ ਅੱਗੇ ਲੰਘੋ ਅਤੇ ਡੂੰਘਾ ਈ-ਕਾਮਰਸ ਵਿਸ਼ਲੇਸ਼ਣ ਟਰੈਕ ਕਰੋ।

1. ਟਰੈਕਿੰਗ ਮੋਡਾਂ ਦਾ ਸੰਖੇਪ

MousePlayer V2 ਇੱਕ ਸ਼ਕਤੀਸ਼ਾਲੀ ਇਹ ਲਿਆਉਂਦਾ ਹੈ: Event Router ਜੋ ਵਰਤੋਂਕਾਰ ਦੇ ਬ੍ਰਾਊਜ਼ਰ ਤੋਂ ਸਾਡੇ ਸਰਵਰਾਂ ਤੱਕ ਡਾਟਾ ਪ੍ਰਵਾਹ ਕੰਟਰੋਲ ਕਰਨ ਦਿੰਦਾ ਹੈ। ਤਿੰਨ ਵੱਖਰੇ ਮੋਡ ਚੁਣ ਸਕਦੇ ਹੋ:

  • ਸਿਰਫ਼ ਵੈੱਬ (ਮੂਲ): WebSockets ਰਾਹੀਂ ਸਾਰਾ ਡਾਟਾ ਸਿੱਧਾ MousePlayer ਨੂੰ ਭੇਜਦਾ ਹੈ। ਅਸਲ ਸਮੇਂ ਦੇ ਲਾਈਵ ਦ੍ਰਿਸ਼ ਲਈ ਵਧੀਆ ਪਰ ਸਖ਼ਤ ਇਸ਼ਤਿਹਾਰ ਬਲੌਕਰਾਂ ਤੋਂ ਪ੍ਰਭਾਵਿਤ।
  • ਹਾਈਬ੍ਰਿਡ ਮੋਡ: ਦੋਵਾਂ ਦਾ ਲਾਭ। ਸੁਚੱਜੇ ਲਾਈਵ ਦ੍ਰਿਸ਼ ਲਈ ਹਲਕੇ ਮਾਊਸ/ਸਕ੍ਰੋਲ ਕੋਆਰਡੀਨੇਟ WebSockets ਰਾਹੀਂ ਜਾਂਦੇ ਹਨ, ਜਦਕਿ ਭਾਰੀ DOM ਬਦਲਾਅ ਅਤੇ ਆਪਣੇ ਇਵੈਂਟ ਬੈਚ ਬਣ ਕੇ HTTP POST ਰਾਹੀਂ ਸਰਵਰ ਪਾਸੇ ਦੇ GTM ਤੋਂ ਸੁਰੱਖਿਅਤ ਜਾਂਦੇ ਹਨ।
  • ਸਿਰਫ਼ CAPI: 100% HTTP POST ਬੈਚ। ਵੱਧ ਤੋਂ ਵੱਧ ਗੋਪਨੀਯਤਾ, ਕੋਈ WebSockets ਨਹੀਂ, ਪੂਰੀ ਪਹਿਲੀ-ਪਾਰਟੀ। ਨੋਟ: ਇਸ ਮੋਡ ਵਿੱਚ ਲਾਈਵ ਦ੍ਰਿਸ਼ ਬੰਦ ਹੈ।

2. Google Tag Manager ਸੈੱਟਅੱਪ (ਸਿਫ਼ਾਰਸ਼ੀ)

Hybrid ਜਾਂ ਸਿਰਫ਼ CAPI ਮੋਡ ਲਗਾਉਣ ਦਾ ਸਭ ਤੋਂ ਸੌਖਾ ਤਰੀਕਾ ਸਾਡੇ ਅਧਿਕਾਰਕ GTM Community Templates ਹਨ। ਹੇਠਲੀਆਂ ਇਹ .tpl ਫਾਈਲਾਂ ਡਾਊਨਲੋਡ ਕਰਕੇ GTM ਵਰਕਸਪੇਸਾਂ ਵਿੱਚ ਆਯਾਤ ਕਰੋ।

ਟੈਮਪਲੇਟ ਡਾਊਨਲੋਡ ਕਰੋ:

↓ Web GTM: MousePlayer SDK Tag

↓ Server GTM: MousePlayer Ingest Client

↓ Server GTM: MousePlayer Connector Tag

ਕਦਮ 1: ਸਰਵਰ ਪਾਸੇ ਦਾ Client ਅਤੇ Tag ਸੈੱਟ ਕਰੋ

ਸਰਵਰ ਪਾਸੇ ਦੇ GTM ਕੰਟੇਨਰ ਵਿੱਚ ਇਹ ਆਯਾਤ ਕਰੋ: Ingest Client ਟੈਮਪਲੇਟ। ਆਪਣੇ ਰਸਤੇ ਉੱਤੇ ਸੁਣਨ ਲਈ ਸੈੱਟ ਕਰੋ (ਜਿਵੇਂ /mp_capi)। ਫਿਰ ਇਹ ਆਯਾਤ ਕਰੋ: Connector Tag ਅਤੇ ਇਸ ਇਵੈਂਟ ਉੱਤੇ ਚੱਲਣ ਲਈ ਸੈੱਟ ਕਰੋ: mouseplayer_batch , ਫਿਰ ਕੰਟੇਨਰ ਲਗਾਓ।

ਕਦਮ 2: Web GTM Tag ਸੈੱਟ ਕਰੋ

Web GTM ਕੰਟੇਨਰ ਵਿੱਚ ਇਹ ਆਯਾਤ ਕਰੋ: SDK Tag। Tag Type ਵਜੋਂ “Configuration & Initialization” ਚੁਣੋ, ਆਪਣਾ ਇਹ ਦਿਓ: Channel ID, ਚੁਣੋ: Hybrid Mode ਅਤੇ 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. ਈ-ਕਾਮਰਸ ਫਨਲ ਟਰੈਕਿੰਗ

ਗਾਹਕ ਦਾ ਪੂਰਾ ਰਸਤਾ ਟਰੈਕ ਕਰੋ। ਮਿਆਰੀ ਇਵੈਂਟ ਨਾਮ 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), ਜਿਵੇਂ ਕੱਚੇ ਈਮੇਲ ਪਤੇ, ਅਸਲ ਨਾਮ ਜਾਂ ਪਾਸਵਰਡ, ਇਵੈਂਟ ਪੈਰਾਮੀਟਰਾਂ ਵਜੋਂ।