الانتقال إلى المحتوى الرئيسي
GET
استرجع مقاييس الإنفاق اليومي المفصّل والأداء لإعلاناتك على فيسبوك. تقدّم هذه النقطة الطرفية تحليلات شاملة لإعلاناتك مع تفصيل يومي، وأداء خاص بكل هدف، ومقاييس مجمّعة.
تحتوي مصفوفة dailySpend على مقاييس الإنفاق والأداء اليومي التاريخي لكل إعلان. البيانات محدَّثة حتى الساعة 8 صباحًا بتوقيت شرق الولايات المتحدة (EST). إذا كنت بحاجة إلى بيانات إنفاق آنية أو لم يبدأ الإنفاق بعد، يُرجى استخدام نقطة نهاية الإعلانات.لن يُعاد الإعلان إذا لم تتوفر بيانات إنفاق أو لم يبدأ الإنفاق بعد.
  • تُحسب المقاييس من واجهة تقارير فيسبوك وقد يكون هناك تأخير طفيف (حتى 24 ساعة).
  • يُجمِّع القسمان byGoalType وbyGoalTitle مقاييس الأداء حسب أهداف الحملة.
  • استخدم مرشحات adId أو postId لتضييق النتائج على حملات محددة.
  • جميع القيم النقدية بعملة حساب الإعلانات (الدولار الأمريكي عادةً).
  • يُبرز القسم goalPerformance أهداف الإعلانات الأفضل أداءً لديك.
لا تُعيد هذه النقطة الطرفية إلا إعلانات فيسبوك التي أُنشئت عبر نقطة نهاية Boost Post. الإعلانات التي أُنشئت في Facebook Ads Manager أو أدوات خارجية أخرى لا يتم إرجاعها.

معاملات الترويسة

معاملات الاستعلام

accountId
number
تصفية النتائج حسب معرّف حساب محدد.
adId
string
تصفية النتائج حسب معرّف إعلان محدد.
postId
string
تصفية النتائج للإعلانات المرتبطة بمعرّف منشور Ayrshare محدد.
fbPostId
string
تصفية النتائج للإعلانات المرتبطة بمعرّف منشور فيسبوك الاجتماعي محدد.
limit
number
افتراضي:25
استرجع حدًا أقصى limit من الإعلانات. الحد الأقصى 500.
startDate
string
افتراضي:"30 days ago"
تاريخ بداية فترة إعداد التقارير بصيغة ISO 8601 (الافتراضي: 30 يومًا مضت)
endDate
string
افتراضي:"today"
تاريخ نهاية فترة إعداد التقارير بصيغة ISO 8601 (الافتراضي: اليوم)