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

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

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

العُقد الجذرية الرئيسية هي:

العقدة الجذرية التمثيل

/{USER}

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

/act_{AD_ACCOUNT_ID}

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

/{CAMPAIGN_ID}

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

/{AD_SET_ID}

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

/{AD_ID}

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

المستخدم

عناصر الربط

عنصر الربط التمثيل

/adaccountgroups

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

/adaccounts

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

/accounts

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

/promotable_events

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

/promotable_domains

جميع النطاقات التي يمكن لهذا الشخص الترويج لها

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

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

عناصر الربط

عنصر الربط التمثيل

/campaigns

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

/adsets

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

/ads

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

/adcreatives

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

/adimages

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

/advideos

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

/activities

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

/adtags

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

/adcampaignconversions

بيانات التحويل المجمّعة حسب المجموعات الإعلانية في الحساب الإعلاني

/adgroupconversions

بيانات التحويل المجمّعة حسب الإعلانات في الحساب الإعلاني

/customaudiences

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

/generatepreviews

إنشاء معاينة للإعلان

/offsitepixels

وحدات البيكسل المرتبطة بهذا الحساب

/reachestimate

إنشاء وصول تقديري للإعلان بمواصفات استهداف محددة

/reportstats

إعداد تقارير حول واجهة API للحصول على بيانات الحساب الإعلاني وجدولة التقارير

/adcampaignstats

مجموعة من الإحصاءات المجمّعة حسب المجموعات الإعلانية في الحساب الإعلاني

/adgroupstats

مجموعة من الإحصاءات المجمّعة حسب الإعلانات في الحساب الإعلاني

/targetingsentencelines

إنشاء وصف مقروء للاستهداف فيما يتعلق بالمجموعة الإعلانية

/users

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

/insights

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

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

عناصر الربط

عنصر الربط التمثيل

/adsets

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

/ads

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

/adtags

الإشارات المتعلقة بالحملات الإعلانية لديك. الاستخدام للعثور على الحملات الإعلانية المشابهة بسهولة

إرجاع مجموعة واحدة من الإحصاءات المجمّعة حسب الحملات الإعلانية

/insights

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

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

عناصر الربط

عنصر الربط التمثيل

/ads

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

/adcreatives

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

/activities

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

/adtags

الإشارات المتعلقة بالمجموعات الإعلانية. الاستخدام للعثور على المجموعات الإعلانية المشابهة بسهولة

/conversions

بيانات التحويل التابعة للمجموعة الإعلانية

/insights

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

عناصر الربط

عنصر الربط التمثيل

/adcreatives

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

/adtags

الإشارات المتعلقة بالإعلانات لديك. الاستخدام للعثور على الإعلانات المشابهة

/conversions

بيانات التحويل التابعة للإعلان

/keywordstats

يمكن إرجاع الإحصاءات لكل كلمة أساسية مستهدفة في الإعلان

/previews

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

/reachestimate

الحصول على وصول تقديري للإعلان

مجموعة من الإحصاءات التابعة للإعلان لديك

/targetingsentencelines

الحصول على وصف مقروء للاستهداف فيما يتعلق بالمجموعة الإعلانية

/trackingtag

قم بتعيين إشارات النقر إلى أحد الإعلانات. من خلال إشارات تتبع النقرات، حدد عنوان URL الذي يتم تشغيله عندما ينقر أحد الأشخاص على الإعلان.

/insights

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

التصميم

عناصر الربط

عنصر الربط التمثيل

/previews

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