استهداف الموضع

اعرض إعلانات في مواضع محددة، مثل الموجز على أجهزة الكمبيوتر فقط أو الموجز على الهواتف المحمولة بالإضافة إلى فيديو بمكافأة على Audience Network. يمكنك فقط استخدام خيارات مواضع معينة بناءً على هدف الحمة الإعلانية. راجع الحملة الإعلانية، الهدف والمواضع لمزيد من المعلومات.

المنصات والمواضع المتوفرة هي device_platforms وpublisher_platformsfacebook_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/v20.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 فقط كموضع لإعلانات الفيديو أو التشكيلة أو اللوحة.

يساعد�� فلتر المخزون على التحكم فيما إذا كانت إعلاناتك تظهر بجوار أنواع مختلفة من المحتوى للإعلانات داخل المحتوى (مقاطع الفيديو المُضمنة في المحتوى على فيسبوك، والإعلانات على ريلز من فيسبوك والإعلانات على ريلز من Instagram)، وإعلانات Audience Network وإعلانات المواجز (موجز فيسبوك وموجز Instagram وموجز ريلز من فيسبوك وموجز ريلز من Instagram). للتعرف على المزيد حول فئات المحتوى هذه، راجع مركز مساعدة الإعلانات، فلتر المخزون. يمكنك اختيار قيم منفصلة للإعلانات داخل المحتوى وAudience Network وإعلانات الموجز. تتضمن الخيارات: Expanded وModerate وLimited. للت��اصيل، راجع brand_safety_content_filter_levels أدناه:

الاسم الوصف

brand_safety_content_filter_levels

array (مصفوفة)<string>

بالنسبة إلى الإعلانات داخل المحتوى (الإعلانات المُضمنة في المحتوى على فيسبوك والإعلانات على ريلز من فيسبوك)، نسمح بهذه القيم:

  • EXPANDED: FACEBOOK_RELAXED
  • MODERATE: FACEBOOK_STANDARD
  • LIMITED: FACEBOOK_STRICT

بالنسبة إلى Audience Network، نسمح بهذه القيم:

  • EXPANDED: AN_RELAXED
  • MODERATE: AN_STANDARD
  • LIMITED: AN_STRICT

بالنسبة إلى إعلانات الموجز (موجز فيسبوك، وموجز Instagram، وموجز ريلز من فيسبوك وموجز ريلز من Instagram)، نسمح بهذه القيم:

  • EXPANDED: FEED_RELAXED
  • MODERATE: FEED_STANDARD
  • LIMITED: FEED_STRICT

مثال: "brand_safety_content_filter_levels":["FACEBOOK_STRICT", "AN_RELAXED"]

ملاحظة: عند تطبيق فلتر على مستوى الحساب الإعلاني، ستتوفر خيارات أكثر تقييدًا على مستوى الحملة الإعلانية. على سبيل المثال، إذا تم تعيين الحساب على MODERATE، فلن يتمكن المستخدم إلا من تحديد MODERATE أو LIMITED لحملة إعلانية ما. لن تتوفر خيارات أقل تقييدًا (في هذا المثال، EXPANDED).

excluded_publisher_categories

array (مصفوفة)<string>

تتضمن: dating وgambling

excluded_publisher_list_ids

array<numeric strings>

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


المثال:
"excluded_publisher_list_ids":["{block_list_id_1}","{block_list_id_2}"]

على سبيل المثال، لاستخدام 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 والفيديو المُضمن في المحتوى، يمكنك استبعاد الناشرين حسب الفئة:

الاسم الوصف

excluded_publisher_categories

array (مصفوفة)<string>

تتضمن:

  • debated_social_issues
  • mature_audiences
  • tragedy_and_conflict

المثال:
"excluded_publisher_categories": ["debated_social_issues", "mature_audiences"]

الجهاز والناشر والمواضع

الاسم: الخيارات الوصف

device_platforms: mobile وdesktop

اختياري.
الافتراضي: الكل
أنواع الأجهزة التي يمكن أن تتوفر لدى الشخص الذي يشاهد إعلانك.

publisher_platforms: وfacebook وinstagram وmessenger وaudience_network

اختياري.
الافتراضي: الكل
قنوات النشر لإعلانك. يمكنك تعيين موضع قناة النشر من خلال إعدادها ضمن facebook_positions أو instagram_positions أو audience_network_positions أو messenger_positions.

facebook_positions: feed أو right_hand_column أو marketplace أو video_feeds أو story أو search أو instream_video أو facebook_reels أو profile_feed

اختياري.
الافتراضي: الكل


ملاحظات:

  • إذا تم توفير ذلك، فيجب أن تتضمن publisher_platforms القيمة facebook أو لا يتم توفيره افتراضيًا للجميع.
  • يتضمن feed الموجز لأجهزة الكمبيوتر والهواتف المحمولة.
  • بالنسبة للحملات الإعلانية التي تستهدف الولايات المتحدة (US) والمملكة المتحدة (GB) وفرنسا (FR) وإسبانيا (ES) وألمانيا (DE) والمكسيك (MX) والهند (IN) وتايلاند (TH)، يمكنك استخدام instream_video بدون feed لأهداف VIDEO_VIEWS وPOST_ENGAGEMENT. ويكون instream_video غير مدعوم للهدف CONVERSIONS.
  • إذا حددت story، فيجب استخدام feed في فيسبوك أو story وdevice_platforms: mobile في Instagram لأن Facebook Stories مخصصة للهواتف المحمولة فقط.
  • إذا حددت marketplace أو search أو profile_feed، فيجب استخدام feed.
  • اعتبارًا من الإصدار 3.0، يتوفر right_hand_column لتنسيقات صورة واحدة وفيديو واحد وإعلان دوّار للأهداف TRAFFIC وCONVERSIONS وPRODUCT_CATALOG_SALES.

instagram_positions: stream، story، explore، explore_home، reels، profile_feed، ig_search، profile_reels

اختياري.
الافتراضي: الكل
يمكنك استهداف الإعلانات الدوّارة في Instagram لكل من stream أو story أو ig_search. إذا كنت تستخدم تصميم إعلان دوّار عشوائي في القصص، فلا يمكنك تحديد كلا الخيارين للمجموعة الإعلانية ذاتها.
سيتم عرض الإعلانات التي تستخدم story في كل من مواجز الويب على الهاتف المحمول وInstagram على الكمبيوتر.

audience_network_positions: classic وrewarded_video

اختياري.
الافتراضي: الكل
بشكل افتراضي، لا يتم إرجاع effective_audience_network_positions عند قراءة مواصفات الاستهداف لمجموعة إعلانية. وقد يختلف ذلك عن audience_network_positions التي تم تكوينها. إذا حددت موضعًا غير مدعوم لهدف معين، فسيظهر في قائمة المواضع التي تم تكوينها، ولكن ليس في قائمة المواضع المؤثرة.

messenger_positions: messenger_home وsponsored_messages وstory

اختياري.
الافتراضي: messenger_home وstory


ملاحظات:

  • إذا حددت messenger_home، فيجب أيضًا تحديد publisher_platform في Facebook وfeed لـ facebook_positions.
  • messenger_home متوفر لصورة واحدة وإعلان دوّار واحد في أهداف LINK_CLICKS وCONVERSIONS وMESSAGES وAPP_INSTALLS وPRODUCT_CATALOG_SALES لإعلانات زيادة الزيارات لمواقع الويب والتطبيقات وMessenger.
  • إذا حددت story، فيمكنك استخدام feed في Facebook أو story وdevice_platforms: mobile في Instagram نظرًا لأن Messenger Stories مخصصة للهواتف المحمولة فقط. ويمكنك استخدام story لتنسيقات الصورة الواحدة والفيديو الواحد في الحملات الإعلانية بالأهداف CONVERSIONS وTRAFFIC وREACH وBRAND_AWARENESS وAPP_INSTALLS لإعلانات زيادة الزيارات لمواقع الويب والتطبيقات.
  • لا يمكنك استخدام sponsored_messages مع المواضع الأخرى، بما في ذلك messenger_home أو مواضع Facebook.

المنطق

  • منطق الخيارات للمعلمة ذاتها هو OR.
    على سبيل المثال، publisher_platforms=['facebook','instagram'] يعني عرض الإعلانات على Facebook وInstagram.
  • المنطق بين المعلمات هو AND.
    على سبيل المثال، publisher_platforms=['facebook']&device_platforms=['mobile'] تعني عرض هذه الإعلانات على Facebook للهواتف المحمولة فقط.
  • إذا أدى المنطق إلى عدم استهداف أي شخص، مثل publisher_platforms=['instagram']& device_platforms=['desktop']، فسيظهر خطأ.

القيود

  • لا يمكنك استخدام Audience Network فقط، لذلك لا يمكن تحديد 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.
  • تستخدم إعلانات مواجز 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

لاستهداف موضع فيديو بمكافأة في 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

الصفحة الرئيسية لقسم "استكشاف" في Instagram

لإنشاء مجموعة إعلانية تتضمن الموضع 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/v20.0/act_<AD_ACCOUNT_ID>/adsets

نتائج البحث على Instagram

لإنشاء مجموعة إعلانية تتضمن الموضع 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/v20.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”},]

لمزيد من المعلومات، يمكنك الرجوع إلى توصيات الإعلان، المرجع والموضع الفعال مع الاستهداف.