Insight tài khoản quảng cáo theo cấp campaign / adset / ad

Ad Account Insights

GET/{version}/act_{account_id}/insightsGọi qua 360: GET https://partner.quantri360.com/v1/facebook/{version}/act_{account_id}/insights

Sắp mở. API này đã chạy thật qua 360 và đang được chốt giá — bạn có thể đọc tài liệu và chuẩn bị tích hợp trước.

Mô tả API

Insight tài khoản quảng cáo theo cấp chiến dịch / nhóm / quảng cáo trong một khoảng ngày — nguồn số liệu Facebook Ads của 360.

Hạn mức Marketing API tính theo tài khoản quảng cáo; gọi dồn sẽ bị Meta trả lỗi code 17 / 80004 — chờ rồi gọi lại.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/facebook/{version}/act_{account_id}/insights

Xác thực & gian hàng

Tên	Vị trí	Kiểu	Mẫu	Mô tả
Authorization	header	header	Bearer q360_live_ab12cd34_…	Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_id	query	string	act_123456789 hoặc 1234567890	Tài sản Facebook brand đã nối với 360: tài khoản quảng cáo (act_<id> hoặc <id>), Page id hoặc Pixel id — lấy ở GET /v1/platforms. Có thể bỏ khi đường dẫn đã chứa act_<id> / page id của brand.

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
version	path	string	Có	v25.0	Phiên bản Graph API.
account_id	path	string	Có	123456789	Id tài khoản quảng cáo (không có act_).
level	query	string	Không	campaign	`campaign` \| `adset` \| `ad` \| `account`.
fields	query	string	Có	campaign_id,campaign_name,spend,impressions,clicks,actions,purchase_roas	Trường cần lấy, cách nhau dấu phẩy.
time_range	query	string	Không	{"since":"2026-10-01","until":"2026-10-19"}	JSON since/until (YYYY-MM-DD).
time_increment	query	string	Không	1	`1` = tách theo ngày.
breakdowns	query	string	Không	age,gender	Chiều phân rã (age, gender, publisher_platform, device_platform…).
filtering	query	string	Không	[{"field":"campaign.id","operator":"IN","value":["123"]}]	Bộ lọc JSON.
limit	query	int	Không	500	Số dòng mỗi trang.
after	query	string	Không		Con trỏ `paging.cursors.after` của trang trước.

Phân trang

Lặp theo paging.next / paging.cursors.after cho tới khi không còn paging.next.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/facebook/v25.0/act_123456789/insights?level=campaign&fields=campaign_id%2Ccampaign_name%2Cspend%2Cimpressions%2Cclicks%2Cactions&time_range=%7B%22since%22%3A%222026-10-01%22%2C%22until%22%3A%222026-10-19%22%7D&time_increment=1&limit=500" \
  -H "Authorization: Bearer $KEY"

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/facebook/v25.0/act_123456789/insights",
    params={
        "level": "campaign",
        "fields": "campaign_id,campaign_name,spend,impressions,clicks,actions",
        "time_range": "{\"since\":\"2026-10-01\",\"until\":\"2026-10-19\"}",
        "time_increment": 1,
        "limit": 500
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())

Node.js

const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/facebook/v25.0/act_123456789/insights');
for (const [k, v] of Object.entries({"level":"campaign","fields":"campaign_id,campaign_name,spend,impressions,clicks,actions","time_range":"{\"since\":\"2026-10-01\",\"until\":\"2026-10-19\"}","time_increment":1,"limit":500})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'GET',
  headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());

PHP

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/facebook/v25.0/act_123456789/insights' . '?' . http_build_query(['level' => 'campaign', 'fields' => 'campaign_id,campaign_name,spend,impressions,clicks,actions', 'time_range' => '{"since":"2026-10-01","until":"2026-10-19"}', 'time_increment' => 1, 'limit' => 500]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]);
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Tham số phản hồi (nguyên của Facebook)

Tên	Kiểu	Mẫu	Mô tả
data	object[]		Mỗi dòng insight theo level/breakdown.
campaign_id	string
campaign_name	string
spend	string	125000	VND.
impressions	string
clicks	string
actions	object[]		[{action_type, value}] — purchase, lead, onsite_conversion.messaging_conversation_started_7d…
date_start	string
date_stop	string
paging	object
cursors	object
before	string
after	string
next	string		URL trang kế (gọi lại qua 360 bằng after).

Bắt đầu dùng

Đăng ký tài khoản Partner
Mở loại dữ liệu thuộc nhóm Quảng cáo (Marketing API) ở trang nền tảng
Tạo API key (tick kênh Facebook)
Gọi theo ví dụ ở trên

Insight tài khoản quảng cáo theo cấp campaign / adset / ad — API Facebook