คุณสามารถจัดกลุ่มผลลัพธ์ของ API ข้อมูลเชิงลึกเป็นชุดต่างๆ โดยใช้ข้อมูลแยกย่อยได้
API ข้อมูลเชิงลึกสามารถส่งคืนเกณฑ์ชี้วัดได้หลายเกณฑ์ที่เป็นแบบโดยประมาณ อยู่ระหว่างการพัฒนา หรือทั้งสองอย่าง ค่าของข้อมูลแยกย่อยสำหรับข้อมูลเชิงลึกจะเป็นแบบโดยประมาณ โปรดดูข้อมูลเพิ่มเติมที่ API ข้อมูลเชิงลึก, เกณฑ์ชี้วัดโดยประมาณและเกณฑ์ชี้วัดที่เลิกใช้แล้ว
คุณไม่สามารถส่งคำขอช่องต่อไปนี้เมื่อระบุข้อมูลแยกย่อย:
app_store_clicks
newsfeed_avg_position
newsfeed_clicks
relevance_score
newsfeed_impressions
ข้อมูลแยกย่อยต่อไปนี้จะใช้งานไม่ได้อีกต่อไปสำหรับเกณฑ์ชี้วัดการดำเนินการภายนอก Meta
region
dma
hourly_stats_aggregated_by_audience_time_zone
hourly_stats_aggregated_by_advertiser_time_zone
action_device
action_destination
action_target_id
product_id
action_carousel_card_id/action_carousel_card_name
action_canvas_component_name
กฎที่เกี่ยวข้องกับการสืบค้นที่ประกอบด้วยข้อมูลแยกย่อยข้างต้น:
หมายเหตุ: ระบบจะยังคงรองรับข้อมูลแยกย่อยตามรายการข้างต้นสำหรับเกณฑ์ชี้วัดบน Meta เช่น อิมเพรสชั่น การคลิกลิงก์ ฯลฯ อีกทั้งการเปลี่ยนแปลงนี้จะไม่ส่งผลกระทบต่อข้อมูลย้อนหลังก่อนวันที่ 27 เมษายน 2021 โดยข้อมูลแยกย่อยของข้อมูลย้อนหลังจะยังคงใช้งานได้ต่อไป
เกณฑ์ชี้วัดจะใช้งานไม่ได้ภายใต้สถานการณ์ต่อไปนี้
หมายเหตุ: เกณฑ์ชี้วัดจะใช้งานได้หากมีการสืบค้นด้วย action_attribution_windows=1d_click,7d_click,1d_view
(ไม่รวมช่วงเริ่มต้น)
ข้อมูลแยกย่อยต่อไปนี้สามารถใช้งานได้
ข้อมูลแยกย่อย | คำอธิบาย |
---|---|
| อุปกรณ์ที่เกิดเหตุการณ์คอนเวอร์ชั่นที่คุณกำลังติดตามอยู่ ตัวอย่างเช่น \"Desktop\" หากมีคนทำคอนเวอร์ชั่นบนคอมพิวเตอร์เดสก์ท็อป |
| ชื่อของส่วนประกอบภายในโฆษณา Canvas |
| ID ของการ์ดโฆษณาแบบภาพสไลด์แบบเฉพาะเจาะจงที่ผู้คนมีส่วนร่วมเมื่อเห็นโฆษณาของคุณ |
| การ์ดโฆษณาแบบภาพสไลด์แบบเฉพาะเจาะจงที่ผู้คนมีส่วนร่วมเมื่อเห็นโฆษณาของคุณ พาดหัวจะเป็นตัวระบุการ์ดดังกล่าว |
| ปลายทางที่ผู้คนจะไปหลังจากคลิกที่โฆษณาของคุณ ซึ่งอาจเป็นเพจ Facebook ของคุณ, URL ภายนอกสำหรับพิกเซลคอนเวอร์ชั่นของคุณ หรือแอพที่ได้รับการกำหนดค่าด้วยชุดพัฒนาซอฟต์แวร์ (SDK) ก็ได้ |
| จำนวนความรู้สึกที่มีต่อโฆษณาหรือโพสต์ที่ได้รับการโปรโมทของคุณ ปุ่ม "ความรู้สึก" บนโฆษณาทำให้ผู้คนสามารถแสดงความรู้สึกต่างๆ ต่อเนื้อหา เช่น ถูกใจ, รักเลย, ฮ่าๆ, ว้าว, เศร้า หรือโกรธ |
| ID ของปลายทางที่ผู้คนจะไปหลังจากคลิกที่โฆษณาของคุณ ซึ่งอาจเป็นเพจ Facebook ของคุณ, URL ภายนอกสำหรับพิกเซลคอนเวอร์ชั่นของคุณ หรือแอพที่ได้รับการกำหนดค่าด้วยชุดพัฒนาซอฟต์แวร์ (SDK) ก็ได้ |
| ประเภทของการดำเนินการที่เกิดขึ้นกับโฆษณา เพจ แอพ หรือเหตุการณ์ของคุณหลังมีการนำเสนอโฆษณาต่อบุคคลหนึ่ง แม้ว่าบุคคลนั้นจะไม่ได้คลิกที่โฆษณาดังกล่าวก็ตาม โดยประเภทของการดำเนินการจะรวมถึงการกดถูกใจเพจ จำนวนการติดตั้งแอพ คอนเวอร์ชั่น การตอบรับงานกิจกรรม และอื่นๆ |
| สถานะของเสียง (เปิด/ปิด) เมื่อมีคนเล่นโฆษณาแบบวิดีโอของคุณ |
| ข้อมูลแยกย่อยเกี่ยวกับเกณฑ์ชี้วัดของวิดีโอ |
| ID ขององค์ประกอบในส่วนรูปแบบโฆษณาซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ |
| ช่วงอายุของผู้คนที่คุณเข้าถึง |
| ID ของแอพพลิเคชั่นที่เกี่ยวข้องกับบัญชีโฆษณาหรือแคมเปญที่ได้รับการส่งคำขอ คุณสามารถดูข้อมูลแอพพลิเคชั่น รวมถึง ID ของแอพพลิเคชั่นได้ในแดชบอร์ดของแอพ ข้อมูลแยกย่อยนี้ใช้ได้กับช่อง |
| ID ขององค์ประกอบในส่วนเนื้อความซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ |
| ID ขององค์ประกอบในส่วนการกระตุ้นให้ดำเนินการซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ |
| ประเทศที่พำนักของผู้คนที่คุณเข้าถึง โดยจะขึ้นอยู่กับข้อมูลต่างๆ เช่น เมืองเกิด เมืองปัจจุบัน และตำแหน่งที่ตั้งทางภูมิศาสตร์ที่บุคคลดังกล่าวน่าจะพำนักอยู่ในขณะเข้าชม Meta |
| ID ขององค์ประกอบในส่วนคำอธิบายซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ |
| ประเภทของอุปกรณ์ ไม่ว่าจะเป็นแบบมือถือหรือเดสก์ท็อปที่ผู้คนใช้ในขณะดูหรือคลิกที่โฆษณาดังที่แสดงอยู่ในการรายงานผลโฆษณา |
| ภูมิภาค Designated Market Area (DMA) คือ พื้นที่ทางภูมิศาสตร์ 210 แห่งในสหรัฐอเมริกา ซึ่ง The Nielsen Company ใช้วัดการรับชมโทรทัศน์ในท้องถิ่น |
| จำนวนครั้งที่นำเสนอโฆษณาในแคมเปญการเข้าถึงและความถี่ของคุณกับแต่ละบัญชีในศูนย์บัญชี |
| เพศของผู้คนที่คุณเข้าถึง ระบบจะแสดงผู้คนที่ไม่ระบุข้อมูลเพศไว้เป็น "ไม่ระบุ" |
| ข้อมูลแยกย่อยรายชั่วโมงที่รวบรวมตามเวลาที่แสดงโฆษณาในโซนเวลาของผู้ลงโฆษณา ตัวอย่างเช่น หากคุณกำหนดเวลาให้แสดงโฆษณาตั้งแต่ 9:00 น. ถึง 11:00 น. แต่โฆษณาดังกล่าวเข้าถึงกลุ่มเป้าหมายในหลายโซนเวลา แสดงว่าโฆษณานั้นอาจแสดงตั้งแต่ 9:00 น. ถึง 13:00 น. ในโซนเวลาของผู้ลงโฆษณา ระบบจะรวบรวมสถิติโดยแบ่งออกเป็น 4 กลุ่ม ได้แก่ 9:00 น. ถึง 10:00 น., 10:00 น. ถึง 11:00 น., 11:00 น. ถึง 12:00 น. และ 12:00 น. ถึง 13:00 น. |
| ข้อมูลแยกย่อยรายชั่วโมงที่รวบรวมตามเวลาที่แสดงโฆษณาในโซนเวลาของกลุ่มเป้าหมาย ตัวอย่างเช่น หากคุณกำหนดเวลาให้แสดงโฆษณาตั้งแต่ 9:00 น. ถึง 11:00 น. แต่โฆษณาดังกล่าวเข้าถึงกลุ่มเป้าหมายในหลายโซนเวลา แสดงว่าโฆษณานั้นอาจแสดงตั้งแต่ 9:00 น. ถึง 13:00 น. ในโซนเวลาของผู้ลงโฆษณา ทั้งนี้ สถิติจะได้รับการรวบรวมโดยแบ่งเป็น 2 กลุ่ม ได้แก่ 9:00 น. ถึง 10:00 น. กับ 10:00 น. ถึง 11:00 น. |
| ID ขององค์ประกอบในส่วนรูปภาพซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ |
| อุปกรณ์ที่มีการแสดงโฆษณาล่าสุดของคุณแก่คนบน Meta ตัวอย่างเช่น \"iPhone\" หากมีคนดูโฆษณาของคุณบน iPhone |
| แฟล็กบูลีนที่ระบุว่า ข้อมูลแยกย่อยนี้ใช้ได้กับช่อง |
| ID ขององค์ประกอบในส่วน URL ซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ |
| ID ของหน้าสถานที่ซึ่งเกี่ยวข้องกับอิมเพรสชั่นหรือการคลิก ข้อมูลเชิงลึกระดับบัญชีและ |
| ตำแหน่งที่โฆษณาของคุณแสดงขึ้นภายในแพลตฟอร์ม เช่น ฟีดบนเดสก์ท็อปของ Facebook หรือฟีดบนมือถือของ Instagram |
| ID ของสินค้าซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ |
| แพลตฟอร์มที่แสดงโฆษณาของคุณ เช่น บน Facebook, Instagram หรือ Audience Network |
| ภูมิภาคที่พำนักของผู้คนที่คุณเข้าถึง โดยจะขึ้นอยู่กับข้อมูลต่างๆ เช่น เมืองเกิด เมืองปัจจุบัน และตำแหน่งที่ตั้งทางภูมิศาสตร์ที่บุคคลดังกล่าวน่าจะพำนักอยู่ในขณะเข้าชม Facebook |
| ID แคมเปญแบบดิบที่ได้รับโดยเป็นส่วนหนึ่งของโพสต์ย้อนกลับ Skan จาก iOS 15 ขึ้นไป หมายเหตุ: ข้อมูลแยกย่อยนี้ใช้ได้กับช่อง |
| ID คอนเวอร์ชั่นที่กำหนด (หรือที่เรียกว่า ID ลำดับความสำคัญ) ของเหตุการณ์และ/หรือชุดเหตุการณ์ได้รับการกำหนดค่าในสกีมาสำหรับการกำหนดค่า SKAdNetwork ของแอพพลิเคชั่น โดยคุณสามารถดูและปรับเปลี่ยนการกำหนดค่าเหตุการณ์ในแอพได้ในตัวจัดการเหตุการณ์ของ Meta คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับการกำหนดค่าเหตุการณ์ในแอพของคุณให้กับ SKAdNetwork ของ Apple ได้ที่นี่ หมายเหตุ: ข้อมูลแยกย่อยนี้ใช้ได้กับช่อง |
| ID ขององค์ประกอบในส่วนชื่อซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ |
| เซกเมนต์ผู้ใช้ (เช่น ใหม่, ที่มีอยู่) ของแคมเปญช้อปปิ้ง Advantage+ (ASC) ผู้ใช้ที่มีอยู่จะได้รับการระบุโดยกลุ่มเป้าหมายที่กำหนดเองในการตั้งค่า ASC |
| ID ขององค์ประกอบในส่วนวิดีโอซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ |
หมายเหตุ
app_id
และ skan_conversion_id
ด้วยช่อง filtering
dma
ไม่มีให้ใช้งานสำหรับเกณฑ์ชี้วัด estimated_ad_recall_rate
หรือเกณฑ์ชี้วัด video_thruplay_watched_actions
dma
ใช้วิธีการสุ่มตัวอย่างเพื่อคำนวณเกณฑ์ชี้วัดเฉพาะอย่างการเข้าถึง ในกรณีที่มีภูมิภาค DMA ที่มีปริมาณค่อนข้างต่ำอยู่เป็นจำนวนมาก ภูมิภาคดังกล่าวอาจไม่แสดงในตัวอย่างหรืออาจได้รับการขยายขนาดเป็นยกกำลัง 2 ได้ ดังนั้นเราจึงแนะนำให้สืบค้นอิมเพรสชั่นที่เกี่ยวข้องด้วย ทั้งนี้ก็เพื่อให้มีความแม่นยำมากขึ้นfrequency_value
ใช้กับ reach
เท่านั้น ตัวอย่างเช่น ความถี่ที่ผู้ใช้ที่ไม่ซ้ำกันเห็นโฆษณาimage_asset
และ video_asset
ได้รับการกำหนดให้ไม่สามารถใช้กับองค์ประกอบที่ใช้ในชิ้นงานโฆษณาแบบไดนามิกในระดับบัญชีโฆษณาได้video_p25_watched_actions
, video_p50_watched_actions
, video_p75_watched_actions
, video_p95_watched_actions
และ video_p100_watched_actions
ไม่รองรับข้อมูลแยกย่อย region
ข้อมูลแยกย่อยของชิ้นงานโฆษณาแบบไดนามิก | เกณฑ์ชี้วัดที่รองรับสำหรับข้อมูลแยกย่อยของชิ้นงานโฆษณาแบบไดนามิก |
---|---|
|
|
การเรียกใช้ต่อไปนี้จะจัดกลุ่มผลลัพธ์ตาม age
และ gender
curl -G \
-d "breakdowns=age,gender" \
-d "fields=impressions" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"
สถิติรายชั่วโมงพร้อมให้ใช้งานแล้วในข้อมูลแยกย่อย โดยการใช้งานข้อมูลแยกย่อยต่อไปนี้:
hourly_stats_aggregated_by_advertiser_time_zone
hourly_stats_aggregated_by_audience_time_zone
โปรดอ่านการรวมข้อมูลแยกย่อยเพื่อดูขีดจำกัดของจำนวนข้อมูลแยกย่อยที่คุณสามารถขอได้ด้วยข้อมูลแยกย่อยรายชั่วโมง ข้อมูลแยกย่อยรายชั่วโมงไม่รองรับช่องที่ไม่ซ้ำกัน ซึ่งก็คือช่องใดก็ตามที่ขึ้นต้นด้วย unique_*
, reach
หรือ frequency
โดยช่อง reach
และ frequency
จะส่งค่าคืนมาเป็น 0 ขณะที่ข้อมูลแยกย่อยรายชั่วโมงอยู่ระหว่างใช้งาน
curl -G \
-d "fields=impressions" \
-d "breakdowns=hourly_stats_aggregated_by_audience_time_zone" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"
จัดกลุ่มผลลัพธ์ในช่อง actions
คุณสามารถใช้ข้อมูลแยกย่อยต่อไปนี้สำหรับ action_breakdowns
ได้:
ข้อมูลแยกย่อยที่สามารถเติมลงในช่อง action_breakdowns
ได้มีดังนี้
action_device
conversion_destination
matched_persona_id
matched_persona_name
signal_source_bucket
standard_event_content_type
action_canvas_component_name
action_carousel_card_id
action_carousel_card_name
action_destination
action_reaction
action_target_id
action_type
action_video_sound
action_video_type
หากไม่ได้ระบุพารามิเตอร์ action_breakdowns
ไว้ ระบบจะเพิ่ม action_type
เป็น action_breakdowns
โดยปริยาย
actions
จำนวนทั้งหมด (จำนวนรวม) ของค่าทั้งหมดที่ส่งคืนมาในผลลัพธ์แบบกลุ่ม (actions
)
ผลลัพธ์นี้อาจไม่เท่ากับ total_actions
เนื่องจากช่องที่ส่งคืนใน actions
มีลักษณะเป็นลำดับชั้น และรวมการดำเนินการอย่างละเอียดที่ไม่ได้นับไว้ด้วย
total_actions - 33 page_engagement - 10 post_engagement - 10 link_click - 2 comment - 3 post_reaction - 3 like - 2 mobile_app_install - 12 app_custom_event - 11 app_custom_event.fb_mobile_activate_app - 6 app_custom_event.other - 5
ในตัวอย่างนี้ post_engagement
คือผลรวมของ link_click
, comment
, like
และ post_reaction
โดยที่ post_reaction
คือจำนวนของความรู้สึกทั้งหมด ซึ่งรวมถึงการกดถูกใจ ในขณะที่ช่อง total_actions
คือผลรวมของการดำเนินการระดับสูงสุดสำหรับอ็อบเจ็กต์ เช่น page_engagement
, mobile_app_install
และ app_custom_event
การเรียงสับเปลี่ยนข้อมูลแยกย่อยจะมีให้บริการเพียงบางประเภทเท่านั้นเนื่องจากข้อจำกัดในการจัดเก็บข้อมูล การเรียงสับเปลี่ยนที่มีเครื่องหมายดอกจัน (*) กำกับอยู่สามารถนำมาใช้ร่วมกับ action_type
, action_target_id
และ action_destination
ซึ่งเป็นชื่อสำหรับ action_target_id
ได้
การเรียงสับเปลี่ยน |
---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
video_*
ได้ด้วยข้อมูลแยกย่อยที่เป็นสถิติรายชั่วโมงvideo_avg_time_watched_actions
ได้ด้วยข้อมูลแยกย่อยตามภูมิภาคaction_type
เป็น action_breakdowns
โดยปริยายเมื่อไม่ได้ระบุพารามิเตอร์ action_breakdowns