ข้อมูลแยกย่อยของ API ข้อมูลเชิงลึก

คุณสามารถจัดกลุ่มผลลัพธ์ของ API ข้อมูลเชิงลึกเป็นชุดต่างๆ โดยใช้ข้อมูลแยกย่อยได้

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

ข้อจำกัด

ช่องที่ไม่พร้อมใช้งาน

คุณไม่สามารถส่งคำขอช่องต่อไปนี้เมื่อระบุข้อมูลแยกย่อย:

  • app_store_clicks
  • newsfeed_avg_position
  • newsfeed_clicks
  • relevance_score
  • newsfeed_impressions

ข้อจำกัดสำหรับเกณฑ์ชี้วัดการดำเนินการภายนอก Meta

ข้อมูลแยกย่อยต่อไปนี้จะใช้งานไม่ได้อีกต่อไปสำหรับเกณฑ์ชี้วัดการดำเนินการภายนอก Meta โดยยกเว้นเกณฑ์ชี้วัดสำหรับแคมเปญของแอพที่กำหนดเป้าหมายเป็น Android, iOS 14.4 ลงไป, เว็บ และการจัดรูปแบบ SKAN (SKAN modeled) โดยเฉพาะ

ข้อมูลแยกย่อยของชิ้นงานโฆษณาแบบไดนามิก

  • ad_format_asset
  • body_asset
  • call_to_action_asset
  • description_asset
  • image_asset
  • link_url_asset
  • title_asset
  • video_asset

ประเภทที่ 1

  • region
  • dma
  • hourly_stats_aggregated_by_audience_time_zone
  • hourly_stats_aggregated_by_advertiser_time_zone
  • action_device
  • platform_position
  • publisher_platform
  • action_target_id

ประเภทที่ 2

  • product_id
  • action_carousel_card_id/action_carousel_card_name

กฎที่เกี่ยวข้องกับข้อมูลแยกย่อยข้างต้น:

  • ประเภทที่ 1 - ระบบจะใส่ค่าของข้อมูลแยกย่อยเหล่านี้ในที่เก็บข้อมูล "ไม่รู้จัก" หรือ "ไม่ได้กำหนดหมวดหมู่" (เช่น targetId จะมีค่าเป็น 0)
  • ประเภทที่ 2 — API ข้อมูลเชิงลึกจะไม่ส่งคืนแถวใดๆ หากการสืบค้นมีข้อมูลแยกย่อยนี้พร้อมกับเกณฑ์ชี้วัดภายนอก (เช่น เกณฑ์ชี้วัดการดำเนินการที่มีข้อมูลแยกย่อยประเภทที่ 2)

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

เกณฑ์ชี้วัดการดำเนินการ

เกณฑ์ชี้วัดจะใช้งานไม่ได้ภายใต้สถานการณ์ต่อไปนี้

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

หมายเหตุ: เกณฑ์ชี้วัดจะใช้งานได้หากมีการสืบค้นด้วย action_attribution_windows=1d_click,7d_click,1d_view (ไม่รวมช่วงเริ่มต้น)

ข้อมูลแยกย่อยทั่วไป

ข้อมูลแยกย่อยต่อไปนี้สามารถใช้งานได้

ข้อมูลแยกย่อยคำอธิบาย

action_device

อุปกรณ์ที่เกิดเหตุการณ์คอนเวอร์ชั่นที่คุณกำลังติดตามอยู่ ตัวอย่างเช่น \"Desktop\" หากมีคนทำคอนเวอร์ชั่นบนคอมพิวเตอร์เดสก์ท็อป

action_canvas_component_name

ชื่อของส่วนประกอบภายในโฆษณา Canvas

action_carousel_card_id

ID ของการ์ดโฆษณาแบบภาพสไลด์แบบเฉพาะเจาะจงที่ผู้คนมีส่วนร่วมเมื่อเห็นโฆษณาของคุณ

action_carousel_card_name

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

action_destination

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

action_reaction

จำนวนความรู้สึกที่มีต่อโฆษณาหรือโพสต์ที่ได้รับการโปรโมทของคุณ ปุ่ม "ความรู้สึก" บนโฆษณาทำให้ผู้คนสามารถแสดงความรู้สึกต่างๆ ต่อเนื้อหา เช่น ถูกใจ, รักเลย, ฮ่าๆ, ว้าว, เศร้า หรือโกรธ

action_target_id

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

action_type

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

action_video_sound

สถานะของเสียง (เปิด/ปิด) เมื่อมีคนเล่นโฆษณาแบบวิดีโอของคุณ

action_video_type

ข้อมูลแยกย่อยเกี่ยวกับเกณฑ์ชี้วัดของวิดีโอ

ad_format_asset

ID ขององค์ประกอบในส่วนรูปแบบโฆษณาซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ

age

ช่วงอายุของผู้คนที่คุณเข้าถึง

app_id

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


ข้อมูลแยกย่อยนี้ใช้ได้กับช่อง total_postbacks เท่านั้น

body_asset

ID ขององค์ประกอบในส่วนเนื้อความซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ

call_to_action_asset

ID ขององค์ประกอบในส่วนการกระตุ้นให้ดำเนินการซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ

country

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

description_asset

ID ขององค์ประกอบในส่วนคำอธิบายซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ

device_platform

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

dma

ภูมิภาค Designated Market Area (DMA) คือ พื้นที่ทางภูมิศาสตร์ 210 แห่งในสหรัฐอเมริกา ซึ่ง The Nielsen Company ใช้วัดการรับชมโทรทัศน์ในท้องถิ่น

frequency_value

จำนวนครั้งที่นำเสนอโฆษณาในแคมเปญการเข้าถึงและความถี่ของคุณกับแต่ละบัญชีในศูนย์บัญชี

gender

เพศของผู้คนที่คุณเข้าถึง ระบบจะแสดงผู้คนที่ไม่ระบุข้อมูลเพศไว้เป็น "ไม่ระบุ"

hourly_stats_aggregated_by_advertiser_time_zone

ข้อมูลแยกย่อยรายชั่วโมงที่รวบรวมตามเวลาที่แสดงโฆษณาในโซนเวลาของผู้ลงโฆษณา ตัวอย่างเช่น หากคุณกำหนดเวลาให้แสดงโฆษณาตั้งแต่ 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 น.

hourly_stats_aggregated_by_audience_time_zone

ข้อมูลแยกย่อยรายชั่วโมงที่รวบรวมตามเวลาที่แสดงโฆษณาในโซนเวลาของกลุ่มเป้าหมาย ตัวอย่างเช่น หากคุณกำหนดเวลาให้แสดงโฆษณาตั้งแต่ 9:00 น. ถึง 11:00 น. แต่โฆษณาดังกล่าวเข้าถึงกลุ่มเป้าหมายในหลายโซนเวลา แสดงว่าโฆษณานั้นอาจแสดงตั้งแต่ 9:00 น. ถึง 13:00 น. ในโซนเวลาของผู้ลงโฆษณา ทั้งนี้ สถิติจะได้รับการรวบรวมโดยแบ่งเป็น 2 กลุ่ม ได้แก่ 9:00 น. ถึง 10:00 น. กับ 10:00 น. ถึง 11:00 น.

image_asset

ID ขององค์ประกอบในส่วนรูปภาพซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ

impression_device

อุปกรณ์ที่มีการแสดงโฆษณาล่าสุดของคุณแก่คนบน Meta ตัวอย่างเช่น \"iPhone\" หากมีคนดูโฆษณาของคุณบน iPhone

is_conversion_id_modeled

แฟล็กบูลีนที่ระบุว่า conversion_bits ได้รับการจัดรูปแบบหรือไม่ โดย 0 เป็นการระบุว่า conversion_bits ไม่ได้รับการจัดรูปแบบ ส่วน 1 เป็นการระบุว่า conversion_bits ได้รับการจัดรูปแบบ


ข้อมูลแยกย่อยนี้ใช้ได้กับช่อง total_postbacks_detailed เท่านั้น

link_url_asset

ID ขององค์ประกอบในส่วน URL ซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ

place_page_id

ID ของหน้าสถานที่ซึ่งเกี่ยวข้องกับอิมเพรสชั่นหรือการคลิก


ข้อมูลเชิงลึกระดับบัญชีและ page_place_id ไม่สามารถทำงานร่วมกันได้ ดังนั้น คุณจึง **ไม่สามารถสืบค้น 2 สิ่งนี้ร่วมกันได้

platform_position

ตำแหน่งที่โฆษณาของคุณแสดงขึ้นภายในแพลตฟอร์ม เช่น ฟีดบนเดสก์ท็อปของ Facebook หรือฟีดบนมือถือของ Instagram

product_id

ID ของสินค้าซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ

publisher_platform

แพลตฟอร์มที่แสดงโฆษณาของคุณ เช่น บน Facebook, Instagram หรือ Audience Network

region

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

skan_campaign_id

ID แคมเปญแบบดิบที่ได้รับโดยเป็นส่วนหนึ่งของโพสต์ย้อนกลับ Skan จาก iOS 15 ขึ้นไป


หมายเหตุ: ข้อมูลแยกย่อยนี้ใช้ได้กับช่อง total_postbacks_detailed เท่านั้น

skan_conversion_id

ID คอนเวอร์ชั่นที่กำหนด (หรือที่เรียกว่า ID ลำดับความสำคัญ) ของเหตุการณ์และ/หรือชุดเหตุการณ์ได้รับการกำหนดค่าในสกีมาสำหรับการกำหนดค่า SKAdNetwork ของแอพพลิเคชั่น โดยคุณสามารถดูและปรับเปลี่ยนการกำหนดค่าเหตุการณ์ในแอพได้ในตัวจัดการเหตุการณ์ของ Meta คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับการกำหนดค่าเหตุการณ์ในแอพของคุณให้กับ SKAdNetwork ของ Apple ได้ที่นี่


หมายเหตุ: ข้อมูลแยกย่อยนี้ใช้ได้กับช่อง total_postbacks เท่านั้น

title_asset

ID ขององค์ประกอบในส่วนชื่อซึ่งเกี่ยวข้องกับอิมเพรสชั่น การคลิก หรือการดำเนินการ

user_segment_key

เซกเมนต์ผู้ใช้ (เช่น ใหม่, ที่มีอยู่) ของแคมเปญช้อปปิ้ง Advantage+ (ASC) ผู้ใช้ที่มีอยู่จะได้รับการระบุโดยกลุ่มเป้าหมายที่กำหนดเองในการตั้งค่า ASC

video_asset

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
  • ข้อมูลแยกย่อยขององค์ประกอบชิ้นงานโฆษณาแบบไดนามิกทั้งหมดรองรับเฉพาะชุดเกณฑ์ชี้วัดแบบจำกัดเท่านั้น:
ข้อมูลแยกย่อยของชิ้นงานโฆษณาแบบไดนามิกเกณฑ์ชี้วัดที่รองรับสำหรับข้อมูลแยกย่อยของชิ้นงานโฆษณาแบบไดนามิก
  • ad_format_asset
  • body_asset
  • call_to_action_asset
  • description_asset
  • image_asset
  • link_url_asset
  • title_asset
  • video_asset
  • impressions
  • clicks
  • spend
  • reach
  • actions
  • action_values

การเรียกใช้ต่อไปนี้จะจัดกลุ่มผลลัพธ์ตาม 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 ได้

การเรียงสับเปลี่ยน

action_converted_product_id - มีความพร้อมใช้งานแบบจำกัดสำหรับโฆษณาร่วม

action_type *

action_type, action_converted_product_id - มีความพร้อมใช้งานแบบจำกัดสำหรับโฆษณาร่วม

action_target_id *

action_device *

action_device, impression_device *

action_device, publisher_platform *

action_device, publisher_platform, impression_device *

action_device, publisher_platform, platform_position *

action_device, publisher_platform, platform_position, impression_device *

action_reaction

action_type, action_reaction

age *

gender *

age, gender *

app_id, skan_conversion_id

country *

region *

publisher_platform *

publisher_platform, impression_device *

publisher_platform, platform_position *

publisher_platform, platform_position, impression_device *

product_id *

hourly_stats_aggregated_by_advertiser_time_zone *

hourly_stats_aggregated_by_audience_time_zone *

action_carousel_card_id / action_carousel_card_name

action_carousel_card_id / action_carousel_card_name

action_carousel_card_id / action_carousel_card_name, impression_device

action_carousel_card_id / action_carousel_card_name, country

action_carousel_card_id / action_carousel_card_name, age

action_carousel_card_id / action_carousel_card_name, gender

action_carousel_card_id / action_carousel_card_name, age, gender

ข้อจำกัด

  • ผู้ใช้ไม่สามารถส่งคำขอช่อง video_* ได้ด้วยข้อมูลแยกย่อยที่เป็นสถิติรายชั่วโมง
  • ผู้ใช้ไม่สามารถส่งคำขอช่อง video_avg_time_watched_actions ได้ด้วยข้อมูลแยกย่อยตามภูมิภาค
  • ระบบจะเพิ่ม action_type เป็น action_breakdowns โดยปริยายเมื่อไม่ได้ระบุพารามิเตอร์ action_breakdowns