— التوثيق
كيف تعمل Adams Analytics
توثيق تقني كامل لكيفية معالجة Adams Analytics لبيانات التسويق الخاصة بك وتقديم رؤى مدعومة بالذكاء الاصطناعي.
●آخر تحديث · أغسطس 2026
🏗️بنية المنصة
البنية التحتية: مبنية على Next.js 15 مع App Router للعرض من جهة الخادم وأداء مثالي. قاعدة بيانات MySQL (عبر Prisma ORM) على بنية OVH VPS في فرنسا. خط مزامنة خلفي مخصّص لبيانات Meta. ومحرّك إنشاء تقارير لتصدير PDF عند الطلب أو حسب جدول زمني.
🔗ربط حساب Meta الخاص بك
عند ربط حساب Meta عبر OAuth 2.0، يقوم نظامنا بـ: المصادقة بأمان باستخدام صلاحيات قراءة فقط (ads_read، pages_read_engagement، instagram_basic)، واكتشاف كل حساباتك الإعلانية وصفحاتك المرتبطة، وبدء أول مزامنة كاملة لبياناتك — تكتمل عادةً في أقل من 5 دقائق. ومن هناك، تُحدَّث بياناتك تلقائيًا وفق جدول منتظم لتبقى لوحة التحكم محدّثة دائمًا.
📊أنواع التقارير المتاحة
تقرير أداء الإعلانات: تفصيلات على مستوى الحملة والمجموعة الإعلانية والإعلان مع الإنفاق والوصول ومرات الظهور والنقرات وCPM وCPC والتحويلات.
قمع مشتريات الموقع: يتتبّع قمع الشراء الكامل من النقرة على الإعلان إلى إتمام الشراء، مع قيمة التحويل وROAS.
تقرير صفحة Facebook: وصول الصفحة وأداء المنشورات واتجاهات التفاعل ونمو المتابعين.
تقرير ملف Instagram: زيارات الملف الشخصي وأداء الريلز ومقاييس القصص ورؤى المتابعين وأفضل المنشورات.
كل التقارير قابلة للتصدير كملفات PDF موسومة بالعربية أو الإنجليزية.
قمع مشتريات الموقع: يتتبّع قمع الشراء الكامل من النقرة على الإعلان إلى إتمام الشراء، مع قيمة التحويل وROAS.
تقرير صفحة Facebook: وصول الصفحة وأداء المنشورات واتجاهات التفاعل ونمو المتابعين.
تقرير ملف Instagram: زيارات الملف الشخصي وأداء الريلز ومقاييس القصص ورؤى المتابعين وأفضل المنشورات.
كل التقارير قابلة للتصدير كملفات PDF موسومة بالعربية أو الإنجليزية.
🔄مزامنة البيانات وحداثتها
تُزامن Adams Analytics بيانات Meta الخاصة بك تلقائيًا. يسحب خط المزامنة أحدث المقاييس من Meta Marketing API وPage Insights API ويخزّنها في حسابك. وتُحدَّث البيانات بانتظام — فتعكس لوحة التحكم دائمًا أحدث مقاييسك المتاحة. ويمكنك أيضًا تشغيل تحديث يدوي من داخل لوحة التحكم في أي وقت.
📄إنشاء تقارير PDF
تُنشأ التقارير من جهة الخادم كملفات PDF عالية الدقة. ويتضمن كل تقرير شعار علامتك وصفحة غلاف وملخّصًا تنفيذيًا وتفصيلًا للمقاييس قسمًا بقسم وفترات مقارنة حيثما أمكن. وتستخدم التقارير العربية تخطيطًا صحيحًا من اليمين لليسار. ويمكن تنزيل التقارير فورًا أو إعادة تنزيلها من أرشيف تقاريرك في أي وقت.
🔐الأمان والخصوصية
تُقدَّم كل حركة المرور عبر HTTPS بتشفير TLS. وتُجزّأ كلمات المرور باستخدام bcrypt ولا تُخزَّن كنص صريح أبدًا. وتُدار الجلسات برموز JWT موقّعة عبر NextAuth.js. ونطلب صلاحيات قراءة فقط من Meta ولا نعدّل حملاتك أو ميزانياتك أو حساباتك الإعلانية. وتُخزَّن رموز OAuth مشفّرة من جهة الخادم ولا تُكشف للمتصفح أبدًا. وبياناتك مستضافة على بنية OVH VPS في فرنسا ولا تُباع أو تُشارك مع أي طرف ثالث.
🚀البدء
الخطوة 1: أنشئ حسابك المجاني — تجربة مجانية دون بطاقة ائتمان.
الخطوة 2: اربط حساباتك الإعلانية في Meta عبر OAuth بنقرة واحدة في أقل من دقيقة.
الخطوة 3: تمتلئ لوحة التحكم ببيانات حملاتك خلال دقائق.
الخطوة 4: اذهب إلى التقارير واختر النطاق الزمني ونوع التقرير، وصدّر أول تقرير PDF احترافي.
الخطوة 2: اربط حساباتك الإعلانية في Meta عبر OAuth بنقرة واحدة في أقل من دقيقة.
الخطوة 3: تمتلئ لوحة التحكم ببيانات حملاتك خلال دقائق.
الخطوة 4: اذهب إلى التقارير واختر النطاق الزمني ونوع التقرير، وصدّر أول تقرير PDF احترافي.