AgentKit
Tài liệuBộ kitTham chiếu CLIỨng dụng Desktop

Skill

Thiết kế paid-ad campaign với ak:paid-ads

Xây dựng paid-media strategy, audience plan, copy, creative test và measurement framework có thể review mà không giả định account access hay launch authority.

Dùng ak:paid-ads để biến offer, audience, objective, platform context và ranh giới budget đã duyệt thành paid-media strategy cùng creative testing package. Skill giúp chọn campaign type, tạo campaign và audience structure, soạn copy, lập kế hoạch creative, xác định retargeting và sắp xếp quyết định measurement cùng optimization.

Source đã phát hành của Skill giả định có ad-platform context, nhưng không đóng gói direct account-management script hay chứng minh credential đã được cấu hình. Hãy coi output là proposal cho đến khi một người duyệt mọi live operation.

Chọn ak:paid-ads cho strategy và creative direction

Dùng ak:paid-ads khi

  • Bạn cần paid-media brief cho Google Ads, Meta, LinkedIn, X, TikTok hoặc platform được chỉ định khác.
  • Bạn cần campaign và audience structure, ad-copy variant, creative direction, retargeting stage hoặc testing backlog.
  • Bạn muốn chẩn đoán bằng chứng CPA, ROAS, CTR, conversion, spend hay funnel được cung cấp và đề xuất experiment có giới hạn tiếp theo.
  • Bạn cần budget allocation proposal gắn với target và bằng chứng rõ ràng.

Chọn workflow khác khi

  • Bạn cần authenticated reporting của Google hoặc Meta hay thay đổi account. Dùng ak:ads-management và duyệt chính xác script action.
  • Bạn cần điều phối paid media với email, organic, content và launch asset. Dùng ak:campaign.
  • Bạn cần phase plan cấp launch thay vì media plan cấp campaign. Dùng ak:launch-strategy.
  • Bạn thiếu offer đã duyệt, claim đúng, audience evidence, landing destination hoặc tracking definition. Hãy xử lý trước.

Chuẩn bị campaign contract

Cung cấp platform và campaign type, primary objective, product hoặc offer đã duyệt, landing destination, customer evidence, geography, exclusion, brand và compliance constraint, campaign history hiện tại, creative khả dụng, tracking state, budget ceiling, target metric cùng review date.

Nếu có thể dùng customer list, pixel, tag hoặc conversion event, hãy nêu data source, consent basis, retention boundary và người có thể duyệt upload hay instrumentation. Không đưa credential value hoặc raw personal data vào prompt.

RuntimeCách gọiRanh giới khả dụng
Claude Code/ak:paid-ads ...Phân phối native là mặc định; plugin delivery là lựa chọn rõ ràng. Platform access vẫn tách biệt.
Cursor/ak:paid-ads ...Cách gọi slash đã được người dùng xác minh. Điều này không thiết lập parity cho provider hay automation.
Codex$ak:paid-ads ...Hỗ trợ native Skill discovery. Codex chỉ projection Marketing automation được hỗ trợ.

Đọc Runtime adapter trước khi giả định integration hoặc Hook đang hoạt động.

Gọi workflow ưu tiên draft

/ak:paid-ads "Draft a Meta lead-generation campaign for the approved operations brief. Use only supplied customer research, keep total test spend at or below $8,000, and produce copy, creative briefs, audience exclusions, and a measurement plan. Do not access or change an ad account"

Argument shape canonical là [platform] [campaign-type]. Thêm ranh giới account và authority trong prose kể cả với yêu cầu draft-only.

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

  1. Xác nhận goal và constraint. Xác định business objective, conversion, value, budget period cùng ceiling, target metric, geography, claim, compliance và non-goal.
  2. Xác nhận offer và audience. Ground landing destination, offer, pain point, search hoặc interest evidence, exclusion, kết quả trước đây và first-party data khả dụng.
  3. Chọn platform và structure. So sánh platform context hiện tại, sau đó đề xuất campaign, ad-group hoặc ad-set, audience, placement, naming cùng budget structure. Xác minh product name và campaign type bằng tài liệu provider chính thức hiện tại.
  4. Tạo draft package. Tạo copy variant, call to action, creative direction, landing-message alignment, retargeting stage cùng test hypothesis. Mọi proof point hoặc urgency claim phải truy về bằng chứng đã duyệt.
  5. Xác định measurement. Map metric theo objective, conversion event, UTM naming, attribution assumption, pacing check, reporting cadence và bằng chứng cần để đổi hoặc dừng test.
  6. Review trước khi vận hành. Một người xác minh audience, data use, platform policy, rights, claim, budget, account, tracking và activation state trước khi giao action đã duyệt cho operating workflow.

Tách riêng tác động account và spend

Strategy không cấp platform authority

Không suy ra quyền truy cập từ role wording của Skill. Tạo audience, upload customer list, cài pixel, tạo campaign, publish ad, đổi bid hay budget và enable delivery đều là external mutation riêng. Mỗi mutation cần đúng account, least-privilege credential, current policy review, spend ceiling chính xác và human approval.

Tách rõ các tác động sau:

Tác độngQuyết định bắt buộc
Draft copy, structure và creative briefDuyệt claim, brand fit, rights và review status trước khi dùng.
Tracking hoặc audience planDuyệt consent, data field, retention, destination và provider term trước implementation hay upload.
Budget recommendationDuyệt currency, daily cùng total ceiling, allocation và stop condition; recommendation không đổi account.
Tạo hoặc sửa account objectPreview chính xác account cùng object ID, field, state và rollback path trong operating workflow.
Publish hoặc enableYêu cầu go/no-go owner có tên; activation có thể gây tác động audience và spend ngay lập tức.

Review output và bằng chứng

Kết quả hoàn tất nên gồm campaign objective cùng non-goal, lý do chọn platform, campaign cùng audience structure, exclusion, copy và creative variant, landing-message alignment, budget proposal, tracking map, test matrix, report cadence, stop condition và approval còn mở.

Với mọi analysis, ghi source, date range, currency, conversion definition, attribution window, reporting delay cùng data gap. Coi performance target được đề xuất là planning input, không phải prediction. Skill không xác định output file path canonical, vì vậy hãy thống nhất destination có kiểm soát trước khi ghi file.

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

Triệu chứngBước tiếp theo an toàn
Runtime không nhận diện ak:paid-adsXá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.
Guidance platform hoặc campaign type có vẻ cũKiểm tra tài liệu product và policy chính thức hiện tại của provider; giữ plan ở draft-only đến khi đối chiếu xong.
Target CPA hoặc ROAS không có bằng chứngĐánh dấu là assumption, tính từ unit economics cùng current data đã duyệt hoặc để quyết định mở.
Audience data được yêu cầu mà không có consent contextKhông upload hay để lộ dữ liệu. Trước tiên xác định field được phép, lawful basis, retention và account owner.
Skill bắt đầu coi plan là live changeDừng và nêu lại “draft-only” hoặc route action chính xác đã duyệt sang ak:ads-management.
Metric từ các platform không khớpĐối chiếu time zone, currency, attribution window, conversion event, deduplication và reporting delay trước khi đề xuất spend change.

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

  • Ví dụ platform và threshold trong package là historical guidance, không phải provider contract hiện tại hay performance guarantee.
  • Skill không tự thiết lập credential availability, account access, media rights, consent hay budget authority.
  • Skill có thể đề xuất test và optimization choice nhưng không thể đảm bảo reach, acquisition cost, conversion, revenue hay return on spend.
  • Cách gọi Cursor đã được người dùng xác minh; capability provider và runtime vẫn phụ thuộc setup.

Tiếp tục với Tổng quan Marketing Kit hoặc so sánh ak:ads-management trước khi duyệt live paid-media work.