ข้อมูลแยกย่อยเกี่ยวกับโมเดลส่วนประสมทางการตลาดใน API ข้อมูลเชิงลึก

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

การเรียกใช้ API รวมอยู่ใน API ข้อมูลเชิงลึกโดยใช้พารามิเตอร์ breakdowns=mmm โดยแตกต่างจากข้อมูลแยกย่อยข้อมูลแยกย่อยอื่นๆ ตรงที่ไม่รองรับการใช้ร่วมกับ breakdowns หรือ action_breakdowns อื่นๆ

การตอบกลับจะมีเกณฑ์ชี้วัดและข้อมูลแยกย่อยที่คล้ายกันซึ่งเป็นผลมาจากการส่งออกข้อมูลโมเดลส่วนประสมทางการตลาดในการรายงานผลโฆษณา ข้อมูลโมเดลส่วนประสมทางการตลาดจะใช้ได้เฉพาะในระดับชุดโฆษณาเท่านั้น ซึ่งเป็นลักษณะการทำงานเริ่มต้น (เทียบเท่ากับพารามิเตอร์ level=adset) ในตอนนี้ เกณฑ์ชี้วัดที่รองรับสำหรับข้อมูลโมเดลส่วนประสมทางการตลาดคือ impressions และ spendหมายเหตุ:spend เป็นเกณฑ์ชี้วัดโดยประมาณ โปรดดูข้อมูลเพิ่มเติมที่ API ข้อมูลเชิงลึก, เกณฑ์ชี้วัดโดยประมาณและเกณฑ์ชี้วัดที่เลิกใช้แล้ว

การเริ่มต้นใช้งานอย่างง่าย

วิธีการรับข้อมูลโมเดลส่วนประสมทางการตลาด:

curl \
  -F "access_token=ACCESS_TOKEN" \ 
  -F "breakdowns=mmm" \ 
  "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/insights"

API ข้อมูลเชิงลึกจะใช้ค่าเริ่มต้นสำหรับพารามิเตอร์ที่ไม่ได้ระบุไว้ในการเรียกใช้ เราขอแนะนำให้ใช้พารามิเตอร์ time_range และ date_preset คุณสามารถเพิ่มความละเอียดของการตอบกลับให้มากยิ่งขึ้นได้โดยใช้ time_increment

ตัวอย่าง

การเรียกใช้ API นี้ได้รับข้อมูลโมเดลส่วนประสมทางการตลาดรายวันสำหรับสัปดาห์ที่ผ่านมา:

curl \
  -F "access_token=ACCESS_TOKEN" \ 
  -F "breakdowns=mmm" \ 
  -F "date_preset=last_7d" \ 
  -F "time_increment=1” \ 
  "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/insights"

หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับ API ข้อมูลเชิงลึกและวิธีเริ่มต้นใช้งาน API การตลาด โปรดดูที่การเริ่มต้นใช้งานอย่างง่ายสำหรับ API ข้อมูลเชิงลึก

การสืบค้นในระดับตัวจัดการธุรกิจ

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

1. หากต้องการดาวน์โหลดข้อมูลสำหรับตัวจัดการธุรกิจ คุณต้องสืบค้นบัญชีโฆษณาที่มีอยู่ด้วยตำแหน่งข้อมูล owned_ad_accounts และ client_ad_accounts

   curl \
     -F "access_token=ACCESS_TOKEN" \ 
     "https://graph.facebook.com/v21.0/BUSINESS_ID/owned_ad_accounts"
   

   curl \
     -F "access_token=ACCESS_TOKEN" \ 
     "https://graph.facebook.com/v21.0/BUSINESS_ID/client_ad_accounts"
   

2. วนซ้ำ ID บัญชีโฆษณาแต่ละรายการที่ส่งคืนเพื่อสืบค้นข้อมูลโมเดลส่วนประสมทางการตลาดสำหรับบัญชีโฆษณาแต่ละบัญชี

ขีดจำกัดและหลักปฏิบัติที่ดีที่สุด

ความละเอียดของข้อมูลโมเดลส่วนประสมทางการตลาดทำให้การตอบกลับมีรายการข้อมูลจำนวนมากและรายการข้อมูลมีขนาดใหญ่ ซึ่งอาจทำให้คำขอของคุณหมดเวลาลงระหว่างการประมวลผล เพื่อบรรเทาปัญหานี้ ให้ลดขนาดของคำขอโดยใช้ time_range และ filtering และสืบค้นช่วงเวลาทั้งหมดในส่วนต่างๆ หากต้องการข้อมูลเพิ่มเติม โปรดดูที่ขีดจำกัดและแนวทางปฏิบัติที่ดีที่สุดของ API ข้อมูลเชิงลึก

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

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

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

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