رابط الصفحة
طابق الصفحة الحالية بمعاملات زي يبدأ بـ ويحتوي. وهذا أكثر تحكّم يُستخدم: تقصر الودجت على
/checkout، وتستثني /admin، وهكذا.
الاستهداف يقرّر مين يشوف زرّك ومتى. بدونه يظهر الودجت على كل صفحة فيها السنيبت. ومعه تقصره على الصفحات والأجهزة والجمهور اللي يهمّك، وتحدّد كم مرّة ينطلب من نفس الزائر. والقواعد تُقيَّم داخل المتصفّح، في نطاق الودجت المعزول، قبل ما يُركَّب؛ ولو ما طابق شي، ما ينرسم الودجت أصلاً — لا زرّ ولا لوحة تنرسم على صفحتك.
افتح مشروعك ← الودجت ← السنيبت، وبتلقى قواعد العرض جنب سنيبت التركيب. والمُدخَلات تُفحَص عند
الحفظ: قيمة القاعدة الفاضية تُسقَط، وN لازم تكون عدداً موجباً. والحفظ غير الصالح ما يستبدل
إعداداتك الصالحة السابقة أبداً، والتغييرات تسري على التحميل الجاي، مو على جلسات مفتوحة أصلاً.
الودجت ما ينرسم إلا لمّا تتحقّق كل الفئات المضبوطة بوقت واحد: مجموعة روابط مطابقة و جهاز مسموح و جمهور مسموح و تحت سقف التكرار.
رابط الصفحة
طابق الصفحة الحالية بمعاملات زي يبدأ بـ ويحتوي. وهذا أكثر تحكّم يُستخدم: تقصر الودجت على
/checkout، وتستثني /admin، وهكذا.
نوع الجهاز
اقصره على أي من desktop وtablet وmobile. ويُستنتَج داخل المتصفّح من وسم المتصفّح وعرض
نافذته.
الجمهور
everyone، أو identified: الزوّار اللي
عرّفتهم صفحة المضيف ببريد فقط.
سقف التكرار
كم مرّة ينطلب من نفس الزائر: دايماً، أو مرّة، أو N مرّات كحد أقصى، أو يرجع بعد N يوماً. ويُتتبَّع داخل متصفّح الزائر نفسه.
كل قاعدة رابط = معامِل + قيمة. والمعاملات خمسة:
| المعامِل | الاتجاه | يطابق لمّا يكون الرابط الكامل… | وش تكتب بالقيمة |
|---|---|---|---|
starts_with |
موجب | يبدأ بالقيمة | الرابط الكامل ومعه النطاق |
contains |
موجب | يحتوي القيمة بأي موضع | جزء منه، مثل /checkout |
exact |
موجب | يساوي القيمة بالضبط | الرابط الكامل ومعه النطاق |
is_not |
سالب | لا يساوي القيمة بالضبط | الرابط الكامل ومعه النطاق |
not_contains |
سالب | لا يحتوي القيمة | جزء منه، مثل /checkout |
كيف تتركّب القواعد. المعاملات الموجبة (starts_with وcontains وexact) تتجمّع بـOR: الودجت
يظهر لو طابقت أي قاعدة موجبة، فإضافة قاعدة موجبة توسّع الوصول لا غير. والمعاملات السالبة
(is_not وnot_contains) تتجمّع بـAND وتُقيَّم أولاً: لازم تتحقّق كل قاعدة سالبة، فأي سالبة
تفشل تكتم الودجت. وهذا اللي يخلّي النفي يقتطع استثناءً موثوقاً حتى لو كانت قاعدة موجبة بتطابق. ولو
عرّفت قواعد سالبة فقط، يظهر الودجت بكل مكان عدا المسارات المستثناة. ولو ما فيه قواعد روابط
إطلاقاً، يظهر على كل صفحة مُضمَّن فيها.
وش تُقارَن فيه القيمة. كل معامِل يطابق على الرابط الكامل اللي بشريط العنوان — البروتوكول
والنطاق والمسار مع بعض، زي https://shop.example.com/checkout — مو على المسار لحاله أبداً. و
contains وnot_contains يدوّران القيمة بأي موضع داخل هالسلسلة كاملة، فجزء زي /checkout يكفيهم.
أمّا starts_with وexact وis_not فترتكز على بداية نفس السلسلة، فقيمة تبدأ بـ/ ما تقدر
تطابق أبداً رابطاً يبدأ بـhttps://. عطِ هالثلاثة الرابط الكامل ومعه النطاق.
التطبيع. المطابقة متوقَّعة: الرابط يُحوَّل لحروف صغيرة، ويُسقَط #fragment، ويُتجاهَل سؤال
الاستعلام إلا إذا كانت قيمة القاعدة نفسها فيها ?. يعني قاعدة contains بقيمة /checkout
تطابق /Checkout?ref=email، لكن قيمة /checkout?step=2 تُقارَن بالرابط ومعه استعلامه.
starts_with https://shop.example.com/checkoutcontains /checkoutcontains /products/not_contains /printnot_contains /adminاختر أي تركيبة من desktop وtablet وmobile. وعدم اختيار شي يعني كل الأجهزة (الافتراضي).
ونوع الجهاز يتقرّر بمرّة وحدة وبهالترتيب. أول شي يُفحَص وسم المتصفّح: iPad أو PlayBook أو
Silk أو كلمة Tablet في أي موضع منه — أو Android بدون Mobile — تُقرأ tablet؛ وiPhone أو
iPod أو Windows Phone أو Mobi أو Android مع Mobile تُقرأ mobile. ولو ما قال وسم
المتصفّح شي معروف، يقرّر عرض نافذة المتصفّح — أقلّ من 768 بكسل mobile، ومن 768 لـ1023 بكسل
tablet، و1024 فأكثر desktop. وما يُفترَض desktop إلا لمّا ما يُقدر يُقرأ هالعرض أصلاً.
devices: desktopاضبط الجمهور على everyone (الافتراضي، وما يكتم أبداً) أو identified. ومع identified، ما
ينرسم الودجت إلا لمّا تمرّر صفحة المضيف بريداً عبر
واجهة التعريف — وdata لحاله ما يخلّي الزائر معرَّفاً. ولو ما فيه
بريد، يبقى الودجت مخفيّاً؛ فهو يفشل باتجاه عدم الظهور بدل التخمين.
سقف التكرار يمنع إزعاج نفس الزائر بكل صفحة يفتحها. وله وضع ورقم N:
| الوضع | السلوك |
|---|---|
always |
بلا سقف: يظهر كل مرّة (الافتراضي). |
once |
يظهر مرّة وحدة للزائر، وبعدها أبداً في ذاك المتصفّح. |
count |
يظهر N مرّات كحدّ أقصى للزائر. |
days |
ما يرجع إلا بعد N يوماً من إرسال الزائر تقريراً أو إغلاقه الأداة. |
كيف يتقدّم العدّاد. في once وcount يُحسب ظهور كل مرّة يكون فيها الودجت مؤهّلاً ويُعرَض.
وفي days يُضبط المؤقّت بـتفاعل (الزائر إمّا يرسل تقريراً أو يطلع من أداة الالتقاط)، ويبقى
الودجت مكتوماً لين تعدّي N يوماً.
وين تعيش الحالة. السقف يُتتبَّع كاملاً في التخزين المحلّي بمتصفّح الزائر، بنطاق المشروع (مُدخَل
md_freq_<key> يحمل عدد مرّات الظهور ووقت آخر تفاعل). وما يُرسَل لـuMarker أبداً. وهذا قيد محلّي
مقبول: مسح التخزين، أو تبديل المتصفّح أو الجهاز، أو التصفّح الخاصّ، كلّها تصفّر السقف. ولو كان
التخزين المحلّي غير متاح، يتدهور الودجت لـبلا سقف (يمكن يظهر كل مرّة) بدل ما يرمي خطأ أو يعطّل
صفحتك.
قل إنك تبغى ملاحظات من مستخدمي سطح المكتب المسجّلين على مسار الدفع، مرّة وحدة لكل واحد:
قاعدة الرابط: starts_with بقيمة https://shop.example.com/checkout — الرابط الكامل،
لأنّ starts_with يطابق من أول شريط العنوان (ومسار عارٍ زي /checkout ما يطابق شي).
الأجهزة: اختر desktop فقط.
الجمهور: identified — وادفع الهويّة من سكربت داخل الصفحة، عشان تكون جاهزة قبل وصول ردّ
الإعدادات لا بعده.
التكرار: الوضع once.
الحين الزائر المسجّل اللي يُصنَّف desktop — يعني وسم متصفّحه لا جوّال ولا لوحي، ونافذته 1024 بكسل
فأكثر — يشوف الزرّ أول مرّة يوصل فيها لرابط الدفع. أمّا الزائر المجهول والجوّال واللوحي والنافذة
المسحوبة ضيّقة والصفحة الرئيسية، فما ينرسم لهم الزرّ: وكل وحدة من هذي تتقرّر داخل المتصفّح، قبل ما
ينرسم أي شي.