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

Google Ads

Quảng cáo trên Google Search, Display, YouTube và Shopping Ads.

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

12-20 giờ (cộng 1-2 tuần chờ Developer Token) · 2 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

    Apply Google Ads API Developer Token

    Vào Google Ads UI > Tools > API Center > Apply for Standard Access. Phê duyệt 1-2 tuần. Test access cho phép dùng ngay với test account.

  2. 2

    Tạo OAuth2 Client trong Google Cloud Console

    Tạo project mới hoặc dùng project sẵn có. APIs & Services > Credentials > Create OAuth Client ID type 'Desktop' hoặc 'Web'.

  3. 3

    Get refresh token qua OAuth flow

    Login với account có quyền vào Google Ads. Grant access. Lưu refresh_token (không hết hạn nếu không revoke).

  4. 4

    Xác định MCC và customer ID

    Nếu bạn quản lý nhiều ad account qua MCC, login-customer-id là MCC ID. customer-id là ad account cụ thể.

  5. 5

    Kết nối qua client library

    Cài thư viện google-ads (Python/Node/Java). Query GAQL: SELECT campaign.id, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_30_DAYS.

  6. 6

    Cron job daily pull

    Pull 30 ngày trước mỗi tối. Đẩy về warehouse với upsert theo (customer_id, campaign_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.

  • Developer Token
  • OAuth Client ID + Secret
  • Refresh Token
  • MCC ID (nếu dùng)
  • Customer 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
  • metrics.cost_micros
  • metrics.impressions
  • metrics.clicks
  • metrics.conversions
  • metrics.conversions_value
  • segments.date
  • ad_group.id

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.

  • Developer Token approval mất 1-2 tuần, lên kế hoạch trước.
  • GAQL khác SQL chuẩn, cần học cú pháp và resource model trước khi viết query phức tạp.
  • metrics.cost_micros là phần triệu (chia 1.000.000 để ra đơn vị tiền), dễ nhầm.
  • Conversion attribution có thể update trong 7-14 ngày, cần refresh historical data.
  • Shopping campaigns trả về thêm segments.product_item_id, cần join với feed để có tên sản phẩm.

Dashboard sử dụng Google Ads

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 Google 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.

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