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

المكون الإضافي لمعاينة الإعلان

يُعد المكون الإضافي لمعاينة الإعلان أسهل طريقة تتيح للمُعلنين من خلالها معاينة الإعلانات في مواقعهم على الويب.

يسمح لك المكون الإضافي بإنشاء معاينات للإعلان في العمود الأيسر أو الموجز أو الهواتف المحمولة من خلال تحديد مواصفات التصميم أو معرف Adgroup أو معرف التصميم. يمكن إنشاء المعاينات باستخدام مكون إضافي للتواصل الاجتماعي أو Graph API.

المعلمات

مطلوب: واحد من creative أو creative_id أو adgroup_id
مطلوب: ad_format الذي يحل محل المعلمة page_type
اختياري: ad_account_id وtargeting وpost

يطلب المكون الإضافي للمعاينة منك أن تكون قد سجّلت الدخول باستخدام تسجيل دخول فيسبوك. وإذا تم استخدام creative_id أو adgroup_id أو ad_account_id، فيجب أيضًا الحصول على الأذونات للوصول إلى التصميم ومجموعة الإعلانات والحساب الإعلاني على التوالي.

الإعداد	سمة HTML5	الوصف
`ad_account_id`	`data-ad-account-id`	مطلوب عند تحديد تصميم يستخدم `image_hash`
`adgroup_id`	`data-adgroup-id`	يمثل معرف Adgroup تم إرجاعه من استدعاء واجهة Graph API.
`creative`	`data-creative`	يمثل مواصفات تصميم مشفّرة بلغة JSON.
`creative_id`	`data-creative-id`	يمثل معرف تصميم تم إرجاعه من استدعاء واجهة Graph API.
`ad_format`	`data-ad-format`	واحد من: `RIGHT_COLUMN_STANDARD` أو `DESKTOP_FEED_STANDARD` أو `MOBILE_FEED_STANDARD` أو `FACEBOOK_STORY_MOBILE`.
`page_type`	`data-page-type`	واحد من: `rightcolumn` أو `desktopfeed` أو `mobile`.
`targeting`	`data-targeting`	يمثل مواصفات استهداف مشفّرة بلغة JSON.
`post`	`data-post`	يمثل مواصفات منشور مشفّرة بلغة JSON وفقًا لوثائق واجهة API الصفحات.

Graph API

يمكن إنشاء المعاينات أيضًا باستخدام واجهة Graph API. ولإنشاء معاينة بنمط مكون إضافي، ما عليك سوى تحديد المعلمة الإضافية ad_format كما هو موضح في الجدول أعلاه.