API Thông tin chi tiết về quảng cáo
API Thông tin chi tiết về quảng cáo cung cấp dữ liệu và số liệu thống kê về hiệu quả của quảng cáo trên Meta. Với các lựa chọn báo cáo linh hoạt, bạn có thể tùy chỉnh yêu cầu của mình và lấy gần như bất kỳ số liệu nào có trong Trình quản lý quảng cáo trên Meta.
Trước khi bắt đầu
Để truy cập vào API Thông tin chi tiết về quảng cáo, bạn sẽ cần có:
- Một ứng dụng. (Xem tài liệu về Phát triển ứng dụng trên Meta để biết thêm thông tin.)
Bạn cũng nên thiết lập quảng cáo để theo dõi các hành động mà mình quan tâm. Để làm điều đó, bạn có thể sử dụng các công cụ như API Chuyển đổi hoặc Meta Pixel.
Gọi API Thông tin chi tiết về quảng cáo
API Thông tin chi tiết về quảng cáo có sẵn dưới dạng cạnh trên tất cả các đối tượng quảng cáo. (Xem thêm thông tin về hệ thống phân cấp quảng cáo của Meta tại đây.)
| Nguồn lực | Cung cấp |
|---|---|
Thông tin chi tiết từ tài khoản quảng cáo | |
Thông tin chi tiết từ chiến dịch quảng cáo | |
Thông tin chi tiết từ nhóm quảng cáo | |
Thông tin chi tiết từ quảng cáo |
Theo mặc định, các yêu cầu GET sẽ trả về số liệu cơ bản cho đối tượng quảng cáo, thường là trong 30 ngày qua.
Yêu cầu mẫu
curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights"
Phản hồi mẫu:
{
"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"
}
}
}
Tùy chỉnh yêu cầu
Bạn có thể lấy dữ liệu cụ thể hơn nhiều bằng cách tận dụng 3 thành phần chính trong yêu cầu: thông số (để chỉ định những yếu tố như khoảng thời gian, khoảng thời gian phân bổ, v.v.), trường thông tin (cụ thể là số liệu) và số liệu chia nhỏ. Ví dụ: Để biết số lượt click (tất cả) theo giới tính trong 7 ngày qua của chiến dịch, bạn có thể thêm:
- Thông số:
date_preset=last_7d - Trường thông tin:
clicks - Số liệu chia nhỏ:
gender
Yêu cầu mẫu
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"
Phản hồi mẫu
{
"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"
}
}
}
Tìm hiểu thêm
API Thông tin chi tiết về quảng cáo có thể rất hữu ích. Vì vậy, hãy đọc tiếp và tìm hiểu cách sử dụng thành thạo các tính năng của API này:
- Các trường thông tin và thông số
- Số liệu
- Hướng dẫn cụ thể về báo cáo chuyển đổi, Báo cáo ở cấp độ sản phẩm và Mô hình marketing hỗn hợp
Bạn cũng có thể tìm tài liệu tham khảo được tạo tự động cho cạnh thông tin chi tiết của từng đối tượng quảng cáo:
Nếu bạn dự định đưa dữ liệu từ API Thông tin chi tiết về quảng cáo vào giải pháp của mình, vui lòng xem cả Điều khoản về nền tảng của Meta và Chính sách dành cho nhà phát triển đối với API Marketing.