يمكنك استخدام إعلانات فيسبوك مع عملائك الحاليين والوصول إلى عملاء جدد. ويتناول كل دليل منتجات إعلانات Facebook التي يمكن أن تساعدك في تلبية أهدافك الإعلانية. ويوجد عدة أنواع من الوحدات الإعلانية التي توفر خيارات متنوعة للمظاهر والموضع والتصميم. وللحصول على إرشادات بشأن الوحدات الإعلانية كمحتوى التصميم، يمكنك الرجوع إلى دليل إعلانات فيسبوك.
يُعد تصميم الإعلان كائنًا يحتوي على كل البيانات الخاصة بالعرض البصري للإعلان نفسه. وفي واجهة API، يوجد العديد من أنواع الإعلانات المختلفة التي يمكنك إنشاؤها على Facebook وكلها مُدرجة هنا.
إذا كانت لديك حملة إعلانية تحتوي على هدف التفاعل مع منشور الصفحة، يمكنك الآن إنشاء إعلان يقوم بترويج منشور أنشأته الصفحة. ويعتبر ذلك إعلان منشور صفحة. وتتطلب إعلانات منشور الصفحة وجود حقل باسم object_story_id
والذي يمثل الأصل id
لمنشور الصفحة. لذا تعرف على المزيد حول تصميم الإعلان، المرجع.
يتكوّن تصميم الإعلان من ثلاثة أجزاء:
لإنشاء كائن تصميم الإعلان، قم بإجراء الاستدعاء التالي:
curl -X POST \
-F 'name="Sample Promoted Post"' \
-F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
Open In Graph API Explorer
تمثل الاستجابة إلى استدعاء واجهة API المعرف id
الخاص بكائن التصميم. ويجب تخزين هذا المعرف نظرًا لأنك ستحتاج إليه في كائن الإعلان:
curl -X POST \
-F 'name="My Ad"' \
-F 'adset_id="<AD_SET_ID>"' \
-F 'creative={
"creative_id": "<CREATIVE_ID>"
}' \
-F 'status="PAUSED"' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/ads
Open In Graph API Explorer
يتم فرض التقييدات على النص وحجم الصورة ونسبة العرض إلى الارتفاع للصورة في التصميم، بالإضافة إلى جوانب أخرى في التصميم. ويمكنك الرجوع إلى دليل الإعلانات.
في واجهة API الإعلانات، يجب طلب كل حقل تريد استرجاعه بوضوح تام باستثناء المعرف id
. ويحتوي كل مرجع خاص بالكائن على قسم لقراءة الكائن مرة أخرى وإدراج الحقول القابلة للقراءة. وبالنسبة للتصميم، يتم استخدام الحقول نفسها المحددة عند إنشاء الكائن والمعرف id
.
curl -G \
-d 'fields=name,object_story_id' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<CREATIVE_ID>Open In Graph API Explorer
الموضع هو المكان الذي يظهر به إعلانك على فيسبوك مثل الموجز على أجهزة الكمبيوتر أو الموجز على الأجهزة المحمولة أو في العمود الأيسر. ويمكنك الرجوع إلى دليل منتج الإعلانات.
نوصيك بتشغيل الإعلانات عبر نطاق كامل من المواضع المتاحة. وتم تصميم مزاد إعلاني في Facebook لعرض مرات ظهور الإعلان خصيصًا للموضع الذي يعزز نتائج الحملة الإعلانية على الأرجح بأقل تكلفة ممكنة.
تتمثل أسهل طريقة للاستفادة من هذا التحسين في ترك هذا الحقل فارغًا. ويمكن أيضًا تحديد مواضع معينة في target_spec في المجموعة الإعلانية.
يحتوي هذا المثال على إعلان منشور صفحة. علمًا بأن المواضع المتوفرة هي الموجز على الهواتف المحمولة والموجز على أجهزة الكمبيوتر والعمود الأيسر في فيسبوك. وفي API، يمكنك الرجوع إلى خيارات المواضع. إذا اخترت desktopfeed
وrightcolumn
لتمثل النوع page_type
، فسيتم تشغيل الإعلان في مواضع الموجز على أجهزة الكمبيوتر والعمود الأيسر. يتوفر لأي إعلان يتم إنشاؤه ضمن هذه المجموعة الإعلانية موضع أجهزة الكمبيوتر فقط.
curl -X POST \
-F 'name=Desktop Ad Set' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'daily_budget=10000' \
-F 'targeting={
"geo_locations": {"countries":["US"]},
"publisher_platforms": ["facebook","audience_network"]
}' \
-F 'optimization_goal=LINK_CLICKS' \
-F 'billing_event=IMPRESSIONS' \
-F 'bid_amount=1000' \
-F 'status=PAUSED' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adsets
Open In Graph API Explorer
يمكنك معاينة إعلان بإحدى طريقتين، إما باستخدام واجهة API معاينة الإعلان أو المكون الإضافي لمعاينة الإعلان.
تتوفر ثلاث طرق لإنشاء معاينة باستخدام واجهة API:
تبعًا للوثائق المرجعية لواجهة API المعاينة، فإن الحد الأدنى اللازم لاستدعاء واجهة API المطلوب هو:
curl -G \
--data-urlencode 'creative="<CREATIVE_SPEC>"' \
-d 'ad_format="<AD_FORMAT>"' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/generatepreviews
Open In Graph API Explorer
تمثل مواصفات التصميم مصفوفة تضم كل الحقول والقيم المطلوبة لإنشاء تصميم الإعلان.
يظهر حاليًا استدعاء تصميم الإعلان بالشكل التالي:
curl -X POST \
-F 'name="Sample Promoted Post"' \
-F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
Open In Graph API Explorer
احصل على المعرف object_story_id
واستخدمه في استدعاء واجهة API المعاينة:
curl -G \
-d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
-d 'ad_format=<AD_FORMAT>' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/generatepreviews
Open In Graph API Explorer
تختلف القيم المتوفرة لـ ad_format
اختلافًا طفيفًا عن page_types
. ولكن في هذا السيناريو، يتم تحديد الموجز على أجهزة الكمبيوتر والعمود الأيسر في فيسبوك. ويتطلب ذلك منك إجراء اثنين من استدعاءات API لإنشاء المعاينات لكل موضع:
curl -G \
-d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
-d 'ad_format=DESKTOP_FEED_STANDARD' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/generatepreviews
Open In Graph API Explorer
curl -G \
-d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
-d 'ad_format=RIGHT_COLUMN_STANDARD' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/generatepreviews
Open In Graph API Explorer
تكون الاستجابة عبارة عن إطار iFrame صالح لمدة 24 ساعة.