กลุ่มเป้าหมายที่กำหนดเองสำหรับการมีส่วนร่วม

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

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

สร้างกลุ่มเป้าหมาย

หากต้องการสร้างกลุ่มเป้าหมายที่กำหนดเองสำหรับการมีส่วนร่วม บัญชีโฆษณาของคุณต้องยอมรับข้อกำหนดในการใช้บริการสำหรับกลุ่มเป้าหมายที่กำหนดเองในตัวจัดการโฆษณา

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

พารามิเตอร์

กลุ่มเป้าหมายที่กำหนดเองสำหรับการมีส่วนร่วมเป็นประเภทของกลุ่มเป้าหมายที่กำหนดเอง ดูช่องที่ใช้ได้ทั้งหมดในข้อมูลอ้างอิงของกลุ่มเป้าหมายที่กำหนดเอง

หมายเหตุ: บัญชีโฆษณาแต่ละบัญชีสามารถสร้างกลุ่มเป้าหมายที่กำหนดเองสำหรับการมีส่วนร่วมได้สูงสุด 500 รายการ

กฎการมีส่วนร่วม

คุณสามารถกำหนดให้ Facebook เพิ่มคนลงในกลุ่มเป้าหมายที่กำหนดเองหรือไม่ด้วยกฎของกลุ่มเป้าหมาย

ระบุช่อง type และ id ภายใน event_sources ในกฎเพื่อระบุ type และ id ของอ็อบเจ็กต์การมีส่วนร่วม ช่อง id ใช้ ID อ็อบเจ็กต์เดียวหรืออาร์เรย์ของ ID ประเภทเดียวกัน

ต่อไปนี้คือแหล่งที่มาของเหตุการณ์และ ID อ็อบเจ็กต์การมีส่วนร่วมที่สอดคล้องกันที่รองรับ

• page: ID เพจ Facebook
• lead: ID แบบฟอร์มข้อมูลลูกค้า
• ig_lead_generation: ID แบบฟอร์มข้อมูลลูกค้า
• canvas: ID แคนวาส
• ig_business: ID ของโปรไฟล์ Instagram Business
• shopping_page: ID เพจร้านค้าบน Facebook
• shopping_ig: ID ร้านค้าบน Instagram
• ar_experience: อินสแตนท์เอ็กซ์พีเรียนซ์ที่ใช้เอ็ฟเฟ็กต์ AR
• ar_effects: เอ็ฟเฟ็กต์ Facebook หรือ Instagram ที่คุณเป็นเจ้าของ ซึ่งไม่รวมเอ็ฟเฟ็กต์ที่ใช้ในโฆษณา

แต่ละกฎจะมี object_id และ event_name

เพจ

ตั้งค่า object_id เป็น ID เพจของคุณ ทั้งนี้ ให้ใช้เหตุการณ์การมีส่วนร่วมรายการใดรายการหนึ่งต่อไปนี้ภายใต้ event_name

• page_engaged: ผู้คนที่เข้าชมเพจของคุณหรือมีส่วนร่วมกับเนื้อหาหรือโฆษณาบนเพจของคุณใน Facebook หรือ Messenger ซึ่งการมีส่วนร่วมประเภทนี้มีความครอบคลุมที่สุดและรวมถึงการมีส่วนร่วมประเภทอื่นๆ ทั้งหมด
• page_visited: ผู้คนที่เข้าชมเพจของคุณ
• page_liked: ผู้คนที่กดถูกใจเพจของคุณในปัจจุบัน (ดูรายละเอียดเกี่ยวกับการเก็บรักษาข้อมูลและกฎที่เกี่ยวข้องกับการกดถูกใจเพจ)
• page_messaged: ผู้คนที่ส่งข้อความถึงเพจของคุณ
• page_cta_clicked: ผู้คนที่คลิกปุ่มกระตุ้นให้ดำเนินการบนเพจของคุณ (เช่น "ติดต่อเรา" หรือ "ช้อปเลย")
• page_or_post_save: ผู้คนที่บันทึกเพจหรือโพสต์บนเพจของคุณ
• page_post_interaction: ผู้คนที่โต้ตอบกับโพสต์บนเพจของคุณ การโต้ตอบประกอบไปด้วยการแสดงความรู้สึก (ได้แก่ ถูกใจ, รักเลย, ฮ่าๆ, ว้าว, เศร้า, โกรธ) การแชร์ ความคิดเห็น การคลิกลิงก์ หรือการปัดภาพสไลด์

โฆษณาข้อมูลลูกค้า

ตั้งค่า object_id เป็น FORM_ID และตั้งค่า rule เพื่อติดตามเหตุการณ์โฆษณาแบบกรอกฟอร์มรายการใดรายการหนึ่งต่อไปนี้

• lead_generation_submitted: ผู้ใช้ทั้งหมดที่กรอกแบบฟอร์มเสร็จสิ้นและส่งแล้ว
• lead_generation_dropoff: ทุกคนที่ปิดแบบฟอร์มโดยไม่ได้ส่ง ผู้คนเหล่านี้อาจกรอกหรือไม่ได้กรอกแบบฟอร์มเลยแม้แต่ช่องเดียวก็ได้
• lead_generation_opened: ทุกคนที่เปิดแบบฟอร์มการรวบรวมข้อมูลลูกค้า ไม่ว่าจะส่งแบบฟอร์มหรือไม่ก็ตาม

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

ตั้งค่า object_id เป็น "CANVAS_ID"rule ควรติดตามเหตุการณ์ใดเหตุการณ์หนึ่งต่อไปนี้:

• 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

โปรไฟล์ Instagram Business

object_id ควรจะเป็น "INSTAGRAM_BUSINESS_PROFILE_ID" และ rule ควรติดตามเหตุการณ์ของโปรไฟล์ Instagram Business รายการใดรายการหนึ่งต่อไปนี้

• ig_business_profile_all: ผู้คนที่เข้าชมโปรไฟล์ Instagram Business ของคุณหรือมีส่วนร่วมกับเนื้อหาหรือโฆษณาของโปรไฟล์ Instagram Business ของคุณ ซึ่งการมีส่วนร่วมประเภทนี้มีความครอบคลุมที่สุดและรวมถึงการมีส่วนร่วมประเภทอื่นๆ ทั้งหมด โดยเป็นการรวม ig_business_profile_engaged, ig_user_messaged_business และ ig_user_messaged_business
• ig_business_profile_engaged: ผู้คนที่มีส่วนร่วมกับโปรไฟล์ Instagram Business ของคุณหรือมีส่วนร่วมกับเนื้อหาหรือโฆษณาของโปรไฟล์ Instagram Business ของคุณ
• ig_user_messaged_business: ผู้คนที่ส่งข้อความถึงโปรไฟล์ Instagram Business ของคุณ
• ig_business_profile_visit: ผู้คนที่เข้าชมโปรไฟล์ Instagram Business ของคุณ
• ig_business_profile_ad_saved: ผู้คนที่บันทึกเนื้อหาหรือโฆษณาแบบออร์แกนิกจากโปรไฟล์ Instagram Business ของคุณ
• 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

การช้อปปิ้ง

กฎการมีส่วนร่วมสำหรับการช้อปปิ้งควรติดตามเหตุการณ์ใดเหตุการณ์หนึ่งต่อไปนี้:

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

วิธีสร้างกฎที่เพิ่มผู้คนที่ดูสินค้าของคุณมีดังนี้

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

Augmented Reality

กลุ่มเป้าหมายที่กำหนดเองสำหรับการมีส่วนร่วมใน Augmented Reality สามารถประกอบด้วย 2 ส่วน ได้แก่ ประสบการณ์การใช้งาน AR และเอ็ฟเฟ็กต์ AR

• สำหรับกลุ่มเป้าหมายที่กำหนดเองสำหรับการมีส่วนร่วมในประสบการณ์การใช้งาน AR ให้ตั้งค่า object_id เป็น ID คอนเทนเนอร์ข้อมูลโฆษณา AR และสำหรับช่อง event_name ให้ใช้ ar_camera_open หรือ camera_cta_click อย่างใดอย่างหนึ่ง
• สำหรับกลุ่มเป้าหมายที่กำหนดเองสำหรับการมีส่วนร่วมในเอ็ฟเฟ็กต์ AR ให้ตั้งค่า object_id เป็น ID เอ็ฟเฟ็กต์ AR และใช้ ar_effect_open สำหรับช่อง event_name

จำนวนวันสูงสุดของอัตราการใช้งานต่อเนื่อง

เนื่องด้วยข้อกำหนดทางกฎหมายและความเป็นส่วนตัว จำนวนวันสูงสุดที่เราอนุญาตให้คุณเก็บรักษาข้อมูลสำหรับแหล่งที่มาของเหตุการณ์แต่ละประเภทจะเป็นดังนี้:

• โฆษณาการรวบรวมข้อมูลลูกค้า: 90 วัน
• โปรไฟล์ Instagram Business: 730 วัน
• เพจ: 730 วัน

  • หมายเหตุ: กลุ่มเป้าหมายสำหรับการกดถูกใจเพจไม่มีการเก็บรักษาข้อมูล
• อินสแตนท์เอ็กซ์พีเรียนซ์ (เดิมเรียกว่าแคนวาส): 730 วัน
• การช้อปปิ้ง: 365 วัน ข้อมูลพร้อมใช้งานตั้งแต่เดือนเมษายน 2020
• Augmented reality: 365 วัน

กฎการมีส่วนร่วมที่มีส่วนการยกเว้น

กฎของกลุ่มเป้าหมายสำหรับการมีส่วนร่วมใช้งานได้กับกฎของกลุ่มเป้าหมายที่กำหนดเองของเว็บไซต์ ดังนั้นจึงอาจมีกฎการคัดเข้าและคัดออกได้หลายข้อ ระบบจะเพิ่มผู้ใช้ที่ตรงกับกฎอย่างน้อย 1 ข้อลงในกลุ่มเป้าหมาย

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

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

ดูข้อมูลเพิ่มเติมที่กลุ่มเป้าหมายที่กำหนดเองจากเว็บไซต์ของคุณ

กฎหลายข้อ

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

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

หลายเพจ

กฎไม่ได้จำกัดสำหรับเพจเดียว คุณสามารถใช้แต่ละกฎกับเพจต่างๆ ได้ และเราจะรวมผู้คนที่มีส่วนร่วมกับเพจอย่างน้อย 1 เพจลงในกลุ่มเป้าหมาย

ต่อไปนี้คือตัวอย่างของกลุ่มเป้าหมายที่รวมผู้คนทั้งหมดที่เข้าชมเพจอย่างน้อย 1 เพจจาก 3 เพจ:

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

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

การเก็บรักษาข้อมูลและกฎของการกดถูกใจเพจ

กลุ่มเป้าหมายสำหรับการกดถูกใจเพจไม่มีการเก็บรักษาข้อมูล (retention_seconds=0) นอกจากนี้ กฎของการกดถูกใจเพจไม่สามารถใช้ร่วมกับเหตุการณ์ของเพจอื่นๆ ได้

ต่อไปนี้คือตัวอย่างของการสร้างกลุ่มเป้าหมายสำหรับการกดถูกใจเพจ

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