سكربت التتبع

يسجل سكربت التتبع زيارات موقعك ووسوم حملاتها، ثم يربط الزائر بجهة اتصال حين يرسل نموذجًا أو يشتري. والنتيجة مسار عميل في كل جهة، وأرقام زوار في تقارير الحملات. تشرح هذه الصفحة ما يفعله السكربت في المتصفح وما يرسله، للمطور الذي يضيفه إلى موقع. أما إضافة المواقع من الشاشة فمشروحة في التتبع.

قبل أن تبدأ

• التتبع متاح عندما تشمل باقتك التتبع ومسار العميل. وقد تحدد باقتك عدد المواقع المتتبعة.
• يضيف المالك أو المسؤول الموقع: افتح التتبع من الشريط الجانبي وأضف اسم الموقع ونطاقه. وتُقبل الزيارات من ذلك النطاق ونطاقاته الفرعية.
• لكل موقع مفتاح من 32 خانة ست عشرية، ويُكتب هنا SITE_KEY.

إضافة السكربت

تعرض شاشة التتبع السطر الدقيق الذي تلصقه تحت أضف هذا السطر إلى ترويسة موقعك. وهو وسم script واحد يحمّل هذا العنوان دون أن يعطل الصفحة:

https://rutbacrm.com/t/SITE_KEY.js

ضعه في ترويسة كل صفحة. وفي ووردبريس استخدم إعدادات الترويسة في القالب أو إضافة تضيف كودًا إلى الترويسة. والمتصفح يحتفظ بالملف ساعة، فقد يستغرق تغيير إعداد الموافقة ساعة حتى يصل إلى الزوار العائدين.

الموافقة

يطلب الموقع الموافقة افتراضيًا: يُحمَّل السكربت لكنه لا يفعل شيئًا حتى يستدعي شريط الموافقة لديك crmConsent(). ويستطيع المالك أو المسؤول إيقاف ذلك لموقع ما بـإيقاف شرط الموافقة، ولا ينبغي ذلك إلا بعد استشارة قانونية.

استدعِ crmConsent() من زر القبول في شريط الموافقة، وcrmWithdraw() من المكان الذي يغير فيه الزائر رأيه. وحين يرسل متصفح الزائر إشارة Do Not Track أو Global Privacy Control لا يفعل السكربت شيئًا، ولا تفعل الدالتان شيئًا أيضًا.

ما يفعله السكربت

بعد السماح، في كل تحميل صفحة، يقوم السكربت بما يلي:

1. يقرأ معرف زائر عشوائيًا أو ينشئه، ويحفظه في ملف التعريف crm_vid من الطرف الأول مدة 180 يومًا.
2. يرسل حدث pageview.
3. يرسل حدث purchase حين يحتوي عنوان الصفحة على order-received/ يليه رقم الطلب، وهي صفحة الشكر في WooCommerce.
4. يضيف حقلًا مخفيًا crm_vid إلى أي نموذج في الصفحة يرسل إلى عنوان نموذج موقع، فتُربط الجهة الجديدة بالزيارات. راجع إرسال النماذج.

ما يُرسل وما يُحفظ

تُرسل الأحداث إلى https://rutbacrm.com/t/SITE_KEY بجسم JSON صغير:

معرّفات نقرات الإعلانات

k كائن فيه هذه المفاتيح، وقيمة كل منها null إن غاب:

يجب أن يتكون المعرّف من 6 إلى 255 من الأحرف أو الأرقام أو _ أو - أو .، وأن يشبه الملف fb. يليه رقم ثم طابع زمني ثم قيمة، مثل fb.1.1700000000000.AbCd، وما سوى ذلك يُتجاهل. وتُحفظ كل نقرة مرة واحدة مهما حملتها صفحات الزيارة، وتنضم إلى جهة اتصال الزائر حين يُربط بها. ولا يقرأ السكربت ملفات Meta إلا إن وُجدت مسبقًا، ولا ينشئها أبدًا. وطريقة استعمال النقرات في الإعلانات.

لا يُحفظ عنوان IP للزائر ولا نص الصفحات ولا محتوى النماذج ولا بقية معاملات العنوان أبدًا. ويُحفظ مصدر أول حدث للزائر ووسيطه وحملته وموقعه المحيل الخارجي على أنها المكان الذي جاء منه أول مرة، ولو خلا ذلك الحدث منها. أما الأحداث اللاحقة فتحفظ مصدرها وحملتها فقط.

إرسال حدث الشراء بنفسك

إن لم يكن متجرك على WooCommerce فعنوان صفحة الشكر فيه مختلف، ولن يرى السكربت الشراء. يمكنك أن ترسل الحدث من تلك الصفحة بنفسك، بعد الموافقة، بمعرف الزائر الذي حفظه السكربت:

(function () {
  var match = document.cookie.match('(?:^|; )crm_vid=([^;]*)');
  if (!match) { return; }
  var body = JSON.stringify({
    v: decodeURIComponent(match[1]),
    e: 'purchase',
    u: location.origin + location.pathname,
    o: 'ORDER_NUMBER'
  });
  navigator.sendBeacon('https://rutbacrm.com/t/SITE_KEY', body);
})();

ضع مكان ORDER_NUMBER معرف الطلب أو رقمه نفسه الذي يرسله متجرك في أحداث المتجر. ولا يُربط الزائر بجهة الطلب إلا إذا:

• كان في شركتك طلب متجر واحد فقط بهذا المعرف أو الرقم،
• وأُنشئ الطلب خلال 24 ساعة حول حدث الشراء، أيهما وصل أولًا،
• ولم تُمحَ جهة الطلب.

والزائر المربوط بجهة يبقى مربوطًا بها.

قواعد عنوان الاستقبال

ولأن الرد لا يتغير بحسب الحدث، لا تستطيع أن تعرف منه هل حُفظ الحدث. راجع شاشة التتبع بدلًا من ذلك. ولا تُحفظ أحداث موقع موقوف، ولا أحداث باقة لا تشمل الميزة.

معلومات مفيدة

• لا يحتاج السكربت أي مكتبة أخرى ولا يبطئ الصفحة، فهو يُحمَّل دون انتظار ويرسل عبر beacon المتصفح.
• معرف الزائر عشوائي ولا يحدد شخصًا وحده، ولا يصبح مفيدًا إلا حين يرسل المتصفح نفسه نموذجًا أو يشتري.
• لا يُدمج الزوار عبر الأجهزة أو المتصفحات.
• خرائط الحرارة وتسجيل الجلسات وتتبع فتح البريد ليست جزءًا من التتبع.

حل المشكلات