إصدار ‏API التسويق‏

مرجع واجهة API التسويق

عُقد جذرية في واجهة API التسويق

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

للوصول إلى جميع المعلومات المرجعية، سيتعين عليك تسجيل الدخول إلى فيسبوك.

العقدة الوصف

/{AD_ACCOUNT_USER_ID}

شخص ما على فيسبوك ينشئ إعلانات. يمكن أن يكون لدى كل مستخدم إعلان دورًا في عدة حسابات إعلانية.

/act_{AD_ACCOUNT_ID}

تمثل الكيان التجاري الذي يدير الإعلانات.

/{AD_ID}

تتضمن معلومات حول أحد الإعلانات، مثل معلومات حول عناصر التصميمات والقياس.

/{AD_CREATIVE_ID}

يمثل تنسيق الصورة أو الإعلان الدوّار أو التشكيلة أو إعلان الفيديو لديك.

/{AD_SET_ID}

تتضمن جميع الإعلانات التي تشترك في الميزانية نفسها والجدول الزمني وعرض الأسعار والاستهداف نفسه.

/{AD_CAMPAIGN_ID}

تحدد هدف الحملات الإعلانية لديك. وتتضمن مجموعة إعلانية واحدة أو أكثر.

المستخدم

عناصر الربط

عنصر الربط الوصف

/adaccounts

جميع الحسابات الإعلانية المرتبطة بهذا الشخص

/accounts

جميع الصفحات والأماكن التي يتمتع شخص ما بدور المسؤول بها

/promotable_events

جميع الأحداث القابلة للترويج التي قمت بإنشائها أو أحداث الصفحة القابلة للترويج التي تنتمي إلى الصفحات التي تتمتع بدور المسؤول بها

الحساب الإعلاني

تنتمي جميع مجموعات الكائنات الإعلانية في واجهات API التسويق إلى حساب إعلاني.

عناصر الربط

عناصر الربط الأكثر شيوعًا لدى عقدة الحساب الإعلاني. وللحصول على قائمة كاملة بجميع عناصر الربط، تفضل بزيارة مرجع عناصر ربط الحساب الإعلاني.

عنصر الربط الوصف

/adcreatives

يمكن تحديد شكل الإعلان ومحتواه

/adimages

مكتبة من الصور بغرض استخدامها في تصميمات الإعلانات. يمكن تحميلها وإدارتها بشكل مستقل

/ads

بيانات حول الإعلان، مثل معلومات حول عناصر التصميمات والقياس

/adsets

يمكن تضمين جميع الإعلانات التي تقوم بمشاركة الميزانية نفسها والجدول الزمني وعرض الأسعار والاستهداف نفسه

/advideos

مكتبة من مقاطع الفيديو بغرض استخدامها في تصميمات الإعلانات. يمكن تحميلها وإدارتها بشكل مستقل

/campaigns

يمكن تحديد هدف الحملات الإعلانية وتضمين مجموعة إعلانية واحدة أو أكثر

/customaudiences

الجماهير المخصصة التي يمتلكها/تتم مشاركتها مع هذا الحساب الإعلاني

/insights

واجهة للرؤى يمكن إلغاء تكرار النتائج عبر الكائنات التابعة وتوفير عملية فرز وتقارير غير متزامنة.

/users

قائمة بالأشخاص المرتبطين بحساب إعلاني

إعلان فردي مرتبط بمجموعة إعلانية.

عناصر الربط

عناصر الربط الأكثر شيوعًا لدى عقدة الإعلان. وللحصول على قائمة كاملة بجميع عناصر الربط، تفضل بزيارة مرجع عناصر ربط الإعلان.

عنصر الربط الوصف

/adcreatives

يمكن تحديد شكل الإعلان ومحتواه

/insights

رؤى حول الأداء الإعلاني لديك.

/leads

أي بيانات عملاء محتملين مرتبطة بإعلان تجميع بيانات العملاء المحتملين.

/previews

إنشاء عمليات معاينة الإعلان من أحد الإعلانات الحالية

المجموعة الإعلانية

تُعد المجموعة الإعلانية بمثابة مجموعة من الإعلانات التي تشارك الميزانية اليومية أو ميزانية الحملة كلها والجدول الزمني ونوع عرض الأسعار ومعلومات عرض الأسعار وبيانات الاستهداف نفسها.

عناصر الربط

عناصر الربط الأكثر شيوعًا لدى عقدة المجموعة الإعلانية. وللحصول على قائمة كاملة بجميع عناصر الربط، تفضل بزيارة مرجع عناصر ربط المجموعة الإعلانية.

عنصر الربط الوصف

/activities

سجل من الإجراءات المتخذة على الحساب الإعلاني

/adcreatives

يمكن تحديد محتوى إعلانك وشكله

/ads

البيانات الضرورية حول الإعلان، مثل معلومات حول عناصر التصميمات والقياس

/insights

رؤى حول الأداء الإعلاني لديك.

الحملة الإعلانية

تمثل الحملة الإعلانية أعلى مستوى في البنية التنظيمية داخل الحساب الإعلاني، ويجب أن تمثل هدفًا واحدًا للمعلن.

عناصر الربط

عناصر الربط الأكثر شيوعًا لدى عقدة الحملة الإعلانية. وللحصول على قائمة كاملة بجميع عناصر الربط، تفضل بزيارة مرجع عناصر ربط الحملة الإعلانية.

عنصر الربط الوصف

/ads

البيانات الضرورية حول الإعلان، مثل معلومات حول عناصر التصميمات والقياس

/adsets

يمكن تضمين جميع الإعلانات التي تقوم بمشاركة الميزانية نفسها والجدول الزمني وعرض الأسعار والاستهداف نفسه.

/insights

رؤى حول الأداء الإعلاني لديك.

تصميمات الإعلان

التنسيق الذي يوفر التخطيط، ويضم محتوى الإعلان.

عناصر الربط

عناصر الربط الأكثر شيوعًا لدى عقدة تصميم الإعلان. وللحصول على قائمة كاملة بجميع عناصر الربط، تفضل بزيارة مرجع عناصر ربط تصميم الإعلان.

عنصر الربط الوصف

/previews

إنشاء عمليات معاينة الإعلان من كائن تصميم الإعلان الحالي