คู่มือ Taboola API: Backstage Endpoints, การยืนยันตัวตน และการใช้งานจริง

Taboola Backstage API ช่วยให้คุณทำงานทุกอย่างในบัญชีของคุณเองได้โดยอัตโนมัติ — แคมเปญ, ครีเอทีฟ, รายงาน นี่คือขั้นตอนการยืนยันตัวตน, endpoints สำคัญ, สิ่งที่ผู้ซื้อโฆษณาจริงๆ นำไปทำอัตโนมัติ และแหล่งข้อมูลเชิงแข่งขันที่ Backstage จะไม่แสดงให้คุณเห็น

ทีม OpenAdLibraryวิจัยข่าวกรองโฆษณาและโฆษณาเนทีฟ

21 สิงหาคม 2569 · อ่าน 6 นาที

ภาพประกอบบรรณาธิการ: คู่มือ Taboola API: Backstage Endpoints, การยืนยันตัวตน และการใช้งานจริง

Taboola API — หรือชื่ออย่างเป็นทางการคือ Backstage API — คือ REST interface ของ Taboola สำหรับผู้โฆษณา คุณยืนยันตัวตนด้วย OAuth 2.0 client credentials จากนั้นอ่านและเขียนทุกสิ่งที่คุณสามารถจัดการได้ใน Ads Console: แคมเปญ, รายการครีเอทีฟ, การกำหนดกลุ่มเป้าหมาย, งบประมาณ และรายงานประสิทธิภาพ ทั้งหมดอยู่ภายใต้ https://backstage.taboola.com/backstage/api/1.0/{account_id}/… มันเป็นชั้นที่ผู้ซื้อสื่อใช้เพื่อทำให้การเปลี่ยนแปลง bid และงบประมาณ, อัปโหลดครีเอทีฟเป็นชุด, ซิงค์ค่าใช้จ่ายไปยังคลังข้อมูล และสร้างเครื่องมือกฎที่ UI ของ Taboola ไม่ได้ให้มา สิ่งที่มันจงใจไม่เปิดเผยคือข้อมูลของคนอื่น — สำหรับมุมมองเชิงแข่งขันของเครือข่าย คุณต้องการ API ที่แตกต่างไปโดยสิ้นเชิง ซึ่งเราจะกล่าวถึงในตอนท้าย

สิ่งที่ Backstage API คลอบคลุม#

Backstage สะท้อนคอนโซลผู้โฆษณาได้เกือบจะหนึ่งต่อหนึ่ง ในทางปฏิบัติ มีสี่พื้นที่ที่ทำงานส่วนใหญ่:

การจัดการแคมเปญ สร้าง, อ่าน, อัปเดต และหยุดแคมเปญชั่วคราว; กำหนด CPC, งบประมาณรายวันและทั้งหมด, การกำหนดกลุ่มเป้าหมายตามภูมิศาสตร์/แพลตฟอร์ม และการบล็อกเว็บไซต์ สิ่งใดก็ตามที่คุณจะเปลี่ยนด้วยตนเองตอน 7 โมงเช้าหลังจากตรวจสอบตัวเลขตอนกลางคืน สามารถเปลี่ยนเป็นสคริปต์ได้แทน
Items (ครีเอทีฟ) แต่ละแคมเปญประกอบด้วย items — หน่วยภาพพร้อมหัวข้อที่แสดงจริงๆ API ช่วยให้คุณเพิ่ม items เป็นชุด, อัปเดตสถานะของพวกมัน และอ่านสถานะการตรวจสอบต่อ item ซึ่งเป็นวิธีที่บัญชีขนาดใหญ่ส่งครีเอทีฟหลากหลายรูปแบบนับสิบโดยไม่ต้องแตะ UI (หากคุณยังคงตั้งค่าแคมเปญแรกด้วยตนเอง ให้เริ่มต้นด้วย คำแนะนำการตั้งค่าแคมเปญ Taboola ของเรา — API สันนิษฐานว่าคุณเข้าใจแนวคิดของคอนโซลอยู่แล้ว)
การรายงาน Endpoints ประสิทธิภาพแบบรวมที่แบ่งตามมิติ — วัน, แคมเปญ, เว็บไซต์, ประเทศ, แพลตฟอร์ม, item — วัตถุดิบสำหรับการปรับให้เหมาะสมอัตโนมัติใดๆ
พจนานุกรม Lookup endpoints สำหรับรายการค่าคงที่ที่ทุกสิ่งอื่นขึ้นอยู่กับ: รหัสประเทศ, แพลตฟอร์ม, กลุ่มผู้ชม

การเข้าถึงมาในรูปแบบ client ID และ secret ที่ออกให้สำหรับบัญชีของคุณ — โดยในอดีตขอผ่านผู้จัดการบัญชี Taboola ของคุณ — และ ข้อมูลอ้างอิง Backstage อย่างเป็นทางการ คือแหล่งข้อมูลที่เชื่อถือได้สำหรับรูปแบบ endpoint และขั้นตอนการเข้าถึงปัจจุบัน เส้นทาง endpoint ด้านล่างเป็นข้อมูลล่าสุด ณ เวลาที่เขียนนี้; ตรวจสอบกับข้อมูลอ้างอิงก่อนสร้าง

การยืนยันตัวตน: จาก client credentials ไปยัง bearer token#

Backstage ใช้กระบวนการมาตรฐาน OAuth 2.0 client-credentials แลกเปลี่ยน ID และ secret ของคุณเพื่อรับ token:

curl -X POST "https://backstage.taboola.com/backstage/oauth/token" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "grant_type=client_credentials"

การตอบกลับประกอบด้วย access_token ที่คุณส่งเป็นส่วนหัว bearer ในทุกการเรียก:

curl "https://backstage.taboola.com/backstage/api/1.0/users/current/allowed-accounts" \
  -H "Authorization: Bearer YOUR_TOKEN"

การเรียก allowed-accounts นั้นเป็นการเรียกแรกที่เหมาะสม: มันส่งคืนค่า account_id (ID ตัวเลขและชื่อที่อ่านได้) ที่ endpoint อื่นๆ ทุกแห่งต้องการในเส้นทางของมัน Token มีอายุหมด — เก็บแคชไว้หนึ่งอันและรีเฟรชเมื่อได้รับสถานะ 401 แทนที่จะสร้าง token ใหม่ทุกคำขอ ทั้งเพื่อความล่าช้าและเพราะคำขอ token ถูกจำกัดความถี่อย่างเข้มงวดกว่าคำขอข้อมูล

Endpoints ที่คุณจะใช้งานจริงๆ#

งาน	วิธีและเส้นทาง (ภายใต้ `/backstage/api/1.0/`)
แสดงรายการบัญชีของคุณ	`GET users/current/allowed-accounts`
แสดงรายการแคมเปญ	`GET {account_id}/campaigns`
สร้างแคมเปญ	`POST {account_id}/campaigns`
อัปเดตงบประมาณ/CPC/สถานะ	`PUT {account_id}/campaigns/{campaign_id}`
แสดงรายการครีเอทีฟของแคมเปญ	`GET {account_id}/campaigns/{campaign_id}/items`
เพิ่มครีเอทีฟ	`POST {account_id}/campaigns/{campaign_id}/items`
ประสิทธิภาพตามมิติ	`GET {account_id}/reports/campaign-summary/dimensions/{dimension}`
ประสิทธิภาพต่อครีเอทีฟ	`GET {account_id}/reports/top-campaign-content/dimensions/item_breakdown`

Endpoints การรายงานรับพารามิเตอร์คิวรี start_date และ end_date พร้อมตัวกรองเพิ่มเติม และส่วน dimension (day, campaign_breakdown, site_breakdown, country_breakdown, platform_breakdown…) เป็นตัวกำหนดการแบ่งส่วน site_breakdown คือส่วนที่สำคัญที่สุดสำหรับการปรับให้เหมาะสม: มันคือฟีดประสิทธิภาพต่อผู้เผยแพร่ที่ขับเคลื่อนการทำงานอัตโนมัติของรายการบล็อก

สิ่งที่ผู้ซื้อสื่อทำอัตโนมัติจริงๆ#

API คืนค่าต้นทุนการตั้งค่าในงานที่เกิดขึ้นซ้ำสี่งาน:

เครื่องมือกฎ งานคลาสสิก: ทุกชั่วโมง ดึง site_breakdown สำหรับแคมเปญที่ใช้งานอยู่; เว็บไซต์ใดๆ ที่ใช้จ่ายเกินเป้าหมาย CPA N เท่าโดยไม่มี Conversion เลย จะถูกเพิ่มเข้าไปในรายการบล็อกเว็บไซต์ของแคมเปญผ่านการอัปเดตแคมเปญ นี่คือขั้นตอนการตัดสิ่งที่ไม่ดีออกแบบเดียวกันที่ผู้โฆษณา Taboola ทุกคนที่จริงจังทำด้วยตนเอง — ถูกทำให้เป็นระบบ, ปราศจากอารมณ์ และทำงานตอนตี 3
การจัดการ bid การปรับ CPC ของแคมเปญ (และตัวปรับแต่ง bid ต่อเว็บไซต์ที่มีให้) ขึ้นเล็กน้อยในวันและภูมิศาสตร์ที่ทำได้ดีกว่าเป้าหมาย, ลดลงเมื่อ CPA เบี่ยงเบน — การปรับแต่งเล็กๆ น้อยๆ ที่เกิดขึ้นบ่อยและน่าเบื่อซึ่งสะสมผล
การดำเนินการครีเอทีฟเป็นชุด อัปโหลดรูปแบบหัวข้อ/ภาพ 30 แบบต่อแคมเปญ, หยุดทุกอย่างที่ต่ำกว่า CTR ค่ามัธยฐานรายสัปดาห์ และรักษาการหมุนเวียนครีเอทีฟให้ทันก่อนที่จะเกิดความล้า โดยไม่ต้องใช้เวลาคลิกทั้งบ่าย
ไปป์ไลน์ค่าใช้จ่าย งานรายวันตอนกลางคืนที่ดึง campaign-summary ตามวันเข้าไปในคลังข้อมูล เพื่อให้ค่าใช้จ่าย Taboola ปรากฏถัดจากรายได้ Conversion และทุกช่องทางอื่นในแดชบอร์ดเดียว

แผนการผสานรวมขั้นต่ำ#

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

Token round-trip แลกเปลี่ยนข้อมูลประจำตัวเพื่อรับ token และเรียก allowed-accounts หากขั้นตอนนี้ทำงานได้ แสดงว่าการยืนยันตัวตนและสิทธิ์ได้รับการแก้ไขแล้ว
การรายงานแบบอ่านอย่างเดียว ดึง campaign-summary ตามวันสำหรับสัปดาห์ที่ผ่านมาและตรวจสอบตัวเลขกับ Ads Console อย่าเขียนอะไรจนกว่าข้อมูลที่อ่านจะตรงกับสิ่งที่ UI แสดง
การเปลี่ยนแปลงที่ปลอดภัยเพียงครั้งเดียว หยุดและเริ่มแคมเปญทดสอบหนึ่งแคมเปญอีกครั้งผ่าน PUT ยืนยันว่าการเปลี่ยนแปลงปรากฏในคอนโซลและสถานะการแสดงผลเป็นไปตามนั้น
การซิงค์ค่าใช้จ่ายรายวันตอนกลางคืน กำหนดเวลาการดึงรายงานเข้าไปในฐานข้อมูลของคุณ งานนี้เพียงอย่างเดียวก็เพียงพอที่จะทำให้การผสานรวมคุ้มค่าสำหรับทีมส่วนใหญ่
เครื่องมือกฎ ในโหมดทดสอบ คำนวณการตัดสินใจบล็อกเว็บไซต์และบันทึกสิ่งที่ จะ เกิดขึ้นเป็นเวลาหนึ่งสัปดาห์ก่อนปล่อยให้มันเขียน การเปรียบเทียบการเลือกของมันกับการเลือกที่คุณทำด้วยตนเองคือการประกันคุณภาพที่ถูกที่สุดที่คุณจะเคยทำ

การข้ามไปยังขั้นตอนที่ห้าโดยตรงเป็นความผิดพลาดทั่วไป — บั๊กในเส้นทางการเขียนต่อบัญชีโฆษณาที่ใช้งานอยู่คือบทเรียนที่มีราคาแพง

ข้อจำกัดความถี่และข้อควรระวังในทางปฏิบัติ#

เคารพขีดจำกัด Backstage บังคับใช้ข้อจำกัดความถี่ต่อบัญชี; ดึงข้อมูลอ่านเป็นชุด (เรียกรายงานหนึ่งครั้งต่อแคมเปญต่อชั่วโมง ไม่ใช่หนึ่งครั้งต่อนาที) และถอยหลังเมื่อได้รับสถานะ 429 ตรวจสอบข้อมูลอ้างอิงสำหรับขีดจำกัดปัจจุบันแทนที่จะสันนิษฐาน
รายงานล่าช้ากว่าการแสดงผล ข้อมูลของชั่วโมงล่าสุดจะค่อยๆ คงที่เมื่อเวลาผ่านไป; สร้างกฎโดยใช้ข้อมูลที่เก่ากว่าสองสามชั่วโมงเป็นอย่างน้อย มิฉะนั้นคุณจะหยุดแคมเปญโดยใช้ตัวเลขที่ไม่สมบูรณ์
การแก้ไขไม่ใช่แบบทันที การเปลี่ยนแปลงแคมเปญแพร่กระจายไปยังการแสดงผลด้วยความล่าช้า และการแก้ไข item อาจทำให้เกิดการตรวจสอบอีกครั้ง การทำงานอัตโนมัติควรทนต่อช่องว่างนี้แทนที่จะส่งคำขอเขียนที่ "ล้มเหลว" ซ้ำ
เก็บ ID ไม่ใช่ชื่อ ชื่อแคมเปญและ item ถูกแก้ไขโดยมนุษย์; ID ตัวเลขเป็นคีย์เชื่อมต่อที่เสถียร
ป้องกันเส้นทางการเขียน เครื่องมือกฎที่มีบั๊กสามารถหยุดค่าใช้จ่ายทั้งหมดของบัญชีหรือเพิ่ม bid 10 เท่าได้ บันทึกการเปลี่ยนแปลงทุกครั้ง, เพิ่มขอบเขตความสมเหตุสมผล (อย่าเปลี่ยน bid มากกว่า X% ต่อรอบ) และเริ่มกฎใหม่ใดๆ ในโหมดทดสอบ

Taboola API อีกตัวหนึ่ง: ข้อมูลเชิงแข่งขัน#

ทุกสิ่งที่กล่าวมาข้างต้นเห็นบัญชีเดียวเท่านั้น: ของคุณ Backstage จะไม่บอกคุณว่าผู้โฆษณาใดกำลังขยายขนาดในอุตสาหกรรมของคุณ, พวกเขากำลังใช้ครีเอทีฟอะไร, หรือแคมเปญของคู่แข่งอยู่รอดมาได้นานแค่ไหน — เครือข่ายไม่ได้เผยแพร่ ad library ของตัวเอง และไม่มี endpoint อย่างเป็นทางการใดเปิดเผยกิจกรรมของผู้โฆษณารายอื่น

นั่นคือช่องว่างที่ developer API ของ OpenAdLibrary คลอบคลุม ดัชนีเก็บครีเอทีฟ Taboola ที่กำลังใช้งานอยู่กว่า 206,000+ รายการ (กรกฎาคม 2026) ภายในคลังข้อมูลโฆษณาเนทีฟกว่า 725,000+ รายการทั่ว 49 เครือข่าย และข้อมูลเดียวกันที่อยู่เบื้องหลัง Taboola ad library สามารถสืบค้นผ่าน REST ได้: ค้นหาครีเอทีฟตามผู้โฆษณา, อุตสาหกรรม, ภูมิศาสตร์ และระยะเวลาการใช้งาน; ดึงหัวข้อและหน้า Landing Page; ติดตามเมื่อคู่แข่งเปิดตัวและยุติแคมเปญ คู่มือ native ad data API เอกสาร endpoints และหากเวิร์กโฟลว์ของคุณอยู่ใน LLM agent มี MCP server ที่เปิดเผยคลังข้อมูลเดียวกันเป็นเครื่องมือสำหรับ Claude และ ChatGPT คีย์ฟรีครอบคลุมการใช้งานเบาๆ และ ราคา คงที่สำหรับส่วนที่เหลือ; ภาพรวมที่กว้างขึ้นของการเข้าถึงข้อมูลข่าวกรองโฆษณาแบบโปรแกรมมาบิกได้รับการสำรวจใน ad spy tools with an API

API ทั้งสองตัวทำงานร่วมกันได้อย่างเป็นธรรมชาติ: Backstage ทำให้ การดำเนินการ ในบัญชีของคุณเป็นอัตโนมัติ, intelligence API ทำให้ การวิจัย เกี่ยวกับบัญชีของทุกคนเป็นอัตโนมัติ ผู้ซื้อที่ได้รับประโยชน์สูงสุดจากการทำงานอัตโนมัติใช้ทั้งสองอย่าง — เครื่องมือกฎที่ดูแลแคมเปญของตัวเองให้สะอาด และฟีดข้อมูลเชิงแข่งขันที่แจ้งเตือนเมื่อมีผู้โฆษณาใหม่เริ่มขยายขนาดในอุตสาหกรรมของพวกเขา เพื่อให้การทดสอบครั้งต่อไปไม่เคยถูกเลือกโดยปราศจากข้อมูล เริ่มต้นด้วย Taboola spy tool เพื่อดูคลังข้อมูลเชิงแข่งขันในเบราว์เซอร์ จากนั้นนำคำค้นหาเดียวกันไปใช้แบบโปรแกรมมาบิกเมื่อเวิร์กโฟลว์พิสูจน์แล้วว่าทำงานได้

คำถามที่พบบ่อย

Taboola Backstage API ใช้ฟรีหรือไม่?

ไม่มีค่าธรรมเนียม API แยกต่างหาก — การเข้าถึงมาพร้อมกับบัญชีผู้โฆษณา และคุณจ่ายค่าใช้จ่ายสื่อตามปกติ สิ่งที่ควบคุมการเข้าถึงคือสิทธิ์มากกว่าราคา: ข้อมูลประจำตัว API (client ID และ secret) จะถูกออกให้สำหรับบัญชีของคุณ โดยในอดีตต้องขอผ่านผู้จัดการบัญชี Taboola ของคุณ ดังนั้นคุณต้องมีความสัมพันธ์ในฐานะผู้โฆษณาที่ใช้งานอยู่ก่อนจึงจะสามารถพัฒนาได้

ฉันจะยืนยันตัวตนกับ Taboola API ได้อย่างไร?

Backstage ใช้กระบวนการ OAuth 2.0 client-credentials: ส่ง POST client ID และ secret ของคุณไปยัง token endpoint ที่ backstage.taboola.com และรับ bearer token กลับมา จากนั้นส่ง token นี้ในส่วนหัว Authorization ในทุกคำขอ Token มีอายุหมด — ควรเก็บแคชไว้หนึ่งอันและรีเฟรชเมื่อได้รับสถานะ 401 แทนที่จะขอ token ใหม่ทุกครั้งที่เรียกใช้ เนื่องจากการสร้าง token มีข้อจำกัดความถี่

Taboola API แสดงโฆษณาของคู่แข่งได้หรือไม่?

ไม่ได้ Backstage ถูกกำหนดขอบเขตอย่างเคร่งครัดให้เห็นเฉพาะบัญชีที่คุณเป็นเจ้าของ — แคมเปญ, ครีเอทีฟ และรายงานสำหรับค่าใช้จ่ายของคุณเอง Taboola ไม่เผยแพร่ ad library และไม่มี endpoint สำหรับข้อมูลเชิงแข่งขัน การมองเห็นในระดับเครือข่ายมาจากการเก็บข้อมูลโดยอิสระ: OpenAdLibrary จัดทำดัชนีครีเอทีฟ Taboola ที่กำลังใช้งานอยู่กว่า 206,000+ รายการ (กรกฎาคม 2026) พร้อมข้อมูลผู้โฆษณา, ระยะเวลาการใช้งาน และหน้า Landing Page ซึ่งสามารถสืบค้นผ่าน REST API และ MCP

ฉันควรทำอะไรให้อัตโนมัติเป็นอันดับแรกด้วย Backstage API?

เครื่องมือจัดการกฎการบล็อกเว็บไซต์ให้ผลตอบแทนเร็วที่สุด: ดึงรายงาน site_breakdown ตามกำหนดเวลา, บล็อกผู้เผยแพร่ใดๆ ที่ใช้จ่ายเกินเป้าหมาย CPA หลายเท่าโดยไม่มี Conversion เลย และบันทึกการดำเนินการทุกครั้ง มันช่วยทำให้ขั้นตอนการตัดสิ่งที่ไม่ดีออก ซึ่งผู้ซื้อโฆษณา Taboola ทุกคนทำด้วยตนเองอยู่แล้ว ทำงานเป็นระบบโดยปราศจากอารมณ์ และปกป้องงบประมาณตลอด 24 ชั่วโมงแทนที่จะรอให้คุณตรวจสอบ

Taboola API มีข้อจำกัดความถี่ (rate limits) หรือไม่?

มี — ข้อจำกัดต่อบัญชีมีผลบังคับใช้ และคำขอ token ถูกจำกัดความถี่อย่างเข้มงวดกว่าคำขอข้อมูล คำแนะนำในทางปฏิบัติ: ดึงรายงานเป็นชุดแทนที่จะดึงข้อมูลแคมเปญละนาที, ถอยหลังเมื่อได้รับสถานะตอบกลับ 429 และสร้างระบบโดยใช้ข้อมูลที่เก่ากว่าสองสามชั่วโมง เนื่องจากรายงานของชั่วโมงล่าสุดจะค่อยๆ คงที่เมื่อเวลาผ่านไป ตรวจสอบข้อมูลอ้างอิงทางการสำหรับค่าขีดจำกัดปัจจุบัน

เขียนโดยทีม OpenAdLibrary

วิจัยข่าวกรองโฆษณาและโฆษณาเนทีฟ

เราสร้าง OpenAdLibrary แพลตฟอร์มเปิดเพื่อความโปร่งใสด้านโฆษณา ทุกวันระบบของเราจับโฆษณาเนทีฟสดจาก Taboola, Outbrain, MGID, Revcontent, Teads, Yahoo และ MSN ระบุผู้โฆษณาจริงที่อยู่เบื้องหลังแต่ละรายการ และติดตามคลิกไปยังหน้า Landing Page คู่มือเหล่านี้สรุปสิ่งที่เราเห็นจากข้อมูลนั้น เพื่อให้คุณวิจัยตลาดได้เร็วขึ้น