الوثائق الفنية والدليل التشغيلي | Analytics Brain AI

مركز الإرشادات الفنية

يستعرض هذا المركز القواعد التشغيلية لربط وإدارة الخدمات المتاحة. تذكر دائماً أن المنصة لا تتطلب تكوين مشروع Google Cloud أو إنشاء مفاتيح API خاصة بك.

١. دليل البداية والربط

إنشاء الحساب وتأكيد البريد: أنشئ حسابك وتأكد من تأكيد البريد الإلكتروني عبر رابط التحقق.
إنشاء أو الانضمام لمؤسسة: أنشئ مساحة عمل خاصة بشركتك أو انضم لمؤسسة قائمة.
فتح قسم التكاملات: افتح لوحة التحكم -> قسم التكاملات (Dashboard -> Integrations).

٢. ربط متجر Shopify

يتطلب ربط Shopify امتلاك صلاحيات التاجر في متجر Shopify:

اضغط على زر (Connect Shopify) في كارت الخدمة.
أدخل نطاق المتجر (my-store.myshopify.com) ووافق على التصاريح المطلوبة.
يتم جلب مبيعات المتجر، الطلبات، والمنتجات وعرضها على لوحة التحكم.

٣. ربط حساب Meta Ads

يتطلب ربط Meta Ads حساب فيسبوك يمتلك أدوار الإدارة في الحساب الإعلاني:

اضغط على زر (Connect Meta) واسترشد بالنافذة لمنح التفويض.
حدد الحساب الإعلاني المستهدف من قائمة الحسابات المتاحة.
تتم مزامنة أداء الحملات والمجموعات الإعلانية والتصاميم.

٤. ربط خدمات Google

القواعد التشغيلية لربط Google:

تفويض حساب Google واحد: منح التفويض لحساب Gmail مرة واحدة يغطي خدمات Search Console وGA4 وGoogle Ads.
تحديد الموارد المستقل: يتم اختيار خاصية Search Console، خاصية GA4، وحساب Google Ads بشكل مستقل منفصل.
في حال عدم وجود موارد: إذا لم يكن الحساب يمتلك موارد، ستظهر رسالة تنبيه تفيد بعدم وجود خاصيات متاحة.
عدم الحاجة لضبط Google Cloud: العملاء لا يقومون بضبط Google Cloud Console أو إنشاء مفاتيح OAuth خاصة بهم.
اشتراط ملكية المورد مسبقاً: يجب أن تكون الخاصية أو الحساب موجوداً ومصرحاً لك بالوصول إليه مسبقاً داخل Google.

٥. تعاريف حالات الخدمات

Authorized Google Accountتم تفويض حساب Google وبانتظار تحديد المورد.

Service Not Configuredالخدمة لم تُربط بعد بمورد محدد.

Configuredتم اختيار المورد واعتماده للمزامنة.

Syncingجاري جلب وتحديث المؤشرات في الخلفية.

Syncedتمت المزامنة بنجاح وعرض البيانات.

Errorحدث خطأ مؤقت أثناء محاولة الجلب.

Permission Missingالحساب يفتقر للتصاريح أو الأذونات المطلوبة.

Reauthorization Requiredانتهت صلاحية التوكن وتتطلب إعادة التوصيل.

Disconnectedتم إلغاء الخدمة وإيقاف المزامنة.

٦. آليات ومعدلات المزامنة

تعمل المزامنة المجدولة في الخلفية بشكل دوري لجلب البيانات دون التأثير على أداء متجرك أو موقعك. تخضع طلبات الجلب لـ API Rate Limits الخاصة بالمنصات الأصلية، وقد تحدث عمليات إعادة محاولة عند وجود ضغط شبكة.

٧. إلغاء الربط وسحب التفويض

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

٨. سياسات البيانات والأمان

سياسة الخصوصية →حذف البيانات →معمارية الأمان →سياسة الكوكيز →

مستند تصميم Google Ads API الرسمى (PDF)

يمكن مراجعة وتحميل وثيقة التصميم المعماري والتوافق المخصصة لمراجعة Google Ads API Basic Access.

تحميل وثيقة التصميم (PDF) ↓

٩. استكشاف الأخطاء وإصلاحها

عدم ظهور الخاصية أو الحساب في القائمة:

تأكد من اختيار حساب Gmail الصحيح أثناء التفويض، وأن الحساب يملك أذونات القراءة المطلوبة في GA4 أو Search Console أو Google Ads.

خطأ انقضاء صلاحية التوكن (Expired Auth):

اضغط على زر إعادة الربط (Reconnect) لمنح التصاريح وتجديد توكن الوصول المشفر.