چرخهٔ عمر (سمت سرور)

به‌محض اینکه نشست شناسهٔ مشتری خودتان را بگیرد، پیوند بازپخش را از سرور ما به ActiveCampaign، Mailchimp، Iterable یا Klaviyo بفرستید.

1. چرا کنار پل مرورگر وجود دارد

MousePlayer از قبل پل چرخهٔ عمری دارد که در SDK روی صفحهٔ خودتان می‌نویسد؛ Klaviyo، Braze، Customer.io و شش مورد دیگر. این مورد همان کار را از سرور ما می‌کند، چون برای دو پلتفرم بزرگ مسیر مرورگر اصلاً ممکن نیست:

  • ActiveCampaign اصلاً API مرورگر برای رویداد ندارد. این موردش vgo() می‌تواند حساب و ایمیل تنظیم و ردیابی را شروع کند، اما رویداد نمی‌فرستد. رویداد فقط از Event Tracking API با کلید جدا و سمت سرور می‌رود.
  • Mailchimp دارد، اما با واژگان بسته. پیکسل ردیابی سایتش این موارد را می‌پذیرد: PAGE_VIEWED، PRODUCT_VIEWED، PURCHASED و چند نام ازپیش‌تعریف‌شدهٔ دیگر. جایی برای رویداد اختصاصی نیست و جا دادن دادهٔ ما در PAGE_VIEWED دروغی در مدل دادهٔ خودتان است.

برای Iterable و Klaviyo مسیر سرور فقط قابل اعتمادتر است: بدون مسدودکنندهٔ تبلیغ، SDK با بارگذاری نامطمئن یا بستن زودهنگام برگه.

2. چه لازم دارد

سه فیلد که پر کردنشان به پلتفرم بستگی دارد.

پلتفرمفیلد حسابکلید
ActiveCampaignactidوب‌سایت → ردیابی سایت، کنار کلید رویداد
Mailchimpشناسهٔ مخاطبانکلید API؛ پسوند به‌سبک -us14 آن را نگه دارید، مرکز داده از آن خوانده می‌شود
Iterableلازم نیست؛ خالی بگذاریدکلید با مجوز «Allow event track calls»
Klaviyoلازم نیست؛ خالی بگذاریدکلید API از نوع خصوصی باشد

فیلد سوم نام رویدادی است که نشان داده می‌شود. کوتاه نگه دارید: حداکثر 32 نویسه. این محدودیت API است، نه ما؛ هنگام ذخیره کوتاه می‌کنیم، نه ارسال، تا فرم چیزی متفاوت از آنچه می‌رسد نشان ندهد.

Mailchimp: پسوند کلید API را نگه دارید. بخش پس از آخرین خط تیره (-us14) مرکز دادهٔ حساب را مشخص می‌کند و نشانی از آن ساخته می‌شود. کلید بدون آن با پیام روشن رد می‌شود تا در جایی دور از دید شکست نخورد.

3. چه وقت اجرا می‌شود و چه وقت نه

هنگام شناسایی نشست: وقتی سایت شما این را فراخوانی می‌کند: MousePlayer.setUserId()، وقتی پل تحلیل ما شناسهٔ متمایز را بازمی‌خواند یا سرور شما نقطهٔ پایانی identify را فراخوانی می‌کند. پیش از آن نمی‌دانیم ضبط متعلق به کیست.

فقط با ایمیل

هر چهار پلتفرم مخاطب را با ایمیل خطاب می‌کنند. اگر شناسهٔ مشتری شمارهٔ قرارداد باشد چیزی نمی‌رود؛ صف کردن کاری محکوم به شکست فقط گزارش را با نویز پر می‌کند.

مخاطب باید از قبل وجود داشته باشد. هیچ‌کدام از رویداد مخاطب نمی‌سازند؛ ActiveCampaign اگر نشانی را نشناسد کل رویداد را کنار می‌گذارد. این پل مخاطب موجود را غنی می‌کند و فهرست نمی‌سازد.

هر رویداد شناسه دارد

تا حتی با تلاش دوبارهٔ کار، همان نشست دو بار شمرده نشود.

4. آنچه به طرف دیگر می‌رسد

یک رویداد با پیوند بازپخش به‌صورت ویژگی با نام mouseplayer_session_url. بازش کنید تا به ضبط دقیق همان نشست بروید.

از آنجا منطق پلتفرم خودتان است: رویداد را راه‌انداز خودکارسازی، شرط بخش یا صرفاً راه باز کردن ضبط از مخاطب برای تیم قرار دهید.

کلید هرگز از سرور ما خارج نمی‌شود

با AES-256-GCM رمزگذاری می‌شود، پس از ذخیره هرگز دوباره نشان داده نمی‌شود و عمداً در صف داخلی حامل کار نمی‌رود؛ پردازشگر خودش از پایگاه داده می‌گیرد.

HTTP 200 به معنی تحویل نیست

ActiveCampaign هنگام رد رویداد وضعیت 200 و این مورد را می‌دهد: {"success":0} . بدنهٔ پاسخ را می‌خوانیم، نه فقط وضعیت، تا رد شدن در گزارش تحویل شکست باشد و نه موفقیت بی‌صدا.

5. Braze، Customer.io و Brevo

سه پلتفرم دیگر در مسیر سمت سرور. دو مورد چیزی می‌خواهند که بقیه نمی‌خواهند: مکان.

اطلاعات شماشناسایی با
Brazeنقطهٔ پایانی REST و کلید APIایمیل
Customer.ioشناسهٔ سایت، کلید API و منطقهٔ شماشناسهٔ مشتری خودتان
Brevoفقط کلید ردیابایمیل

دو مورد در مکان مشخصی‌اند

Braze نقطهٔ پایانی REST وابسته به نمونه دارد؛ Customer.io دو منطقهٔ جدا با میزبان متفاوت. هیچ‌کدام از کلید معلوم نمی‌شود و انتخاب اشتباه پاسخ 401 می‌دهد و شما را به بررسی کلید می‌فرستد. دلیل وجود هر دو فیلد همین است.

Customer.io ایمیل لازم ندارد

افراد را با همان شناسهٔ تخصیصی شما می‌شناسد؛ الزام ایمیل مانع ساختگی است. شش مورد دیگر با ایمیل تطبیق می‌دهند و برای آن‌ها نشست با شناسهٔ شمارهٔ قرارداد درست است که چیزی نسازد.

بدون نمایهٔ جدید

فراخوان Braze این مورد را دارد: _update_existing_only. همان تصمیم پل CRM: نشست مرورگر اظهارنظر قابل اعتماد دربارهٔ مشتری شما نیست و پلتفرم چرخهٔ عمر که برای هر بازدیدکنندهٔ ناشناس نمایه بسازد از نبود یکپارچه‌سازی بدتر است.

Brevo پاسخ 204 و Braze پاسخ 201 با نکته‌ای می‌دهد

Brevo اصلاً بدنه نمی‌دهد و آنجا 2xx همهٔ حقیقت است. Braze این مورد را برمی‌گرداند: "message": "success" و ممکن است کنار آن آرایهٔ errors را داشته باشد: مشکل مهلک در message و از دست رفتن قابل تحمل فیلد فقط در errors می‌آید. خواندن فقط یکی در این یا آن جهت اشتباه می‌کند.

همهٔ علائم تجاری نام‌برده متعلق به مالکانشان‌اند. MousePlayer با این ارائه‌دهندگان رابطهٔ تجاری ندارد.