სერვერის მხარის CAPI და მოვლენების აღრიცხვა

გვერდი აუარეთ რეკლამის ბლოკერებსა და ITP შეზღუდვებს: MousePlayer ტრაფიკი საკუთარ, პირველი მხარის სერვერის მხარის GTM კონტეინერში გაატარეთ და ელექტრონული კომერციის დეტალური ანალიტიკა აღრიცხეთ.

1. აღრიცხვის რეჟიმების მიმოხილვა

MousePlayer V2 წარმოგიდგენთ მძლავრ მოვლენების მარშრუტიზატორს , რომლითაც მართავთ მონაცემთა ნაკადს მომხმარებლის ბრაუზერიდან ჩვენს სერვერებამდე. შეგიძლიათ სამი განსხვავებული რეჟიმი აირჩიოთ:

  • მხოლოდ ვები (ნაგულისხმევი): ყველა მონაცემს WebSockets-ით პირდაპირ MousePlayer-ს გადასცემს. საუკეთესოა რეალურ დროში პირდაპირი ხედისთვის, თუმცა ძლიერი რეკლამის ბლოკერების მიმართ მოწყვლადია.
  • ჰიბრიდული რეჟიმი: ორივე მიდგომის უპირატესობები. მსუბუქ მაუსის/გადახვევის კოორდინატებს WebSockets-ით აგზავნის გლუვი პირდაპირი ხედისთვის, ხოლო მძიმე DOM ცვლილებები და მორგებული მოვლენები ჯგუფდება და HTTP POST-ით უსაფრთხოდ გადის თქვენი სერვერის მხარის GTM-ში.
  • სუფთა CAPI: 100% HTTP POST ჯგუფური გაგზავნა. მაქსიმალური კონფიდენციალურობა, ნული WebSockets, სრულად პირველი მხარის. შენიშვნა: ამ რეჟიმში პირდაპირი ხედი გამორთულია.

2. Google Tag Manager-ის გამართვა (რეკომენდებული)

ჰიბრიდული ან სუფთა CAPI რეჟიმების დანერგვის უმარტივესი გზაა ჩვენი ოფიციალური GTM Community Templates-ის გამოყენება. ჩამოტვირთეთ ქვემოთ მოცემული .tpl ფაილები და თქვენს GTM სამუშაო სივრცეებში შემოიტანეთ.

შაბლონების ჩამოტვირთვა:

↓ Web GTM: MousePlayer SDK Tag

↓ Server GTM: MousePlayer Ingest Client

↓ Server GTM: MousePlayer Connector Tag

ნაბიჯი 1: სერვერის მხარის კლიენტისა და ტეგის კონფიგურაცია

თქვენს სერვერის მხარის GTM კონტეინერში შემოიტანეთ Ingest Client შაბლონი. მოსასმენად მორგებული გზა მიუთითეთ (მაგალითად, /mp_capi). შემდეგ შემოიტანეთ Connector Tag, მიუთითეთ ამოქმედება ამ mouseplayer_batch მოვლენაზე და განათავსეთ თქვენი კონტეინერი.

ნაბიჯი 2: ვების GTM ტეგის კონფიგურაცია

თქვენს ვების GTM კონტეინერში შემოიტანეთ SDK Tag. ტეგის ტიპად აირჩიეთ „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), როგორიცაა დაუმუშავებელი ელფოსტის მისამართები, ნამდვილი სახელები ან პაროლები, მოვლენის პარამეტრებად არ გაგზავნოთ.