Trải nghiệm tức thì

Trải nghiệm tức thì là một đích đến quảng cáo toàn màn hình, gần như tải ngay sau khi người dùng nhấp vào quảng cáo trên Bảng feed.

Trước khi bạn bắt đầu

Để tạo và quản lý Trải nghiệm tức thì, bạn cần:

• Có quyền pages_manage_ads
• Có quyền pages_read_engagement
• Có quyền pages_show_list
• Có khả năng thực hiện tác vụ ADVERTISE trên Trang

Giới hạn

• Bạn chỉ có thể cập nhật Trải nghiệm tức thì chưa đăng.
• Bạn có thể sử dụng API Trải nghiệm tức thì cho Instagram ở mức giới hạn.
• Facebook Stories không hỗ trợ quảng cáo sử dụng Trải nghiệm tức thì.

Tạo

Để tạo Trải nghiệm tức thì, bạn sẽ cần có ID của Trang Facebook (PAGE-ID) và bất kỳ thành phần nào (chẳng hạn như ảnh, nút và văn bản) mà bạn muốn đưa vào trải nghiệm của mình.

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

Thành phần

Xóa thành phần

Để xóa một thành phần, bạn cần gửi yêu cầu DELETE kèm theo ID của thành phần mà bạn muốn xóa.

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

Lấy Trải nghiệm tức thì có sẵn

Để lấy thông tin về một Trải nghiệm tức thì có sẵn, bạn cần có ID của Trải nghiệm tức thì đó (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>

Lấy tất cả các Trải nghiệm tức thì cho một Trang

Để lấy thông tin về tất cả Trải nghiệm tức thì hiện có cho một Trang Facebook, bạn sẽ cần có ID của Trang đó (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

Cập nhật Trải nghiệm tức thì

Để cập nhật một Trải nghiệm tức thì, bạn phải hủy đăng trải nghiệm đó, đồng thời sẽ cần có ID của Trải nghiệm tức thì (CANVAS-ID) và bất kỳ ID thành phần nào bạn muốn cập nhật.

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>

Sử dụng mẫu

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 mình.

Lấy loại thành phần cho mẫu

Bước 1. Lấy thông tin tài liệu cho mẫu

Gửi yêu cầu GET để xác định thành phần nào là cần thiết cho mẫu cụ thể, ở đây là mẫu Thu hút khách hàng mới trong ví dụ sau.

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

Phản hồi mẫu

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

Bước 2. Lấy loại thành phần

Sử dụng ID cho trường document để lấy các thành phần cụ thể có sẵn cho mẫu nhất định.

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

Danh sách được trả về hiển thị các loại thành phần có thể sử dụng trong mẫu Thu hút khách hàng mới.

    {
  "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"
}

Đăng

Để đăng quảng cáo Trải nghiệm tức thì, bạn cần gửi yêu cầu POST đến ID Trải nghiệm tức thì (CANVAS-ID) và đặt trường is_published là true.

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

Tạo nội dung quảng cáo

Tạo nội dung quảng cáo bằng liên kết cho một Trải nghiệm tức thì hiện có (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

Sau khi nội dung đã sẵn sàng, bạn có thể tiếp tục tạo nhóm quảng cáo và chiến dịch quảng cáo.

Hộp thoại quảng cáo Trải nghiệm tức thì

Bạn có thể sử dụng Hộp thoại quảng cáo Trải nghiệm tức thì để cung cấp giao diện người dùng tạo quảng cáo Trải nghiệm tức thì trên Facebook trong trang web của mình. Để biết thông tin chi tiết về thành phần giao diện người dùng, hãy xem Hộp thoại.

Nếu bạn muốn thiết lập Facebook SDK for JavaScript, hãy xem:

• Hướng dẫn bắt đầu nhanh
• Tài liệu tham khảo về cách khởi tạo

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 này sẽ hiển thị lỗi. Để đảm bảo không xảy ra lỗi, người dùng phải thuộc doanh nghiệp đó và có quyền "tạo quảng cáo" cho trang đó.

Sau đó, kích hoạt hộp thoại:

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

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

canvas_id là thông số không bắt buộc và cho phép người dùng chỉnh sửa hoặc xem trước một Trải nghiệm tức thì có sẵn. Bạn không thể chỉnh sửa một Trải nghiệm tức thì sau khi trải nghiệm đó hoàn tất. Để xem trước một Trải nghiệm tức thì, bạn nên sử dụng Hộp thoại xem trước Trải nghiệm tức thì.

Khi thành công, plugin sẽ đưa ra phản hồi sau đây:

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

ID trả về là Trải nghiệm tức thì đã đăng. Bạn hiện có thể sử dụng ID đó trong chiến dịch quảng cáo. Nếu có phản hồi undefined hoặc không có phản hồi nào được trả về, tức là người xem đã đóng hộp thoại trước khi hoàn tất Trải nghiệm tức thì. Người dùng có thể đã lưu Trải nghiệm tức thì mà chưa hoàn tất trải nghiệm đó. Bạn có thể kéo mọi Trải nghiệm tức thì thuộc một trang thông qua API Đồ thị để xem có trải nghiệm nào chưa hoàn tất không.

Xem trước Trải nghiệm tức thì

API Bản xem trước iframe

Bạn có thể tạo bản xem trước Trải nghiệm tức thì bằng cách gọi API bản xem trước (trả về một iframe, tương tự như API bản xem trước quảng cáo):

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

Phản hồi của API nêu trên có dạng như sau (bạn có thể xem phản hồi này bằng cách nhúng thành phần iframe được trả về vào 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

Bạn có thể sử dụng hộp thoại này để xem trước Trải nghiệm tức thì như khi người dùng Facebook nhìn thấy trên trang web của bạn. Để biết chi tiết về thành phần giao diện người dùng, hãy xem bài viết Hộp thoại.

Nếu bạn muốn thiết lập Facebook SDK dành cho JavaScript, hãy xem:

• Hướng dẫn bắt đầu nhanh
• Tài liệu tham khảo về cách khởi tạo

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 để xem Trải nghiệm tức thì, hộp thoại này sẽ hiển thị lỗi.

Sau đó, kích hoạt hộp thoại xem trước:

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

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

Tạo đối tượng cho Trải nghiệm tức thì

Để tạo đối tượng tương tác (đối tượng gồm những người đã tương tác với Trải nghiệm tức thì), hãy đặt thông số object_id của trường rule thành ID Trải nghiệm tức thì (CANVAS-ID) trong lệnh gọi POST /act_AD-ACCOUNT/customaudiences của bạn.

Những người đã mở Trải nghiệm tức thì

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

Những người đã nhấp vào liên kết bất kỳ trong Trải nghiệm tức thì

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

Hãy xem Đối tượng tùy chỉnh, Tài liệu tham khảo để biết thêm thông tin về đối tượng tùy chỉnh.

Trải nghiệm tức thì và quảng cáo trên Instagram

Triển khai Trải nghiệm tức thì với Instagram bằng cùng các lệnh gọi API mà bạn sử dụng cho Trải nghiệm tức thì trên Facebook. Lưu ý rằng sẽ có các giới hạn khi bạn sử dụng Instagram và Trải nghiệm tức thì:

• Vị trí quảng cáo - Có thể sử dụng cho Bảng feed Instagram và Instagram Stories. Nếu chọn Instagram Stories, bạn phải chọn vị trí này làm vị trí quảng cáo duy nhất của mình.
• Thành phần Trải nghiệm tức thì - Hỗ trợ đầy đủ đầu trang và các nhóm sản phẩm.

Chúng tôi hỗ trợ một phần các thành phần Trải nghiệm tức thì sau đây trên Instagram:

• Chân trang - Không có swipe to open; nút này hiển thị dưới dạng Tap to open trong các ứng dụng.
• Thẻ quay vòng - Không có ảnh liên kết đến Trải nghiệm tức thì khác; trong ứng dụng, định dạng này xuất hiện dưới dạng liên kết không thể nhấp vào. Đối với ảnh và video, không khớp với chiều cao, không khớp với chiều rộng hoặc nghiêng để xem thêm; ảnh/video này hiển thị dưới dạng khớp với chiều rộng.
• Nút - Không thể liên kết đến Trải nghiệm tức thì khác hoặc đến Cửa hàng ứng dụng.
• Văn bản - Không hỗ trợ ngôn ngữ RTL.
• Video - Không có video 360.
• Công cụ tìm vị trí cửa hàng - Không hỗ trợ.

Thông tin chi tiết về quảng cáo

Hãy xem bài viết Thông tin chi tiết về quảng cáo để biết thông tin tổng quan và nội dung mô tả về những số liệu hiện có.

Xem thêm

• Hướng dẫn về quảng cáo trên Facebook: Quy cách Trải nghiệm tức thì
• Trung tâm trợ giúp doanh nghiệp: Tìm hiểu về Trải nghiệm tức thì