Vận hành paid media an toàn với ak:ads-management

Lập kế hoạch, kiểm tra và tối ưu paid ads trong khi tách draft cùng report khỏi thay đổi account, budget, tracking và activation có credential.

Dùng ak:ads-management cho paid-media setup, copy, targeting, creative brief, measurement, account reporting và optimization có kiểm soát. Skill bao phủ Google Ads, Meta Ads, LinkedIn Ads và TikTok Ads ở lớp planning. Skill cũng đóng gói script Google và Meta API trực tiếp; write action của chúng có thể thay đổi live account, budget, asset và delivery state.

Chọn ak:ads-management cho vận hành paid media

Dùng ak:ads-management khi

Bạn cần campaign structure riêng theo platform, bidding proposal, audience plan, ad-copy variant, creative requirement hoặc test design.
Bạn cần đọc report tài khoản Google hoặc Meta bằng credential đã duyệt.
Bạn cần plan có kiểm soát cho budget pacing, negative keyword, pause, activation hoặc thay đổi account khác.
Bạn muốn tạo draft image hoặc video asset sau khi duyệt riêng generation provider, input, output location và chi phí có thể phát sinh.

Chọn workflow khác khi

Bạn cần paid-ad strategy và creative package mà không vận hành account. Dùng ak:paid-ads.
Bạn cần campaign đa kênh được điều phối, gồm email, content hoặc organic work. Dùng ak:campaign.
Bạn cần organic social, SEO, email marketing hoặc website development. Đây là các phạm vi Skill loại trừ rõ ràng.
Bạn chưa có platform policy hiện tại, account access, tracking consent hoặc spend boundary đã duyệt. Hãy chuẩn bị chúng trước mọi API mutation.

Chuẩn bị ranh giới account và credential

Cung cấp platform, campaign type, objective, account identifier đã duyệt, bằng chứng audience, offer và claim, geography, exclusion, daily và total budget ceiling, tracking definition, date range cùng output mong muốn. Đánh dấu yêu cầu là planning, reporting hay mutation; không để lựa chọn này ngầm định.

Script Google nhận google-ads.yaml hoặc các environment variable sau: GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CUSTOMER_ID và GOOGLE_ADS_LOGIN_CUSTOMER_ID. Script Meta dùng META_APP_ID, META_APP_SECRET, META_ACCESS_TOKEN và META_AD_ACCOUNT_ID. Không đưa value vào prompt, output, source control hay screenshot. Chỉ dùng đúng ad account và provider role có least privilege.

Runtime	Cách gọi	Ranh giới khả dụng
Claude Code	`/ak:ads-management ...`	Phân phối native là mặc định; delivery plugin là lựa chọn rõ ràng. Provider tool và credential vẫn được cấu hình riêng.
Cursor	`/ak:ads-management ...`	Cách gọi slash đã được người dùng xác minh. Điều này không chứng minh behavior provider, Agent hay Hook tương đương.
Codex	`$ak:ads-management ...`	Hỗ trợ native Skill discovery. Hook chỉ được projection một phần và không có Marketing statusline.

Xem Runtime adapter để hiểu khác biệt theo từng component.

Gọi paid-media task có giới hạn

/ak:ads-management "Google Search campaign for approved brand terms. Inspect the supplied export, draft structure and copy, and propose a $150/day ceiling. Do not use credentials or change the account"

/ak:ads-management "Google Search campaign for approved brand terms. Inspect the supplied export, draft structure and copy, and propose a $150/day ceiling. Do not use credentials or change the account"

$ak:ads-management "Google Search campaign for approved brand terms. Inspect the supplied export, draft structure and copy, and propose a $150/day ceiling. Do not use credentials or change the account"

Argument hint của Skill là [platform] [campaign-type], nhưng yêu cầu an toàn cũng nêu bằng chứng, account, budget, quyền hạn và điểm dừng.

Đi qua các giai đoạn paid media

Xác định contract. Xác nhận objective, platform, account, campaign type, audience, exclusion, claim, landing destination, budget ceiling, success measure và lần chạy chỉ tạo draft, read-only hay được phép mutate.
Research và tạo structure. Review keyword, competitor, account và audience evidence được cung cấp; đề xuất campaign, ad-group hoặc ad-set, bidding, placement cùng exclusion structure.
Tạo asset có thể review. Soạn ad copy, creative brief, variant và measurement requirement. Image hoặc video được tạo là network action riêng, cần provider access cùng content review.
Xác minh tracking. Xác định conversion, value, attribution assumption, naming và report field. Thiết lập Pixel, CAPI, GTM, customer list hoặc tương tự làm thay đổi việc thu thập dữ liệu và phải được duyệt độc lập.
Chỉ vận hành trong phạm vi đã duyệt. Đọc report trước. Preview chính xác ID, field, amount và state dự kiến trước mọi lệnh create, upload, pause, enable, keyword hay budget.
Đo lường và ghi nhận. Ghi provider response, account và object ID, time range, spend unit, before/after state cùng thời điểm review tiếp theo. Coi recommendation là hypothesis, không phải kết quả được đảm bảo.

Tách read khỏi live mutation

Skill đã cài gồm scripts/google-ads-manager.py và scripts/meta-ads-manager.py. Chỉ chạy chúng từ bản cài đáng tin cậy sau khi review provider API cùng source script hiện tại.

Bề mặt script	Tác động
Google `report --days <n> [--customer-id <id>]`	Đọc hiệu suất campaign và in JSON. Nó vẫn tạo authenticated network request và đưa account data vào local process.
Google `create-campaign --name <name> --budget <amount>`	Tạo budget resource và Search campaign ở trạng thái paused. Amount là daily budget USD trong script được đóng gói.
Google `pause` / `enable --campaign-id <id>`	Đổi delivery state của campaign. `enable` có thể bắt đầu delivery và spend.
Google `add-negative-keyword --campaign-id <id> --keyword <text>`	Tạo campaign-level broad negative keyword.
Google `update-budget --budget-id <id> --amount <amount>`	Đổi daily budget USD được tham chiếu.
Meta `report --preset <value> --level <campaign\|adset\|ad>` / `list-campaigns [--status <value>]`	Đọc account data và in JSON.
Meta `create-campaign --name <name> --objective <value>`	Tạo campaign paused. Common objective value trong package là `traffic`, `awareness`, `engagement`, `leads`, `sales` và `app_promotion`.
Meta `create-adset --campaign-id <id> --name <name> --budget <amount> --countries <codes>`	Tạo ad set paused; amount được chuyển thành daily USD value tính theo cent. Age field tùy chọn là `--age-min` và `--age-max`.
Meta `create-ad --adset-id <id> --name <name> --page-id <id> --image <path> --link <url> --message <text>`	Upload image, tạo creative và tạo ad paused. Đây là mutation bền vững trên account ngay cả trước activation.
Meta `pause` / `enable --id <id> --type <campaign\|adset\|ad>`	Đổi delivery state. `enable` có thể kích hoạt spend.
Meta `update-budget --adset-id <id> --budget <amount>`	Đổi daily budget USD của ad set được tham chiếu.

Enable là quyết định chi tiêu

Object paused vẫn là live account mutation, còn object enabled có thể deliver ngay. Trước mọi write, xác minh provider account, object ID, currency và unit, total cùng daily ceiling, targeting, destination, creative rights, tracking consent, policy status và rollback owner. Yêu cầu approval mới cho enable và mỗi lần tăng budget.

Ví dụ creative generation trong package dùng external command và có thể tải package, gửi prompt hoặc asset tới provider, tiêu quota và ghi image hay video file. Duyệt riêng các tác động đó; review brand, rights, disclosure, likeness, claim và platform specification trước khi dùng.

Review output và bằng chứng

Một lần chạy hoàn tất nên cung cấp campaign structure, copy và creative variant, targeting cùng exclusion, bidding và budget proposal, tracking map, test design cùng operation log. Với API work, giữ exact command, account cùng object ID, before/after state, JSON trả về, timestamp, approver và mọi provider warning hay partial failure.

Không ghi credential value. Không gọi CTR, CPA, ROAS, conversion rate hoặc scaling result dự đoán là outcome. Threshold lịch sử và platform specification đóng gói cùng Skill cần được xác minh hiện tại.

Xử lý sự cố an toàn

Triệu chứng	Bước tiếp theo an toàn
Runtime không tìm thấy `ak:ads-management`	Xác nhận target và scope Marketing Kit, khởi động lại runtime, rồi làm theo Runtime không tìm thấy Skill hoặc Agent.
Thiếu dependency hoặc provider SDK	Dừng trước mutation. Review Skill đã cài và setup chính thức hiện tại của provider; không cài hay tải package khi chưa được duyệt.
Thiếu credential hoặc account ID	Giữ lần chạy ở draft-only. Yêu cầu account owner cấu hình least-privilege access bên ngoài prompt.
Report rỗng hoặc metric không khớp	Xác minh account, date range, level, currency, conversion definition, attribution window và độ trễ report của provider. Giữ raw response.
Preview hiện object hoặc amount sai	Dừng. Resolve ID và unit từ account data read-only; không dùng identifier đoán được hay corrective live write.
Write thành công một phần	Không rerun mù quáng. Ghi ID trả về cùng provider state, kiểm tra read-only, rồi chuẩn bị recovery action có giới hạn để duyệt.
Rule platform hiện tại khác bundled reference	Theo tài liệu và policy chính thức hiện tại của provider; coi material trong package là historical workflow guidance.

Biết các giới hạn hiện tại

Direct script chỉ bao phủ Google và Meta; material LinkedIn cùng TikTok là planning guidance, không phải direct API manager được đóng gói.
Provider API, policy, objective, format, attribution, pricing và SDK có thể thay đổi độc lập với AgentKit.
Skill không thể đảm bảo approval, delivery, reach, conversion, revenue, CPA, ROAS hay creative performance.
Cài runtime không cấp provider credential, account authority, tracking consent, media rights hay budget approval.

Tiếp tục với Tổng quan Marketing Kit và Projects, artifacts và checkpoints để hiểu ranh giới runtime ownership cùng recovery.

Vận hành paid media an toàn với ak:ads-management

On this page