API Marketing

Đối tượng tùy chỉnh tương tác

Tạo đối tượng tùy chỉnh dựa trên những người đã tương tác với nội dung của bạn trên Facebook hoặc Instagram. Các loại đối tượng hiện được hỗ trợ là Trang, trang kinh doanh trên Instagram, quảng cáo tìm kiếm khách hàng tiềm năng, quảng cáo Trải nghiệm tức thì, Mua sắm và thực tế tăng cường.

Hướng dẫn này mô tả API bằng cách dùng đối tượng tương tác với Trang làm ví dụ. Facebook cập nhật đối tượng tùy chỉnh dựa trên hoạt động tương tác với Trang bằng cách liên tục thêm những người dùng tương tác với Trang của bạn. Vào lần đầu bạn tạo đối tượng này, Facebook sẽ điền sẵn danh sách những người dùng đã tương tác với Trang của bạn trong một khoảng thời gian giữ chân cụ thể.

  • Kể từ tháng 09/2018, chúng tôi không hỗ trợ subtype cho đối tượng tùy chỉnh của trang web, ứng dụng, đối tượng tùy chỉnh tương tác và đối tượng từ dữ liệu chuyển đổi offline. Tuy nhiên, subtype vẫn được hỗ trợ cho đối tượng tùy chỉnh tương tác của video.

  • Nếu bạn tạo đối tượng đến từ châu Âu hoặc nhắm mục tiêu những người ở châu Âu, hãy xem phần Thay đổi không có trong phiên bản ngày 02/12/2020 của chúng tôi.

Tạo đối tượng

Để tạo đối tượng tùy chỉnh tương tác, tài khoản quảng cáo của bạn phải chấp nhận Điều khoản dịch vụ dành cho đối tượng tùy chỉnh trong Trình quản lý quảng cáo.

Cách tạo một đối tượng gồm những người dùng đã tương tác với Trang của bạn dựa trên sự kiện page_engaged:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

Thông số

TênMô tả

name

chuỗi

Bắt buộc.
Tên đối tượng tùy chỉnh.

rule

Đối tượng JSON

Bắt buộc.
Quy tắc để xác định đối tượng. Quy tắc này tuân theo cú pháp tương tự như cú pháp của đối tượng tùy chỉnh từ trang web.

Đối tượng tùy chỉnh tương tác là các loại đối tượng tùy chỉnh. Để biết tất cả các trường có sẵn, hãy xem Tài liệu tham khảo về Đối tượng tùy chỉnh.

Lưu ý: Mỗi tài khoản quảng cáo có thể tạo tối đa 500 đối tượng tùy chỉnh tương tác.

Quy tắc tương tác

Bạn có thể sử dụng Quy tắc đối tượng để xác định xem Facebook có thêm người nào đó vào đối tượng tùy chỉnh hay không.

Hãy chỉ định các trường type và id bên trong event_sources thuộc quy tắc để biểu thị type và id của đối tượng tương tác. Trường id lấy một ID đối tượng hoặc mảng ID cùng loại.

Dưới đây là các nguồn sự kiện được hỗ trợ và ID đối tượng tương tác tương ứng:

  • page: ID trang Facebook.
  • lead: ID mẫu tìm kiếm khách hàng tiềm năng.
  • ig_lead_generation: ID mẫu tìm kiếm khách hàng tiềm năng.
  • canvas: ID canvas.
  • ig_business: ID trang kinh doanh trên Instagram.
  • shopping_page: ID Trang Cửa hàng trên Facebook.
  • shopping_ig: ID Cửa hàng trên Instagram.
  • ar_experience: Trải nghiệm tức thì sử dụng hiệu ứng AR.
  • ar_effects: Hiệu ứng bạn sở hữu trên Facebook hoặc Instagram, không bao gồm các hiệu ứng được dùng trong quảng cáo.

Mỗi quy tắc gồm có một object_id và một event_name.

Trang

Đặt object_id là ID Trang của bạn. Trong event_name, hãy sử dụng một trong những sự kiện tương tác sau:

  • page_engaged: Những người dùng đã truy cập vào Trang của bạn hoặc tương tác với nội dung hay quảng cáo bất kỳ trên Trang đó, trên Facebook hoặc Messenger. Đây là loại tương tác bao quát nhất và bao gồm tất cả các loại tương tác khác.
  • page_visited: Những người dùng đã truy cập vào Trang của bạn.
  • page_liked: Những người dùng hiện thích Trang của bạn. (Xem thông tin chi tiết về tỷ lệ giữ chân và các quy tắc liên quan đến lượt thích trang.)
  • page_messaged: Những người dùng đã gửi tin nhắn cho Trang của bạn.
  • page_cta_clicked: Những người dùng đã nhấp vào nút kêu gọi hành động bất kỳ trên Trang của bạn (ví dụ: "Liên hệ với chúng tôi" hoặc "Mua ngay").
  • page_or_post_save: Những người dùng đã lưu Trang của bạn hoặc bất kỳ bài viết nào trên Trang đó.
  • page_post_interaction: Những người dùng đã tương tác với bất kỳ bài viết nào trên Trang của bạn. Hoạt động tương tác bao gồm bày tỏ cảm xúc (ví dụ: Thích, Yêu thích, Haha, Wow, Buồn, Phẫn nộ), chia sẻ, bình luận, click vào liên kết hoặc vuốt thẻ quay vòng.

Quảng cáo tìm kiếm khách hàng tiềm năng

Đặt object_id là FORM_ID và đặt rule để theo dõi một trong những sự kiện sau của quảng cáo tìm kiếm khách hàng tiềm năng:

  • lead_generation_submitted: Tất cả những người dùng đã hoàn tất và gửi mẫu.
  • lead_generation_dropoff: Tất cả những người dùng đóng mẫu mà không gửi đi. Họ có thể đã điền hoặc chưa điền vào bất kỳ trường nào.
  • lead_generation_opened: Tất cả những người dùng đã mở mẫu tìm kiếm khách hàng tiềm năng, bất kể họ có gửi mẫu hay không.

Trải nghiệm tức thì

Đặt object_id thành "CANVAS_ID". rule sẽ theo dõi một trong những sự kiện sau:

  • instant_shopping_document_open
  • instant_shopping_document_pause
  • instant_shopping_document_resume
  • instant_shopping_document_close
  • instant_shopping_did_scroll
  • instant_shopping_element_click
  • instant_shopping_element_impression

Trang kinh doanh trên Instagram

object_id phải là "INSTAGRAM_BUSINESS_PROFILE_ID" và rule phải theo dõi một trong những sự kiện sau trong trang kinh doanh trên Instagram:

  • ig_business_profile_all: Những người dùng đã truy cập vào trang kinh doanh trên Instagram hoặc đã tương tác với nội dung hay quảng cáo bất kỳ trong trang kinh doanh trên Instagram của bạn. Đây là loại tương tác bao quát nhất và bao gồm tất cả các loại tương tác khác. Đó là một tổ hợp gồm ig_business_profile_engaged, ig_user_messaged_business và ig_user_messaged_business.
  • ig_business_profile_engaged: Những người dùng tương tác với trang kinh doanh trên Instagram hoặc đã tương tác với nội dung hay quảng cáo bất kỳ trong trang kinh doanh trên Instagram của bạn.
  • ig_user_messaged_business: Những người dùng đã nhắn tin cho trang kinh doanh trên Instagram của bạn.
  • ig_business_profile_visit: Những người dùng đã truy cập vào trang kinh doanh trên Instagram của bạn.
  • ig_business_profile_ad_saved: Những người dùng đã lưu nội dung tự nhiên hoặc một quảng cáo từ trang kinh doanh trên Instagram của bạn.
  • ig_ad_like
  • ig_ad_comment
  • ig_ad_share
  • ig_ad_save
  • ig_ad_cta_click
  • ig_ad_carousel_swipe
  • ig_organic_like
  • ig_organic_comment
  • ig_organic_share
  • ig_organic_save
  • ig_organic_swipe
  • ig_organic_carousel_swipe

Loại Người tạo file phương tiện trên Instagram hiện không được hỗ trợ cho quá trình tạo đối tượng tùy chỉnh tương tác với video.

Mua sắm

Quy tắc tương tác mua sắm sẽ theo dõi một trong những sự kiện sau:

  • VIEW_CONTENT: Những người đã xem trang thông tin về sản phẩm của bạn. Tùy chọn này hiện có trên toàn cầu.
  • ADD_TO_CART: Những người đã thêm sản phẩm của bạn vào giỏ hàng. Chỉ doanh nghiệp hỗ trợ tính năng thanh toán và chỉ người tiêu dùng ở Hoa Kỳ mới có thể sử dụng tùy chọn này.
  • PURCHASE: Những người đã mua sản phẩm của bạn. Chỉ doanh nghiệp hỗ trợ tính năng thanh toán và chỉ người tiêu dùng ở Hoa Kỳ mới có thể sử dụng tùy chọn này.

Cách tạo quy tắc để thêm những người dùng đã xem sản phẩm của bạn:

curl -i -X POST
-F 'name="test_api"'\
-F 'rule= {
	"inclusions": {
		"operator": "or",
		"rules": [
			{
				"event_sources": [
					{
						"id": "<ID>",
						"type": "shopping_ig"
					}
				]
				"retention_seconds": <RETENTION_SECONDS>,
				"filter": {
					"operator": "and",
					"filters": [
						{
						"field":"event",
						"operator":"eq",
						"value": "VIEW_CONTENT"
						}
					]
				}
			}
		]
	}
}
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

Thông số page_messaged và ig_user_messaged_business có thể không sử dụng được ở châu Âu do các quy tắc mới về quyền riêng tư.

Thực tế tăng cường

Đối tượng tùy chỉnh tương tác từ thực tế tăng cường có thể gồm 2 phần: trải nghiệm AR và hiệu ứng AR.

  • Đối với đối tượng tùy chỉnh tương tác từ trải nghiệm AR, hãy đặt object_id là ID vùng chứa dữ liệu quảng cáo AR và sử dụng ar_camera_open hoặc camera_cta_click cho trường event_name.
  • Đối với đối tượng tùy chỉnh tương tác từ hiệu ứng AR, hãy đặt object_id là ID hiệu ứng AR và sử dụng ar_effect_open cho trường event_name.

Số ngày giữ chân tối đa

Đối với các yêu cầu về pháp lý và quyền riêng tư, chúng tôi cho phép sử dụng số ngày giữ chân tối đa khác nhau cho từng loại nguồn sự kiện như sau:

  • Quảng cáo tìm kiếm khách hàng tiềm năng: 90 ngày
  • Trang kinh doanh trên Instagram: 730 ngày
  • Trang: 730 ngày
  • Trải nghiệm tức thì, trước đây gọi là Canvas: 730 ngày
  • Mua sắm: 365 ngày. Dữ liệu này có từ tháng 04/2020.
  • Thực tế tăng cường: 365 ngày

Quy tắc tương tác với phần loại trừ

Quy tắc đối tượng tương tác tương thích với quy tắc đối tượng tùy chỉnh từ trang web. Do đó, các quy tắc này có thể có nhiều quy tắc bao gồm và loại trừ. Người dùng khớp với ít nhất một trong các quy tắc đó sẽ được thêm vào đối tượng.

Trong ví dụ dưới đây, chúng tôi tạo một đối tượng gồm những người dùng đã truy cập vào trang hoặc tương tác với trang của bạn, nhưng loại trừ những người dùng đã nhấp vào nút kêu gọi hành động:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       },
       "exclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_cta_clicked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

Để biết thêm thông tin, hãy xem phần Đối tượng tùy chỉnh từ trang web của bạn.

Nhiều quy tắc

Đối tượng tương tác có thể có nhiều quy tắc. Người dùng khớp với ít nhất một trong các quy tắc đó sẽ được thêm vào đối tượng. Sau đây là ví dụ về cách tạo đối tượng gồm những người dùng đã nhắn tin cho trang của bạn hoặc nhấp vào nút kêu gọi hành động:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 },
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

Nhiều trang

Các quy tắc không chỉ giới hạn ở một trang. Bạn có thể có trang khác nhau cho mỗi quy tắc và những người đã tương tác với tối thiểu một trong các trang đó sẽ được bao gồm trong đối tượng.

Sau đây là ví dụ về đối tượng bao gồm tất cả những người đã truy cập ít nhất 1 trong 3 trang:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               },
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

Để biết chi tiết về Đối tượng tùy chỉnh, hãy xem Tài liệu tham khảo về Đối tượng tùy chỉnh.

Quy tắc và tỷ lệ giữ chân cho lượt thích Trang

Đối tượng lượt thích Trang không có tỷ lệ giữ chân (retention_seconds=0). Bạn cũng không thể kết hợp quy tắc lượt thích Trang với các sự kiện khác trên Trang.

Ví dụ dưới đây minh họa cách tạo đối tượng lượt thích Trang:

curl -X POST \
  -F 'name="Page Likes Audience Name"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 0,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_liked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences