Mirror Pixels

التثبيت والتفعيل وأول تشغيل

1. «الإضافات ← أضف إضافة جديدة ← رفع إضافة»، اختار ملف ZIP وثبّت وفعّل.
2. افتح «Mirror Pixels ← التفعيل والتحديثات» وحط كود الترخيص من حسابك على mirrororg.com. من غير كود ساري مفيش أي بكسل بيتحمّل ولا حدث بيتبعت، وشاشات الإعدادات بتفضل مقفولة.
3. افتح شاشة المنصة اللي بتستخدمها (Meta مثلًا)، دوس «إضافة بكسل»، حط المعرّف وفعّل المنصة. كل شاشة فيها صندوق «إزاي تربط المنصة» بيقولك تجيب المعرّف والتوكن منين.
4. من «الإعدادات العامة» فعّل «تفعيل التتبّع». الإضافة بتبدأ في وضع التجربة: الأحداث بتتبني وتتسجّل ومفيش حاجة بتتبعت.
5. تصفّح موقعك واعمل طلب تجريبي، وراجع «الفحص والتجربة» و«السجل». لما كل حاجة تبان سليمة غيّر «الوضع» إلى فعلي.

المتطلبات: WordPress 6.4 أو أحدث، PHP 8.1 أو أحدث، وامتداد openssl (التفعيل بيتحقق من توقيع رقمي، والتوكنات بتتشفّر بـ AES-256-GCM). ووكومرس 8.0 أو أحدث لو هتتتبّع متجر.

الواجهة عربي افتراضيًا. تقدر تغيّرها لـ English أو «نفس لغة الموقع» من زر اللغة أعلى الشاشة أو من «الإعدادات العامة ← لغة الواجهة». اللغة بتأثر على شاشات الإضافة بس.

المنصات الـ١٢ وإزاي تربطها

كل منصة ليها شاشة في القائمة الجانبية، والنقطة الخضرا جنب اسمها معناها إنها مفعّلة.

• Meta: Pixel ID من Events Manager، وتوكن Conversions API من إعدادات البكسل. «اقفل الإعداد التلقائي» مفعّل افتراضيًا عشان البكسل مايبعتش ضغطات أزرار من نفسه.
• Google: في شاشة واحدة: GA4 (Measurement ID وAPI secret للمشتريات من السيرفر)، Google Ads (AW-… وتسمية لكل تحويل، والتحويلات المحسّنة وإعادة الاستهداف الديناميكي)، وGTM (إرسال للـ dataLayer ببادئة mpx_، وتحميل الحاوية مقفول افتراضيًا).
• TikTok: كود البكسل وتوكن Events API، واسم حدث الشراء CompletePayment أو Purchase.
• Snapchat وPinterest: البكسل/الوسم وتوكن Conversions API (Pinterest محتاج رقم الحساب الإعلاني).
• Microsoft: وسوم UET وClarity. لو Clarity شغّال من GTM ماتفعّلوش هنا.
• Reddit: الـ Pixel ID هو رقم الحساب الإعلاني (t2_… أو a2_…)، وتوكن Conversions API، ووضع اختبار للإرسالات الأولى.
• X (تويتر): Pixel ID، وبعدين سطر لكل تحويل في «ربط الأحداث» بالشكل purchase = tw-o1a2b-o3c4d. X مابيحسبش غير الأحداث المعمولة في X Ads Manager، فالأحداث غير المربوطة مابتتبعتش.
• LinkedIn: Partner ID، وسطر لكل تحويل في «ربط التحويلات» بالشكل lead = 12345678.

تقدر تضيف لحد ٢٠ بكسل لكل منصة (٥ لـ Reddit وX وLinkedIn)، ولكل بكسل اسم وتوكن خاص اختياري (لو فاضي بيستخدم توكن المنصة العام).

الإرسال من السيرفر ومنع التكرار

المنصات اللي عندها واجهة سيرفر (Meta وTikTok وSnapchat وPinterest وReddit وGA4 للمشتريات) بتاخد نسختين من نفس الحدث: من المتصفح ومن السيرفر، بنفس event_id، فالمنصة بتحسبه مرة واحدة. ده بيرجّع التحويلات اللي مانعات الإعلانات وأجهزة iOS بتضيّعها.

• أحداث الصفحات (PageView وViewContent وViewCategory وSearch) بتوصل للسيرفر عن طريق إشارة موقّعة من المتصفح، فبتشتغل حتى مع الكاش. الإشارة مقبولة ٧ أيام ومرة واحدة لكل event_id، وبحد ١٢٠ طلب في الدقيقة لكل IP (قابل للتعديل).
• الشراء بيتبعت من السيرفر بس، ومربوط بطلب حقيقي، فمحدش يقدر يزوّر Purchase.
• التوصيل في طابور خلفي (Action Scheduler أو WP-Cron) أو آخر الطلب — والزائر في الحالتين مابيستناش المنصة. الإرسال الفاشل بيتعاد لحد ٣ مرات بمهلة متزايدة.
• بيانات العميل (الإيميل والموبايل والاسم والعنوان) بتتوحّد وتتشفّر SHA-256 قبل ما تخرج، وتقدر تقفل أي نوع منها من «الموافقة والخصوصية». الـ IP والمتصفح بيتبعتوا للمطابقة ومابيتسجّلوش.

بكسلات حسب الدولة

كل بكسل ليه قاعدة: كل الدول، أو هذه الدول فقط، أو كل الدول ما عدا — بأكواد ISO زي EG وSA وAE. مثال: بكسل لمصر وبكسل تاني لكل الدول ما عدا مصر.

• دولة الزائر بتتعرف من هيدر Cloudflare، أو تحديد الموقع في ووكومرس، أو دولة فاتورة العميل المسجّل — بالترتيب اللي تختاره.
• الطلبات بتستخدم دولة الفاتورة وبعدها دولة الشحن، فالـ Purchase بيروح للبكسل الصح حتى لو الحدث اتبعت من السيرفر.
• لو الدولة مش معروفة: افتراضيًا بيشتغل بس بكسلات «كل الدول».
• لو صفحاتك متخزّنة (كاش كامل أو CDN) فعّل «الصفحات متخزّنة»: المتصفح بيسأل السيرفر عن دولته مرة في الجلسة.

ووكومرس: الشراء والسلة والدفع

• الإضافة للسلة بتتلقط من أي طريق: الصفحات الكلاسيكية وAJAX وبلوكات السلة والدفع وStore API. ضغطة واحدة = حدث AddToCart واحد حتى لو المنتج باقة فيها كذا منتج.
• InitiateCheckout مرة لكل سلة (إعادة تحميل صفحة الدفع بنفس السلة مابتكررهوش).
• AddPaymentInfo افتراضيًا لحظة ما العميل يختار طريقة الدفع (الكلاسيكي والبلوك)، ولو فضل على الطريقة المختارة مسبقًا بيتحسب لما يدوس «تأكيد الطلب». تقدر تخليه «لما الطلب يتسجّل» (متصفح وسيرفر) أو تقفله.
• Purchase من السيرفر لما الطلب يوصل لحالة من «الحالات المختارة» (افتراضيًا: قيد التنفيذ، مكتمل، معلّق)، ومرة واحدة لكل طلب مهما اتغيّرت حالته بعد كده. الدفع عند الاستلام بيتحسب فورًا، والبطاقة بعد الدفع.
• Purchase من المتصفح في صفحة استلام الطلب، مرة واحدة، وبنفس المعرّف الثابت للطلب فالتكرار بيتشال.
• القيم: تقدر تختار تضمين الضريبة والشحن والرسوم. بيانات العميل مع الشراء: جديد/متكرر وعدد الطلبات وإجمالي المشتريات (من ووكومرس مش من الزائر).
• متوافق مع HPOS (جداول الطلبات الجديدة).

كتالوج المنتجات

«كتالوج المنتجات» بيعمل ملف XML واحد (RSS بمعايير Google) تقرأه كتالوجات Meta وGoogle Merchant Center وTikTok وPinterest وSnapchat.

1. فعّل الكتالوج واختار «استخدم إعدادات معرّف المنتج الخاصة بـ» المنصة الأساسية عندك (Meta افتراضيًا). نوع المعرّف (ID أو SKU) والبادئة وطريقة المنتجات المتغيرة بتتاخد منها، فالكتالوج والبكسل دايمًا متطابقين والإعلانات الديناميكية بتلاقي المنتج الصح.
2. انسخ «رابط الكتالوج الخاص بك» والصقه كخلاصة مجدولة في كل منصة (الطريق مكتوب تحت الرابط لكل منصة).

• كل تنويعة عنصر لوحدها ومجمّعة بـ item_group_id (تقدر تقفلها). المنتجات المخفية والمحمية بكلمة سر والمستبعدة بالتصنيف، واللي من غير سعر أو صورة، مابتدخلش.
• الحقول: المعرّف، العنوان، الوصف، الرابط، الصورة وصور المعرض، التوفر، السعر وسعر التخفيض ومدته، العلامة التجارية، تصنيف المنتج وتصنيف Google، وGTIN لو موجود.
• الملف بيتبني مع أول طلب وبيتحدّث كل ٦ ساعات افتراضيًا، وتقدر «تحدّث الآن». الحد الأقصى ٥٠٠٠ منتج افتراضيًا (لحد ٥٠٠٠٠).
• الرابط فيه مفتاح خاص؛ من غيره الصفحة بترد 404. لو الرابط اتسرّب دوس «رابط خاص جديد» وحدّثه في المنصات.

الأحداث التلقائية وواتساب والأحداث المخصصة

الأحداث التلقائية (من المتصفح، لـ Meta وGA4 افتراضيًا): ضغطات واتساب، الاتصال، الإيميل، التنزيلات. وتقدر تفعّل: الروابط الخارجية، إرسال النماذج، نسبة التمرير، مدة البقاء، تشغيل الفيديو، الضغط المتكرر، صفحة 404، تسجيل الدخول، التعليقات، وLead عند نجاح Contact Form 7.

واتساب: أي رابط wa.me أو api.whatsapp.com أو whatsapp:// بيتسجّل افتراضيًا كحدث Contact قياسي، فحملات Meta وTikTok تقدر تحسّن على المحادثات. أو تختار WhatsAppClick كحدث مخصص.

الأحداث المخصصة من شاشة «الأحداث»: اختار المُشغِّل (زيارة رابط، نوع محتوى، صفحة منتج، صفحة الشكر، إضافة للسلة، دخول، تسجيل، ضغطة على CSS selector، إرسال نموذج، نسبة تمرير، مدة)، وشروط اختيارية، والمنصات، والمعاملات (نص أو متغيرات زي {product_id} و{cart_value})، والقيمة والعملة، وعدد المرات (كل مرة، مرة لكل جلسة، مرة لكل متصفح). تقدر تبعته كحدث قياسي (Lead مثلًا) أو باسمك.

الموافقة والخصوصية

• نموذج الموافقة: غير مطلوبة (افتراضي)، أو Opt-in (مفيش حاجة لحد ما الزائر يوافق، والأحداث بتستنى وتتبعت بعد الموافقة)، أو Opt-out.
• بتقرأ الموافقة من WP Consent API أو Cookiebot أو CookieYes أو Complianz تلقائيًا، أو من window.MirrorPixels.setConsent( statistics, marketing ).
• لكل منصة فئة (وظيفية، إحصائيات، تسويق)، وإشارات Google Consent Mode v2 مفعّلة.
• في Opt-in من غير رد، مفيش كوكي بيتعمل ولا حدث بيتحفظ.
• التوكنات محفوظة مشفّرة ومابتظهرش في الصفحات ولا التصدير ولا السجل. أكواد الهيدر/الفوتر الخام مش مدعومة عن قصد (ثغرة XSS بطبيعتها).

لوحة الأداء ودرجة صحة الإعداد

«لوحة الأداء» بتعرض لآخر ٧ أو ٣٠ أو ٩٠ يوم:

• الأحداث اللي وصلت من السيرفر وعدد الفاشل ونسبة النجاح، والطلبات المتتبَّعة وقيمتها (الطلب بيتحسب مرة واحدة مهما كان عدد المنصات)، وأحداث وضع التجربة.
• رسم يومي للإرسال والفشل والطلبات، وكروت للمنصات فيها عدد البكسلات ونوع الإرسال وأرقامها، وأكثر الأحداث.
• درجة صحة الإعداد من ١٠٠: بتشيك التتبّع والوضع الفعلي وربط المنصات وConversions API وأكواد الاختبار المنسية وحالات الشراء والتعارضات والإرسال الفاشل وطابور السيرفر والتشفير. كل بند ناقص جنبه رابط «إصلاح».

الأرقام دي بتعد الإرسال من السيرفر فقط (أحداث المتصفح بتتشاف في أدوات المنصة نفسها). الإحصائيات مابتخزّنش أي بيانات شخصية، وبتتحفظ ٤٠٠ يوم، وتقدر تمسحها من «الأدوات ← إعادة الضبط والحذف».

وضع التجربة والانتقال من PixelYourSite

• وضع التجربة بيبني كل الأحداث ويسجّلها من غير إرسال ومن غير تحميل أي بكسل للزوار، فتقدر تشغّل Mirror Pixels جنب إضافتك الحالية وتقارن من غير تكرار.
• الانتقال من PixelYourSite («الأدوات ← الانتقال من PixelYourSite»): بيقرا الإعدادات قراءة فقط ويعرض كل إعداد هيتنقل وحالته، وبعد التأكيد بيستورده (والتوكنات مشفّرة) بعد نسخة احتياطية، وتقدر تتراجع بضغطة. PixelYourSite نفسه مابيتغيّرش.
• التعارضات: الإضافة بتكشف إضافات التتبّع التانية اللي ممكن تشغّل نفس البكسل، وتقدر «تفحص صفحة» لتشوف التتبّع الموجود فيها.

الفحص والسجل والنسخ الاحتياطية

• الفحص والتجربة: زر لكل بكسل يبعت حدث سيرفر في وضع اختبار المنصة (Meta وTikTok محتاجين كود حدث اختبار، GA4 نقطة التحقق، Pinterest وReddit وضع الاختبار؛ Snapchat مالوش وضع آمن فبيترفض). وجدول آخر الأحداث حسب event_id يوضح وصلت من المتصفح ولا السيرفر وأي تكرار.
• السجل: بالمستوى اللي تختاره، والبيانات الحساسة بتتشال منه تلقائيًا، وبحد أقصى ٢٠٠٠ سجل افتراضيًا. تصدير CSV ومسح.
• استيراد / تصدير: ملف JSON بكل الإعدادات والأحداث المخصصة من غير توكنات.
• النسخ الاحتياطية: تلقائية قبل كل استيراد واستعادة وانتقال وإعادة ضبط، وبيتحفظ أحدث ١٥.
• حالة النظام: نص جاهز تنسخه للدعم الفني.

حل المشاكل

• مفيش أي بكسل بيتحمّل: اتأكد إن الإضافة مفعّلة بكود، وإن «تفعيل التتبّع» شغّال، وإن الوضع «فعلي» (وضع التجربة مابيحمّلش حاجة للزوار)، وإن دورك مش في «لا تتتبّع هذه الأدوار»، وإن قاعدة دول البكسل بتسمح بدولتك.
• الأحداث بتظهر في Events Manager كاختبار: احذف «كود حدث الاختبار» من شاشة Meta أو TikTok.
• Purchase مكرر: افتح «الأدوات ← التعارضات»؛ غالبًا إضافة تانية (PixelYourSite أو Facebook for WooCommerce أو Meta Pixel for WordPress) بتشغّل نفس البكسل. اقفلها أو خلّي Mirror Pixels في وضع التجربة.
• Purchase مابيوصلش من السيرفر: راجع «حالات الطلب» في شاشة ووكومرس، وإن التوكن محفوظ، وافتح «السجل» على مستوى «الأحداث» لرد المنصة. لو الطابور كبير اتأكد إن WP-Cron شغّال.
• رسالة «لم يعد ممكنًا فك تشفير» التوكنات: مفاتيح أمان wp-config اتغيّرت؛ أدخل التوكنات من جديد.
• الكتالوج بيرد 404: الكتالوج مقفول أو الرابط قديم بعد «رابط خاص جديد». لو بيرد 503 أعد المحاولة بعد دقيقتين (بيتبني).
• X أو LinkedIn مابيسجّلش تحويل: لازم الحدث يكون مربوط بسطر في «ربط الأحداث» بمعرّف معمول فعلًا في حساب الإعلانات.
• رسالة «الإضافة مقفولة»: الكود انتهى أو اتلغى أو الموقع مش مضاف للترخيص. من «التفعيل والتحديثات» دوس «إعادة الفحص» أو أدخل كود جديد. لو المركز مش متاح الموقع بيكمّل شغله خلال مهلة السماح.

التحديث والرجوع لإصدار سابق وإزالة الإضافة

• التحديثات بتوصل من مركز MirrorORG: المركز بيبلّغ الموقع أول ما الإصدار ينزل، وفيه فحص كل ساعة كخطة بديلة، والتثبيت التلقائي مفعّل افتراضيًا (تقدر تقفله وتحدّث من البنر). الملف بيتحقق من بصمته الموقّعة قبل التثبيت.
• الإعدادات والتوكنات والإحصائيات بتفضل كما هي بعد التحديث.
• للرجوع لإصدار سابق: نزّل ZIP الإصدار المطلوب من حسابك وارفعه فوق الحالي من «رفع إضافة».
• إيقاف الإضافة بيشيل مهامها المجدولة بس، والإعدادات بتفضل. الحذف بيمسح البيانات فقط لو فعّلت «احذف كل بيانات Mirror Pixels لما الإضافة تتحذف» في «الأدوات ← إعادة الضبط والحذف». الطلبات والمنتجات والمستخدمين وبيانات PixelYourSite لا تُمس أبدًا.

سجل الإصدارات

هذه التغييرات مأخوذة مباشرة من الإصدارات المنشورة على الـHub.