أحداث الصفحة وعناصر HTML
استمع في صفحتك لظهور حملة أو إغلاقها أو التسجيل فيها، وضع حملة مضمّنة، وافتح حملة من رابطك أو زرك.
يتواصل السكربت مع صفحتك بطريقتين: يرسل أحداثًا على window يستطيع كودك الاستماع لها، ويقرأ بعض خصائص HTML التي تضيفها.
أحداث على window
- tafsee:ready: حمّل السكربت حملاتك.
- tafsee:show: رُسمت حملة.
- tafsee:view: شوهدت فعلًا.
- tafsee:spin: دارت عجلة.
- tafsee:coupon: وصل كود خاص بالزائر، والكود في detail.code.
- tafsee:conversion: سجّل زائر أو بلغ الهدف.
- tafsee:close: أُغلقت حملة.
- tafsee:error: حدث خطأ أثناء التحميل.
الأحداث المتعلقة بحملة تحمل في detail معرّف الحملة ومعرّف النسخة.
window.addEventListener('tafsee:conversion', function (event) {
console.log('Signed up on campaign', event.detail.campaignId, 'version', event.detail.variantId);
});يعرض التطبيق هذا المستمع جاهزًا للنسخ في صفحة الموقع تحت للمطوّرين: حدث التسجيل.
ضع حملة مضمّنة
<div data-tafsee-inline="YOUR_CAMPAIGN_ID"></div>تُرسم الحملة داخل هذا العنصر. ومع data-tafsee-inline="auto" يأخذ العنصر أول حملة مضمّنة لا مكان خاصًا لها.
افتح حملة من رابط أو زر
<button data-tafsee-show="YOUR_CAMPAIGN_ID">Get the offer</button>
<a href="#tafsee-show-YOUR_CAMPAIGN_ID">Get the offer</a>الضغطة تفتح الحملة مهما كانت قواعدها وتكرارها. ولأي عنصر آخر استخدم الشرط نقرة على عنصر مع محدِّد CSS.
أخبر السكربت بأحداثك
أرسل حدثًا مسمّى عبر TafseePopup.track('your-event') واستخدم الشرط حدث JavaScript بالاسم نفسه. راجع واجهة JavaScript.
معرّفات للتنسيق والتتبع
لكل عنصر في المحرر معرّف في تبويب متقدم. ويمكن أن تحمل الحملة كود CSS وJavaScript خاصًا بها؛ راجع إعدادات الحملة والكود المخصص. تُرسم النافذة داخل shadow root، فلا يصل إليها CSS من ملف أنماط موقعك.
طبقة البيانات
في الصفحة التي فيها طبقة بيانات لمدير الوسوم يُدفع حدثان إليها أيضًا. راجع أحداث مدير الوسوم والتحليلات.
إن لم ينجح الأمر
- مستمعك لا يعمل أبدًا: أُضيف بعد وقوع الحدث. أضفه قبل كود التثبيت أو في بداية الصفحة.
- الحملة المضمّنة لا تظهر: المعرّف في الخاصية ليس معرّف تلك الحملة، أو الحملة غير منشورة.
- الرابط لا يفتح شيئًا: الصفحة لا تحمل كود التثبيت.
