특정 노출 위치(예: 데스크톱 피드 전용 또는 모바일 피드와 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/v21.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
만 단독으로 동영상, 컬렉션 또는 캔버스 광고의 노출 위치로 사용할 수 없습니다.
인벤토리 필터는 콘텐츠 내 광고(Facebook 인스트림 동영상, Facebook 릴스 광고, Instagram 릴스 광고), Audience Network 광고 및 피드 광고(Facebook 피드, Instagram 피드, Facebook 릴스 피드 및 Instagram 릴스 피드)에서 다른 콘텐츠 유형 옆에 광고 표시 여부를 관리하는 데 도움이 됩니다. 이 콘텐츠 카테고리에 대한 자세한 내용은 광고 고객 센터, 인벤토리 필터를 참조하세요. 콘텐츠 내 광고, Audience Network 광고, 피드 광고에 별도의 값을 선택할 수 있습니다. 옵션에는 Expanded
, Moderate
및 Limited
가 포함됩니다. 자세한 내용은 아래의 brand_safety_content_filter_levels
를 참조하세요.
이름 | 설명 |
---|---|
array<string> | 콘텐츠 내 광고(Facebook 인스트림 광고 및 Facebook 릴스 광고)의 경우 다음과 같은 값을 허용합니다.
Audience Network에는 다음과 같은 값이 허용됩니다.
피드 광고(Facebook 피드, Instagram 피드, Facebook 릴스 피드 및 Instagram 릴스 피드)의 경우 다음과 같은 값이 허용됩니다.
예: 참고: 광고 계정 수준에서 필터가 적용되면 캠페인 수준에서 더 제한적인 옵션만 제공됩니다. 예를 들어 계정이 |
array<string> | 포함: |
array<numeric strings> | 각 문자열은 제외 리스트 ID입니다. 광고 관리자 또는 마케팅 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
만 선택할 수 없습니다. VIDEO_VIEWS
인 audience_network
노출 위치는 THRUPLAYS
최적화 목표와 함께 사용해야 합니다.facebook_positions
에 단독으로 story
를 선택할 수 없습니다. facebook_positions
에 story
를 선택하는 경우 Facebook feed
또는 Instagram story
도 선택해야 합니다.messenger_positions
에 단독으로 story
를 선택할 수 없습니다. messenger_positions
에 story
를 선택하는 경우 Facebook feed
또는 Instagram story
도 선택해야 합니다.stream
노출 위치를 사용하고 데스크톱 및 모바일 웹 피드에 게재하기 위한 웹 요건에 대한 검사를 받습니다. 호환되는 목표는 BRAND_AWARENESS
, REACH
, LINK_CLICKS
, POST_ENGAGEMENT
, VIDEO_VIEWS
및 CONVERSIONS
입니다.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 보상형 동영상 노출 위치를 타게팅하는 방법은 다음과 같습니다.
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
지원되는 국가(예: '미국')를 타게팅하는 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
지원되는 국가(예: '미국')를 타게팅하는 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_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" } ], } }
/ad-recommendation
에 대한 호출에서 이 결과의 code
필드를 사용하여 자세한 이유를 확인할 수 있습니다. 예를 들어 다음과 같은 정보를 얻을 수 있습니다.
[{“code”: 1815610, “summary”: “Device Platform Not Supported By Objective”},]
자세한 내용은 광고 추천, 참고 자료와 타게팅을 사용한 효과적인 노출 위치를 참조하세요.