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

Meta Ads (Facebook + Instagram)

Quảng cáo trên Facebook và Instagram, nguồn traffic và conversion lớn nhất với retailer VN.

Trang chính của vendor Tài liệu API chính thức

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

8-16 giờ (cộng 3-14 ngày chờ App Review) · 2-3 giờ (cập nhật version và xử lý lệch attribution)

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 trong Meta for Developers

    Vào developers.facebook.com, tạo App type 'Business'. Add product 'Marketing API'.

  2. 2

    Yêu cầu Advanced Access cho ads_read

    App Review > Marketing API > yêu cầu permission ads_read và ads_management. Phê duyệt 3-14 ngày, có thể cần screencast use case.

  3. 3

    Tạo System User trong Business Manager

    Business Settings > System Users > tạo system user, gán permission Manage Ads. Generate access token (không hết hạn).

  4. 4

    Add ad account vào system user

    Trong Business Settings, assign các ad account cần truy cập cho system user. Mỗi ad account có id dạng act_<id>.

  5. 5

    Kết nối Insights API

    GET /act_<id>/insights?fields=spend,impressions,clicks,actions,action_values&level=campaign&time_range={...}. Phân tách level: campaign / adset / ad.

  6. 6

    Cron job daily pull

    Mỗi tối pull 30 ngày trước (vì attribution có thể update trong 28 ngày). Đẩy về data warehouse, upsert theo (account_id, level_id, date).

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
  • System User Access Token
  • Ad Account 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
  • actions[].action_type=purchase
  • action_values[].value
  • objective
  • buying_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.

  • Rate limit theo tier (Standard/Development), pull cho nhiều ad accounts cùng lúc dễ bị throttle.
  • Attribution window: số liệu hôm nay vẫn có thể đổi trong 28 ngày tiếp, luôn refresh 30 ngày trước.
  • Số actions có nhiều type (purchase, lead, add_to_cart…), chọn đúng action_type khi tính conversion.
  • iOS 14+ làm SKAdNetwork attribution lệch khoảng 10-15% so với báo cáo trong Ads Manager, chuẩn bị tinh thần con số không khớp 100%.
  • API version đổi mỗi 3 tháng, set version cố định (ví dụ v20.0 thay vì latest) và plan upgrade theo quý.

Dashboard sử dụng Meta Ads (Facebook + Instagram)

Xem toàn bộ thư viện dashboard →
Bán lẻ đa kênhCEO

P&L theo kênh bán

Lãi/lỗ thật của từng kênh (Shopee, TikTok Shop, Lazada, Web, Offline) sau khi trừ phí sàn, phí thanh toán, chi phí quảng cáo, hoàn hàng và vận chuyển. Một con số duy nhất cho mỗi kênh, không còn tranh luận cảm tính.

Mở dashboard
Bán lẻ đa kênhTrưởng phòng marketing

Ngân sách quảng cáo lãng phí (Meta / Google / TikTok)

Bảng so sánh chiến dịch theo ROAS thật (sau trừ hoàn hàng và phí sàn), nhóm 20% kém nhất tô màu để xem lại trước khi tiêu thêm. Liên kết ngược về kênh bán để hiểu chiến dịch nào kéo về đơn thật.

Mở dashboard
Bán lẻ đa kênhCEO

Brief CEO cuộc họp đầu tuần

Một trang A4 sáng thứ Hai 7h45: 3 điều tốt, 3 điều cần chú ý, 3 quyết định cần ra trong tuần. Mỗi gạch đầu dòng đều có nguồn để CEO click ra dòng gốc trong dashboard chi tiết.

Mở dashboard
Bước tiếp theo

Kết nối Meta Ads (Facebook + Instagram) 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.

Đặt lịch rà soát 30 phútXem toàn bộ nguồn dữ liệu