Quảng cáo bộ sưu tập

Định dạng quảng cáo bộ sưu tập bao gồm Trải nghiệm tức thì, giúp mọi người dễ dàng khám phá, lướt xem cũng như mua sản phẩm và dịch vụ trên thiết bị di động theo cách trực quan và chân thực. Quảng cáo trong bảng feed sẽ nêu bật 3 sản phẩm trong một video hoặc hình ảnh chính mở ra Trải nghiệm tức thì toàn màn hình khi ai đó tương tác với quảng cáo đó. Có 2 loại quảng cáo bộ sưu tập: loại dựa trên hình ảnh và loại dựa trên video.

Hãy xem mọi trường hợp đề cập đến "Canvas" đều là biểu thị Trải nghiệm tức thì vì Canvas là tên trước của định dạng này.

Bạn có thể tạo quảng cáo có định dạng bộ sưu tập bằng cách tạo Trải nghiệm tức thì. Bắt đầu bằng một mẫu hoặc chọn bố cục tùy chỉnh của riêng bạn. Để biết thêm thông tin, hãy xem Trung tâm trợ giúp quảng cáo, Trải nghiệm tức thì.

Bạn cũng có thể thêm giao diện người dùng tạo quảng cáo của Facebook cho định dạng bộ sưu tập trên trang web của mình bằng JavaScript SDK để tạo Hộp thoại quảng cáo bộ sưu tập.

Để biết thông tin chung về cách sử dụng bộ sưu tập, hãy xem:

Để tạo bộ sưu tập dùng trong Cửa hàng hoặc thêm siêu dữ liệu vào nhóm sản phẩm, hãy xem phần Nền tảng thương mại, API Bộ sưu tập từ nhóm sản phẩm.

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

Mục tiêu và vị trí quảng cáo được hỗ trợ

Bạn có thể sử dụng quảng cáo bộ sưu tập với những mục tiêu sau:

Lưu lượng truy cập
Lượt chuyển đổi
Doanh số theo danh mục sản phẩm (Được hỗ trợ khi bạn sử dụng bộ sưu tập có một nhóm sản phẩm.)
Lượt ghé thăm cửa hàng (Được hỗ trợ khi bạn sử dụng bộ sưu tập có một nhóm sản phẩm.)
Mức độ nhận biết thương hiệu
Số người tiếp cận

Đối với các mục tiêu Lưu lượng truy cập và Lượt chuyển đổi, bạn cũng có thể sử dụng video bản trình chiếu. Để biết thêm thông tin, hãy xem Trung tâm trợ giúp doanh nghiệp: Chọn mục tiêu quảng cáo phù hợp.

Các vị trí quảng cáo sau đây được hỗ trợ:

Bảng feed Facebook
Facebook Reels
Bảng feed Instagram (Xem phần Trải nghiệm tức thì: Trải nghiệm tức thì và quảng cáo trên Instagram.)
Instagram Stories (Xem phần Trải nghiệm tức thì: Trải nghiệm tức thì và quảng cáo trên Instagram.)

Để biết thêm thông tin về vị trí quảng cáo, hãy xem Trung tâm trợ giúp doanh nghiệp: Giới thiệu về vị trí quảng cáo và Trung tâm trợ giúp doanh nghiệp: Các vị trí quảng cáo hiện có cho mục tiêu marketing.

Quảng cáo bộ sưu tập từ nhóm sản phẩm

Trước khi tạo quảng cáo bộ sưu tập, bạn cần cung cấp nội dung quảng cáo và Trải nghiệm tức thì. Bạn phải cung cấp ít nhất 4 thành phần đại diện cho ảnh hoặc 4 thành phần đại diện cho sản phẩm có thẻ sản phẩm cần hiển thị xoay vòng. Ngoài ra, các thành phần ảnh phụ trong thành phần quay vòng cũng được chấp nhận.

Tạo quảng cáo bộ sưu tập từ danh mục. Quảng cáo bộ sưu tập có 3 sản phẩm trong một hình ảnh hoặc video chính và hiển thị trong Bảng feed trên di động. Bạn có thể sử dụng video bản trình chiếu với tính năng này.

Quảng cáo này sẽ xuất hiện trong Bảng feed và mọi người có thể xem thêm trong trải nghiệm toàn màn hình mở ra khi họ nhấn vào quảng cáo.

Để sử dụng nhóm sản phẩm, bạn cần làm quen với quảng cáo danh mục Advantage+ và thiết lập sẵn danh mục sản phẩm. Hãy xem phần Quảng cáo danh mục Advantage+ và Quảng cáo danh mục Advantage+, Danh mục sản phẩm để biết thêm thông tin.

Tạo quảng cáo

Khi tạo quảng cáo bộ sưu tập từ nhóm sản phẩm, rõ ràng là bạn cũng phải tạo Trải nghiệm tức thì với đúng thành phần. Khi bạn sử dụng Trải nghiệm tức thì này trong quảng cáo bộ sưu tập, Facebook sẽ tự động tạo quảng cáo bộ sưu tập. Trải nghiệm tức thì của bạn cần bao gồm:

Một hình ảnh, ở dạng Ảnh canvas, Video canvas hay Video mẫu canvas.
Một nhóm sản phẩm có show_in_feed được đặt thành true. (Hãy xem Tài liệu tham khảo về nhóm sản phẩm canvas.)
Chân trang (Hãy xem Tài liệu tham khảo về chân trang canvas.)

Hình ảnh Trải nghiệm tức thì

Tạo Trải nghiệm tức thì bằng hình ảnh:

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/PAGE_ID/canvas_elements
Open In Graph API Explorer

Cách khác là tạo Trải nghiệm tức thì bằng video:

curl \
  -F 'canvas_video={ 
    "video_id": "VIDEO_ID", 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/PAGE_ID/canvas_elements
Open In Graph API Explorer

Cách khác là tạo Trải nghiệm tức thì bằng video mẫu:

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/v21.0/<PAGE_ID>/canvas_elements

Nhóm sản phẩm Trải nghiệm tức thì

Sau đó, bạn tạo một canvas_product_set có product_set_id từ danh mục sản phẩm của mình. Bạn phải đặt show_in_feed thành true để tạo quảng cáo bộ sưu tập.

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/v21.0/<PAGE_ID>/canvas_elements

Lưu ý: Trong ví dụ nêu trên, item_headline, item_description, image_overlay_spec, storefront_setting và retailer_item_ids đều là các trường không bắt buộc. Trước đây, bạn cung cấp các trường này trong cùng một lệnh gọi để tạo quảng cáo bộ sưu tập và tài sản Trải nghiệm tức thì cơ bản. Giờ thì bạn cung cấp các trường đó trong lệnh gọi này.

Cung cấp các trường bắt buộc trong thông số image_overlay_spec. Để biết thêm thông tin, hãy xem API Marketing, Tài liệu tham khảo, Dữ liệu liên kết nội dung quảng cáo, Quy cách lớp phủ hình ảnh.

Thông số storefront_setting hỗ trợ các trường product_set_layout, enable_sections và customized_section_titles.

Trường `product_set_layout`

Tên	Mô tả
`layout_type` chuỗi	Bắt buộc.. Cách nhóm sản phẩm sẽ hiển thị. Giá trị:`GRID_2COL`, `GRID_3COL`, `CAROUSEL`, `HSCROLL_LIST`

Để sử dụng customized_section_titles, enable_sections phải được đặt là true. Trường customized_section_titles yêu cầu một mảng đối tượng, mỗi đối tượng đều có các thông số title_id và customized_title

Trường `customized_section_titles`

Tên	Mô tả
`title_id` chuỗi	Bắt buộc. Chuỗi enum biểu thị chuỗi tiêu đề phần mặc định mà bạn muốn thay thế. Giá trị:`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` chuỗi	Bắt buộc. Chuỗi tùy chỉnh thay thế mà người xem sẽ thấy dưới dạng tiêu đề phần.

Chân trang Trải nghiệm tức thì

Tạo chân trang Trải nghiệm tức thì thông qua liên kết.

curl \
  -F 'canvas_button={ 
    "rich_text": {
      "plain_text": "See more at www.abc.com."
    },
    "open_url_action": {
      "url": "https://www.abc.com"
    }
  }' \
 -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/PAGE_ID/canvas_elements
Open In Graph API Explorer

Nếu muốn, bạn cũng có thể tạo một nút để sử dụng trong chân trang.

curl \
  -F 'canvas_footer={ 
    "child_elements": [BUTTON_ELEMENT_ID]
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/PAGE_ID/canvas_elements
Open In Graph API Explorer

Văn bản bạn cung cấp trong chân trang tương đối linh hoạt. Trước đây, bạn cần phải cung cấp See more.... nhưng giờ thì bạn có thể cung cấp văn bản tùy chỉnh với nút URL.

Trải nghiệm tức thì hoàn chỉnh

curl \
  -F 'body_element_ids=[
    PHOTO/VIDEO_ELEMENT_ID,
    PRODUCT_SET_ELEMENT_ID,
    FOOTER_ELEMENT_ID
  ]' \
  -F 'is_published=true' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/PAGE_ID/canvases
Open In Graph API Explorer

Để tạo Trải nghiệm tức thì bằng video mẫu, nhóm sản phẩm, nút, vị trí cửa hàng và chân trang không bắt buộc mà bạn đã thiết lập, bạn sẽ phải thêm thông số 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' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/canvases
Open In Graph API Explorer

Đối với mẫu Mặt tiền cửa hàng, bạn cần chỉ định source_template_id = 1932289657009030 như xác định trong phần Trải nghiệm tức thì, Sử dụng mẫu. Bố cục cho từng mẫu là cố định. Tuy nhiên, bạn có thể thay thế nội dung mặc định bằng video, sản phẩm, văn bản và liên kết động của chính mình. Để biết thêm thông tin, hãy xem phần Trải nghiệm tức thì, Sử dụng mẫu.

Tạo quảng cáo bộ sưu tập qua Trải nghiệm tức thì

Cuối cùng, bạn cần tạo một quảng cáo bộ sưu tập. Nhờ đó, mọi người có thể nhấp vào các hình ảnh hoặc thành phần video trong quảng cáo bộ sưu tập này.

Nếu thành phần đầu tiên của Trải nghiệm tức thì là ảnh, bạn phải đặt object_type thành 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/v21.0/AD_ACCOUNT_ID/adcreatives

Open In Graph API Explorer

Nếu thành phần đầu tiên của Trải nghiệm tức thì là video, hãy tạo yêu cầu sau:

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/v21.0/AD_ACCOUNT_ID/adcreatives

Nếu thành phần đầu tiên của Trải nghiệm tức thì là video mẫu, hãy tạo yêu cầu sau:

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/v21.0/act_<AD_ACCOUNT_ID>/ads

Bản xem trước quảng cáo

Nếu có tính năng Xem trước quảng cáo, bạn có thể cung cấp ad_format và mã truy cập dành cho Người dùng để tạo bản xem trước dựa trên quảng cáo hoặc nội dung quảng cáo của mình.

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

Open In Graph API Explorer

Lưu ý: Đối với quảng cáo Trải nghiệm tức thì dựa trên video mẫu, các định dạng được hỗ trợ là BIZ_DISCO_FEED_MOBILE, GROUPS_MOBILE, MOBILE_FEED_STANDARD, SUGGESTED_VIDEO_DESKTOP, SUGGESTED_VIDEO_MOBILE, WATCH_FEED_MOBILE.

Hãy xem phần Bản xem trước quảng cáo để biết thêm thông tin.

Quảng cáo bộ sưu tập tiêu chuẩn

Bạn có thể sử dụng mẫu để tạo nhanh Trải nghiệm tức thì cho một mục tiêu kinh doanh cụ thể. Bố cục cho từng mẫu là cố định. Tuy nhiên, bạn có thể thay nội dung mặc định bằng hình ảnh, video, sản phẩm, văn bản và liên kết của chính mình. Để biết thêm thông tin, hãy xem Trải nghiệm tức thì, Sử dụng mẫu.

Có 2 loại quảng cáo bộ sưu tập có Trải nghiệm tức thì: loại dựa trên hình ảnh và loại dựa trên video, tùy thuộc vào tài sản bạn cung cấp. Sau khi có nội dung quảng cáo, bạn có thể tạo quảng cáo.

Tạo quảng cáo dựa trên hình ảnh

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/v21.0/AD_ACCOUNT_ID/adcreatives

Tạo quảng cáo dựa trên video

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/v21.0/AD_ACCOUNT_ID/adcreatives

Thông số

Tên	Mô tả
`link` chuỗi	Bắt buộc Chuyển hướng người xem đến Trải nghiệm tức thì.
`collection_thumbnails` mảng	Bắt buộc Mảng hình thu nhỏ. Bạn cần cung cấp 4 hình thu nhỏ.

Trường `collection_thumbnails`

Tên	Mô tả
`element_id` chuỗi số	Bắt buộc ID thành phần ảnh canvas hoặc ID thành phần danh sách sản phẩm. Ảnh canvas cần phải liên kết với Trải nghiệm tức thì đính kèm với quảng cáo bộ sưu tập này. Hình ảnh liên kết với ID này xuất hiện trong Trải nghiệm tức thì sau khi ai đó nhấp vào quảng cáo. Một ID thành phần hình ảnh chính không hợp lệ.
`element_child_index` số nguyên	Bắt buộc đối với thành phần ảnh có thẻ sản phẩm và thành phần danh sách sản phẩm Chỉ mục sản phẩm từ mảng ID thành phần ảnh có thẻ sản phẩm. Hoặc chỉ mục sản phẩm từ mảng `product_id_list`, chứa thành phần danh sách sản phẩm. Lưu ý: Phải là một số nguyên dương.
`element_crops` AdsImageCrops	Bắt buộc đối với thành phần ảnh Một đối tượng JSON xác định kích thước cắt cho hình ảnh đã chỉ định. Chỉ cho phép khóa cắt `100x100`.

Tạo đối tượng tương tác

Bạn có thể tạo tự động đối tượng gồm những người đã tương tác với quảng cáo bộ sưu tập của mình. Điều này tương tự như đối tượng tương tác cho Trải nghiệm tức thì tiêu chuẩn. Để biết thêm thông tin, hãy xem Trải nghiệm tức thì, Đối tượng tương tác.

Bạn có thể nhắm mục tiêu quảng cáo Trải nghiệm tức thì toàn màn hình đến những người đã nhấn vào quảng cáo bộ sưu tập của bạn. Chúng tôi gọi loại đối tượng này là Đối tượng tương tác Trải nghiệm toàn màn hình. Tạo đối tượng này bằng cách tạo Đối tượng tùy chỉnh, sau đó đặt object_id thành CANVAS_ID và tạo một quy tắc để theo dõi một trong các sự kiện.

Tạo đối tượng gồm những người đã mở Trải nghiệm tức thì

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/v21.0/AD_ACCOUNT_ID/customaudiences

Open In Graph API Explorer

Tạo đối tượng gồm những người đã nhấp vào quảng cáo bộ sưu tập

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/v21.0/AD_ACCOUNT_ID/customaudiences
    
Open In Graph API Explorer

Hộp thoại Quảng cáo bộ sưu tập

Quảng cáo bộ sưu tập dựa trên Trải nghiệm tức thì có một mẫu. Do đó, để tạo quảng cáo bộ sưu tập bằng hộp thoại, bạn sẽ sử dụng hộp thoại Trải nghiệm tức thì với các thông số bổ sung. Điều này sẽ cung cấp quy trình giao diện người dùng tạo quảng cáo bộ sưu tập của Facebook trên trang web của bạn. Để biết thông tin chi tiết về thành phần giao diện người dùng, hãy xem phần Hộp thoại.

Để thiết lập Facebook SDK for JavaScript, hãy xem:

JavaScript SDK dựa vào quyền của người dùng đã đăng nhập để tạo Trải nghiệm tức thì. Nếu người dùng chưa có quyền cần thiết để tạo Trải nghiệm tức thì cho trang và doanh nghiệp đã cung cấp, hộp thoại sẽ hiển thị lỗi. Người dùng cũng phải có quyền truy cập vào bộ sản phẩm và danh mục sản phẩm. Để đảm bảo không xảy ra lỗi, người dùng phải có quyền truy cập vào Trình quản lý kinh doanh và có quyền tạo quảng cáo cho trang.

Sau đó, bạn có thể kích hoạt hộp thoại quảng cáo bộ sưu tập.

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
});

Bạn có thể cung cấp các cài đặt sau cho plugin:

Tên	Mô tả
`display`	Bắt buộc Thông số cần thiết được đặt thành giá trị `popup`.
`method`	Bắt buộc Thông số cần thiết được đặt thành giá trị `instant_experiences_builder`.
`account_id`	Bắt buộc ID tài khoản quảng cáo của bạn.
`business_id`	Bắt buộc ID doanh nghiệp của bạn.
`page_id`	Bắt buộc ID Trang mà bạn muốn liên kết với Trải nghiệm tức thì.
`template_id`	Bắt buộc ID mẫu mà bạn muốn sử dụng.
`product_catalog_id`	Không bắt buộc ID danh mục sản phẩm sẽ được dùng trong bộ sưu tập. Cần phải có ID này nếu bạn cung cấp `product_set_id`.
`product_set_id`	Không bắt buộc ID nhóm sản phẩm sẽ được dùng trong bộ sưu tập.

Bạn có thể tìm thấy tất cả các loại mẫu hợp lệ và ID tương ứng trong phần Trải nghiệm tức thì: Sử dụng mẫu.

product_catalog_id và product_set_id là các thông số không bắt buộc. Tuy nhiên, nếu cung cấp product_set_id, bạn cần phải cung cấp product_catalog_id. Sau khi bạn cung cấp những ID này, người dùng sẽ không thể thay đổi bộ sưu tập trong giao diện người dùng. Nếu thông số không được cung cấp, người dùng có thể chọn danh mục và nhóm sản phẩm trong giao diện người dùng. Để xem trước quảng cáo bộ sưu tập, bạn nên sử dụng Hộp thoại xem trước Trải nghiệm tức thì.

Khi thiết lập thành công, plugin sẽ đưa ra phản hồi sau:


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

id được trả về sẽ là một Trải nghiệm tức thì chưa đăng. Bạn cần phải đăng Trải nghiệm tức thì đó trước khi có thể dùng trong chiến dịch quảng cáo.

Nếu có phản hồi undefined hoặc không phản hồi nào được trả về, tức là người dùng đã đóng hộp thoại trước khi hoàn tất Trải nghiệm tức thì hoặc người dùng đã lưu Trải nghiệm tức thì nhưng chưa hoàn tất. Bạn có thể truy vấn API Đồ thị để xem tất cả các Trải nghiệm tức thì thuộc một trang; thao tác này cho phép bạn xem có Trải nghiệm tức thì nào chưa hoàn tất không.

Thêm danh mục điểm đến

Bạn có thể hiển thị nội dung quảng cáo từ danh mục điểm đến trong hình ảnh chính của quảng cáo bộ sưu tập. Bạn cũng có thể hiển thị thẻ quay vòng gồm những hình ảnh về khách sạn tại điểm đến đó. Để làm điều này, bạn phải cung cấp hình ảnh dự phòng sẽ hiển thị trong hình ảnh chính nếu chúng tôi không tìm thấy điểm đến tương ứng cho các khách sạn trong thẻ quay vòng. Để biết thêm thông tin, hãy xem Danh mục điểm đến.

Lưu ý những giới hạn sau:

Nội dung video không được hỗ trợ.
Chúng tôi chỉ hỗ trợ hiển thị kết hợp các hình ảnh trong danh mục điểm đến và khách sạn.
Chúng tôi không hỗ trợ hiển thị các kết hợp danh mục khác.

Để sử dụng tính năng này, hãy thêm thông số destination_set_id khi tạo thành phần canvas_photo, sau đó thực hiện các bước thông thường khác để tạo quảng cáo bộ sưu tập và Trải nghiệm tức thì.

Ví dụ

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
    "destination_set_id": "DESTINATION_SET_ID",
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/PAGE_ID/canvas_elements
Open In Graph API Explorer