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

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

ก่อนเริ่มต้น

ในการสร้างและจัดการอินสแตนท์เอ็กซ์พีเรียนซ์ คุณต้องมีสิ่งต่อไปนี้

• สิทธิ์การอนุญาต pages_manage_ads
• สิทธิ์การอนุญาต pages_read_engagement
• สิทธิ์การอนุญาต pages_show_list
• ความสามารถในการดำเนินงาน ADVERTISE บนเพจได้

ข้อจำกัด

• คุณสามารถอัพเดตได้เฉพาะอินสแตนท์เอ็กซ์พีเรียนซ์ที่ยังไม่ได้เผยแพร่เท่านั้น
• API นี้พร้อมใช้งานแบบจำกัดสำหรับ Instagram
• Facebook Stories ไม่รองรับโฆษณาที่ใช้อินสแตนท์เอ็กซ์พีเรียนซ์

สร้าง

หากต้องการสร้างอินสแตนท์เอ็กซ์พีเรียนซ์ คุณจำเป็นต้องใช้ ID ของเพจ Facebook (PAGE-ID) และองค์ประกอบอื่นๆ เช่น รูปภาพ ปุ่ม และข้อความที่คุณต้องการรวมไว้ในประสบการณ์ของคุณ

curl \
  -F 'background_color=FFFFFF' \
  -F 'body_element_ids=["<CANVAS_PHOTO_ID>"]' \
  -F 'is_hidden=' \
  -F 'is_published=' \
  -F 'name=Canvas Name' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/canvases

องค์ประกอบ

ลบองค์ประกอบ

หากต้องการลบองค์ประกอบ ให้ทำการส่งคำขอ DELETE ไปพร้อม ID ขององค์ประกอบที่คุณต้องการลบ

curl -X DELETE \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CANVAS_ELEMENT_ID>

รับอินสแตนท์เอ็กซ์พีเรียนซ์ที่มีอยู่

หากต้องการข้อมูลเกี่ยวกับอินสแตนท์เอ็กซ์พีเรียนซ์ที่มีอยู่ในตอนนี้ คุณจำเป็นต้องใช้ ID ของอินสแตนท์เอ็กซ์พีเรียนซ์ (CANVAS-ID)

curl -G \
  --data-urlencode 'fields=[ 
    "body_elements", 
    "canvas_link", 
    "id", 
    "is_hidden", 
    "is_published", 
    "name" 
  ]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CANVAS_ID>

รับอินสแตนท์เอ็กซ์พีเรียนซ์ทั้งหมดสำหรับเพจ

หากต้องการข้อมูลเกี่ยวกับอินสแตนท์เอ็กซ์พีเรียนซ์ที่มีอยู่ทั้งหมดสำหรับเพจ Facebook คุณจำเป็นต้องใช้ ID ของเพจนั้น (PAGE-ID)

curl -G \
  --data-urlencode 'fields=[ 
    "background_color", 
    "body_elements", 
    "canvas_link", 
    "id", 
    "is_hidden", 
    "is_published", 
    "last_editor", 
    "name", 
    "owner", 
    "update_time" 
  ]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/canvases

อัพเดตอินสแตนท์เอ็กซ์พีเรียนซ์

คุณสามารถอัพเดตได้เฉพาะอินสแตนท์เอ็กซ์พีเรียนซ์ที่ยังไม่ได้เผยแพร่เท่านั้น และจำเป็นต้องใช้ ID ของอินสแตนท์เอ็กซ์พีเรียนซ์ (CANVAS-ID) และ ID ขององค์ประกอบที่คุณต้องการอัพเดต

curl \
  -F 'background_color=FFFFFF' \
  -F 'body_element_ids=["<CANVAS_PHOTO_ID>"]' \
  -F 'is_hidden=' \
  -F 'is_published=' \
  -F 'name=Canvas Name' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CANVAS_ID>

ใช้เทมเพลต

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

เรียกใช้ประเภทองค์ประกอบสำหรับเทมเพลต

ขั้นตอนที่ 1 เรียกใช้ข้อมูลเอกสารสำหรับเทมเพลต

ส่งคำขอ GET เพื่อพิจารณาว่าเทมเพลตนั้นๆ จำเป็นต้องใช้องค์ประกอบใดบ้าง โดยในตัวอย่างด้านล่างนี้จะเป็นเทมเพลต สร้างลูกค้ารายใหม่

curl -i -X GET \
 "https://graph.facebook.com/VERSION/133471657203838?fields=document&access_token=ACCESS-TOKEN"

ตัวอย่างการตอบกลับ

{
  "document": {
    "name": "Get New Customers",
    "id": "397246414010297"
  },
  "id": "133471657203838"
}

ขั้นตอนที่ 2 เรียกใช้ประเภทองค์ประกอบ

ใช้ ID ในช่อง document เพื่อเรียกใช้องค์ประกอบที่เฉพาะเจาะจงสำหรับเทมเพลตนั้นๆ

curl -i -X GET \
 "https://graph.facebook.com/VERSION/397246414010297?fields=body_elements&access_token=ACCESS-TOKEN"

รายการที่ส่งคืนมาจะแสดงประเภทองค์ประกอบที่สามารถใช้ได้ในเทมเพลต สร้างลูกค้ารายใหม่

    {
  "body_elements": [
    {
      "name": "Cover Image or Video",
      "element_type": "PHOTO",
      "id": "397271930674412"
    },
    {
      "name": "Text",
      "element_type": "RICH_TEXT",
      "id": "397271920674413"
    },
    {
      "name": "Text",
      "element_type": "RICH_TEXT",
      "id": "397271910674414"
    },
    {
      "name": "Button",
      "element_type": "BUTTON",
      "id": "397271914007747"
    },
    {
      "name": "Carousel",
      "element_type": "CAROUSEL",
      "id": "397271940674411"
    },
    {
      "name": "Text",
      "element_type": "RICH_TEXT",
      "id": "397271917341080"
    },
    {
      "name": "Button",
      "element_type": "BUTTON",
      "id": "397271924007746"
    }
  ],
  "id": "397246414010297"
}

เผยแพร่

หากต้องการเผยแพร่โฆษณาอินสแตนท์เอ็กซ์พีเรียนซ์ คุณจะต้องส่งคำขอ POST ไปยัง ID อินสแตนท์เอ็กซ์พีเรียนซ์ของคุณ (CANVAS-ID) และตั้งค่าช่อง is_published เป็น true

curl \
  -F 'is_published=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CANVAS_ID>

สร้างชิ้นงานโฆษณา

สร้างชิ้นงานโฆษณาโดยใช้ลิงก์สำหรับอินสแตนท์เอ็กซ์พีเรียนซ์ที่มีอยู่ (CANVAS-LINK)

curl -X POST \
  -F 'image_hash="<IMAGE_HASH>"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "image_hash": "<IMAGE_HASH>",
         "link": "<CANVAS_LINK>",
         "name": "Creative message",
         "call_to_action": {
           "type": "LEARN_MORE"
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

คุณสามารถสร้างกลุ่มโฆษณา ชุดโฆษณา และแคมเปญโฆษณาได้ทันทีที่ชิ้นงานโฆษณาพร้อม

กล่องโต้ตอบโฆษณาอินสแตนท์เอ็กซ์พีเรียนซ์

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

ตั้งค่า Facebook SDK สำหรับ JavaScript โปรดดู:

• คู่มือการเริ่มต้นอย่างง่าย
• ข้อมูลอ้างอิงสำหรับการเริ่มต้น

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

จากนั้นจึงทริกเกอร์กล่องโต้ตอบ:

FB.ui({         
  display: 'popup',
  method: 'instant_experiences_builder',
  business_id: '<BUSINESS_ID>',
  page_id: '<PAGE_ID>'
}, function(response) {
  // callback
});

คุณสามารถกำหนดการตั้งค่าเหล่านี้ให้กับปลั๊กอินได้:

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

เมื่อสำเร็จ ปลั๊กอินจะส่งการตอบกลับดังนี้:

{
  "success": true,
  "id": "CANVAS-ID"
}

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

ดูตัวอย่างอินสแตนท์เอ็กซ์พีเรียนซ์

API ภาพตัวอย่าง iframe

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

curl -X GET \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v18.0/<CANVAS_ID>/preview
  
Open In Graph API Explorer

API จะส่งคืนในลักษณะนี้ ซึ่งสามารถดูได้ด้วยการฝังองค์ประกอบ iframe ที่ส่งคืนมาในรูปแบบ HTML

{
"data": [
    {
      "body": "<iframe src=\"https://www.facebook.com/ads/canvas/preview?d=AQKELApdJxoVp2f3PHl8-pRtYuAh4-_eDupMDbh-pS9zde_EFxckhYQCXu7NYUi4PhhBA7uskIo2Ys3IjIVNGZiS&t=AQKGOPqGI-NWcv1YKbA\" width=\"405\" height=\"720\" scrolling=\"yes\" style=\"border: none;\"></iframe>"
    }
  ],
  "__www_request_id__": "AQnyr47Qp2r5M-ISqSiMgrw"
}

Facebook SDK

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

ตั้งค่า Facebook SDK สำหรับ JavaScript โปรดดู:

• คู่มือการเริ่มต้นอย่างง่าย
• ข้อมูลอ้างอิงสำหรับการเริ่มต้น

JavaScript SDK ใช้สิทธิ์การอนุญาตของผู้ใช้ที่เข้าสู่ระบบเพื่อสร้างอินสแตนท์เอ็กซ์พีเรียนซ์ หากผู้ใช้ไม่มีสิทธิ์การอนุญาตที่จำเป็นเพื่อดูอินสแตนท์เอ็กซ์พีเรียนซ์ กล่องโต้ตอบจะแสดงข้อผิดพลาด

จากนั้นจึงทริกเกอร์กล่องโต้ตอบในการดูตัวอย่าง:

FB.ui({         
  display: 'popup',
  method: 'instant_experiences_preview',
  canvas_id: 'CANVAS-ID'
});

คุณสามารถกำหนดการตั้งค่าเหล่านี้ให้กับปลั๊กอินได้:

สร้างกลุ่มเป้าหมายสำหรับอินสแตนท์เอ็กซ์พีเรียนซ์

หากต้องการสร้างกลุ่มเป้าหมายการมีส่วนร่วม ซึ่งเป็นกลุ่มเป้าหมายของผู้คนที่มีส่วนร่วมกับอินสแตนท์เอ็กซ์พีเรียนซ์ ให้ตั้งค่าพารามิเตอร์ object_id ในช่อง rule เป็น ID ของอินสแตนท์เอ็กซ์พีเรียนซ์ (CANVAS-ID) ในการเรียก POST /act_AD-ACCOUNT/customaudiences ของคุณ

ผู้ที่เคยเปิดอินสแตนท์เอ็กซ์พีเรียนซ์นี้

curl \
  -F 'name=Instant Experience 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/<VERSION>/act_<AD_ACCOUNT_ID>/customaudiences
Open In Graph API Explorer

ผู้ที่เคยคลิกลิงก์ใดลิงก์หนึ่งในอินสแตนท์เอ็กซ์พีเรียนซ์นี้

curl \
  -F 'name=Instant Experience 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/<VERSION>/act_<AD_ACCOUNT_ID>/customaudiences
Open In Graph API Explorer

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับกลุ่มเป้าหมายที่กำหนดเองที่กลุ่มเป้าหมายที่กำหนดเอง, ข้อมูลอ้างอิง

อินสแตนท์เอ็กซ์พีเรียนซ์และโฆษณาบน Instagram

การนำอินสแตนท์เอ็กซ์พีเรียนซ์ไปใช้กับ Instagram จะใช้การเรียก API เดียวกันกับที่คุณใช้สำหรับอินสแตนท์เอ็กซ์พีเรียนซ์บน Facebook โปรดทราบว่าการใช้ Instagram และอินสแตนท์เอ็กซ์พีเรียนซ์ยังมีข้อจำกัด:

• ตำแหน่งการจัดวาง - พร้อมใช้งานสำหรับฟีดบน Instagram และ Instagram Stories หากคุณเลือก Instagram Stories คุณควรเลือกตัวเลือกนี้เป็นตำแหน่งการจัดวางโฆษณาเฉพาะ
• องค์ประกอบของอินสแตนท์เอ็กซ์พีเรียนซ์ - รองรับส่วนหัวและชุดสินค้าอย่างเต็มรูปแบบ

เรารองรับองค์ประกอบของอินสแตนท์เอ็กซ์พีเรียนซ์บน Instagram เพียงบางส่วน

• ส่วนท้าย - ไม่มี swipe to open ของไคลเอ็นต์ โดยแสดงภาพเป็น Tap to open
• ภาพสไลด์ - ไม่มีรูปภาพที่เชื่อมโยงกับอินสแตนท์เอ็กซ์พีเรียนซ์อื่น ในไคลเอ็นต์ปรากฏเป็นลิงก์ที่ไม่สามารถคลิกได้ สำหรับรูปภาพและวิดีโอ ไม่มีการจัดให้พอดีกับความสูง ไม่มีการจัดให้พอดีกับความกว้างหรือเอียงเพื่อแพน แต่จะแสดงเป็นการจัดให้พอดีกับความกว้าง
• ปุ่ม - ไม่สามารถเชื่อมโยงกับอินสแตนท์เอ็กซ์พีเรียนซ์อื่นหรือ App Store ได้
• ข้อความ - ไม่รองรับภาษา RTL
• วิดีโอ - ไม่มีวิดีโอ 360 องศา
• ตัวค้นหาร้านค้า - ไม่รองรับ

ข้อมูลเชิงลึกของโฆษณา

ดู ข้อมูลเชิงลึกของโฆษณา เพื่อดูภาพรวมและคำอธิบายสำหรับเกณฑ์ชี้วัดที่สามารถใช้ได้

ดูเพิ่มเติม

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