Hướng dẫn Taboola API: Các Endpoint Backstage, Xác thực và Ứng dụng Thực tế

Taboola API — chính thức là Backstage API — là giao diện REST của Taboola dành cho nhà quảng cáo. Bạn xác thực bằng thông tin xác thực client OAuth 2.0, sau đó đọc và ghi mọi thứ bạn có thể chạm tới trong Ads Console: chiến dịch, mục sáng tạo, nhắm mục tiêu, ngân sách và báo cáo hiệu suất, tất cả dưới https://backstage.taboola.com/backstage/api/1.0/{account_id}/…. Đây là lớp mà người mua truyền thông sử dụng để tự động hóa thay đổi giá thầu và ngân sách, tải lên hàng loạt sáng tạo, đồng bộ chi tiêu vào kho dữ liệu và xây dựng các công cụ quy tắc mà giao diện người dùng của Taboola không cung cấp. Điều mà nó cố ý không tiết lộ là dữ liệu của bất kỳ ai khác — để có cái nhìn cạnh tranh về mạng lưới, bạn cần một API hoàn toàn khác, mà chúng tôi sẽ đề cập ở cuối.

Những gì Backstage API bao phủ#

Backstage phản chiếu bảng điều khiển nhà quảng cáo gần như một-một. Trong thực tế, bốn lĩnh vực thực hiện hầu hết công việc:

• Quản lý chiến dịch. Tạo, đọc, cập nhật và tạm dừng chiến dịch; đặt CPC, ngân sách hàng ngày và tổng cộng, nhắm mục tiêu theo địa lý/nền tảng và chặn trang web. Bất cứ điều gì bạn sẽ thay đổi thủ công lúc 7 giờ sáng sau khi kiểm tra số liệu qua đêm đều có thể là một tập lệnh.
• Mục (sáng tạo). Mỗi chiến dịch chứa các mục — các đơn vị hình ảnh-cộng-tiêu đề thực sự được phục vụ. API cho phép bạn thêm mục hàng loạt, cập nhật trạng thái của chúng và đọc trạng thái xem xét theo mục, đây là cách các tài khoản lớn triển khai hàng chục biến thể sáng tạo mà không cần chạm vào giao diện người dùng. (Nếu bạn vẫn đang thiết lập các chiến dịch đầu tiên của mình thủ công, hãy bắt đầu với hướng dẫn thiết lập chiến dịch Taboola của chúng tôi — API giả định bạn đã biết các khái niệm của bảng điều khiển.)
• Báo cáo. Các endpoint hiệu suất tổng hợp được chia nhỏ theo chiều — ngày, chiến dịch, trang web, quốc gia, nền tảng, mục — nguyên liệu thô cho bất kỳ tối ưu hóa tự động nào.
• Từ điển. Các endpoint tra cứu cho các danh sách mà mọi thứ khác phụ thuộc vào: mã quốc gia, nền tảng, phân khúc đối tượng.

Quyền truy cập được cấp dưới dạng client ID và secret được cấp cho tài khoản của bạn — trước đây được yêu cầu thông qua quản lý tài khoản Taboola của bạn — và tài liệu tham khảo Backstage chính thức là nguồn chân lý cho các hình dạng endpoint hiện tại và quy trình truy cập. Các đường dẫn endpoint dưới đây là hiện tại tại thời điểm viết bài; hãy xác minh với tài liệu tham khảo trước khi xây dựng.

Xác thực: Thông tin xác thực client đến bearer token#

Backstage sử dụng luồng client-credentials tiêu chuẩn của OAuth 2.0. Trao đổi ID và secret của bạn để lấy 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"

Phản hồi chứa một access_token mà bạn gửi dưới dạng tiêu đề bearer trên mỗi lần gọi:

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

Lệnh gọi allowed-accounts đó là yêu cầu đầu tiên phù hợp: nó trả về các giá trị account_id (ID số và tên có thể đọc được) mà mọi endpoint khác cần trong đường dẫn của nó. Token hết hạn — hãy lưu vào bộ nhớ đệm một token và làm mới khi gặp lỗi 401 thay vì tạo token mới cho mỗi yêu cầu, cả vì độ trễ và vì các yêu cầu token bị giới hạn tốc độ mạnh mẽ hơn so với yêu cầu dữ liệu.

Các endpoint bạn thực sự sẽ sử dụng#

Các endpoint báo cáo nhận các tham số truy vấn start_date và end_date cộng với các bộ lọc tùy chọn, và phân đoạn dimension (day, campaign_breakdown, site_breakdown, country_breakdown, platform_breakdown…) quyết định lát cắt. site_breakdown là cái quan trọng nhất cho tối ưu hóa: đó là luồng hiệu suất theo nhà xuất bản thúc đẩy tự động hóa danh sách chặn.

Những gì người mua truyền thông thực sự tự động hóa#

API kiếm được chi phí thiết lập của nó trong bốn công việc định kỳ:

1. Công cụ quy tắc. Kinh điển: mỗi giờ, kéo site_breakdown cho các chiến dịch đang hoạt động; bất kỳ trang web nào đã chi tiêu nhiều hơn N× CPA mục tiêu với không có chuyển đổi nào sẽ được đưa vào danh sách trang web bị chặn của chiến dịch thông qua một cập nhật chiến dịch. Đây là cùng một vòng lặp cắt-giảm-thua-lỗ mà mọi nhà quảng cáo Taboola nghiêm túc chạy thủ công — được mã hóa, không cảm tính và chạy lúc 3 giờ sáng.
2. Quản lý giá thầu. Điều chỉnh CPC của chiến dịch (và các điều chỉnh giá thầu theo trang web nếu có) lên vào những ngày và khu vực địa lý vượt mục tiêu, giảm khi CPA trôi — những điều chỉnh nhỏ, thường xuyên, nhàm chán tích lũy.
3. Thao tác sáng tạo hàng loạt. Tải lên 30 biến thể tiêu đề/hình ảnh cho mỗi chiến dịch, tạm dừng mọi thứ dưới CTR trung bình hàng tuần và giữ cho vòng quay sáng tạo luôn đi trước sự mệt mỏi mà không cần một buổi chiều nhấp chuột.
4. Đường ống chi tiêu. Một công việc hàng đêm kéo campaign-summary theo ngày vào kho dữ liệu, để chi tiêu Taboola xuất hiện bên cạnh doanh thu chuyển đổi và mọi kênh khác trong một bảng điều khiển.

Một kế hoạch tích hợp tối thiểu#

Nếu bạn bắt đầu từ số không, chuỗi này giúp bạn đạt được tự động hóa hữu ích trong khoảng một ngày làm việc, với mỗi bước có thể xác minh trước bước tiếp theo:

1. Vòng lặp token. Trao đổi thông tin xác thực để lấy token và gọi allowed-accounts. Nếu điều này hoạt động, xác thực và quyền đã được giải quyết.

2. Báo cáo chỉ đọc. Kéo campaign-summary theo ngày cho tuần trước và đối chiếu các con số với Ads Console. Đừng ghi bất cứ điều gì cho đến khi việc đọc của bạn khớp với những gì giao diện người dùng hiển thị.

3. Một đột biến an toàn duy nhất. Tạm dừng và bỏ tạm dừng một chiến dịch thử nghiệm qua PUT. Xác nhận thay đổi xuất hiện trong bảng điều khiển và trạng thái phục vụ tuân theo.

4. Đồng bộ chi tiêu hàng đêm. Lên lịch kéo báo cáo vào cơ sở dữ liệu của bạn. Chỉ riêng điều này đã biện minh cho việc tích hợp đối với hầu hết các nhóm.

5. Công cụ quy tắc, ở chế độ chạy thử. Tính toán các quyết định chặn trang web và ghi lại những gì sẽ xảy ra trong một tuần trước khi cho phép nó ghi. So sánh các lựa chọn của nó với những lựa chọn bạn thực hiện thủ công là kiểm tra chất lượng rẻ nhất bạn từng chạy.

Bỏ qua thẳng đến bước năm là sai lầm tiêu chuẩn — các lỗi đường dẫn ghi đối với tài khoản quảng cáo đang hoạt động là những bài học đắt giá.

Giới hạn tốc độ và những điểm cần lưu ý thực tế#

• Tôn trọng giới hạn trên. Backstage áp dụng các giới hạn tốc độ theo tài khoản; gộp các lần đọc (một lệnh gọi báo cáo cho mỗi chiến dịch mỗi giờ, không phải mỗi phút) và giảm tần suất khi gặp lỗi 429. Kiểm tra tài liệu tham khảo để biết các giới hạn hiện tại thay vì giả định.
• Báo cáo trễ so với phục vụ. Dữ liệu trong những giờ gần đây ổn định theo thời gian; xây dựng quy tắc dựa trên dữ liệu ít nhất vài giờ tuổi hoặc bạn sẽ tạm dừng chiến dịch dựa trên các con số không đầy đủ.
• Chỉnh sửa không phải tức thì. Các thay đổi chiến dịch lan truyền đến việc phục vụ với độ trễ và các chỉnh sửa mục có thể kích hoạt lại việc xem xét. Tự động hóa nên chịu đựng khoảng cách này thay vì phát hành lại các lần ghi "thất bại".
• Lưu trữ ID, không phải tên. Tên chiến dịch và mục được chỉnh sửa bởi con người; ID số là khóa nối ổn định.
• Bảo vệ đường dẫn ghi. Một công cụ quy tắc có lỗi có thể tạm dừng toàn bộ chi tiêu của tài khoản hoặc tăng giá thầu lên 10 lần. Ghi lại mọi đột biến, thêm các giới hạn hợp lý (không bao giờ thay đổi giá thầu quá X% mỗi lần) và bắt đầu bất kỳ quy tắc mới nào ở chế độ chạy thử.

Taboola API khác: dữ liệu cạnh tranh#

Mọi thứ ở trên chỉ thấy chính xác một tài khoản: của bạn. Backstage sẽ không bao giờ cho bạn biết nhà quảng cáo nào đang mở rộng quy mô trong lĩnh vực của bạn, họ đang chạy những sáng tạo nào hoặc một chiến dịch của đối thủ đã tồn tại bao lâu — mạng lưới không xuất bản thư viện quảng cáo của riêng mình và không có endpoint chính thức nào tiết lộ hoạt động của các nhà quảng cáo khác.

Đó là khoảng trống mà API dành cho nhà phát triển của OpenAdLibrary bao phủ. Chỉ mục chứa 206.000+ sáng tạo Taboola đang hoạt động (tháng 7 năm 2026) bên trong một kho ngữ liệu gồm 725.000+ quảng cáo native trên 49 mạng lưới, và cùng một dữ liệu đằng sau thư viện quảng cáo Taboola có thể truy vấn qua REST: tìm kiếm sáng tạo theo nhà quảng cáo, lĩnh vực, địa lý và thời gian tồn tại; kéo tiêu đề và trang đích; theo dõi khi đối thủ khởi chạy và kết thúc chiến dịch. Hướng dẫn API dữ liệu quảng cáo native ghi lại các endpoint, và nếu quy trình làm việc của bạn nằm trong một tác nhân LLM thì có một máy chủ MCP tiết lộ cùng một kho ngữ liệu dưới dạng công cụ cho Claude và ChatGPT. Một khóa miễn phí bao phủ việc sử dụng nhẹ và giá cả giữ nguyên cho phần còn lại; bối cảnh rộng hơn của quyền truy cập trí tuệ quảng cáo lập trình được khảo sát trong công cụ gián điệp quảng cáo có API.

Hai API kết hợp một cách tự nhiên: Backstage tự động hóa thực thi trên tài khoản của bạn, API thông minh tự động hóa nghiên cứu trên tài khoản của mọi người khác. Những người mua tận dụng tối đa tự động hóa chạy cả hai — một công cụ quy tắc giữ cho các chiến dịch của chính họ được tỉa gọn và một luồng cạnh tranh cảnh báo khi một nhà quảng cáo mới bắt đầu mở rộng quy mô trong lĩnh vực của họ để bài kiểm tra tiếp theo không bao giờ được chọn một cách mù quáng. Bắt đầu với công cụ gián điệp Taboola để xem kho ngữ liệu cạnh tranh trong trình duyệt, sau đó thực hiện các truy vấn tương tự theo cách lập trình khi quy trình làm việc được chứng minh.