Playbook team Marketing

Bạn phụ trách paid media và analytics. Playbook này bao việc audit các chiến dịch quảng cáo đang (và đã) chạy trên Google Ads và Meta, kéo GA4 + Search Console, và đọc dữ liệu hành vi — tất cả chỉ đọc, nên bạn báo cáo mà không đụng tới chiến dịch.

Bạn làm được gì

• Chạy báo cáo Google Ads với truy vấn GAQL bất kỳ (campaign, ad group, keyword, search term, chi phí, conversion).
• Kéo insight Meta (Facebook / Instagram) Ads (spend, CTR, CPC, actions) ở cấp account / campaign / ad-set / ad, kèm breakdown.
• Đọc traffic GA4 và hiệu suất query/page Search Console.
• Đọc metric tương tác + heatmap Microsoft Clarity.
• Audit funnel, tỉ lệ opt-in và A2P (tuân thủ nhắn tin) trên GoHighLevel.

Điều kiện cần

1. Một token cấp phạm vi tới site của khách.
2. Google Ads: user Google gắn với site đã kết nối Google với scope adwords, Worker có GOOGLE_ADS_DEVELOPER_TOKEN, và site có google_ads_customer_id (một tài khoản leaf, không phải manager/MCC — cộng google_ads_login_customer_id khi truy cập qua MCC).
3. Meta Ads: Worker có META_APP_ID + META_APP_SECRET, user gắn với site đã kết nối Meta tại /admin/users, và site có meta_ad_account_id.
4. GA4 / Search Console: đã kết nối Google với scope Analytics + Search Console; site có ga4_property_id / gsc_site_url.
5. Clarity: site có clarity_project_id + token Data Export.

Tool chính

Tính năng	Tool
Google Ads	get_google_ads_report (GAQL, chi phí tính bằng micro)
Insight Meta Ads	get_meta_ads_insights
Cấu trúc account Meta	list_meta_ad_accounts, get_meta_ad_account, list_meta_campaigns, list_meta_adsets, list_meta_ads
GA4	get_ga4_report
Search Console	get_gsc_search_analytics
Clarity	clarity_get_metrics, clarity_get_heatmap_metrics, clarity_get_historical_metrics
Funnel / opt-in / A2P	ghl_get_funnel_stats, ghl_compute_opt_in_rate, ghl_get_campaign_a2p_stats
Báo cáo SEO gộp	generate_seo_report

Prompt mẫu

Audit Google Ads

Với "kleentech", chạy báo cáo Google Ads 30 ngày gần nhất: campaign theo chi phí
kèm click, conversion, CPC và CTR. Rồi truy vấn thứ hai cho keyword tốn tiền mà
0 conversion. Đánh dấu cái tôi nên tạm dừng.

Hai lần gọi get_google_ads_report. GAQL hữu ích để đưa cho nó:

SELECT campaign.name, metrics.cost_micros, metrics.clicks,
       metrics.conversions, metrics.average_cpc, metrics.ctr
FROM campaign WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.cost_micros DESC

Breakdown Meta Ads

Kéo insight Meta Ads cho "acme" 14 ngày gần nhất ở cấp campaign, rồi tách cái
tốn tiền nhất theo publisher_platform và theo age/gender. Tiền đi đâu và cái gì
đang convert?

get_meta_ads_insights với level=campaign, rồi breakdowns.

Organic so với paid

Với "acme-blog": session GA4 theo channel tháng trước, cộng click Search
Console. So organic search với số liệu paid từ Google Ads để tôi trình bày CAC
tổng hợp.

get_ga4_report + get_gsc_search_analytics + get_google_ads_report.

Friction landing page

Landing page paid của "acme" convert kém. Kéo metric rage-click và scroll-depth
Clarity cho URL đó trong 3 ngày gần nhất và cho biết user rớt ở đâu.

clarity_get_heatmap_metrics + clarity_get_metrics.

Cạm bẫy

Chú ý

• Mọi thứ ở đây chỉ đọc. Không có tool nào đổi ngân sách, tạm dừng chiến dịch, hay sửa ad. Bạn báo cáo; bạn đổi trong nền tảng quảng cáo.
• Chi phí Google Ads tính bằng micro — chia cost_micros cho 1.000.000 để ra số tiền.
• Đừng truy vấn metric từ tài khoản manager (MCC). google_ads_customer_id phải là tài khoản leaf, nếu không sẽ REQUESTED_METRICS_FOR_MANAGER. Đặt MCC vào google_ads_login_customer_id.
• Token Meta hết hạn (~60 ngày). E_META_TOKEN_EXPIRED nghĩa là user gắn với site phải kết nối lại Meta tại /admin/users.
• API công khai Clarity giới hạn 3 ngày mỗi lần gọi — dùng clarity_get_historical_metrics cho xu hướng dài hơn.

Đi tiếp

• Tham chiếu: tất cả tool — mọi tham số của các tool báo cáo.
• Playbook SEO — phía organic của cùng cái funnel.
• Playbook CRM — nối chi phí quảng cáo tới doanh thu đã đặt lịch.