마케팅 API

자산 피드 사양 옵션

asset_feed_spec에서 다음 옵션을 사용할 수 있습니다. 자세한 참고 자료 정보는 광고 자산 피드 사양을 참조하세요.

속성 이름 설명

images

유형: 리스트 배열

SINGLE_IMAGE 및 CAROUSEL_IMAGE 형식에 필수입니다.

적격 이미지의 배열. 이 배열에서 제공되는 이미지는 광고 계정의 이미지 라이브러리에 포함해야 합니다.


이 필드는 {"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"}를 포함하는 리스트의 배열로 제공합니다. url 또는 hash가 필요합니다.

videos

유형: 리스트 배열

SINGLE_VIDEO 형식에 필수입니다.

video_id의 배열. 이 배열에서 제공되는 video_id는 해당 광고 계정에 속해야 합니다.


이 필드는 {"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"}를 포함하는 리스트의 배열로 제공합니다.

carousels
유형: 리스트의 배열

선택 사항.
multi_share_end_card 및 multi_share_optimized 부울을 포함한 child_attachments와 adlabels의 배열. 이 배열에서 제공된 child_attachments는 해당 광고 계정에 속해야 합니다.



child_attachments는 {"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}}를 포함하는 리스트의 배열로 제공합니다. image_label 또는 video_label은 필수입니다.

bodies

유형: 리스트 배열

선택 사항.

본문의 배열. 광고의 기본 메시지 또는 문구.


이 필드는 {"text": "{BODY_TEXT}", "url_tags": "{TAG}"}의 리스트 배열로 제공합니다.

call_to_action_types

유형: 리스트 배열

OUTCOME_AWARENESS를 제외한 모든 목표에 필수입니다.

call-to-action-type 값의 배열.


이 필드는 {"{CALL_TO_ACTION}"}의 리스트 배열로 제공합니다. 여러 개의 값을 5개까지 제고할 수 있습니다.

titles

유형: 리스트 배열

선택 사항.

제목의 배열. 제목은 광고의 짧은 제목으로, 일반적으로는 링크, 이미지 또는 동영상 옆에 표시됩니다.


이 필드는 {"text": "{TITLE}", "url_tags": "{TAG}"}의 리스트 배열로 제공합니다.

descriptions

유형: 리스트 배열

선택 사항.

보조 설명 텍스트의 배열. 일반적으로 링크, 이미지 또는 동영상 옆에 표시됩니다. 이를 지정하지 않을 경우 Facebook이 비즈니스가 제공한 링크를 스크래핑하여 생성합니다. 스크래핑된 텍스트를 사용하고 싶지 않을 경우 공백 한 칸이 들어간 빈 문자열을 사용하여 설명을 비워두세요.


이 필드는 {"text": "{DESCRIPTION}", "url_tags": "{TAG}"}의 리스트 배열로 제공합니다.

link_urls

유형: 리스트 배열

필수 항목.

링크 URL의 배열.


이 필드는 {"website_url": "{URL}"}의 리스트 배열로 제공합니다.

ad_formats

유형: 문자열 배열

필수 항목.

광고를 생성하고자 하는 Facebook 광고 형식의 배열. 지원되는 형식: SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO, AUTOMATIC_FORMAT.


이 필드는 문자열 ["{AD_FORMAT}"]의 배열로 제공합니다.

optimization_type

유형: 문자열

선택 사항.

자산 필드에서 사용한 최적화 유형. 가능한 값은 ASSET_CUSTOMIZATION, LANGUAGE, PLACEMENT 및 REGULAR입니다.

message_extensions

유형: 문자열 배열

선택 사항.
자산 피드에서 사용되는 메시지 확장 유형.


가능한 값: whatsapp

onsite_destinations
유형: 리스트 배열

Shops 광고에 필수입니다. 고정 광고에 유효합니다. SINGLE_IMAGE, SINGLE_VIDEO 또는 CAROUSEL 형식입니다.
이 필드는 사이트 Shop의 랜딩 페이지를 지정하기 위해 다음 값 중 하나를 포함한 리스트 배열로 제공합니다.

{"storefront_shop_id": "<SHOP_STOREFRONT_ID>"}
or 
{"shop_collection_product_set_id": "<PRODUCT_SET_ID>" 
or 
{"details_page_product_id": "<PRODUCT_ID>"}

shops_bundle
유형: 부울

Shops 광고에 필수입니다. 어드밴티지+ 카탈로그 광고에 유효합니다.
이 필드는 Shop 최적화에 제공합니다. reasons_to_shop 및 automated_product_tags Shop 최적화 유형을 모두 포함합니다.
가능한 값: true, false

reasons_to_shop
유형: 부울

Shops 광고에 필수입니다. 어드밴티지+ 카탈로그 광고에 유효합니다.
이 필드는 Shop 최적화에 제공합니다. Shop에서 '무료 쇼핑', '인기 상승' 또는 '재고 부족' 등의 제품 정보를 자동으로 강조 표시합니다.
가능한 값: true, false

자산 피드 사양 제한

광고 형식

  • 지원되는 ad_formats: SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO 및 AUTOMATIC_FORMAT.
  • 자산 피드당 하나의 ad_format만 허용됩니다.
  • ad_format은 자산 피드에서 하나의 자산으로 계산됩니다.

자산 수:

  • 총 자산: 최대 30개. 예를 들어 images 10개, bodies 5개, titles 5개, description 5개, ad_format 1개, link_url 1개 및 call_to_action_types 1개를 포함하여 28개의 자신이 있습니다.
  • 총 이미지 수: 10개 이하.
  • 총 영상 수: 10개 이하. Instagram을 노출 위치로 사용하는 경우 정사각형 동영상 또는 가로 동영상만 허용됩니다.
  • 총 본문 수: 5개 이하.
  • 총 행동 유도 수: 5개 이하.
  • 총 제목 수: 5개 이하.
  • 총 링크 수: 5개 이하.
  • 총 설명 수: 5개 이하.

이미지 요구 사항:

  • 권장 이미지 사양: 1.9:1
  • 권장 이미지 크기: 1,200 x 628픽셀
  • CAROUSEL_IMAGE 형식의 경우 이미지를 2개 이상 제공해야 합니다.
  • Instagram을 노출 위치로 사용하는 경우 성능 향상을 위해 정사각형 이미지를 사용하세요.

텍스트 요구 사항:

  • 제목 및 설명 텍스트: 최대 255자
  • 본문 텍스트: 최대 1,024자
  • 설명을 지정하지 않는 경우 Facebook에서 비즈니스가 제공한 링크를 스크래핑하여 설명을 가져옵니다.
  • CAROUSEL_IMAGE의 경우 제목은 선택 사항입니다.

url_tags는 선택 사항이고 images, videos, bodies, descriptions 및 titles에만 제공됩니다. Facebook은 각 광고 자산에서 링크 URL에 대해 url_tags를 매개변수로 첨부합니다.

예를 들어 SINGLE_IMAGE 형식에 대한 유효한 자산 피드 조합 설정은 다음과 같습니다.

  • images 5개
  • bodies 3개
  • titles 3개
  • descriptions 3개
  • 형식 1개: SINGLE_IMAGE
  • link_urls 2개
"link_urls=[{'website_url':'<WEBSITE_URL>'}, {'website_url':'<WEBSITE_URL>'}]"

딥 링크 사용

다음과 같은 목표가 설정된 캠페인의 자산 피드 사양에 딥 링크를 사용할 수 있습니다.

  • APP_INSTALLS
  • CONVERSIONS
  • LINK_CLICKS

asset_feed_spec을 생성할 때 link_urls에 deeplink_url을 추가합니다.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F "asset_feed_spec={'images': [{'hash':'image_hash'}], 'bodies': [{'text':'Body 1'}, {'text':'Body 2'}], 'titles': [{'text':'Title 1'}, {'text':'Title 2'}], 'descriptions': [{'text':' '}], 'ad_formats': ['SINGLE_IMAGE'], 'link_urls': [{'website_url':'App's object store URL','deeplink_url':'deeplink URL'}]}" \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

WhatsApp 광고에서 웹사이트 연결

사람들이 바로 비즈니스에 연락할 수 있도록 화면 하단에 표시되는 WhatsApp 버튼으로 사람을 웹사이트로 보내는 광고를 만들 수 있습니다. 그러면 사람들이 웹사이트를 방문할 때 WhatsApp에서 비즈니스와 연결하는 데 도움이 됩니다.

asset_feed_spec을 만들 때 message_extensions를 추가합니다.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F 'asset_feed_spec={"images": [{"hash":"image_hash"}], "bodies": [{"text":"Body 1"}, {"text":"Body 2"}],"titles": [{"text":"Title 1"}, {"text":"Title 2"}], "descriptions": [{"text":" "}], "ad_formats": ["SINGLE_IMAGE"], "link_urls": [{"website_url":"business URL"}], "message_extensions": [{"type": "whatsapp"}]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives