Ads campaign — API Pancake Chat

get /pages/{page_id}/statistics/pages_campaigns

GET/public_api/v1/pages/{page_id}/statistics/pages_campaignsGọi qua 360: GET https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/{page_id}/statistics/pages_campaigns

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

Thống kê theo QUẢNG CÁO / CHIẾN DỊCH đang gắn với trang trong khoảng thời gian: tên, tài khoản, trạng thái, ngân sách ngày, ngân sách còn lại, chi tiêu và chỉ số phân phối. Dùng để rà nhanh quảng cáo nào của trang đang chạy / tạm dừng, ngân sách bao nhiêu.

Thiếu since → {"message":"since is required!","success":false} (HTTP 200).
Thử thật: mọi phần tử có proposals.fb_error_type = "OAuthException" và chi tiêu "0" / chỉ số null — tức kết nối quảng cáo trong Pancake của trang đã hết quyền. Khi gặp, cấp lại quyền quảng cáo trong Pancake; số liệu chi tiêu nên lấy thẳng từ nền tảng quảng cáo.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/{page_id}/statistics/pages_campaigns

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	107896751234567	page_id đã nối — có thể bỏ (lấy từ đường dẫn).

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
page_id	path	string	Có	107896751234567	Mã trang đã nối với 360.
since	query	timestamp	Có	1790787600	Từ (Unix giây, UTC).
until	query	timestamp	Có	1793206799	Đến (Unix giây, UTC).

Ví dụ request

curl -s "https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/107896751234567/statistics/pages_campaigns?since=1790787600&until=1793206799" \
  -H "Authorization: Bearer $KEY"

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/107896751234567/statistics/pages_campaigns",
    params={
        "since": 1790787600,
        "until": 1793206799
    },
    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/pancake_chat/public_api/v1/pages/107896751234567/statistics/pages_campaigns');
for (const [k, v] of Object.entries({"since":1790787600,"until":1793206799})) 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/pancake_chat/public_api/v1/pages/107896751234567/statistics/pages_campaigns' . '?' . http_build_query(['since' => 1790787600, 'until' => 1793206799]);
$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 Pancake Chat)

Tên	Kiểu	Mẫu	Mô tả
success	bool	true
data	object[]		Mỗi phần tử một quảng cáo.
id	string	120247891034560559	Mã nhóm / chiến dịch Pancake gắn với quảng cáo.
ad_id	string	120247891034600559	Mã quảng cáo.
name	string	online - D1040	Tên.
account_id	string	100000426446592	Tài khoản quảng cáo.
status / ad_status	string	PAUSED	Trạng thái.
optimization_goal	string	MESSAGING_PURCHASE_CONVERSION
daily_budget / lifetime_budget / budget_remaining	string	150000	Ngân sách (chuỗi số; có thể `null`).
currency	string	VND
spend	string	0	Chi tiêu (chuỗi số).
impressions / reach / clicks / ctr / cpc / cpm / results	string	null	Chỉ số phân phối — có thể `null`.
proposals	object	{"fb_error_type":"OAuthException"}	Cảnh báo phía Pancake — `fb_error_type: OAuthException` = Pancake mất quyền đọc tài khoản quảng cáo, các chỉ số sẽ `null`.

Mẫu phản hồi

{
  "success": true,
  "data": [
    {
      "id": "120247891034560559",
      "ad_id": "120247891034600559",
      "name": "online - D1040",
      "page_id": "107896751234567",
      "account_id": "100000426446592",
      "type": "ads",
      "status": "PAUSED",
      "ad_status": "PAUSED",
      "optimization_goal": "MESSAGING_PURCHASE_CONVERSION",
      "currency": "VND",
      "daily_budget": "150000",
      "lifetime_budget": null,
      "budget_remaining": "150000",
      "spend": "0",
      "impressions": null,
      "reach": null,
      "clicks": null,
      "results": null,
      "proposals": {
        "fb_error_type": "OAuthException"
      }
    }
  ]
}

Bắt đầu dùng

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