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

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

หากคุณเห็นการกล่าวถึง canvas ใดๆ ใน API นั่นคือการอ้างถึงอินสแตนท์เอ็กซ์พีเรียนซ์ Canvas เป็นชื่อเดิมของรูปแบบดังกล่าว

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

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

ข้อจำกัด

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

สร้าง

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

use FacebookAds\Api;
use FacebookAds\Http\RequestInterface;

$params = array(
  'background_color' => 'FFFFFF',
  'body_element_ids' => array(<CANVAS_PHOTO_ID>),
  'is_hidden' => false,
  'is_published' => false,
  'name' => 'Canvas Name',
);

$data = Api::instance()->call(
  '/' . <PAGE_ID> . '/canvases',
  RequestInterface::METHOD_POST,
  $params)->getContent();
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/v2.11/<PAGE_ID>/canvases

องค์ประกอบ

ชื่อคำอธิบาย

ปุ่ม

ปุ่มในอินสแตนท์เอ็กซ์พีเรียนซ์ ต้องระบุข้อมูลในช่อง button_style

ภาพสไลด์

ภาพสไลด์สำหรับอินสแตนท์เอ็กซ์พีเรียนซ์

ส่วนท้าย

ส่วนท้ายสำหรับอินสแตนท์เอ็กซ์พีเรียนซ์

ส่วนหัว

ส่วนหัวสำหรับอินสแตนท์เอ็กซ์พีเรียนซ์

รูปภาพ

รูปภาพในอินสแตนท์เอ็กซ์พีเรียนซ์ คุณควรระบุ PHOTO-ID สำหรับรูปภาพที่อัพโหลดไปยังเพจ Facebook

รายการสินค้า

รายการสินค้าสำหรับอินสแตนท์เอ็กซ์พีเรียนซ์

ชุดสินค้า

ชุดสินค้าจากแค็ตตาล็อกสินค้าที่เป็นโฆษณาแค็ตตาล็อก Advantage+ ที่แสดงในอินสแตนท์เอ็กซ์พีเรียนซ์

ตัวค้นหาร้านค้า

ตัวค้นหาร้านค้าในอินสแตนท์เอ็กซ์พีเรียนซ์

ข้อความ

ข้อความและรูปแบบข้อความที่แสดงในอินสแตนท์เอ็กซ์พีเรียนซ์

วิดีโอ

วิดีโอในอินสแตนท์เอ็กซ์พีเรียนซ์ คุณควรระบุ VIDEO-ID สำหรับวิดีโอที่อัพโหลดไปยังเพจ Facebook

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

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

use FacebookAds\Api;
use FacebookAds\Http\RequestInterface;

$data = Api::instance()->call(
  '/' . <CANVAS_ELEMENT_ID>,
  RequestInterface::METHOD_DELETE,
  array())->getContent();
curl -X DELETE \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<CANVAS_ELEMENT_ID>

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

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

use FacebookAds\Api;
use FacebookAds\Http\RequestInterface;

$params = array(
  'fields' => array(
    'body_elements',
    'canvas_link',
    'id',
    'is_hidden',
    'is_published',
    'name',
  ),
);

$data = Api::instance()->call(
  '/' . <CANVAS_ID>,
  RequestInterface::METHOD_GET,
  $params)->getContent();
curl -G \
  --data-urlencode 'fields=[ 
    "body_elements", 
    "canvas_link", 
    "id", 
    "is_hidden", 
    "is_published", 
    "name" 
  ]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<CANVAS_ID>

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

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

use FacebookAds\Api;
use FacebookAds\Http\RequestInterface;

$params = array(
  'fields' => array(
    'background_color',
    'body_elements',
    'canvas_link',
    'id',
    'is_hidden',
    'is_published',
    'last_editor',
    'name',
    'owner',
    'update_time',
  ),
);

$data = Api::instance()->call(
  '/' . <PAGE_ID> . '/canvases',
  RequestInterface::METHOD_GET,
  $params)->getContent();
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/v2.11/<PAGE_ID>/canvases

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

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

use FacebookAds\Api;
use FacebookAds\Http\RequestInterface;

$params = array(
  'background_color' => 'FFFFFF',
  'body_element_ids' => array(<CANVAS_PHOTO_ID>),
  'is_hidden' => false,
  'is_published' => false,
  'name' => 'Canvas Name',
);

$data = Api::instance()->call(
  '/' . <CANVAS_ID>,
  RequestInterface::METHOD_POST,
  $params)->getContent();
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/v2.11/<CANVAS_ID>

ใช้เทมเพลต

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

ชื่อเทมเพลตสำหรับ APIID เทมเพลตคำอธิบาย

สร้างลูกค้ารายใหม่

133471657203838

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

แสดงธุรกิจของคุณ

1063217037112304

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

ขายสินค้า (แบบไม่มีแค็ตตาล็อก)

424787857903852

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

ขายสินค้า: เลย์เอาท์ไลฟ์สไตล์

1369752616394017

แสดงรูปภาพของสินค้าขณะกำลังใช้งานเพื่อให้ผู้คนสำรวจสินค้าของคุณ เทมเพลต Lookbook ในตัวจัดการโฆษณา

ขายสินค้า: เลย์เอาท์ตาราง

1932289657009030

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

ประสบการณ์ AR

เทมเพลตประสบการณ์ AR สามารถใช้ได้ผ่านตัวจัดการโฆษณาเท่านั้น

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

ขั้นตอนที่ 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

use FacebookAds\Api;
use FacebookAds\Http\RequestInterface;

$params = array(
  'is_published' => true,
);

$data = Api::instance()->call(
  '/' . <CANVAS_ID>,
  RequestInterface::METHOD_POST,
  $params)->getContent();
curl \
  -F 'is_published=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<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/v20.0/act_<AD_ACCOUNT_ID>/adcreatives
'use strict'; const bizSdk = require('facebook-nodejs-business-sdk'); const AdAccount = bizSdk.AdAccount; const AdCreative = bizSdk.AdCreative; const access_token = '<ACCESS_TOKEN>'; const app_secret = '<APP_SECRET>'; const app_id = '<APP_ID>'; const id = '<AD_ACCOUNT_ID>'; const api = bizSdk.FacebookAdsApi.init(access_token); const showDebugingInfo = true; // Setting this to true shows more debugging info. if (showDebugingInfo) { api.setDebug(true); } const logApiCallResult = (apiCallName, data) => { console.log(apiCallName); if (showDebugingInfo) { console.log('Data:' + JSON.stringify(data)); } }; let fields, params; fields = [ ]; params = { 'image_hash' : '<imageHash>', 'object_story_spec' : {'page_id':'<pageID>','link_data':{'image_hash':'<imageHash>','link':'<canvasURI>','name':'Creative message','call_to_action':{'type':'LEARN_MORE'}}}, }; const adcreatives = (new AdAccount(id)).createAdCreative( fields, params ); logApiCallResult('adcreatives api call complete.', adcreatives);
require __DIR__ . '/vendor/autoload.php'; use FacebookAds\Object\AdAccount; use FacebookAds\Object\AdCreative; use FacebookAds\Api; use FacebookAds\Logger\CurlLogger; $access_token = '<ACCESS_TOKEN>'; $app_secret = '<APP_SECRET>'; $app_id = '<APP_ID>'; $id = '<AD_ACCOUNT_ID>'; $api = Api::init($app_id, $app_secret, $access_token); $api->setLogger(new CurlLogger()); $fields = array( ); $params = array( 'image_hash' => '<imageHash>', 'object_story_spec' => array('page_id' => '<pageID>','link_data' => array('image_hash' => '<imageHash>','link' => '<canvasURI>','name' => 'Creative message','call_to_action' => array('type' => 'LEARN_MORE'))), ); echo json_encode((new AdAccount($id))->createAdCreative( $fields, $params )->exportAllData(), JSON_PRETTY_PRINT);
from facebook_business.adobjects.adaccount import AdAccount from facebook_business.adobjects.adcreative import AdCreative from facebook_business.api import FacebookAdsApi access_token = '<ACCESS_TOKEN>' app_secret = '<APP_SECRET>' app_id = '<APP_ID>' id = '<AD_ACCOUNT_ID>' FacebookAdsApi.init(access_token=access_token) fields = [ ] params = { 'image_hash': '<imageHash>', 'object_story_spec': {'page_id':'<pageID>','link_data':{'image_hash':'<imageHash>','link':'<canvasURI>','name':'Creative message','call_to_action':{'type':'LEARN_MORE'}}}, } print AdAccount(id).create_ad_creative( fields=fields, params=params, )
import com.facebook.ads.sdk.*; import java.io.File; import java.util.Arrays; public class SAMPLE_CODE_EXAMPLE { public static void main (String args[]) throws APIException { String access_token = \"<ACCESS_TOKEN>\"; String app_secret = \"<APP_SECRET>\"; String app_id = \"<APP_ID>\"; String id = \"<AD_ACCOUNT_ID>\"; APIContext context = new APIContext(access_token).enableDebug(true); new AdAccount(id, context).createAdCreative() .setImageHash(\"<imageHash>\") .setObjectStorySpec( new AdCreativeObjectStorySpec() .setFieldLinkData( new AdCreativeLinkData() .setFieldCallToAction( new AdCreativeLinkDataCallToAction() .setFieldType(AdCreativeLinkDataCallToAction.EnumType.VALUE_LEARN_MORE) ) .setFieldImageHash(\"<imageHash>\") .setFieldLink(\"<canvasURI>\") .setFieldName(\"Creative message\") ) .setFieldPageId(\"<pageID>\") ) .execute(); } }
require 'facebook_ads' access_token = '<ACCESS_TOKEN>' app_secret = '<APP_SECRET>' app_id = '<APP_ID>' id = '<AD_ACCOUNT_ID>' FacebookAds.configure do |config| config.access_token = access_token config.app_secret = app_secret end ad_account = FacebookAds::AdAccount.get(id) adcreatives = ad_account.adcreatives.create({ image_hash: '<imageHash>', object_story_spec: {'page_id':'<pageID>','link_data':{'image_hash':'<imageHash>','link':'<canvasURI>','name':'Creative message','call_to_action':{'type':'LEARN_MORE'}}}, })

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

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

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

ตั้งค่า Facebook SDK for JavaScript โปรดดู:

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

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

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

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

ชื่อต้องระบุหรือไม่คำอธิบาย

display

ได้

พารามิเตอร์ที่จำเป็นซึ่งมีค่าที่กำหนดไว้เป็น popup

method

ได้

พารามิเตอร์ที่จำเป็นซึ่งมีค่าที่กำหนดไว้เป็น instant_experiences_builder

business_id

ได้

ID ธุรกิจของคุณ

page_id

ได้

ID เพจที่คุณต้องการเชื่อมโยงกับอินสแตนท์เอ็กซ์พีเรียนซ์

canvas_id

ไม่ได้

ID ของอินสแตนท์เอ็กซ์พีเรียนซ์ที่คุณต้องการแก้ไข

คุณจะระบุหรือไม่ระบุพารามิเตอร์ 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

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

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

ชื่อต้องระบุหรือไม่คำอธิบาย

display

ได้

พารามิเตอร์ที่จำเป็นซึ่งมีค่าที่กำหนดไว้เป็น popup

method

ได้

พารามิเตอร์ที่จำเป็นซึ่งมีค่าที่กำหนดไว้เป็น instant_experiences_preview

canvas_id

ได้

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

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

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

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

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

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

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

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

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

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

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