Сервер талын CAPI ба үйл явдлын хяналт

MousePlayer урсгалыг өөрийн нэгдүгээр талын сервер талын GTM контейнерээр дамжуулан зар хориглогч, ITP хязгаарлалтыг тойрч, цахим худалдааны гүнзгий шинжилгээг хянана уу.

1. Хяналтын горимуудын тойм

MousePlayer V2 нь хүчирхэг Үйл явдлын чиглүүлэгч танилцуулдаг. Энэ нь хэрэглэгчийн хөтчөөс манай серверүүд рүү өгөгдөл хэрхэн урсахыг удирдах боломж олгоно. Гурван ялгаатай горимоос сонгож болно:

  • Зөвхөн вэб (өгөгдмөл): Бүх өгөгдлийг WebSocket-оор MousePlayer руу шууд дамжуулна. Бодит цагийн шууд харагдацад хамгийн тохиромжтой боловч хүчтэй зар хориглогчид өртөмтгий.
  • Хосолсон горим: Хоёр талын давуу талыг нэгтгэнэ. Жигд шууд харагдацын тулд хулганы/гүйлгэлтийн хөнгөн координатыг WebSocket-оор илгээнэ. Харин том DOM өөрчлөлт болон тусгай үйл явдлуудыг багцалж, HTTP POST-оор сервер талын GTM-ээр аюулгүй дамжуулна.
  • Цэвэр CAPI: 100% HTTP POST багц боловсруулалт. Дээд нууцлал, WebSocket байхгүй, бүрэн нэгдүгээр талын. Анхаарна уу: энэ горимд шууд харагдац идэвхгүй.

2. Google Tag Manager тохируулах (зөвлөмж)

Хосолсон эсвэл цэвэр CAPI горим хэрэгжүүлэх хамгийн хялбар арга бол манай албан ёсны GTM Community Templates-ийг ашиглах юм. Доорх .tpl файлуудыг татаж, GTM ажлын орчнууддаа импортолно уу.

Загваруудыг татах:

↓ Вэб GTM: MousePlayer SDK шошго

↓ Серверийн GTM: MousePlayer өгөгдөл хүлээн авах хэрэглэгч

↓ Серверийн GTM: MousePlayer холбогч шошго

Алхам 1: сервер талын хэрэглэгч & шошгыг тохируулах

Сервер талын GTM контейнертээ дараах Өгөгдөл хүлээн авах хэрэглэгч загварыг импортолно уу. Тусгай замыг сонсохоор тохируулна уу (ж.нь. /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. Цахим худалдааны юүлүүрийн хяналт

Харилцагчийн бүх замналыг хянана уу. Стандартчилсан үйл явдлын нэр ашиглавал 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) бүү илгээгээрэй.