List of ad campaigns — API Pancake POS

get /shops/{SHOP_ID}/ads_manager/campaigns_v2

GET/shops/{SHOP_ID}/ads_manager/campaigns_v2Gọi qua 360: GET https://partner.quantri360.com/v1/pancake_pos/shops/{SHOP_ID}/ads_manager/campaigns_v2

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

Danh sách chiến dịch quảng cáo Facebook (đồng bộ vào Pancake) kèm chỉ số hiệu quả trong khoảng thời gian: chi tiêu, hiển thị, tiếp cận, nhấp, CPC / CPM / CTR, sản phẩm và marketer gắn chiến dịch, cộng tổng summary.

Chi tiêu theo tiền tệ của TKQC (ad_account.currency).
Gọi thật trên cửa hàng thử (chưa dùng Quản lý quảng cáo): HTTP 200, 0 chiến dịch, summary toàn 0.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/pancake_pos/shops/{SHOP_ID}/ads_manager/campaigns_v2

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	1234567	SHOP_ID đã nối — có thể bỏ khi đường dẫn có /shops/{SHOP_ID}.

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
SHOP_ID	path	integer	Có	1234567	Mã cửa hàng đã nối với 360.
page	query	int	Không	1
page_size	query	int	Không	30
start_time	query	int	Không	1790787600	Đầu kỳ chỉ số (Unix giây).
end_time	query	int	Không	1793466000	Cuối kỳ (Unix giây).
select_fields	query	string	Không	spend,impressions,clicks,reach,cpc,ctr	Các trường `insights` cần, cách nhau dấu phẩy; có tham số này thì chỉ trả các trường đó.

Phân trang

Tăng page tới total_pages.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/pancake_pos/shops/1234567/ads_manager/campaigns_v2?page=1&page_size=30&start_time=1790787600&end_time=1793466000" \
  -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_pos/shops/1234567/ads_manager/campaigns_v2",
    params={
        "page": 1,
        "page_size": 30,
        "start_time": 1790787600,
        "end_time": 1793466000
    },
    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_pos/shops/1234567/ads_manager/campaigns_v2');
for (const [k, v] of Object.entries({"page":1,"page_size":30,"start_time":1790787600,"end_time":1793466000})) 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_pos/shops/1234567/ads_manager/campaigns_v2' . '?' . http_build_query(['page' => 1, 'page_size' => 30, 'start_time' => 1790787600, 'end_time' => 1793466000]);
$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 POS)

Tên	Kiểu	Mẫu	Mô tả
success	bool	true
data	object[]		Chiến dịch.
id	string
name	string
status / effective_status	string	ACTIVE	`ACTIVE` · `PAUSED` · `DELETED` · `ARCHIVED`…
objective	string		Mục tiêu.
created_time / start_time / end_time	string
marketer_id	string		Marketer phụ trách.
product_id / product			Sản phẩm gắn chiến dịch.
ad_account	object		id, name, currency.
insights	object		spend, impressions, reach, clicks, cpc, cpm, cpp, ctr, frequency, ad_ids[]…
summary	object		Tổng: clicks, cpc, cpm, cpp, ctr, frequency, impressions, reach, spend.
page_number / page_size / total_pages / total_entries	int

Mẫu phản hồi

{
  "success": true,
  "data": [],
  "summary": {
    "clicks": 0,
    "cpc": 0,
    "cpm": 0,
    "cpp": 0,
    "ctr": 0,
    "frequency": 0,
    "impressions": 0,
    "reach": 0,
    "spend": 0
  },
  "page_size": 30,
  "total_pages": 1,
  "page_number": 1,
  "total_entries": 0
}

Bắt đầu dùng

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