Google Ads¶
Kích hoạt theo yêu cầu
Rào cản khó nhất đã qua: MCC của Logidata đã được Google cấp developer token ở mức Standard. Báo Logidata khi bạn cần, nền tảng được bật cho tài khoản của bạn. Trang này ghi lại mô hình dữ liệu và các ràng buộc cần biết khi lập kế hoạch.
Base URL:
Một kết nối = một tài khoản quảng cáo (customer ID, dạng 123-456-7890).
Hai cách kết nối¶
| Cách | Tình trạng | Khi nào dùng |
|---|---|---|
| Link MCC — gửi yêu cầu liên kết tài khoản quảng cáo của bạn vào MCC của Logidata | Dùng được ngay | Mặc định. Không cần chờ Google xác minh gì thêm. |
| OAuth tài khoản của bạn — đăng nhập Google, cấp quyền trực tiếp | Đang trong giai đoạn thử nghiệm | Khi bạn không muốn (hoặc không thể) đưa tài khoản vào MCC bên thứ ba |
Với Link MCC, bạn nhập Google Ads ID của mình trên portal và gửi yêu cầu liên
kết trong Google Ads (MCC Logidata: 105-511-0068); Logidata xác nhận và kích
hoạt kết nối. Cả hai cách cùng dùng chung một tên nền tảng (google-ads) và một
khoá tra (customer_id) — code của bạn không phân biệt.
Điều Logidata làm hộ bạn¶
| Việc | Gọi thẳng Google Ads | Qua Logidata |
|---|---|---|
| Xin developer token | Nộp đơn, chờ duyệt, có thể bị từ chối | Đã có, mức Standard |
| OAuth2 + refresh token | Bạn dựng và tự bảo trì | Tự động |
| Liên kết tài khoản vào MCC | Bạn xử lý | Bấm một nút trên portal |
| Backoff khi Google giới hạn tần suất | Bạn viết | Tự động |
Vì sao “Standard” đáng giá
Developer token mức Basic bị chặn ở 15.000 operations/ngày — thường không đủ cho một tài khoản nhiều campaign, và việc nâng lên Standard là một quy trình xét duyệt riêng của Google. Logidata đã ở mức Standard, nên hạn mức bạn gặp là hạn mức trong gói Logidata, không phải trần của Google.
Nhóm dữ liệu¶
Allowlist chỉ đọc. Google Ads REST là POST + customer_id trong đường
dẫn, nên hai endpoint dưới đây gọi bằng POST; mọi endpoint :mutate bị chặn.
| Đường dẫn gốc | Dùng để |
|---|---|
/customers/{customer_id}/googleAds:searchStream |
Chạy một câu GAQL tuỳ biến — chi tiêu, hiệu suất campaign/ad group, từ khoá tìm kiếm thật (search_term_view) |
/customers/{customer_id}:generateKeywordIdeas |
Gợi ý từ khoá từ Keyword Planner |
Khác biệt lớn nhất: GAQL¶
Google Ads không có endpoint kiểu "lấy báo cáo với các tham số này". Bạn gửi một câu truy vấn bằng GAQL (Google Ads Query Language) trong body:
SELECT campaign.id, campaign.name, metrics.cost_micros, metrics.impressions
FROM campaign
WHERE segments.date BETWEEN '2026-08-01' AND '2026-08-07'
Ba hệ quả:
- Allowlist đường dẫn là không đủ. Với các nền tảng khác, "chỉ đọc" được đảm
bảo bằng danh sách endpoint. Ở đây câu truy vấn nằm trong body, nên Logidata
kiểm chính GAQL: giới hạn độ dài và whitelist
FROM <resource>. Hiện cho phépFROM:campaign,campaign_budget,ad_group,ad_group_ad,ad_group_criterion,keyword_view,search_term_view,click_view,customer. Cần resource khác thì báo Logidata. customer_idtrong đường dẫn phải khớp kết nối. Đổi số trong path để đọc tài khoản khác sẽ nhận403 customer_id_mismatch.- Đơn vị tiền tệ là micro.
cost_micros = 1.250.000nghĩa là 1,25 đơn vị tiền. Chia cho 1.000.000 trước khi hiển thị — đây là lỗi kinh điển khi mới dùng Google Ads API.
Keyword Planner¶
generateKeywordIdeas trả gợi ý từ khoá kèm volume tìm kiếm, mức cạnh tranh,
CPC gợi ý và lịch sử theo tháng. Truyền keyword_text (các từ khoá gốc cách
nhau bởi dấu phẩy).
Số liệu là volume Google Search, không phải YouTube
API chỉ trả volume của mạng Google Search. Giao diện Keyword Planner có tuỳ chọn YouTube nhưng API chưa mở ra — gắn nhãn "lượt tìm kiếm YouTube" cho con số này là sai sự thật. Muốn từ khoá thật trên chính website của bạn, xem Google Search Console.
Ràng buộc tần suất¶
Google không áp trần dùng chung theo app như TikTok Ads, nên Google Ads dễ mở rộng hơn hẳn cho khối lượng lớn. Vẫn có giới hạn hệ thống theo giờ mà Google không công bố con số; khi chạm, Logidata backoff rồi thử lại — khác với TikTok Ads, ở đây retry là hành vi đúng.
Nếu bạn có khối lượng lớn và được chọn nền tảng, Google Ads là hướng nên ưu tiên.
Cần dùng Google Ads?¶
Báo Logidata kèm số tài khoản quảng cáo và khối lượng dự kiến để được kích hoạt kết nối.