Սերվերային CAPI և իրադարձությունների հետևում

Շրջանցեք գովազդի արգելափակիչներն ու ITP սահմանափակումները՝ MousePlayer-ի տրաֆիկը ձեր սեփական առաջին կողմի սերվերային GTM կոնտեյներով փոխանցելով, և հետևեք էլեկտրոնային առևտրի խորքային վերլուծությանը։

1. Հետևման ռեժիմների ակնարկ

MousePlayer V2-ը ներկայացնում է հզոր Event Router , որը թույլ է տալիս կառավարել տվյալների հոսքը օգտատիրոջ դիտարկիչից դեպի մեր սերվերներ։ Կարող եք ընտրել երեք տարբեր ռեժիմներից՝

  • Միայն վեբ՝ լռելյայն՝ Բոլոր տվյալներն ուղարկում է WebSockets-ով անմիջապես MousePlayer։ Լավագույնը իրական ժամանակի ուղիղ դիտման համար, բայց խոցելի է ուժեղ գովազդի արգելափակիչների հանդեպ։
  • Hybrid ռեժիմ՝ Երկու աշխարհների լավագույնը։ Մկնիկի/ոլորման թեթև կոորդինատներն ուղարկում է WebSockets-ով՝ սահուն ուղիղ դիտման համար, իսկ ծավալուն DOM փոփոխություններն ու հատուկ իրադարձությունները խմբավորվում և անվտանգ ուղղորդվում են սերվերային GTM-ով՝ HTTP POST-ով։
  • Pure CAPI՝ 100% HTTP POST խմբավորում։ Առավելագույն գաղտնիություն, զրո WebSockets, ամբողջությամբ առաջին կողմի։ Նշում. այս ռեժիմում ուղիղ դիտումն անջատված է։

2. Google Tag Manager-ի կարգավորում՝ խորհուրդ է տրվում

Hybrid կամ Pure CAPI ռեժիմները ներդնելու ամենահեշտ ճանապարհը մեր պաշտոնական GTM Community Templates-ն օգտագործելն է։ Ներբեռնեք ստորևի .tpl ֆայլերը և ներմուծեք GTM աշխատանքային տարածքներ։

Ներբեռնել ձևանմուշները՝

↓ Web GTM. MousePlayer SDK պիտակ

↓ Server GTM. MousePlayer ընդունման հաճախորդ

↓ Server GTM. MousePlayer միակցիչի պիտակ

Քայլ 1. կարգավորել սերվերային հաճախորդն ու պիտակը

Սերվերային GTM կոնտեյներում ներմուծեք Ingest Client ձևանմուշը։ Սահմանեք հատուկ ուղի լսելը, օրինակ՝ /mp_capi։ Այնուհետև ներմուծեք Connector Tag-ը, կարգավորեք գործարկումը՝ mouseplayer_batch իրադարձության պահին, և տեղակայեք կոնտեյները։

Քայլ 2. կարգավորել Web GTM պիտակը

Web GTM կոնտեյներում ներմուծեք SDK Tag-ը։ Որպես պիտակի տիպ ընտրեք «Configuration & Initialization», մուտքագրեք ձեր Channel ID, ընտրեք Hybrid ռեժիմև տեղադրեք 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' });

Միջերեսի հատուկ փոխազդեցություն

Հասկացեք՝ ինչպես են օգտատերերը փոխազդում բարդ տարրերի հետ՝ հաշվիչներ, մոդալ պատուհաններ կամ ներդիրների փոխարկիչներ։

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, օրինակ՝ չմշակված էլփոստի հասցեներ, իրական անուններ կամ գաղտնաբառեր, որպես իրադարձության պարամետրեր։