마케팅 API

컬렉션 광고

컬렉션 광고 형식은 인스턴트 경험을 포함하며 사람들이 모바일 기기에서 시각적으로 몰입하여 제품과 서비스를 간편하게 찾고, 둘러보고, 구매할 수 있도록 합니다. 피드 내 광고에는 주요 이미지 또는 동영상에 3가지 제품이 나타납니다. 광고 내 주요 이미지 또는 동영상은 누군가 광고와 상호작용하면 전체 화면 상태의 인스턴트 경험에서 열립니다. 컬렉션 광고에는 이미지 기반 광고와 동영상 기반 광고가 있습니다.

캔버스는 이 형식의 이전 이름이므로 항상 인스턴트 경험을 나타낼 수 있도록 '캔버스'를 지칭하는 것을 고려해 보세요.

인스턴트 경험을 구축하여 컬렉션 형식으로 광고를 만들 수 있습니다. 템플릿으로 시작하거나 맞춤 설정된 레이아웃을 선택하세요. 자세한 내용은 광고 지원 센터, 인스턴트 경험을 참조하세요.

JavaScript SDK를 사용하여 컬렉션 광고 대화 상자를 만들면 웹사이트 내 컬렉션 형식에 Facebook 광고 생성 사용자 인터페이스를 포함할 수도 있습니다.

컬렉션 사용에 대한 일반 정보는 다음을 참조하세요.

Shops에 사용할 컬렉션을 만들거나 제품 세트에 메타데이터를 추가하려면 상거래 플랫폼, 제품 세트 컬렉션 API를 참조하세요.

For API calls, your AD_ACCOUNT_ID should be formatted as act_XXXXXXXXXXXXXXX.

지원되는 목표 및 노출 위치

다음과 같은 목표로 컬렉션 광고를 사용할 수 있습니다.

  • 트래픽
  • 전환
  • 제품 카탈로그 판매(제품 세트를 포함한 컬렉션을 사용하는 경우 지원됨)
  • 매장 방문(제품 세트를 포함한 컬렉션을 사용하는 경우 지원됨)
  • 브랜드 인지도
  • 도달

트래픽과 전환 목표에 슬라이드쇼 동영상도 사용할 수 있습니다. 자세한 내용은 비즈니스 고객 센터: 적절한 광고 목표 선택을 참조하세요.

지원되는 노출 위치는 다음과 같습니다.

노출 위치에 대한 자세한 내용은 비즈니스 고객 센터: 노출 위치 소개와 비즈니스 고객 센터: 마케팅 목표에 사용 가능한 광고 노출 위치를 참조하세요.

제품 세트의 컬렉션 광고

컬렉션 광고를 만들기 전에 광고 크리에이티브와 인스턴트 경험을 제공해야 합니다. 회전 시 표시할, 사진을 나타내는 요소 또는 제품 태그가 포함된 제품을 나타내는 요소를 4개 이상 제공해야 합니다. 슬라이드 요소의 하위 사진 요소도 유효합니다.

카탈로그에서 컬렉션 광고를 만듭니다. 컬렉션 광고는 주요 이미지 또는 동영상에 세 개의 제품이 있고 모바일 피드에 표시됩니다. 슬라이드쇼 동영상을 이 기능과 함께 사용할 수 있습니다.

광고는 피드에 표시되며 사람들은 광고를 누를 때 열리는 전체 화면 경험에서 자세한 내용을 볼 수 있습니다.

제품 세트를 사용하려면 어드밴티지+ 카탈로그 광고에 익숙하고 이미 제품 카탈로그가 설정되어 있어야 합니다. 자세한 내용은 어드밴티지+ 카탈로그 광고 및 어드밴티지+ 카탈로그 광고, 제품 카탈로그를 참조하세요.

광고 만들기

제품 세트에서 컬렉션 광고를 만들 때 올바른 요소를 포함한 인스턴트 경험도 명시적으로 만들어야 합니다. 컬렉션 광고에서 이런 인스턴트 경험을 사용하면 Facebook이 컬렉션 광고를 자동으로 생성합니다. 인스턴트 경험에는 다음 항목이 포함되어야 합니다.

인스턴트 경험 이미지

이미지가 포함된 인스턴트 경험을 만듭니다.

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

또는 동영상이 포함된 인스턴트 경험을 만들어도 됩니다.

curl \
  -F 'canvas_video={ 
    "video_id": "VIDEO_ID", 
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

또는 템플릿 동영상이 포함된 인스턴트 경험을 만듭니다.

curl -X POST \
  -F canvas_template_video={
      "name": "Cover Image or Video",
	"bottom_padding": "0",
	"top_padding": "0",
	"product_set_id": <Product_Set_ID>,
	"template_video_spec": {
	    "customization": {
	        "text_color": "FFFFFF",
	        "text_background_color": "000000",
		  "name_template": "{{product.name}}",
		  "body_template": "{{product.current_price strip_zeros}}"
	    },
	}
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<PAGE_ID>/canvas_elements

인스턴트 경험 제품 세트

그런 다음, 제품 카탈로그에서 product_set_id를 포함한 canvas_product_set를 만듭니다. 컬렉션 광고를 만들려면 show_in_feed를 true로 설정해야 합니다.

curl \
  -F 'canvas_product_set={ 
    "max_items": 50,
    "product_set_id": "<PRODUCT_SET_ID>",
    "item_headline": "{{product.name}}",
    "item_description": "{{product.current_price}}"
    "image_overlay_spec": {
      "overlay_template": "pill_with_text",
      "text_type": "price",
      "text_font": "dynads_hybrid_bold",
      "position": "top_left",
      "theme_color": "background_e50900_text_ffffff",
      "float_with_margin": true,
    },
    "storefront_setting": {
        "enable_sections": true,
        "customized_section_titles": [
            { "title_id": "popular", "customized_title": "My Populars" },
            { "title_id": "favorites", "customized_title": "My Favorites" }
        ],
        "product_set_layout": {
            "layout_type": "GRID_3COL"
        }
    },
    "retailer_item_ids": [0, 0, 0],
    "show_in_feed": true
  }' \
  https://graph.facebook.com/v19.0/<PAGE_ID>/canvas_elements

참고: 위의 예시에서 item_headline, item_description, image_overlay_spec, storefront_setting 및 retailer_item_ids는 모두 선택 사항 필드입니다. 예전에는 같은 호출에서 이러한 필드를 제공해서 컬렉션 광고와 기본 인스턴트 경험 자산을 만들었습니다. 이제는 이 호출에서 해당 피드를 제공합니다.

image_overlay_spec 매개변수에 모든 필수 필드를 입력합니다. 자세한 내용은 마케팅 API, 참고 자료, 광고 크리에이티브 링크 데이터, 이미지 오버레이 사양을 참조하세요.

storefront_setting 매개변수는 product_set_layout, enable_sections 및 customized_section_titles 필드를 지원합니다.

product_set_layout 필드
이름설명

layout_type

문자열

필수 항목.. 제품 세트가 표시되는 방식.
값:GRID_2COL, GRID_3COL, CAROUSEL, HSCROLL_LIST

customized_section_titles를 사용하려면 enable_sections를 true로 설정해야 합니다. customized_section_titles 필드에는 각각 title_id 및 customized_title 매개변수가 포함되어 있는 개체 배열이 필요합니다.

customized_section_titles 필드
이름설명

title_id

문자열

필수 항목.
바꾸고자 하는 기본 섹션 제목 문자열을 나타내는 enum 문자열.
값:keep_shopping, take_another_look, you_may_also_like, related_products, trending, popular, top_items, favorites, most_viewed, top_picks_for_you, suggested_for_you, featured_favorites, just_for_you, explore_more, shop_by_category

customized_title

문자열

필수 항목.
보는 사람에게 섹션 제목으로 표시되어야 하는 대체 맞춤 문자열.

인스턴트 경험 바닥글

링크가 포함된 인스턴트 경험 바닥글을 만듭니다.

curl \
  -F 'canvas_button={ 
    "rich_text": {
      "plain_text": "See more at www.abc.com."
    },
    "open_url_action": {
      "url": "https://www.abc.com"
    }
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

원하는 경우 바닥글에서 사용할 버튼을 만들 수도 있습니다.

curl \
  -F 'canvas_footer={ 
    "child_elements": [BUTTON_ELEMENT_ID]
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

바닥글에 입력하는 텍스트는 이전보다 자유롭게 지정할 수 있습니다. 이전에는 See more....를 입력해야 했지만 이제 맞춤 텍스트와 버튼 URL을 함께 입력할 수 있습니다.

완전한 인스턴트 경험

curl \
  -F 'body_element_ids=[
    PHOTO/VIDEO_ELEMENT_ID,
    PRODUCT_SET_ELEMENT_ID,
    FOOTER_ELEMENT_ID
  ]' \
  -F 'is_published=true' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvases

템플릿 동영상, 제품 세트, 버튼, 매장 위치, 설정한 선택적 바닥글을 포함하여 인스턴트 경험을 만들려면 source_template_id 매개변수를 포함해야 합니다.

curl \
  -F 'body_element_ids=[
    TEMPLATE_VIDEO_ELEMENT_ID,
    PRODUCT_SET_ELEMENT_ID,
    FOOTER_ELEMENT_ID
  ]' \
  -F 'name="Dynamic Video Instant Experience"', \
  -F 'source_template_id="1932289657009030"', \
  -F 'is_published=true' \
  https://graph.facebook.com/v19.0/<PAGE_ID\/canvases

상점 템플릿의 경우 source_template_id = 1932289657009030를 지정해야 합니다. 이는 인스턴트 경험, 템플릿 사용에서 정의됩니다. 각 템플릿의 레이아웃은 고정되어 있지만 기본 콘텐츠를 동적인 동영상, 제품, 텍스트 및 링크로 대체할 수 있습니다. 자세한 내용은 인스턴트 경험, 템플릿 사용을 참조하세요.

인스턴트 경험으로 컬렉션 광고 만들기

마지막으로 컬렉션 광고를 만들어야 합니다. 이렇게 하면 사람들이 컬렉션 광고에서 이미지 또는 동영상 요소를 클릭할 수 있습니다.

인스턴트 경험의 첫 번째 요소가 사진인 경우 object_type을 SHARE로 설정해야 합니다.

curl \
  -F 'name=Collection Sample Image Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "link": "https://fb.com/canvas_doc/CANVAS_ID", 
      "message": "AD_MESSAGE",
      "name": "AD_HEADLINE", 
    }, 
    "page_id": "PAGE_ID" 
  }' \
  -F 'object_type=SHARE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

인스턴트 경험의 첫 번째 요소가 동영상인 경우 다음과 같이 요청을 보냅니다.

curl \
  -F 'name=Collection Sample Video Creative' \
  -F 'object_story_spec={ 
    "video_data": {
      "call_to_action": {
        "type":"LEARN_MORE",
        "value":{
          "link":"https://fb.com/canvas_doc/CANVAS_ID",
        }
      },
      "image_url": "THUMBNAIL_IMAGE_URL",
      "message": "AD_MESSAGE",
      "title": "AD_HEADLINE", 
    }, 
    "page_id": "PAGE_ID" 
  }' \
  -F 'object_type=VIDEO' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

인스턴트 경험의 첫 번째 요소가 템플릿 동영상인 경우 다음과 같이 요청을 보냅니다.

curl -X POST \
  -F 'name="Dynamic Video Collection Ad"' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'status=PAUSED \
  -F 'creative={
       "object_story_spec": {
         "instagram_actor_id": "<INSTAGRAM_PAGE_ID>",
         "page_id": "<MAIN_PAGE_ID>",
         "template_data":{
           "call_to_action":{
             "type":"LEARN_MORE"
           },
           "format_option":"collection_video",
           "link":"https://fb.com/canvas_doc/CANVAS_ID",   
           "name":"Test Dynamic Ads with dynamic video",
           "retailer_item_ids":[
             "0",
             "0",
             "0",
             "0"
           ]
         }
       },
       "object_type": "SHARE",
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

광고 미리 보기

광고 미리 보기 기능이 있는 경우 ad_format과 사용자 액세스 토큰을 제공하여 광고 또는 광고 크리에이티브 기반의 미리 보기를 생성할 수 있습니다.

curl -X GET \
  -d 'ad_format="MOBILE_FEED_STANDARD"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<CREATIVE_ID>/previews

참고: 템플릿 동영상 인스턴트 경험 광고의 경우 지원되는 형식은 BIZ_DISCO_FEED_MOBILE, GROUPS_MOBILE, MOBILE_FEED_STANDARD, SUGGESTED_VIDEO_DESKTOP, SUGGESTED_VIDEO_MOBILE, WATCH_FEED_MOBILE입니다.

자세한 내용은 광고 미리 보기를 참조하세요.

표준 컬렉션 광고

템플릿을 사용하여 특정 비즈니스 목표를 위한 인스턴트 경험을 신속하게 만들 수 있습니다. 각 템플릿의 레이아웃은 고정되어 있지만 기본 콘텐츠를 자체 이미지, 동영상, 제품, 텍스트 및 링크로 대체할 수 있습니다. 자세한 내용은 인스턴트 경험, 템플릿 사용을 참조하세요.

인스턴트 경험이 포함된 컬렉션 광고는 제공하는 자산에 따라 이미지 기반 광고와 동영상 기반 광고, 이렇게 두 가지 유형으로 나뉩니다. 광고 크리에이티브가 있으면 광고를 만들 수 있습니다.

이미지 기반 광고 만들기

curl 
  -F 'name=Instant Experiences Collection Sample Image Creative' 
  -F 'object_story_spec={ 
    "link_data": {
      "link": "https://fb.com/canvas_doc/ELIGIBLE_CANVAS_ID", 
      "message": "Ad message", 
      "name": "name", 
      "picture": "IMAGE_URL", 
      "collection_thumbnails": [
        {"element_crops": {"100x100": [[0, 0], [100, 100]]},"element_id": "PHOTO_ELEMENT_WITH_PRODUCT_TAGS_ID",},
        {"element_child_index": 0,"element_id": "",},
        {"element_child_index": 1,"element_id": "PRODUCT_LIST_ELEMENT_ID",},
      ],
    }, 
    "page_id": "PAGE_ID" 
  }' 
  -F 'access_token=ACCESS_TOKEN' 
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

동영상 기반 광고 만들기

curl 
  -F 'name=Instant Experiences Collection Sample Video Creative' 
  -F 'object_story_spec={ 
    "page_id": "PAGE_ID", 
    "video_data": { 
      "call_to_action": {"type":"LEARN_MORE","value":{"link":"https://fb.com/canvas_doc/ELIGIBLE_CANVAS_ID"}}, 
      "image_url": "IMAGE_URL",
      "collection_thumbnails": [
        {"element_crops": {"100x100": [[0, 0], [100, 100]]},"element_id": "PHOTO_ELEMENT_NO_PRODUCT_TAGS_ID",},
        {"element_child_index": 0,"element_id": "PHOTO_ELEMENT_WITH_PRODUCT_TAGS_ID",},
        {"element_child_index": 1,"element_id": "PRODUCT_LIST_ELEMENT_ID",},
      ],
      "title": "My title", 
      "video_id": "VIDEO_ID" 
    } 
  }' 
  -F 'access_token=ACCESS_TOKEN' 
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

매개변수

이름설명

link

문자열

필수
시청자를 인스턴트 경험으로 리디렉션합니다.

collection_thumbnails

배열

필수
썸네일의 배열. 썸네일 4개가 필요합니다.

collection_thumbnails 필드

이름설명

element_id

숫자 문자열

필수
캔버스 사진 요소 ID 또는 제품 리스트 요소 ID. 캔버스 사진은 이 컬렉션 광고에 추가된 인스턴트 경험과 연결되어야 합니다. 누군가 광고를 클릭하면 이 ID와 연결된 이미지가 인스턴트 경험에 나타납니다. 주요 이미지 요소 ID가 잘못되었습니다.

element_child_index

정수

제품 태그가 포함된 사진 요소와 제품 리스트 요소에 필수
제품 태그가 포함된 사진 요소 ID 배열의 제품 인덱스 또는 제품 리스트 요소를 포함하는 product_id_list 배열의 제품 인덱스.
참고: 양의 정수여야 합니다.

element_crops
AdsImageCrops

사진 요소에 필수
지정된 이미지의 자르기 범위를 정의하는 JSON 개체. 100x100 자르기 키만 허용됩니다.

참여 타겟 만들기

컬렉션 광고에 반응을 보인 사람들로 타겟을 자동 생성할 수 있습니다. 표준 인스턴트 경험의 참여 타겟과 유사합니다. 자세한 내용은 인스턴트 경험, 참여 타겟을 참조하세요.

컬렉션 광고를 누른 사람에게 전체 화면 보기가 포함된 인스턴트 경험 광고를 타게팅할 수 있습니다. 이 타겟 유형을 전체 화면 경험 참여 타겟이라고 합니다. 맞춤 타겟을 만들어 이 타겟을 빌드한 다음, object_id를 CANVAS_ID로 설정하고 다음 이벤트 중 하나를 추적할 규칙을 설정합니다.

인스턴트 경험을 열었던 타겟 만들기

curl \
    -F 'name=Collection Engagement Audience' 
    -F 'description=People who opened this Instant Experience' 
    -F 'rule=[{"object_id":"CANVAS_ID","event_name":"instant_shopping_document_open"}]' 
    -F 'access_token=ACCESS_TOKEN' 
https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/customaudiences

컬렉션 광고를 클릭했던 타겟 만들기

curl \
    -F 'name=Collection Engagement Audience' 
    -F 'description=People who clicked any links in this Instant Experience' 
    -F 'rule=[{"object_id":"CANVAS_ID","event_name":"instant_shopping_element_click"}]'
    -F 'access_token=ACCESS_TOKEN' 
https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/customaudiences

컬렉션 광고 대화 상자

컬렉션 광고는 템플릿을 포함한 인스턴트 경험에 기반합니다. 그러므로 대화 상자로 컬렉션 광고를 만들려면 추가적 매개변수를 포함한 인스턴트 경험 대화 상자를 사용하게 됩니다. 그러면 웹사이트에 Facebook 컬렉션 광고 만들기 UI 플로가 제공됩니다. UI 구성 요소에 대한 자세한 내용은 대화 상자를 참조하세요.

Facebook SDK for JavaScript를 설정하는 방법은 다음과 같습니다.

JavaScript SDK는 로그인한 사용자 권한으로 인스턴트 경험을 생성합니다. 제공된 페이지와 비즈니스에 대해 사용자에게 인스턴트 경험을 생성할 권한이 없다면 대화 상자에 오류가 나타납니다. 또한 사용자는 제품 카탈로그와 세트에 액세스할 수 있어야 합니다. 오류가 없도록 하려면 사용자가 비즈니스 관리자에 액세스할 수 있고 페이지에 광고를 만들 권한이 있어야 합니다.

그런 다음, 컬렉션 광고 대화 상자를 트리거합니다.

FB.ui({         
  display: 'popup',
  method: 'instant_experiences_builder',
  account_id: 'AD_ACCOUNT_ID'.
  business_id: 'BUSINESS_ID',
  page_id: 'PAGE_ID',
  template_id: 'TEMPLATE_ID'
}, function(response) {
  // callback
});

플러그인에 다음과 같은 설정을 제공할 수 있습니다.

이름 설명

display

필수
값이 popup으로 설정된 필수 매개변수.

method

필수
값이 instant_experiences_builder로 설정된 필수 매개변수.

account_id

필수
광고 계정 ID.

business_id

필수
비즈니스 ID.

page_id

필수
인스턴트 환경과 연결하려는 페이지 ID.

template_id

필수
사용하려는 템플릿의 ID.

product_catalog_id

선택 사항
컬렉션에서 사용할 제품 카탈로그의 ID. product_set_id가 제공되는 경우 필요합니다.

product_set_id

선택 사항
컬렉션에서 사용할 제품 세트의 ID.

모든 유효한 템플릿 유형과 해당 ID는 인스턴트 경험: 템플릿 사용에서 확인할 수 있습니다.

product_catalog_id와 product_set_id 매개변수는 선택 사항입니다. 그러나 product_set_id를 제공하면 product_catalog_id를 제공해야 합니다. 이러한 ID를 제공하고 나면 사용자가 UI에서 컬렉션을 변경할 수 없게 됩니다. 이 두 가지 매개변수 중 어느 하나도 제공하지 않으면 사용자가 UI에서 카탈로그와 제품 세트를 선택할 수 있습니다. 컬렉션 광고를 미리 보려면 인스턴트 경험 미리 보기 대화 상자를 사용하는 것이 좋습니다.

성공 시 플러그인에서 다음과 같은 응답을 제공합니다.


{
  "success": true,
  "id": "CANVAS_ID"
}

반환된 id는 게시되지 않은 인스턴트 경험입니다. 이는 게시한 다음에 광고 캠페인에서 사용할 수 있습니다.

응답이 없거나 undefined 응답이 반환되면 사용자가 인스턴트 경험을 완료하기 전에 대화 상자를 닫았거나 사용자가 인스턴트 경험을 저장했지만 완료하지 않았다는 것을 의미합니다. 그래프 API를 사용하여 페이지에 속한 모든 인스턴트 경험을 불러와서 완료되지 않은 인스턴트 경험이 있는지 확인할 수 있습니다.

목적지 카탈로그 포함

컬렉션 광고의 주요 이미지에서 목적지 카탈로그의 광고 크리에이티브를 표시할 수 있습니다. 해당 목적지에서 호텔 이미지 슬라이드도 표시할 수 있습니다. 이를 위해서는 슬라이드에서 호텔의 해당 목적지를 찾지 못할 경우 주요 이미지에 나타날 폴백 이미지를 제공해야 합니다. 자세한 내용은 목적지 카탈로그를 참조하세요.

다음과 같은 제한 사항을 참조하세요.

  • 동영상 크리에이티브는 지원되지 않습니다.
  • 목적지와 호텔 카탈로그 이미지를 결합한 것만 표시합니다.
  • 다른 카탈로그 조합은 표시되지 않습니다.

이 기능을 사용하려면 canvas_photo 요소를 만들 때 destination_set_id 매개변수를 추가한 다음, 다른 표준 절차에 따라 인스턴트 경험과 컬렉션 광고를 만드세요.

예

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
    "destination_set_id": "DESTINATION_SET_ID",
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements