المرجع

النشر

نقطة النهايةالوصف

/{ad-account-id}/ads

إنشاء إعلان.

/{business-id}/initiated_sharing_agreements

الموافقة على طلب اتفاقية النشاط التجاري المعلق أو رفضه.

/{business-creative-folder-id}

إنشاء مجلد عناصر تصميمات النشاط التجاري وحدّثه.

/{business-id}/creative_folders

توفير مجلد عناصر تصميمات النشاط التجاري.

/{business-id}/images

تحميل الصور إلى مجلد عناصر التصميمات.

/{business-id}/videos

تحميل مقاطع الفيديو إلى مجلد عناصر التصميمات.

/{business-creative-folder-id}/agencies

إضافة شريك ما إلى مجلد عناصر التصميمات.

/{business-creative-folder-id}/assigned_users

الحصول على قائمة بالأشخاص الذين لديهم صلاحية الوصول إلى مجلد عناصر تصميمات النشاط التجاري.

القراءة

نقطة النهايةالوصف

/{business-creative-folder-id}

الحصول على تفاصيل حول مجلد عناصر تصميمات النشاط التجاري.

/{business-id}/creative_folders

الحصول على قائمة بمجلدات عناصر تصميمات النشاط التجاري التي يمكن للنشاط التجاري الوصول إليها.

/{business-id}/creatives

الحصول على صور النشاط التجاري ومقاطع فيديو النشاط التجاري للنشاط التجاري.

/{business-id}/initiated_sharing_agreement

الحصول على قائمة بطلبات الاتفاقيات المعلقة.


تمت إعادة تقديم نقطة النهاية هذه في مايو 2020. سابقًا، تم إيقاف استخدام /initiated_sharing_agreement عند طرح Graph API بالإصدار 6.0.

/{business-image-id}

الحصول على تفاصيل الصورة.

/{business-image-id}/insights

الحصول على رؤى الصورة المشتركة.

/{business-video-id}

الحصول على تفاصيل الفيديو المشترك.

/{business-video-id}/insights

الحصول على رؤى الفيديو المشترك.

/{business-creative-folder-id}/agencies

الحصول على قائمة بالأنشطة التجارية التي لديها صلاحية الوصول إلى مجلد عناصر التصميمات.

/{business-creative-folder-id}/assigned_users

الحصول على قائمة بالأشخاص الذين لديهم صلاحية الوصول إلى مجلد عناصر التصميمات.

الحذف

نقطة النهايةالوصف
/{business-creative-folder-id}

حذف مجلد عناصر التصميمات.

/{business-creative-folder-id}/agencies

إزالة شريك من مجلد عناصر التصميمات.

/{business-creative-folder-id}/assigned_users

إزالة مستخدم من مجلد عناصر التصميمات.

/{business-image-id}

إزالة صورة مشتركة.

/{business-video-id}

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

المهام المسموح بها

المهمة المسموح بها لمستخدم النشاط التجاريالوصف

CREATE_CONTENT

بإمكان هذا المستخدم إنشاء المجلدات.

MANAGE_CONTENT

بإمكان هذا المستخدم إدارة أصول مجلد عناصر التصميمات.

MANAGE_PERMISSIONS

بإمكان هذا المستخدم إدارة أذونات مجلد عناصر تصميمات النشاط التجاري.

VIEW_CONTENT

بإمكان هذا المستخدم عرض الأصول في مجلد عناصر التصميمات.

VIEW_INSIGHTS

بإمكان هذا المستخدم عرض الرؤى لأصول عناصر التصميمات.

الرؤى

أدوات القياس هذه قيد التطوير.

اسم أداة القياسالوصف
impressions

عدد مرات ظهور الصورة أو الفيديو في الإعلان.

inline_link_clicks

عدد مرات النقر على الروابط في الإعلان. تستخدم النقرات على الروابط المضمنة فترة إسناد ثابتة للنقر تبلغ يومًا واحدًا.

video_play_actions

عدد مرات تشغيل الفيديو. نحتسب ذلك لكل مرة ظهور للفيديو، ونستثني مرات إعادة التشغيل.

actions

إجمالي عدد الإجراءات التي اتخذها الأشخاص والتي تم إسنادها إلى إعلاناتك. قد تتضمن الإجراءات التفاعل أو النقرات أو التحويلات. راجع هذا المستند للحصول على قائمة كاملة بالأنواع المدعومة.

video_thruplay_watched_actions

عدد مرات تشغيل الفيديو بالكامل، أو لمدة 15 ثانية على الأقل.

quality_ranking

تصنيف لجودة الإعلان المتوقعة. يتم قياس الجودة باستخدام ملاحظات الإعلان وتجربة ما بعد النقر. يتم تصنيف الإعلان مقابل الإعلانات الأخرى التي تنافس على الجمهور ذاته.


تتضمن القيم المحتملة ما يلي:

  • BELOW_AVERAGE_10
  • BELOW_AVERAGE_20
  • BELOW_AVERAGE_35
  • AVERAGE
  • ABOVE_AVERAGE
  • UNKNOWN، إذا لم تكن هناك معلومات كافية حول الإعلان.

هذا يتعلق بتشخيصات ملاءمة الإعلان.

تتوفر التقسيمات التالية:

  • age
  • gender
  • country
  • objective
  • publisher_platform
  • platform_position
  • device_platform
  • optimization_goal