Quay lại catalog nguồn dữ liệu
Quảng cáoPhù hợp với Retailer

TikTok Ads

Quảng cáo trên TikTok và TikTok Shop, kênh tăng trưởng mạnh nhất 2024-2026 tại VN.

Loại API

REST API

Xác thực

OAuth 2.0

Tần suất refresh khả thi

Mỗi giờ, Hằng ngày

Setup · Maintain hằng tháng

10-16 giờ (cộng 5-10 ngày chờ duyệt App) · 2-3 giờ

Hướng dẫn kết nối, 6 bước

Làm theo thứ tự từ trên xuống. Mỗi bước có ngữ cảnh để đội kỹ thuật của bạn hiểu lý do, không phải checklist bấm.

  1. 1

    Tạo App trên TikTok for Business

    Vào business-api.tiktok.com, tạo Developer Account và App. App được duyệt trong 5-10 ngày.

  2. 2

    Lấy App ID + App Secret

    Trang App detail. Lưu vào vault.

  3. 3

    Authorize advertiser của khách

    Generate auth URL với scope advertiser.read, ads.read, reports.read. Admin advertiser của khách accept → nhận auth_code.

  4. 4

    Trade auth_code lấy access_token

    POST /open_api/v1.3/oauth2/access_token với auth_code. Access token không hết hạn cho đến khi revoke.

  5. 5

    Get advertiser list

    GET /open_api/v1.3/oauth2/advertiser/get, trả về danh sách advertiser_id mà token có quyền truy cập.

  6. 6

    Kết nối Reporting API

    POST /open_api/v1.3/report/integrated/get với advertiser_id, report_type=BASIC, dimensions=[campaign_id, stat_time_day], metrics=[spend, impressions, clicks, conversion, conversion_rate].

Credentials cần có

Lưu vào vault hoặc secret manager. Không hardcode trong code, không commit lên git.

  • App ID
  • App Secret
  • Access Token
  • Advertiser ID

Trường dữ liệu mẫu

Các field thường có trong API response. Map vào schema warehouse khi ingest.

  • campaign_id
  • campaign_name
  • spend
  • impressions
  • clicks
  • conversion
  • conversion_rate
  • ctr
  • cpm
  • objective_type

Lỗi và pitfalls thường gặp tại Việt Nam

Đọc kỹ trước khi cam kết timeline, vài rủi ro dưới đây có thể kéo dài tích hợp thêm 1-2 tuần nếu không lên kế hoạch.

  • Reporting API rate limit khoảng 10 request/giây, pull theo batch hợp lý.
  • Conversion data có delay 6-24 giờ, refresh ngày trước thường có thay đổi.
  • Spark Ads (boost video creator) tính spend khác native ads, đọc kỹ tài liệu attribution.
  • Custom conversion event cần setup qua TikTok Pixel hoặc Events API, nếu khách chưa setup, conversion sẽ luôn bằng 0.
  • Region Vietnam có thể có endpoint khác US/EU, xác nhận region khi tạo App.
Bước tiếp theo

Kết nối TikTok Ads vào data warehouse của doanh nghiệp bạn

Đặt lịch rà soát 30 phút. Chia sẻ tài khoản hiện tại, chúng tôi đề xuất phạm vi kết nối ưu tiên và timeline ngày bàn giao.