‏واجهة API التسويق‏

واجهة API رؤى الإعلانات

توفر واجهة API رؤى الإعلانات بيانات وإحصائيات الأداء لإعلانات Meta. من خلال خيارات التقارير المرنة، يمكنك تخصيص طلباتك والحصول على أي أداة قياس متاحة في مدير الإعلانات من Meta.

قبل البدء

للوصول إلى واجهة API رؤى الإعلانات، ستحتاج إلى:

يجب أيضًا إعداد إعلاناتك لتتبع الإجراءات التي تهمك. لتحقيق ذلك، يمكنك استخدام أدوات مثل واجهة API التحويلات أو بيكسل Meta.

استدعاء واجهة API رؤى الإعلانات

تتوفر واجهة API رؤى الإعلانات كعنصر ربط من جميع كائنات الإعلانات. (راجع المزيد من المعلومات حول التسلسل الهرمي للإعلانات لدى Meta من هنا.)

الموارديوفر

/{ad-account-id}/insights

الرؤى من حساب إعلاني

/{campaign-id}/insights

الرؤى من حملة إعلانية

/{ad-set-id}/insights

الرؤى من مجموعة إعلانية

/{ad-id}/insights

الرؤى من إعلان

بشكل افتراضي، ستعمل طلبات GET على إرجاع أدوات القياس الأساسية لكائن الإعلان، وعادةً ما تكون عن آخر 30 يومًا.

مثال على الطلب

curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights"

مثال على الاستجابة:

{
  "data": [
    {
      "account_id": "<AD_ACCOUNT_ID>",
      "campaign_id": "<CAMPAIGN_ID>",
      "date_start": "2025-03-14",
      "date_stop": "2025-04-12",
      "impressions": "361324",
      "spend": "5339.5"
    }
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

تخصيص طلباتك

يمكنك الحصول على بيانات أكثر تحديدًا باستخدام ثلاثة مكونات رئيسية في طلبك وهي: المعلمات (لتحديد أشياء مثل النطاقات الزمنية وفترات الإسناد، وغير ذلك)، والحقول (أي أدوات القياس)، والتقسيمات. فعلى سبيل المثال، لمعرفة عدد النقرات (الكل) حسب الجنس والتي حدثت في آخر 7 أيام من حملتك الإعلانية، يمكنك تضمين:

  • المعلمات: date_preset=last_7d
  • الحقول: clicks
  • التقسيمات: gender

مثال على الطلب

curl -G \ -d "date_preset=last_7d" \ -d "fields=clicks" \ -d "breakdowns=gender" \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights"

مثال على الاستجابة

{
  "data": [
    {
      "clicks": "7346",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "female"
    },
    {
      "clicks": "3788",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "male"
    },
    {
      "clicks": "79",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "unknown"
    },
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

معرفة المزيد

يمكن أن تكون واجهة API رؤى الإعلانات فعالة؛ لذلك، تأكد من قراءة المزيد والتعرف على كيفية إتقان ميزاتها:

يمكنك أيضًا العثور على وثائق مرجعية تم إنشاؤها تلقائيًا لعنصر ربط الرؤى لكل كائن إعلاني:

إذا كنت تخطط لتضمين البيانات من واجهة API رؤى الإعلانات في الحل الذي توفره، يُرجى أيضًا مراجعة شروط منصة Meta وسياسات المطوّرين لواجهة API التسويق.