Hướng dẫn · Cập nhật 2026-10-08

Hiểu hệ thống, chuẩn bị setup, khai thác hiệu quả

Cập nhật 2026-10-08. Ba sơ đồ trong diagrams/ (mở bằng trình duyệt, hoặc index.html):

File Nội dung
diagrams/01-google-ads-mcp.html Google Ads MCP: chỉ đọc, ba tool, đọc toàn MCC; AI phân tích, người thực hiện thay đổi.
diagrams/02-ban-do-mcp-google.html Bản đồ mọi MCP chính thức của Google mà studio game chạm được, và chỗ nào chưa có (AdMob, Play).
diagrams/03-trien-khai-ai-o-dau.html Nên đặt AI ở đâu: máy cá nhân, server riêng hay cloud, kèm bảng so sánh và lộ trình 3 giai đoạn.

1. Google Ads MCP hôm nay là gì

Theo mã nguồn googleads/google-ads-mcp (v0.0.4, 2026-09-25) và tài liệu Google:

  • Máy chủ chỉ đọc. Mỗi tool mang cờ readOnlyHint=True. Không có tool mutate, không có recommender, không có "write proxy".
  • Có đúng 3 tool: list_accessible_customers, search (agent tự viết GAQL), get_resource_metadata. Kèm 4 resource: discovery document, metrics, segments, release notes.
  • Bạn tự chạy (pipx run google-ads-mcp, stdio) hoặc tự host dạng Streamable HTTP với OAuth proxy. Google không vận hành endpoint Ads MCP nào.
  • Google nói sẽ thêm quyền ghi, bật tùy chọn qua tools_config.yaml (issue #84, 2026-06), nhưng chưa phát hành.
  • Dữ liệu LTV/retention không đi qua máy chủ này. Nó đến từ GA4 MCP hoặc BigQuery MCP (mục 2).

Vì vậy mô hình đúng hôm nay là: AI đọc toàn bộ MCC, phân tích, đề xuất; người thực hiện thay đổi trong giao diện Google Ads. Đây cũng là mô hình an toàn nhất, nên không phải là bất lợi.

Quyền truy cập hợp lệ gắn với access level của Google Ads API trên Cloud project (Explorer, Basic, Standard). Từ 2026-09-09 Google bỏ developer token, access level nằm trên project. Explorer đủ cho thử nghiệm (2.880 thao tác/ngày); Basic/Standard cần cho dùng hằng ngày trên MCC nhiều tài khoản. Nếu Google cấp quyền riêng cho doanh nghiệp, cần làm rõ đó là access level API hay quyền ghi giai đoạn thử nghiệm (khi đó Google sẽ cung cấp cấu hình tools_config.yaml hoặc gói riêng).

1.1 Ba tool làm gì, lấy được gì

Tool Nhận Trả Dùng để
list_accessible_customers không tham số (tài khoản OAuth đã đăng nhập) danh sách customer ID được cấp quyền trực tiếp (với MCC: ID MCC và tài khoản gán thẳng) biết hỏi tài khoản nào; liệt kê toàn bộ tài khoản con bằng search trên customer_client
get_resource_metadata tên resource (campaign, ad_group, change_event…), login_customer_id field chọn được / lọc được / sắp xếp được, kèm metrics.* và segments.* tương thích agent không đoán tên field; cache lại trong phiên
search customer_id, resource, fields[], conditions[], orderings[], limit, login_customer_id các dòng JSON của câu GAQL SELECT … FROM … WHERE … ORDER BY … LIMIT qua search_stream mọi báo cáo: chi phí/lượt cài/CPI theo chiến dịch (campaign), theo quốc gia (geographic_view), asset LOW (ad_group_ad_asset_view), ngân sách (campaign_budget), ai đổi gì (change_event, LIMIT ≤ 10000), gợi ý của Google (recommendation), tài khoản con (customer_client)

Chi phí trả về ở micros (chia 1.000.000). Bốn resource đọc kèm: discovery-document, metrics, segments, release-notes. Ví dụ lời gọi cụ thể nằm trên dashboard, mục "Ba tool".

2. Những hệ thống Google nào mở MCP

Hệ thống Có MCP chính thức? Ai chạy Đọc / ghi Dùng cho studio game
Google Ads (MCC, App Campaigns) Có, google-ads-mcp Bạn tự chạy Chỉ đọc Chi phí, CPI, chuyển đổi, asset, change history, recommendation của Google
Google Analytics 4 / Firebase Analytics Có, analytics-mcp (experimental, v0.7.0) Bạn tự chạy Chỉ đọc Retention, phễu, sự kiện, doanh thu IAP; doanh thu AdMob nếu đã liên kết AdMob với Firebase
Firebase (Crashlytics, Remote Config, Firestore, Auth, FCM) Có, firebase-tools mcp Bạn tự chạy Đọc + ghi Crash theo bản build, bật tắt Remote Config (cẩn trọng vì là ghi)
BigQuery Có, bigquery.googleapis.com/mcp (GA 2026-04) Google host Đọc; ghi nếu IAM cho phép Kho dữ liệu tổng hợp UA + AdMob + Play; chặn ghi bằng IAM deny
Google Workspace (Gmail, Drive, Docs, Sheets, Slides, Calendar, Chat) Có, Developer Preview (2026-05) Google host Đọc + ghi hạn chế (Gmail chỉ tạo nháp) Báo cáo tự động vào Sheets/Docs, lịch họp, tóm tắt email đối tác
AdMob Chưa Đi vòng: liên kết AdMob với Firebase để GA4 có doanh thu quảng cáo; hoặc job gọi AdMob API ghi vào BigQuery/Sheets
Play Console Chưa Bật xuất báo cáo Play sang BigQuery/Cloud Storage rồi hỏi qua BigQuery MCP
YouTube, Search Console, SA360, DV360, CM360 Chưa Chỉ có bản cộng đồng, không chính thức

Mọi máy chủ Google host đều dùng được từ Claude (Desktop, Code, claude.ai custom connector), ChatGPT, Cursor, Gemini CLI. Không phải chỉ Gemini.

3. Chuẩn bị setup cho tài khoản MCC (UA) và AdMob (monetization)

3.1 Google Cloud project của công ty (bắt buộc, làm một lần)

  1. Tạo (hoặc dùng) một Cloud project thuộc tổ chức Workspace của công ty, không dùng project cá nhân.
  2. Bật API: Google Ads API, Google Analytics Admin API, Google Analytics Data API, BigQuery API (nếu dùng), Firebase Management API (nếu dùng Firebase MCP).
  3. Vào Google Ads API Center (trong giao diện MCC) để xin/kiểm tra access level của project. Explorer thường được cấp tự động; xin Basic nếu dùng hằng ngày.
  4. Tạo OAuth client (loại Desktop cho giai đoạn 1; loại Web nếu host server). Nếu Workspace admin bật "Manage third-party app access", đánh dấu client này là Trusted.

3.2 Giai đoạn 1: chạy trên laptop của Giám đốc Marketing (chỉ đọc, vài giờ)

# 1. Cài pipx và gcloud (một lần)
brew install pipx google-cloud-sdk

# 2. Đăng nhập ADC bằng tài khoản Google có quyền trên MCC, kèm scope adwords
gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=/path/to/oauth-desktop-client.json
# Ghi lại đường dẫn "Credentials saved to file: [...]"

# 3. Thêm vào Claude Code (hoặc dán khối mcpServers tương đương vào Claude Desktop)
claude mcp add google-ads-mcp \
  -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/adc.json \
  -e GOOGLE_PROJECT_ID=your-cloud-project-id \
  -e GOOGLE_ADS_LOGIN_CUSTOMER_ID=1234567890 \
  -- pipx run --spec "google-ads-mcp==0.0.4" google-ads-mcp

GOOGLE_ADS_LOGIN_CUSTOMER_ID là ID của MCC (bỏ dấu gạch). Nhờ nó, mọi truy vấn đi qua manager account và list_accessible_customers trả về toàn bộ tài khoản UA con. Agent có thể ghi đè bằng tham số login_customer_id trên từng lời gọi.

Cài thêm skill chính thức của Google để agent viết GAQL đúng hơn:

claude plugin install google-ads@skills

Kiểm tra: hỏi Claude "what customers do I have access to?" rồi "chi phí và lượt cài theo chiến dịch 7 ngày qua cho customer id X".

3.3 GA4 và AdMob

  1. Trong AdMob, liên kết app AdMob với Firebase project (AdMob > Apps > App settings > Link to Firebase). Sau khi liên kết, GA4 có các metric doanh thu quảng cáo (totalAdRevenue, publisherAdImpressions) theo nguồn cài đặt.
  2. Chạy GA4 MCP: claude mcp add analytics-mcp -- pipx run analytics-mcp với ADC đã có scope analytics.readonly.
  3. Khi cần dữ liệu AdMob chi tiết hơn GA4 (eCPM theo ad unit, mediation), viết một job nhỏ gọi AdMob API (admob.googleapis.com, report mediationReport/networkReport) ghi vào BigQuery hoặc Google Sheets theo lịch, rồi hỏi qua BigQuery MCP hoặc Sheets MCP.

3.4 Giai đoạn 2: đưa lên server (1–3 tuần)

  • Host google-ads-mcp dạng Streamable HTTP với OAuth proxy (biến GOOGLE_ADS_MCP_OAUTH_CLIENT_ID/SECRET, GOOGLE_ADS_MCP_BASE_URL, GOOGLE_ADS_MCP_STORAGE_TYPE=firestore|redis, GOOGLE_ADS_MCP_LOGIN_CUSTOMER_ID). Repo có Dockerfile, Quadlet cho Podman và recipe Cloud Run.
  • Mỗi người dùng vẫn tự đăng nhập Google qua OAuth proxy (đúng chính sách Google: "end-users should manually sign in"); server không giữ mật khẩu ai.
  • Thêm agent runtime (Claude Agent SDK hoặc tương đương) cho báo cáo sáng, cảnh báo CPI/ROAS, gửi đề xuất qua Slack/email. Ghi nhật ký mọi lời gọi tool.
  • Nếu dùng BigQuery MCP: cấp roles/mcp.toolUser + bigquery.jobUser + dataViewer, và đặt IAM deny trên tool.isReadOnly == false cho project production. Bật Data Access audit log (mặc định tắt).

4. Khai thác thế nào cho hiệu quả

Vì máy chủ chỉ đọc, giá trị nằm ở phân tích nhanh và sâu trên toàn MCC, thứ mà giao diện Google Ads làm chậm:

  1. Báo cáo sáng tự động (ROAS thực): chi phí và lượt cài theo chiến dịch/quốc gia từ Ads MCP, ghép với doanh thu IAP + AdMob từ GA4 MCP theo first_user_campaign. Agent tự ghép, tự tính payback D7/D30.
  2. Chẩn đoán CPI tăng: agent so sánh theo ngày, theo asset group, theo quốc gia; đọc change_event để tìm thay đổi nào gây ra; đọc recommendation để thấy Google gợi ý gì.
  3. Rà soát asset: hiệu suất video/ảnh/text theo nhóm asset, phát hiện asset "Low" để đội creative thay.
  4. Theo dõi pacing ngân sách: so chi tiêu luỹ kế với ngân sách tháng, cảnh báo qua Slack trước khi vượt.
  5. Kiểm tra sức khoẻ MCC: tài khoản nào bị từ chối quảng cáo, thanh toán lỗi, chiến dịch "Limited by budget".
  6. Monetization: eCPM và fill rate theo ad unit/quốc gia (qua GA4 nếu liên kết AdMob với Firebase, hoặc qua BigQuery nếu đã xuất AdMob API), tương quan với retention để tránh quá tải quảng cáo.

Cách làm việc hiệu quả: mỗi bài phân tích lặp lại hãy đóng thành một prompt mẫu hoặc một skill (Claude Code skill) để ai trong team cũng chạy ra cùng một báo cáo; để agent ghi kết quả vào Google Sheets qua Workspace MCP thay vì chỉ trả lời trong chat.

Những gì không nên kỳ vọng hôm nay: agent tự đổi bid, tạm dừng chiến dịch, tạo campaign. Khi Google mở quyền ghi, bật nó chỉ trên server, mọi thay đổi xếp hàng chờ người duyệt (mẫu "tạo ở trạng thái tạm dừng, người kích hoạt" mà Meta Ads MCP đang áp dụng).

5. Nên đặt AI ở đâu

Khuyến nghị: người ở máy cá nhân, máy chủ MCP và quyền ở server.

  • Giai đoạn 1 (tuần 1–2): laptop CMO, stdio, chỉ đọc. Đủ để học và đánh giá.
  • Giai đoạn 2 (tháng 1–2): một VPS hoặc máy nội bộ host Ads MCP + GA4/BigQuery MCP sau cổng SSO, chạy báo cáo theo lịch, ghi nhật ký. Cloud (Cloud Run/Google Cloud) khi không có người vận hành server hoặc dữ liệu đã ở BigQuery.
  • Giai đoạn 3: mở quyền ghi có kiểm soát khi Google phát hành.

Lý do không để lâu dài trên laptop: token OAuth của CMO nằm trên máy cá nhân, không có nhật ký, không chạy nền, không chia sẻ được cho team.

6. Nguồn

Google MCP cho doanh nghiệp game · dashboardKiểm chứng tới 2026-10-08 · nguồn: googleads/google-ads-mcp, docs.cloud.google.com/mcp