اعرض إعلانات في مواضع محددة، مثل الموجز على أجهزة الكمبيوتر فقط أو الموجز على الهواتف المحمولة بالإضافة إلى فيديو بمكافأة على Audience Network. يمكنك فقط استخدام خيارات مواضع معينة بناءً على هدف الحمة الإعلانية. راجع الحملة الإعلانية، الهدف والمواضع لمزيد من المعلومات.
المنصات والمواضع المتوفرة هي device_platforms
وpublisher_platforms
facebook_positions
وaudience_network_positions
وinstagram_positions
وmessenger_positions
. راجع القسم الجهاز، الناشر والمواضع لمزيد من المعلومات.
curl -X POST \
-F 'name="My AdSet"' \
-F 'optimization_goal="REACH"' \
-F 'billing_event="IMPRESSIONS"' \
-F 'bid_amount=2' \
-F 'daily_budget=1000' \
-F 'campaign_id="<AD_CAMPAIGN_ID>"' \
-F 'targeting={
"geo_locations": {
"countries": [
"US"
]
},
"publisher_platforms": [
"facebook"
],
"facebook_positions": [
"feed"
]
}' \
-F 'promoted_object={
"page_id": "<PAGE_ID>"
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0
/act_<AD_ACCOUNT_ID>/adsets
إذا لم تحدد أي شيء لحقل موضع معين، فسيعمل Facebook على تضمين كل المواضع الافتراضية المحتملة لهذا الحقل. على سبيل المثال، إذا تم تعيين publisher_platforms
إلى facebook
، لكن لم يتم تحديد أي شيء لـ facebook_positions
، فسيعمل Facebook على تضمين كل مواضع Facebook الافتراضية مثل feed
وright_hand_column
، وغير ذلك. أو إذا لم تحدد أي publisher_platforms
، فسيعمل Facebook على تضمين كل publisher_platforms
الافتراضية. وقد يعمل Facebook أيضًا على تضمين المواضع أو المنصات الجديدة عند توفرها تلقائيًا.
في Audience Network، يمكنك تقييد الناشرين الذين يعرضون إعلاناتك. ويمكنك استبعاد الناشرين حسب الفئة أو إنشاء قائمة مخصصة تضم عناوين URL لمتجر التطبيقات أو عناوين URL للنطاق لاستبعادها.
لا يمكنك استخدام right_hand_column
فقط كموضع لإعلانات الفيديو أو التشكيلة أو اللوحة.
يساعدك فلتر المخزون في التحكم فيما إذا كانت إعلاناتك ستظهر بجوار أنواع مختلفة من المحتوى في المحتوى المُضمن في فيسبوك وAudience Network. للتعرف على المزيد حول فئات المحتوى هذه، راجع مركز مساعدة الإعلانات، فلتر المخزون. يمكنك اختيار قيمة واحدة للمحتوى المُضمن في فيسبوك وقيمة واحدة لـ Audience Network. تتضمن الخيارات: Full
وStandard
وLimited
. للتفاصيل، راجع brand_safety_content_filter_levels
أدناه:
الاسم | الوصف |
---|---|
array (مصفوفة)<string> | للمحتوى المُضمن في فيسبوك، نسمح بالقيم التالية:
بالنسبة إلى Audience Network، نسمح بهذه القيم:
المثال: ملاحظة: عند تطبيق فلتر على مستوى الحساب الإعلاني، ستتوفر خيارات أكثر تقييدًا على مستوى الحملة الإعلانية. على سبيل المثال، إذا تم تعيين الحساب للإشراف، فسيتمكن المستخدم فقط من تحديد خيارات متوسطة أو محدودة للحملة الإعلانية. لن تتوفر خيارات أقل تقييدًا (في هذا المثال، الموسعة).
|
array (مصفوفة)<string> | تتضمن: |
array<numeric strings> | كل سلسلة هي معرف قائمة للاستبعادات. يمكنك إنشاء قوائم مخصصة في مدير الإعلانات أو واجهة API التسويق، قائمة حظر الناشر. المثال: |
على سبيل المثال، لاستخدام brand_safety_content_filter_levels
:
curl \ -F 'name=My AdSet' \ -F 'optimization_goal=REACH' \ -F 'billing_event=IMPRESSIONS' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id=CAMPAIGN_ID' \ -F 'targeting= { "geo_locations":{"countries":["US"]}, "brand_safety_content_filter_levels":["FACEBOOK_STRICT","AN_STANDARD"]}' \ -F 'status=ACTIVE' \ -F 'access_token=ACCESS_TOKEN' \ https://graph.facebook.com/VERSION/AD_ACCOUNT_ID/adsets
بالنسبة إلى Audience Network والفيديو المُضمن في المحتوى، يمكنك استبعاد الناشرين حسب الفئة:
الاسم | الوصف |
---|---|
array (مصفوفة)<string> | تتضمن:
المثال: |
الاسم: الخيارات | الوصف |
---|---|
| اختياري. |
| اختياري. |
| اختياري. ملاحظات:
|
| اختياري. |
| اختياري. |
| اختياري. ملاحظات:
|
OR
.publisher_platforms=['facebook','instagram']
يعني عرض الإعلانات على Facebook وInstagram. AND
.publisher_platforms=['facebook']&device_platforms=['mobile']
تعني عرض هذه الإعلانات على Facebook للهواتف المحمولة فقط. publisher_platforms=['instagram']& device_platforms=['desktop']
، فسيظهر خطأ.publisher_platforms: audience_network
بذاتها. audience_network
الذي يتضمن الهدف VIDEO_VIEWS
بهدف التحسين THRUPLAYS
.story
لـ facebook_positions
بذاتها. إذا حددت story
لـ facebook_positions
، فيجب أيضًا تحديد feed
في Facebook أو story
في Instagram.story
لـ messenger_positions
بذاتها. إذا حددت story
لـ messenger_positions
، فيجب تحديد إما feed
في فيسبوك أو story
في Instagram.stream
ويتم التحقق منها فيما يتعلق بأهلية الويب ليتم عرضها على كل من موجز الكمبيوتر والهاتف المحمول على الويب. الأهداف المتوافقة هي BRAND_AWARENESS
وREACH
وLINK_CLICKS
وPOST_ENGAGEMENT
وVIDEO_VIEWS
وCONVERSIONS
.لاستخدام Facebook Stories كموضع:
curl \ -F 'name=My Ad Set' -F 'optimization_goal=CONVERSIONS' -F 'billing_event=IMPRESSIONS' -F 'bid_amount=2' -F 'daily_budget=1000' -F 'campaign_id=<AD_CAMPAIGN_ID>' -F 'targeting={"geo_locations":{"countries":["US"]}, "publisher_platforms":["messenger", "facebook"], "facebook_positions":["story"], "messenger_positions":["story"]}' -F 'status=ACTIVE' -F 'access_token=<ACCESS_TOKEN>' https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets
لإنشاء مجموعة إعلانية بالموضع instream_video
فقط الذي يستهدف بلدًا مدعومًا مدرجًا أعلاه:
curl \ -F 'name=My AdSet' \ -F 'optimization_goal=REACH' \ -F 'billing_event=IMPRESSIONS' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id=CAMPAIGN_ID' \ -F 'targeting={"geo_locations":{"countries":["US"]},"publisher_platforms":["facebook"], "facebook_positions":["instream_video"]}' \ -F 'status=ACTIVE' \ -F 'access_token=ACCESS_TOKEN' \ https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets
لاستهداف موضع فيديو بمكافأة في Audience Network:
curl \ -F 'name=My Ad Set' \ -F 'optimization_goal=OFFSITE_CONVERSIONS' \ -F 'billing_event=IMPRESSIONS' \ -F 'is_autobid=true' \ -F 'daily_budget=40000' \ -F 'campaign_id=<AD_CAMPAIGN_ID>' \ -F 'targeting={"app_install_state": "not_installed","geo_locations":{"countries":["US"]},"facebook_positions":["feed"],"device_platforms": ["mobile"],"audience_network_positions": ["classic","rewarded_video"],"user_device": ["Android_Smartphone","Android_Tablet"],"user_os": ["Android_ver_4.4_and_above"]}' \ -F 'promoted_object={"application_id": "<APPLICATION_ID>","custom_event_type": "PURCHASE","object_store_url": "<OBJECT_STORE_URL>"}' \ -F 'status=ACTIVE' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<APIVERSION>/<AD_ACCOUNT_ID>/adsets
يؤدي ذلك إلى إرجاع الآتي:
{ "targeting": { "audience_network_positions": [ "classic", "rewarded_video" ], "effective_audience_network_positions": [ "classic", "rewarded_video" ] }, "id": "<AD_SET_ID>" }
لاستخدم ريلز من فيسبوك كموضع:
curl \ -F 'name=My AdSet' \ -F 'optimization_goal=REACH' \ -F 'billing_event=IMPRESSIONS' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id=CAMPAIGN_ID' \ -F 'targeting={"geo_locations":{"countries":["US"]},"publisher_platforms":["facebook"], "facebook_positions":["facebook_reels"]}' \ -F 'status=ACTIVE' \ -F 'access_token=ACCESS_TOKEN' \ https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets
لإنشاء مجموعة إعلانية تتضمن الموضع explore_home
الذي يستهدف بلدًا مدعومًا (مثل "الولايات المتحدة"):
curl -X POST \
-F 'name="My AdSet"' \
-F 'optimization_goal="LINK_CLICKS"' \
-F 'billing_event="IMPRESSIONS"' \
-F 'bid_amount=2' \
-F 'daily_budget=1000' \
-F 'campaign_id="<AD_CAMPAIGN_ID>"' \
-F 'targeting={
"geo_locations": {
"countries": [
"US"
]
},
"publisher_platforms": [
"instagram"
],
"instagram_positions": [
"stream",
"explore",
"explore_home"
],
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0
/act_<AD_ACCOUNT_ID>/adsets
لإنشاء مجموعة إعلانية تتضمن الموضع ig_search
الذي يستهدف بلد مدعومة (مثل "الولايات المتحدة"):
curl -X POST \
-F 'name="My AdSet"' \
-F 'optimization_goal="LINK_CLICKS"' \
-F 'billing_event="IMPRESSIONS"' \
-F 'bid_amount=2' \
-F 'daily_budget=1000' \
-F 'campaign_id="<AD_CAMPAIGN_ID>"' \
-F 'targeting={
"geo_locations": {
"countries": [
"US"
]
},
"publisher_platforms": [
"instagram"
],
"instagram_positions": [
"stream",
"ig_search"
],
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0
/act_<AD_ACCOUNT_ID>/adsets
يمكنك إنشاء مجموعات إعلانية مع مواضع في مواصفات الاستهداف، ومع ذلك فأنت لا تعرف دائمًا ما إذا كان Facebook قد قام بعرض إعلانك ضمن المواضع المحددة. هذا لأن الموضع الذي حددته قد لا ينطبق على هدف الإعلان الذي اخترته. باستخدام API المواضع الفعالة للاستهداف، يمكنك تحديد المواضع التي سيتم عرض إعلانك ضمنها، في ضوء خيارات الاستهداف التي حددتها، وتلقي رسائل التحقق لفهم سبب فلترة بعض المواضع. إذا لم توفر الاستهداف، فلا يزال بإمكانك تحديد الموضع الفعال استنادًا إعدادات المجموعة الإعلانية والحملة الإعلانية.
لقراءة موضع فعال استنادًا إلى الاستهداف الذي حددته، ضع effective_
أمام اسم حقل الموقع. على سبيل المثال:
curl -G \ -d "fields=targeting{effective_publisher_platforms,effective_facebook_positions,effective_device_platforms,effective_audience_network_positions,effective_instagram_positions}" \ -d "access_token=<access_token>" \ https://graph.facebook.com/<VERSION>/<AD_SET_ID>
لعرض سبب فلترة بعض المواضع، استخدم الحقل recommendation
:
curl -G \ -d "fields=recommendations" \ -d "access_token=<access_token>" \ https://graph.facebook.com/<VERSION>/23842573364570019
بفضل المواضع الفعالة، يمكنك تحديد المواضع التي سيظهر فيها إعلانك بناءً على billing_event
وoptimization_goal
وpromoted_object
، بالإضافة إلى buying_type
وobjective
للحملة الإعلانية في المجموعة الإعلانية. تتضمن كل معلمات /ad_campaign_placement
ما يلي:
account_id
ورمز الوصول للإعلانbilling_event
، مثل IMPRESSIONS
AUCTION
POST_ENGAGEMENT
POST_ENGAGEMENT
PIXEL_ID
يلزم توفير كل المعلمات باستثناء promoted_object
وoptimization_goal
. وإذا كنت تقدم استهدافًا، يمكنك استخدام واجهة API التسويق لتحديد الموضع الفعال استنادًا إلى المواضع المسموح بها في الإعدادات لديك والرجوع إلى الموضع الفعال مع الاستهداف. على سبيل المثال:
curl -G \ -d 'account_id=<ACCOUNT_ID>' \ -d 'billing_event=IMPRESSIONS' \ -d 'buying_type=AUCTION' \ -d 'objective=PAGE_LIKES' \ -d 'optimization_goal=IMPRESSIONS' \ https://graph.facebook.com/<VERSION>/ad_campaign_placement?access_token=<TOKEN>
يقوم الاستدعاء بإرجاع ما يلي:
{ "effective_device_platforms": [ "mobile", "desktop" ], "effective_facebook_positions": [ "feed", "right_hand_column" ], "effective_publisher_platforms": [ "facebook" ], "recommendations": [ { "title": "Placement Not Supported By Objective", "message": "Ads with PAGE_LIKES objective do not support facebook.instream_video, facebook.suggested_video, facebook.marketplace, audience_network.classic, audience_network.instream_video, audience_network.rewarded_video, instagram.stream, instagram.story, messenger.messenger_home.", "code": 1815609, "importance": "LOW", "confidence": "HIGH", "blame_field": "targeting" }, { "title": "Device Platform Not Supported By Objective", "message": "Ads with PAGE_LIKES objective do not support connected_tv.", "code": 1815610, "importance": "LOW", "confidence": "HIGH", "blame_field": "targeting" } ], } }
يمكنك استخدام الحقل code
من هذه النتيجة لإجراء استدعاء إلى /ad-recommendation
بغرض عرض السبب بالتفصيل. على سبيل المثال، يمكنك الحصول على المعلومات التالية:
[{“code”: 1815610, “summary”: “Device Platform Not Supported By Objective”},]
لمزيد من المعلومات، يمكنك الرجوع إلى توصيات الإعلان، المرجع والموضع الفعال مع الاستهداف.