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
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
Lấy App ID + App Secret
Trang App detail. Lưu vào vault.
- 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
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
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
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 IDApp SecretAccess TokenAdvertiser 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.
Dashboard sử dụng TikTok Ads
Xem toàn bộ thư viện dashboard →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.