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

มีอินเทอร์เฟซหนึ่งเดียวที่สอดคล้องกันเพื่อเรียกดูสถิติของโฆษณา

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

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

การอัพเดต iOS 14.5

เราตอบรับนโยบายใหม่ของ Apple ด้วยการประกาศการเปลี่ยนแปลงที่มีผลต่อการทำงานต่างๆ ซึ่งจะส่งผลกระทบต่อช่วงการระบุที่มา

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

ตำแหน่งข้อมูลที่ได้รับผลกระทบ

GET /{ad-account-id}/insights
GET /{ad-id}/insights
GET /{ad-set-id}/insights
GET /{campaign-id}/insights
POST /{ad-account-id}/insights
POST /{ad-id}/insights
POST /{ad-set-id}/insights
POST /{campaign-id}/insights

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

คุณจะต้องดำเนินการดังต่อไปนี้

สิทธิ์การอนุญาต ads_read
แอพ โปรดดูข้อมูลเพิ่มเติมที่การพัฒนาแอพบน Meta

สถิติแคมเปญ

หากต้องการดูสถิติเกี่ยวกับประสิทธิภาพ 7 วันล่าสุดของแคมเปญ:

curl -G \
  -d "date_preset=last_7d" \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/API_VERSION/AD_CAMPAIGN_ID/insights"

หากต้องการเรียนรู้เพิ่มเติม โปรดดูข้อมูลอ้างอิงเกี่ยวกับข้อมูลเชิงลึกของโฆษณา

การเรียก

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

เมธอดของ API
`act_<AD_ACCOUNT_ID>/insights`
`<CAMPAIGN_ID>/insights`
`<ADSET_ID>/insights`
`<AD_ID>/insights`

คำขอ

คุณสามารถส่งคำขอช่องที่เฉพาะเจาะจงได้ด้วยรายการที่คั่นด้วยเครื่องหมายจุลภาคในพารามิเตอร์ fields ตัวอย่างเช่น:

curl -G \
-d "fields=impressions" \
-d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/v21.0/AD_OBJECT_ID/insights"

การตอบกลับ

{
  "data": [
    {
      "impressions": "2466376",
      "date_start": "2009-03-28",
      "date_stop": "2016-04-01"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MAZDZD"
    }
  }
}

ระดับ

รวมผลลัพธ์ที่ระดับอ็อบเจ็กต์ที่กำหนด การดำเนินการนี้จะแยกข้อมูลที่ซ้ำซ้อนออกโดยอัตโนมัติ

คำขอ

ตัวอย่างเช่น รับข้อมูลเชิงลึกของแคมเปญในระดับโฆษณา

curl -G \
-d "level=ad" \
-d "fields=impressions,ad_id" \
-d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/v21.0/CAMPAIGN_ID/insights"

การตอบกลับ

{
  "data": [
    {
      "impressions": "9708",
      "ad_id": "6142546123068",
      "date_start": "2009-03-28",
      "date_stop": "2016-04-01"
    },
    {
      "impressions": "18841",
      "ad_id": "6142546117828",
      "date_start": "2009-03-28",
      "date_stop": "2016-04-01"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MQZDZD"
    }
  }
}

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

ช่วงการระบุที่มา

การอัพเดตสำหรับ iOS 14 ขึ้นไป

เมื่อไม่ได้ตั้งค่า action_attribution_windows ค่าการระบุที่มาเริ่มต้นจะเป็น 7d_click และ 1d_view เมื่อมีการเริ่มบังคับใช้ จำนวนการดูในช่วง 28 วันจะไม่สามารถใช้ได้อีกต่อไปและจะส่งคืนข้อมูลว่างเปล่ากลับมา
สำหรับโฆษณาเดิมที่ไม่มีการใช้งานและมีค่าของช่วง 28 วัน เราจะส่งคืนข้อมูลนี้ให้
สำหรับช่วงเริ่มต้นหรือระดับบัญชี ค่าจะถูกตั้งเป็น 7 วันหลังมีการบังคับใช้
ระบบเลิกใช้ช่อง use_account_attribution_setting แล้ว เราจะเปลี่ยนคำขอดังกล่าวเป็น action_attribution_windows ซึ่งเป็นค่าเริ่มต้นของ 7d_click และ 1d_view

โปรดไปที่บันทึกการเปลี่ยนแปลงของการเปลี่ยนแปลงที่มีผลต่อการทำงานเพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงที่สืบเนื่องมาจาก iOS 14

ช่วงการระบุที่มาของคอนเวอร์ชั่นจะแสดงกรอบเวลาซึ่งกำหนดเวลาที่เราจะระบุว่าเหตุการณ์มีที่มาจากโฆษณาบนแอพ Meta โปรดดูข้อมูลความเป็นมาที่ศูนย์ช่วยเหลือทางธุรกิจของ Meta, เกี่ยวกับช่วงการระบุที่มา เราวัดผลการดำเนินการที่เกิดขึ้นขณะเกิดเหตุการณ์คอนเวอร์ชั่น และย้อนกลับไปดูในช่วง 1 วันและ 7 วันที่ผ่านมา หากต้องการดูการดำเนินการที่มาจากช่วงการระบุที่มาต่างๆ ให้ส่งคำขอไปยัง /{ad-account-id}/insights หากคุณไม่ได้ระบุ action_attribution_windows เราจะใช้ 7d_click และระบุไว้ใน value

เช่น ระบุ action_attribution_windows และตั้ง "ค่า" ให้เป็นช่วงการระบุที่มา 7d_click ส่งคำขอไปยัง act_10151816772662695/insights?action_attribution_windows=['1d_click','1d_view'] และรับผลลัพธ์นี้:

"spend": 2352.45,
"actions": [
{
"action_type": "link_click",
"value": 6608,
"1d_view": 86,
"1d_click": 6510
},
"cost_per_action_type": [
{
"action_type": "link_click",
"value": 0.35600030266344,
"1d_view": 27.354069767442,
"1d_click": 0.36135944700461
},

// if attribution window is _not_ specified in query. And note that the number under 'value' key is the same even if attribution window is specified.
// act_10151816772662695/insights
"spend": 2352.45,
"actions": [
{
"action_type": "link_click",
"value": 6608
},
"cost_per_action_type": [
{
"action_type": "link_click",
"value": 0.35600030266344
},

การขยายเงื่อนไขในช่อง

ส่งคำขอช่องที่ระดับโหนดและตามช่องที่ระบุในการขยายเงื่อนไขในช่อง:

คำขอ

curl -G \
-d "fields=insights{impressions}" \
-d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/v21.0/AD_ID"

การตอบกลับ

{
  "id": "6042542123268",
  "name": "My Website Clicks Ad",
  "insights": {
    "data": [
      {
        "impressions": "9708",
        "date_start": "2016-03-06",
        "date_stop": "2016-04-01"
      }
    ],
    "paging": {
      "cursors": {
        "before": "MAZDZD",
        "after": "MAZDZD"
      }
    }
  }
}

การเรียงลำดับ

จัดเรียงผลลัพธ์โดยระบุพารามิเตอร์sortเป็น {fieldname}_descending หรือ {fieldname}_ascending:

คำขอ

curl -G \
-d "sort=reach_descending" \
-d "level=ad" \
-d "fields=reach" \
-d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/v21.0/AD_SET_ID/insights"

การตอบกลับ


{
  "data": [
    {
      "reach": 10742,
      "date_start": "2009-03-28",
      "date_stop": "2016-04-01"
    },
    {
      "reach": 5630,
      "date_start": "2009-03-28",
      "date_stop": "2016-04-03"
    },
    {
      "reach": 3231,
      "date_start": "2009-03-28",
      "date_stop": "2016-04-02"
    },
    {
      "reach": 936,
      "date_start": "2009-03-29",
      "date_stop": "2016-04-02"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MQZDZD"
    }
  }
}

ป้ายโฆษณา

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

คำขอ

curl -G \  
-d "fields=id,name,insights{unique_clicks,cpm,total_actions}" \
-d "level=ad" \
-d 'filtering=[{"field":"ad.adlabels","operator":"ANY", "value":["Label Name"]}]'  \
-d 'time_range={"since":"2015-03-01","until":"2015-03-31"}' \
-d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/v21.0/AD_OBJECT_ID/insights"

การตอบกลับ

{
  "data": [
    {
      "unique_clicks": 74,
      "cpm": 0.81081081081081,
      "total_actions": 49,
      "date_start": "2015-03-01",
      "date_stop": "2015-03-31",
    },
  ], 
  "paging": {
    "cursors": {
      "before": "MA==",
      "after": "MA==",
    }
  }
}

คำนิยามเกี่ยวกับจำนวนคลิก

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

การคลิกลิงก์, actions:link_click - จำนวนการคลิกลิงก์โฆษณาเพื่อเลือกปลายทางหรือประสบการณ์ต่างๆ ไม่ว่าจะภายในหรือภายนอกทรัพย์สินที่ Meta เป็นเจ้าของ โปรดดูศูนย์ช่วยเหลือโฆษณา, จำนวนคลิกลิงก์
การคลิก (ทั้งหมด), clicks - เกณฑ์ชี้วัดจะนับการคลิกโฆษณาของคุณหลากหลายประเภท ซึ่งรวมถึงการโต้ตอบบางประเภทกับแหล่งรวมโฆษณา ลิงก์ไปยังปลายทางอื่นๆ และลิงก์ไปยังประสบการณ์โฆษณาที่ขยายเพิ่มเติม โปรดดูศูนย์ช่วยเหลือโฆษณา, การคลิก (ทั้งหมด)

อ็อบเจ็กต์ที่ลบและจัดเก็บแล้ว

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

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

ทั้งนี้ คุณก็สามารถรับสถิติของอ็อบเจ็กต์ที่ARCHIVEDจากโหนดหลักได้ด้วย โดยระบุพารามิเตอร์filteringเพิ่มเติม

คำขอ

หากต้องการดูสถิติของโฆษณาที่ ARCHIVED ทั้งหมดในบัญชีโฆษณาโดยแสดงทีละรายการ:

curl -G \
  -d "level=ad" \
  -d "filtering=[{'field':'ad.effective_status','operator':'IN','value':['ARCHIVED']}]" \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights/"

การตอบกลับ

โปรดทราบว่าเฉพาะอ็อบเจ็กต์ที่จัดเก็บเท่านั้นที่จะแสดงในการตอบกลับนี้

{
  "data": [
    {
      "impressions": "1741",
      "date_start": "2016-03-11",
      "date_stop": "2016-03-12"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MAZDZD"
    }
  }
}

ข้อมูลเชิงลึกของอ็อบเจ็กต์ที่ถูกลบ

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

คำขอ

ยกตัวอย่างเช่น หากคุณมี ID ชุดโฆษณา ให้ดำเนินการดังนี้

curl -G \
-d "fields=id,name,status,insights{impressions}" \
-d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/v21.0/AD_SET_ID"

ในตัวอย่างนี้ เราสืบค้นด้วย ad.effective_status:

POST https://graph.facebook.com/<VERSION>/act_ID/insights?access_token=token&appsecret_proof=proof&fields=ad_id,impressions&date_preset=lifetime&level=ad&filtering=[{"field":"ad.effective_status","operator":"IN","value":["DELETED"]}]

การตอบกลับ

{
  "id": "6042147342661",
  "name": "My Like Campaign",
  "status": "DELETED",
  "insights": {
    "data": [
      {
        "impressions": "1741",
        "date_start": "2016-03-11",
        "date_stop": "2016-03-12"
      }
    ],
    "paging": {
      "cursors": {
        "before": "MAZDZD",
        "after": "MAZDZD"
      }
    }
  }
}

การแก้ไขปัญหา

การหมดเวลา

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

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

คำแนะนำ

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

การจำกัดอัตรา

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

ความคลาดเคลื่อนกับตัวจัดการโฆษณา

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

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

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