واجهة API لمكتبة إعلانات Meta: ماذا تعطيك، وما الذي لا تعطيه؟

ما هي Ad Library API؟

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

ماذا تغطي الواجهة؟

بمعنى آخر: إعلان متجر عطور في الرياض يظهر لك في facebook.com/ads/library، لكن الواجهة البرمجية لا تعيده. هذه الفجوة سبب وجود أدوات مثل GccFY.

كيف تحصل على الوصول؟

1. أنشئ حساب مطوّر في Meta for Developers.
2. أكّد هويتك وموقعك كما تطلب Meta (قد يحتاج إرسال وثيقة هوية).
3. أنشئ تطبيقاً، ثم احصل على رمز وصول (Access Token).
4. استدعِ نقطة ads_archive في Graph API بمعايير البحث.

مثال على طلب يبحث عن إعلانات في دولة أوروبية (الإعلانات التجارية خارج أوروبا لن تعود):

GET https://graph.facebook.com/v<version>/ads_archive
  ?search_terms=perfume
  &ad_type=ALL
  &ad_reached_countries=['FR']
  &fields=page_name,ad_creative_bodies,ad_delivery_start_time,ad_snapshot_url,publisher_platforms
  &access_token=<token>

أهم الحقول التي تعود بها

• page_name وpage_id: المعلن.
• ad_creative_bodies وad_creative_link_titles: نص الإعلان وعنوان الرابط.
• ad_delivery_start_time وad_delivery_stop_time: مدة العرض، ومنها تحسب مدة التشغيل.
• ad_snapshot_url: رابط لعرض الإعلان كما يظهر، بدل ملفات الصور والفيديو.
• publisher_platforms وlanguages: المنصات واللغات.
• للإعلانات السياسية: نطاقات الإنفاق والظهور وتوزيعها حسب العمر والجنس والمنطقة.
• لإعلانات الاتحاد الأوروبي: الوصول الإجمالي وتوزيعه، والفئات المستهدفة، والجهة المستفيدة والدافعة.

حدود يجب أن تعرفها قبل أن تبني عليها

• لا إعلانات تجارية خارج أوروبا: الحد الأكبر لمن يعمل في الخليج.
• لا ملفات وسائط مباشرة: تحصل على رابط عرض الإعلان، لا ملف الصورة أو الفيديو.
• حدود الاستدعاء: لكل تطبيق حد لعدد الطلبات، والطلبات الكثيرة تتوقف مؤقتاً.
• الرموز تنتهي: رموز الوصول لها مدة، وتحتاج تجديداً.
• شروط الاستخدام: لشركة Meta شروط تحدد كيف تُستخدم هذه البيانات؛ اقرأها قبل أي مشروع تجاري.

بديل لإعلانات الخليج التجارية

إن كان هدفك متابعة الإعلانات التجارية في السعودية والخليج، فالواجهة الرسمية لن تكفي. GccFY يجمع الإعلانات العربية لمتاجر الخليج من المكتبة العامة يومياً، ويحتفظ بها بعد توقفها، مع مدة التشغيل ومنصة المتجر ولقطة صفحة الهبوط: أكثر من 780,000 إعلان من 69,000 معلن.

للاحتياجات الخاصة بالبيانات، تواصل معنا.