Bỏ qua

Bắt đầu trong 5 phút

Từ liên kết mời tới request đầu tiên. Bạn cần: liên kết đặt mật khẩu do Logidata gửi, và một tài khoản có quyền trên TikTok Business Center của bạn.

1. Đặt mật khẩu

Mở liên kết dạng https://portal.logidata.vn/set-password/… trong email/tin nhắn Logidata gửi.

Liên kết dùng một lần, hết hạn sau 48 giờ

Mở xong là liên kết chết. Nếu quá hạn hoặc đã dùng, báo Logidata cấp lại — không có cách tự khôi phục.

Mật khẩu từ 12 ký tự, có cả chữ và số. Đặt xong bạn được đăng nhập luôn.

2. Nối tài khoản TikTok Ads

Vào Kết nối → Cấp quyền TikTok Ads. Đặt một tên gợi nhớ (chỉ để bạn phân biệt, ví dụ "BC Chính") rồi bấm nút.

Trang cấp quyền của TikTok mở ở tab mới. Đăng nhập bằng tài khoản có quyền trên Business Center và bấm đồng ý.

Giữ nguyên tab portal

Tab portal tự kiểm tra mỗi 2 giây và sẽ báo "Kết nối thành công" — thường dưới 10 giây sau khi bạn bấm đồng ý.

Xong, portal hiện X-Account-Id của kết nối — một chuỗi dạng ldc_…. Đó là định danh bạn gửi kèm mỗi request. Bạn không cần (và không thể) tự đặt giá trị này.

3. Tạo API key

Vào API key → chọn kết nối vừa tạo → Tạo API key.

Key thật chỉ hiện đúng một lần

Logidata chỉ lưu bản băm SHA-256, không có cách nào xem lại. Copy ngay vào nơi lưu bí mật của bạn (biến môi trường, secret manager). Lỡ mất thì dùng Đổi key để cấp key mới — key cũ chết ngay lập tức.

4. Request đầu tiên

Liệt kê các advertiser account mà kết nối của bạn nhìn thấy:

curl -H "X-API-Key: $LOGIDATA_API_KEY" \
     -H "X-Account-Id: ldc_9fK2xQ..." \
  "https://api.logidata.vn/v1/tiktok-ads/v1.3/oauth2/advertiser/get/"

import os, httpx

r = httpx.get(
    "https://api.logidata.vn/v1/tiktok-ads/v1.3/oauth2/advertiser/get/",
    headers={
        "X-API-Key": os.environ["LOGIDATA_API_KEY"],
        "X-Account-Id": "ldc_9fK2xQ...",
    },
)
r.raise_for_status()
print(r.json()["data"]["list"])

Response là nguyên văn của TikTok:

{
  "code": 0,
  "message": "OK",
  "data": {
    "list": [
      { "advertiser_id": "7001234567890", "advertiser_name": "Acme VN" }
    ]
  }
}

code: 0 nghĩa là thành công

Đây là quy ước của TikTok, không phải của Logidata. Lỗi do Logidata sinh ra có hình dạng khác hẳn — xem Mã lỗi.

5. Kéo báo cáo thật

Lấy advertiser_id ở bước trên rồi gọi báo cáo:

curl -G "https://api.logidata.vn/v1/tiktok-ads/v1.3/report/integrated/get/" \
  -H "X-API-Key: $LOGIDATA_API_KEY" \
  -H "X-Account-Id: ldc_9fK2xQ..." \
  --data-urlencode "advertiser_id=7001234567890" \
  --data-urlencode "report_type=BASIC" \
  --data-urlencode "data_level=AUCTION_CAMPAIGN" \
  --data-urlencode "dimensions=[\"campaign_id\",\"stat_time_day\"]" \
  --data-urlencode "metrics=[\"spend\",\"impressions\",\"clicks\"]" \
  --data-urlencode "start_date=2026-08-01" \
  --data-urlencode "end_date=2026-08-07" \
  --data-urlencode "page_size=100"

Tham số giống hệt tài liệu TikTok Business API — chỉ khác base URL và cách xác thực.

Tiếp theo