API การตลาด

API ข้อมูลเชิงลึกของโฆษณา

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

ก่อนที่คุณจะเริ่ม

ในการเข้าถึง API ข้อมูลเชิงลึกของโฆษณา คุณจะต้องมีสิ่งต่อไปนี้

คุณควรตั้งค่าโฆษณาให้ติดตามการดำเนินการที่คุณสนใจด้วย ซึ่งคุณสามารถใช้เครื่องมือต่างๆ เช่น API คอนเวอร์ชั่นหรือพิกเซลของ Meta เพื่อดำเนินการตั้งค่าดังกล่าวได้

การเรียกใช้ API ข้อมูลเชิงลึกของโฆษณา

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

แหล่งข้อมูลแสดง

/{ad-account-id}/insights

ข้อมูลเชิงลึกจากบัญชีโฆษณา

/{campaign-id}/insights

ข้อมูลเชิงลึกจากแคมเปญโฆษณา

/{ad-set-id}/insights

ข้อมูลเชิงลึกจากชุดโฆษณา

/{ad-id}/insights

ข้อมูลเชิงลึกจากโฆษณา

โดยค่าเริ่มต้นแล้ว คำขอ GET จะส่งคืนเกณฑ์ชี้วัดพื้นฐานสำหรับอ็อบเจ็กต์โฆษณา ซึ่งมักจะมาจาก 30 วันที่ผ่านมา

ตัวอย่างคำขอ

curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights"

ตัวอย่างการตอบกลับ:

{
  "data": [
    {
      "account_id": "<AD_ACCOUNT_ID>",
      "campaign_id": "<CAMPAIGN_ID>",
      "date_start": "2025-03-14",
      "date_stop": "2025-04-12",
      "impressions": "361324",
      "spend": "5339.5"
    }
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

การปรับแต่งคำขอ

คุณสามารถรับข้อมูลที่เฉพาะเจาะจงมากขึ้นได้โดยการระบุองค์ประกอบหลัก 3 อย่างในคำขอ ซึ่งได้แก่ พารามิเตอร์ (เพื่อระบุรายละเอียดต่างๆ เช่น ช่วงเวลา ช่วงการระบุที่มา ฯลฯ), ช่อง (เช่น เกณฑ์ชี้วัด) และข้อมูลแยกย่อย ตัวอย่างเช่น หากต้องการทราบจำนวนการคลิก (ทั้งหมด) ที่แบ่งตามตามเพศซึ่งเกิดขึ้นในช่วง 7 วันสุดท้ายของแคมเปญ คุณอาจระบุข้อมูลดังนี้

  • พารามิเตอร์: date_preset=last_7d
  • ช่อง: clicks
  • ข้อมูลแยกย่อย: gender

ตัวอย่างคำขอ

curl -G \ -d "date_preset=last_7d" \ -d "fields=clicks" \ -d "breakdowns=gender" \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights"

ตัวอย่างการตอบกลับ

{
  "data": [
    {
      "clicks": "7346",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "female"
    },
    {
      "clicks": "3788",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "male"
    },
    {
      "clicks": "79",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "unknown"
    },
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

เรียนรู้เพิ่มเติม

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

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

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