노출 위치 타게팅

특정 노출 위치(예: 데스크톱 피드 전용 또는 모바일 피드와 Audience Network 보상형 동영상)에 광고를 게재합니다. 캠페인 목표에 따라 특정 노출 위치 옵션만 사용할 수도 있습니다. 자세한 내용은 캠페인, 목표 및 노출 위치를 참조하세요.

사용 가능한 플랫폼과 위치는 device_platforms, publisher_platforms, facebook_positions, audience_network_positions, instagram_positionsmessenger_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/v21.0/act_<AD_ACCOUNT_ID>/adsets


특정 노출 위치 필드에 아무것도 지정하지 않은 경우 Facebook은 해당 필드에 모든 사용 가능한 기본 위치를 고려합니다. 예를 들어 publisher_platformsfacebook으로 설정했지만 facebook_positions에 아무것도 선택하지 않았다면 Facebook은 모든 기본 Facebook 위치(예: feed, right_hand_column 등)를 고려합니다. 또는 publisher_platforms를 아무것도 선택하지 않았다면 Facebook은 모든 기본publisher_platforms를 고려합니다. 또한 Facebook은 새로운 위치나 플랫폼이 사용 가능하게 되면 이를 자동으로 고려할 수 있습니다.

Audience Network에서 광고를 표시할 퍼블리셔를 제한할 수 있습니다. 카테고리별로 퍼블리셔를 제외하거나 앱 스토어 URL 또는 도메인 URL의 맞춤 리스트를 만들어 제외할 수 있습니다.

right_hand_column만 단독으로 동영상, 컬렉션 또는 캔버스 광고의 노출 위치로 사용할 수 없습니다.

인벤토리 필터는 콘텐츠 내 광고(Facebook 인스트림 동영상, Facebook 릴스 광고, Instagram 릴스 광고), Audience Network 광고 및 피드 광고(Facebook 피드, Instagram 피드, Facebook 릴스 피드 및 Instagram 릴스 피드)에서 다른 콘텐츠 유형 옆에 광고 표시 여부를 관리하는 데 도움이 됩니다. 이 콘텐츠 카테고리에 대한 자세한 내용은 광고 고객 센터, 인벤토리 필터를 참조하세요. 콘텐츠 내 광고, Audience Network 광고, 피드 광고에 별도의 값을 선택할 수 있습니다. 옵션에는 Expanded, ModerateLimited가 포함됩니다. 자세한 내용은 아래의 brand_safety_content_filter_levels를 참조하세요.

이름 설명

brand_safety_content_filter_levels

array<string>

콘텐츠 내 광고(Facebook 인스트림 광고 및 Facebook 릴스 광고)의 경우 다음과 같은 값을 허용합니다.

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

Audience Network에는 다음과 같은 값이 허용됩니다.

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

피드 광고(Facebook 피드, Instagram 피드, Facebook 릴스 피드 및 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>

포함: datinggambling

excluded_publisher_list_ids

array<numeric strings>

각 문자열은 제외 리스트 ID입니다. 광고 관리자 또는 마케팅 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, facebook_reels_overlay, profile_feed

선택 사항.
기본값: 전체


참고:

  • publisher_platforms를 제공하는 경우 facebook을 포함해야 합니다. 그렇지 않은 경우 기본값이 전체로 지정합니다.
  • feed에는 데스크톱 및 모바일의 피드가 포함됩니다.
  • 미국(US), 영국(GB), 프랑스(FR), 스페인(ES), 독일(DE), 멕시코(MX), 인도(IN) 및 태국(TH)을 타게팅하는 캠페인의 경우 VIDEO_VIEWSPOST_ENGAGEMENT 목표에 대해 feed 없이 instream_video를 사용할 수 있습니다. instream_video의 경우 CONVERSIONS 목표에서는 지원되지 않습니다.
  • story를 선택하는 경우 Facebook 스토리는 모바일 전용이므로 Facebook feed 또는 Instagram storydevice_platforms: mobile을 사용해야 합니다.
  • marketplace, search 또는 profile_feed를 선택하는 경우 feed를 사용해야 합니다.
  • v3.0부터 right_hand_columnTRAFFIC, CONVERSIONSPRODUCT_CATALOG_SALES 목표의 단일 이미지, 단일 동영상과 슬라이드 형식에만 제공됩니다.

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

선택 사항.
기본값: 전체
Instagram stream, story 또는 ig_search에 대해 Instagram 슬라이드 광고를 타게팅할 수 있습니다. 스토리에서 자동형 슬라이드 크리에이티브를 사용할 경우 동일한 광고 세트에 대해 두 가지 옵션을 모두 선택할 수 없습니다.
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을 선택하는 경우 facebook_positions에 대해 Facebook publisher_platformfeed도 선택해야 합니다.
  • messenger_home은 웹사이트, 앱, Messenger로 트래픽을 유도하는 광고에서 목표가 LINK_CLICKS, CONVERSIONS, MESSAGES, APP_INSTALLSPRODUCT_CATALOG_SALES인 단일 이미지와 슬라이드에 사용할 수 있습니다.
  • story를 선택하는 경우 Messenger 스토리는 모바일 전용이므로 Facebook feed 또는 Instagram storydevice_platforms: mobile을 사용해야 합니다. 웹사이트와 앱으로 트래픽을 유도하는 광고에서 목표가 CONVERSIONS, TRAFFIC, REACH, BRAND_AWARENESSAPP_INSTALLS인 광고 캠페인의 단일 이미지와 동영상 형식에 story를 사용할 수 있습니다.
  • 다른 노출 위치(예: messenger_home, Facebook 노출 위치)와 sponsored_messages를 사용할 수 없습니다.

로직

  • 동일한 매개변수의 옵션에 대한 로직은 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만 선택할 수 없습니다.
  • 목표가 VIDEO_VIEWSaudience_network 노출 위치는 THRUPLAYS 최적화 목표와 함께 사용해야 합니다.
  • facebook_positions에 단독으로 story를 선택할 수 없습니다. facebook_positionsstory를 선택하는 경우 Facebook feed 또는 Instagram story도 선택해야 합니다.
  • messenger_positions에 단독으로 story를 선택할 수 없습니다. messenger_positionsstory를 선택하는 경우 Facebook feed 또는 Instagram story도 선택해야 합니다.
  • Instagram 웹 피드 광고는 stream 노출 위치를 사용하고 데스크톱 및 모바일 웹 피드에 게재하기 위한 웹 요건에 대한 검사를 받습니다. 호환되는 목표는 BRAND_AWARENESS, REACH, LINK_CLICKS, POST_ENGAGEMENT, VIDEO_VIEWSCONVERSIONS입니다.

스토리

Facebook 스토리를 노출 위치로 사용하는 방법은 다음과 같습니다.

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>"
}

릴스

Facebook 릴스를 노출 위치로 사용하는 방법은 다음과 같습니다.

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/v21.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/v21.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_objectoptimization_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"
      }
   ],     
   }
}

/ad-recommendation에 대한 호출에서 이 결과의 code 필드를 사용하여 자세한 이유를 확인할 수 있습니다. 예를 들어 다음과 같은 정보를 얻을 수 있습니다.

[{“code”: 1815610, “summary”: “Device Platform Not Supported By Objective”},]

자세한 내용은 광고 추천, 참고 자료타게팅을 사용한 효과적인 노출 위치를 참조하세요.