โฆษณาแบบคอลเลกชั่น

รูปแบบโฆษณาแบบคอลเลกชั่นประกอบด้วยอินสแตนท์เอ็กซ์พีเรียนซ์ ซึ่งทำให้ผู้คนค้นพบ เลือกดู และซื้อผลิตภัณฑ์และบริการจากอุปกรณ์มือถือได้ง่ายขึ้นในรูปแบบภาพสมจริง โฆษณาในฟีดของคุณจะแสดงสินค้าสามรายการใต้รูปภาพหรือวิดีโอหลัก โดยระบบจะแสดงในรูปแบบอินสแตนท์เอ็กซ์พีเรียนซ์แบบเต็มหน้าจอเมื่อมีคนโต้ตอบกับโฆษณาของคุณ โดยโฆษณาแบบคอลเลกชั่นมีอยู่ 2 ประเภท ได้แก่ แบบใช้รูปภาพและแบบใช้วิดีโอ

โปรดทราบว่าเราอาจเรียกอินสแตนท์เอ็กซ์พีเรียนซ์ว่า "แคนวาส" เนื่องจากแคนวาสเป็นชื่อเรียกเดิมของรูปแบบอินสแตนท์เอ็กซ์พีเรียนซ์

คุณสามารถสร้างโฆษณาด้วยรูปแบบคอลเลกชั่นได้โดยการสร้างอินสแตนท์เอ็กซ์พีเรียนซ์ โดยจะสร้างจากเทมเพลตหรือเลือกเลย์เอาท์ที่คุณปรับแต่งเองก็ได้ โปรดดูข้อมูลเพิ่มเติมที่ศูนย์ช่วยเหลือโฆษณา, อินสแตนท์เอ็กซ์พีเรียนซ์

นอกจากนี้ คุณยังสามารถใส่อินเทอร์เฟซผู้ใช้เพื่อการสร้างโฆษณาของ Facebook สำหรับรูปแบบคอลเลกชั่นลงในเว็บไซต์ของคุณได้ โดยใช้ JavaScript SDK เพื่อสร้างกล่องโต้ตอบโฆษณาแบบคอลเลกชั่น

หากต้องการทราบข้อมูลทั่วไปเกี่ยวกับการใช้คอลเลกชั่น โปรดดู:

หากต้องการสร้างคอลเลกชั่นที่ใช้ในร้านค้าหรือเพิ่มเมตาดาต้าให้กับชุดสินค้า โปรดดูแพลตฟอร์มการค้า, API คอลเลกชั่นชุดสินค้า

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

วัตถุประสงค์และตำแหน่งการจัดวางที่รองรับ

คุณสามารถใช้โฆษณาแบบคอลเลกชั่นกับวัตถุประสงค์ต่อไปนี้ได้

จำนวนผู้เข้าชม
คอนเวอร์ชั่น
ยอดขายตามแค็ตตาล็อกสินค้า (รองรับเมื่อคุณใช้คอลเลกชั่นกับชุดสินค้า)
การเยี่ยมชมหน้าร้าน (รองรับเมื่อคุณใช้คอลเลกชั่นกับชุดสินค้า)
การรับรู้แบรนด์
การเข้าถึง

สำหรับวัตถุประสงค์ในด้านจำนวนผู้เข้าชมและคอนเวอร์ชั่น คุณสามารถใช้วิดีโอแบบสไลด์โชว์ได้ด้วย หากต้องการข้อมูลเพิ่มเติม โปรดดูศูนย์ช่วยเหลือทางธุรกิจ: เลือกวัตถุประสงค์ของโฆษณาที่เหมาะสม

ระบบรองรับตำแหน่งการจัดวางต่อไปนี้

ฟีด Facebook
Facebook Reels
ฟีด Instagram (โปรดดูอินสแตนท์เอ็กซ์พีเรียนซ์: อินสแตนท์เอ็กซ์พีเรียนซ์ และโฆษณาบน Instagram)
Instagram Stories (โปรดดูอินสแตนท์เอ็กซ์พีเรียนซ์: อินสแตนท์เอ็กซ์พีเรียนซ์ และโฆษณาบน Instagram)

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับตำแหน่งการจัดวางที่ศูนย์ช่วยเหลือทางธุรกิจ: เกี่ยวกับตำแหน่งการจัดวางและศูนย์ช่วยเหลือทางธุรกิจ: ตำแหน่งการจัดวางโฆษณาที่พร้อมใช้งานสำหรับวัตถุประสงค์ทางการตลาด

โฆษณาแบบคอลเลกชั่นจากชุดสินค้า

โปรดใส่ชิ้นงานโฆษณาและอินสแตนท์เอ็กซ์พีเรียนซ์ก่อนที่คุณจะสร้างโฆษณาแบบคอลเลกชั่น โดยต้องระบุอย่างน้อยสี่องค์ประกอบที่แสดงถึงรูปภาพ หรือสี่องค์ประกอบที่แสดงถึงสินค้าพร้อมแท็กสินค้าเพื่อนำมาแสดงหมุนเวียน นอกจากนี้ยังสามารถใส่องค์ประกอบภาพรองในองค์ประกอบแบบภาพสไลด์ได้อีกด้วย

สร้างโฆษณาแบบคอลเลกชั่นจากแค็ตตาล็อกของคุณ โฆษณาแบบคอลเลกชั่นจะมีสินค้า 3 รายการอยู่ใต้รูปภาพหรือวิดีโอหลัก และจะแสดงในฟีดบนมือถือ ซึ่งคุณสามารถใช้วิดีโอแบบสไลด์โชว์กับฟีเจอร์นี้ได้

โฆษณาจะปรากฏในฟีด และผู้คนจะสามารถดูเนื้อหาเพิ่มเติมได้ในประสบการณ์แบบเต็มหน้าจอที่จะเปิดขึ้นเมื่อแตะที่โฆษณา

หากต้องการใช้ชุดสินค้า คุณควรคุ้นเคยกับโฆษณาแค็ตตาล็อก Advantage+ และตั้งค่าแค็ตตาล็อกสินค้าไว้ก่อนแล้ว โปรดดูข้อมูลเพิ่มเติมที่โฆษณาแค็ตตาล็อก Advantage+ และโฆษณาแค็ตตาล็อก Advantage+, แค็ตตาล็อกสินค้า

การสร้างโฆษณา

เมื่อคุณสร้างโฆษณาแบบคอลเลกชั่นจากชุดสินค้า คุณต้องสร้างอินสแตนท์เอ็กซ์พีเรียนซ์อย่างชัดเจนพร้อมกับองค์ประกอบที่ถูกต้องด้วย และเมื่อคุณใช้อินสแตนท์เอ็กซ์พีเรียนซ์นี้ในโฆษณาแบบคอลเลกชั่น Facebook จะสร้างโฆษณาแบบคอลเลกชั่นโดยอัตโนมัติ ดังนั้นอินสแตนท์เอ็กซ์พีเรียนซ์ของคุณควรประกอบด้วยสิ่งต่อไปนี้

รูปภาพ ซึ่งเป็นรูปภาพแคนวาส วิดีโอแคนวาส หรือวิดีโอเทมเพลตแคนวาสก็ได้
ชุดสินค้าที่มีการตั้งค่า show_in_feed เป็น true(โปรดดูชุดสินค้าแคนวาส, ข้อมูลอ้างอิง)
ส่วนท้าย (โปรดดูส่วนท้ายแคนวาส, ข้อมูลอ้างอิง)

รูปภาพอินสแตนท์เอ็กซ์พีเรียนซ์

สร้างอินสแตนท์เอ็กซ์พีเรียนซ์ที่มีรูปภาพ:

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

ชุดสินค้าอินสแตนท์เอ็กซ์พีเรียนซ์

จากนั้นสร้าง canvas_product_set ด้วย product_set_id จากแค็ตตาล็อกสินค้าของคุณ โดยต้องตั้งค่า 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` สตริง	จำเป็นต้องระบุ สตริงทางเลือกแบบกำหนดเองที่ผู้ชมควรจะเห็นเป็นชื่อส่วน

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

สำหรับเทมเพลต Storefront คุณต้องระบุ 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` อาร์เรย์	จำเป็นต้องระบุ อาร์เรย์ของภาพขนาดย่อ ต้องมีภาพขนาดย่อสี่ภาพ

ช่อง `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

กล่องโต้ตอบโฆษณาแบบคอลเลกชั่น

โฆษณาแบบคอลเลกชั่นขึ้นอยู่กับอินสแตนท์เอ็กซ์พีเรียนซ์ที่มีเทมเพลต ดังนั้นหากต้องการสร้างโฆษณาแบบคอลเลกชั่นโดยใช้กล่องโต้ตอบ คุณจะต้องใช้กล่องโต้ตอบอินสแตนท์เอ็กซ์พีเรียนซ์ที่มีพารามิเตอร์เพิ่มเติม ซึ่งวิธีนี้จะช่วยให้เว็บไซต์ของคุณมีขั้นตอนผ่าน UI ในการสร้างโฆษณาแบบคอลเลกชั่นบน Facebook โปรดดูรายละเอียดเกี่ยวกับองค์ประกอบของ UI ที่กล่องโต้ตอบ

ในการตั้งค่า Facebook SDK สำหรับ 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 กราฟเพื่อดูอินสแตนท์เอ็กซ์พีเรียนซ์ทั้งหมดของเพจได้ ซึ่งช่วยให้คุณสามารถเห็นว่ามีอินสแตนท์เอ็กซ์พีเรียนซ์ใดบ้างที่ยังไม่เสร็จสิ้น

เพิ่มแค็ตตาล็อกปลายทาง

คุณสามารถแสดงชิ้นงานโฆษณาจากแค็ตตาล็อกปลายทางในรูปภาพหลักของโฆษณาแบบคอลเลกชั่นได้ นอกจากนี้ คุณยังสามารถแสดงภาพสไลด์ของโรงแรมที่ปลายทางนั้นได้อีกด้วย หากต้องการดำเนินการนี้ คุณต้องให้รูปภาพสำรองที่แสดงที่รูปภาพหลัก ในกรณีที่เราไม่พบปลายทางที่สอดคล้องกันสำหรับโรงแรมในภาพสไลด์ โปรดดูข้อมูลเพิ่มเติมที่แค็ตตาล็อกปลายทาง

โปรดคำนึงถึงข้อจำกัดต่อไปนี้

เราไม่รองรับชิ้นงานโฆษณาแบบวิดีโอ
เรารองรับเฉพาะการแสดงรูปภาพแค็ตตาล็อกปลายทางและโรงแรมที่รวมกันเท่านั้น
เราไม่รองรับการแสดงแค็ตตาล็อกรวมในรูปแบบอื่นๆ

หากต้องการใช้ฟีเจอร์นี้ ให้เพิ่มพารามิเตอร์ destination_set_id เมื่อสร้างองค์ประกอบ canvas_photo ของคุณ จากนั้นทำตามขั้นตอนมาตรฐานอื่นๆ เพื่อสร้างอินสแตนท์เอ็กซ์พีเรียนซ์และโฆษณาแบบคอลเลกชั่นของคุณ

ตัวอย่าง

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