التوثيق

المتطلبات: WordPress 6.0 أو أحدث، WooCommerce 7.0 أو أحدث، PHP 8.1 أو أحدث، وتفعيل الروابط الدائمة المقروءة لمسارات الخلاصات وخرائط الموقع وllms.txt وAI Catalog.

نزّل emargy-geo.zip من حسابك. في لوحة WordPress افتح الإضافات ← أضف إضافة جديدة ← رفع إضافة، ثم ثبّت الملف وفعّله. افتح Emargy GEO ← البدء.

لتفعيل الترخيص، افتح Emargy GEO ← الترخيص، والصق المفتاح من بريد الشراء أو لوحة حسابك، ثم اختر تفعيل الترخيص. يتيح الترخيص الساري التحديثات والدعم وأدوات الإدارة المرخصة. تبقى مخرجات schema والخلاصات وllms.txt وAI Catalog وخرائط الموقع العامة متاحة إذا انتهى الترخيص لاحقًا.

افتح التوافق وتأكد من وضع SEO المكتشف، ثم شغّل فحصًا كاملًا من Merchant Readiness. عد إلى لوحة GEO لمراجعة المنتجات الجاهزة والمنتجات التي تحتاج إصلاحًا وأبرز المشكلات.

صحح الصور والعلامة التجارية ومعرّفات GTIN/MPN والأوصاف والفئات وإشارات الشحن والسياسات الناقصة. بعد ذلك تحقق من Merchant Feed وأنشئ الملفات الثابتة، وراجع معاينتي llms.txt وAI Catalog.

يعني وصف «جاهز» اجتياز فحوص Merchant والاكتشاف المضبوطة في الإضافة. يحسن ذلك جودة البيانات، لكنه لا يضمن موافقة Google أو الترتيب أو النتائج الغنية أو الظهور في إجابات الذكاء الاصطناعي أو أداء Merchant Center.

افتح Emargy GEO ← التوافق لترى الوضع الحالي والنتائج التي يملكها كل نظام. في الوضع المستقل يمكن لـGEO توفير العناوين والأوصاف وrobots وcanonical ووسوم المشاركة وschema العامة وخرائط الموقع.

عند اكتشاف Yoast SEO أو Rank Math أو AIOSEO أو SEOPress، يؤجل وضع التوافق المخرجات العامة المتداخلة. يتيح الوضع اليدوي تحديد الجهة المسؤولة عن كل مخرج عند الحاجة. تبقى Product schema وMerchant Feed والفحص والتحقق ولوحة المنتج وAI Catalog وllms.txt وتتبع التجارة الإلكترونية ضمن طبقة GEO التجارية.

بعد تغيير الوضع، امسح ذاكرة الصفحات وCDN وافحص مصدر صفحة منتج ممثلة للتأكد من عدم تكرار البيانات الوصفية أو المنظمة.

يفحص النظام المنتجات المنشورة والمتغيرات القابلة للبيع من حيث السعر والتوفر وأبعاد الصور والعلامة وSKU وGTIN أو MPN وطول الوصف والفئة والشحن وسياسة الإرجاع وربط فئة منتجات Google.

يعيد الفحص الكامل بناء النتائج المخزنة للكتالوج كله؛ ويركز الفحص التفاضلي على المنتجات المتغيرة منذ الفحص السابق لتخفيف الحمل؛ ويمسح خيار حذف الذاكرة النتائج المخزنة لبدء فحص نظيف.

ابدأ بالأخطاء التي تمنع اكتمال عناصر الخلاصة، ثم أصلح التحذيرات التي تضعف التعرف على المنتج وجودته. افتح المنتج المعني أو استخدم أدوات الإصلاح الجماعي للتغييرات المناسبة بعد مراجعة المعاينة.

تنشر Emargy GEO خلاصات XML وTSV متوافقة مع Google Merchant. انسخ الرابط من Emargy GEO ← Merchant Feed إلى إعداد الجلب المجدول في Merchant Center.

يتحقق فحص الخلاصة من العناصر والمتغيرات القابلة للبيع ويكشف معرّفات أو علامات ناقصة وصورًا غير صالحة وفئات Google مفقودة وتعارضات noindex.

تُنشأ الملفات الثابتة على دفعات داخل مجلد رفع WordPress. تغييرات المنتجات تضع إعادة بناء مؤجلة، وتعرض شاشة Merchant Feed الحالة وعدد العناصر ووقت الإكمال وأحجام الملفات وأعداد نتائج التحقق والتحكم اليدوي. إذا فُعّلت حماية الرمز، فاستخدم الرابط المحمي المعروض وتعامل مع الرمز كبيانات سرية.

يمكن لإيمارجي GEO نشر Product وBreadcrumb بصيغة JSON-LD من بيانات WooCommerce، بما فيها العروض والتوفر والمتغيرات والعلامة وSKU وGTIN وMPN والتقييمات والشحن والإرجاع عند توفرها.

يوفر الوضع المستقل بيانات Organization وWebSite وArticle المنظمة والبيانات الوصفية الأساسية. ويؤجل وضع التوافق المخرجات العامة المتداخلة مع إبقاء طبقة التجارة فعالة.

تغطي الخرائط المنتجات وصورها وفئاتها واكتشاف Merchant والذكاء الاصطناعي. تُستبعد المنتجات المحددة noindex في إضافات SEO المدعومة حيث يلزم. استخدم اختبار Google للنتائج الغنية وافحص المصدر المعروض لمنتجات ممثلة بعد تغيير الإعدادات.

افتح Emargy GEO ← AI Catalog لمعاينة مساري /llms.txt و/ai-catalog. يقدّم llms.txt وصفًا مقروءًا للمتجر وسياساته وفئاته ومنتجاته؛ ويعرض AI Catalog بيانات منظمة عن المنتجات والمعرّفات والعروض والمتغيرات والتقييمات واللغة والسياق.

تُستبعد المنتجات غير المنشورة أو المحددة noindex. تُقيّد المخرجات باللغة النشطة في المتاجر متعددة اللغات المدعومة، وتُنظف محارف التحكم ثنائية الاتجاه المخفية لحماية النص العربي والعبري.

يمكن تهيئة OpenAI أو Anthropic لاقتراح ملخصات وتحسينات للكتالوج. تُشفّر مفاتيح API أثناء التخزين، ويجب مراجعة المحتوى المقترح قبل نشره.

تلخص لوحة GEO Visibility داخل محرر منتج WooCommerce جاهزية Merchant والظهور للذكاء الاصطناعي وحالة schema والمعرّفات والإدراج في الخلاصة والفهرسة ومعاينة نتيجة البحث.

تتضمن بيانات المنتج ملخص AI وتجاوز فئة منتجات Google وتسميات مخصصة للخلاصة. استخدم التجاوز عندما لا يكون ربط الفئة العام دقيقًا بما يكفي.

يوفر Bulk Fix خطوات معاينة ثم تأكيد لتغييرات مختارة على الكتالوج. وقد تقترح Category Suggestions ربطًا بفئات Google، اختياريًا عبر مزود AI. افحص المعاينة دائمًا قبل تأكيد عملية جماعية.

اضبط معرّف قياس GA4 أو حاوية Google Tag Manager في Emargy GEO ← الإعدادات. يمكن للإضافة إرسال أحداث التجارة الإلكترونية إلى dataLayer لعرض المنتجات وإجراءات السلة والدفع والمشتريات.

يمكن ضبط حالات الموافقة الافتراضية وتحديثاتها للمتاجر التي تستخدم Google Consent Mode v2. يبقى التتبع معطلًا إذا أُوقف مفتاح التتبع العام.

استخدم Emargy GEO ← Tracking Debug للتحقق من الإعداد وسلوك الأحداث، ثم تأكد من الأحداث في GTM Preview وGA4 DebugView قبل الاعتماد على تقارير الإنتاج.

تكتشف Emargy GEO إضافتي WPML وPolylang، وتحدد اللغة الحالية وروابط المنتجات المترجمة، وتفصل ذاكرة Merchant Feed وAI Catalog وllms.txt والخرائط بحسب اللغة.

يُنظف نص schema والخلاصات وAI مع الحفاظ على Unicode المقروء وإزالة محارف التحكم ثنائية الاتجاه التي قد تفسد المخرجات الآلية.

افتح كل خلاصة ومسار AI بحسب اللغة؛ تحقق من الأسماء والأوصاف والعملة والروابط المترجمة؛ افحص schema المنتج العربي مستقلًا؛ وامسح الذاكرة بعد تغيير قواعد روابط اللغات.

تُكتب ملفات الخلاصات وAI Catalog على دفعات قابلة للضبط داخل wp-content/uploads/emargy-geo/. يستخدم النظام Action Scheduler إن توفر، وإلا يعود إلى WP-Cron.

تُخزن نتائج الجاهزية في جدول خاص كي لا تعيد اللوحات والفحوص التفاضلية مسح الكتالوج كله عند كل تحميل.

استخدم cron حقيقيًا لأحداث WordPress، وأبقِ مجلد الرفع قابلًا للكتابة، وراقب حالة الإنشاء وآخر خطأ بعد الاستيراد الكبير. شغّل فحصًا كاملًا بعد الترحيلات الجماعية واستخدم التفاضلي للتغييرات اليومية. فوق 2,000 منتج، ينتظر أول طلب خلاصة الإنشاء الخلفي بدل بنائها كاملة داخل طلب الويب.

إذا فشل تفعيل الترخيص، فتأكد من أنه يخص Emargy GEO وأن هناك تفعيل موقع متاحًا، وأن طلبات HTTPS الصادرة إلى https://emargy.com مسموحة. ألغِ تفعيل النطاق القديم قبل نقل ترخيص محدود المواقع.

عند تكرار schema أو البيانات الوصفية، راجع وضع التوافق وإضافة SEO المكتشفة، وامسح ذاكرة الصفحات وCDN، ثم افحص المصدر المعروض. لا تفعل المخرج نفسه في إضافتين.

إذا بقيت الخلاصة معلقة، فتأكد من تشغيل WP-Cron أو Action Scheduler ومن قابلية مجلد الرفع للكتابة، ثم راجع آخر خطأ وأعد الإنشاء يدويًا. إذا غابت منتجات، فتحقق من النشر والظهور والسعر والمتغيرات وقواعد noindex.

للدعم، راسل [email protected] مع إصدارات الإضافة وWordPress وWooCommerce وPHP والرابط المتأثر ولقطة الحالة والسجلات المنقحة. لا ترسل مفاتيح API أو رموز الخلاصات.