---
title: "Quản lý Apple Ads bằng công cụ lập trình AI"
description: "Cài đặt kỹ năng ads-manager để Claude Code, Copilot CLI, Codex, hoặc Gemini CLI có thể chạy các chiến dịch Apple Ads của bạn thông qua Adapty CLI."
---

Kỹ năng `ads-manager` cho phép công cụ AI hỗ trợ lập trình vận hành tài khoản Apple Ads của bạn thông qua [Adapty CLI](developer-cli-ads-manager). Chỉ cần đặt câu hỏi bằng ngôn ngữ thông thường, công cụ sẽ tự xác định những lệnh nào cần thiết, đọc thông tin tài khoản trước, rồi đề xuất thao tác ghi trước khi bất kỳ thay đổi nào được gửi đến Apple.

Một skill là tập hợp các hướng dẫn mà công cụ AI của bạn tải theo yêu cầu. Skill này bao gồm những phần của giao diện Ads Manager dễ gây nhầm lẫn nhất: định danh nào được mỗi flag chấp nhận, bộ lọc nào áp dụng cho từng danh sách, một batch chứa tối đa bao nhiêu từ khóa, và những lệnh nào phát sinh chi phí.

## Tính năng xử lý \{#what-it-handles\}

- **Hiệu suất đọc dữ liệu**: Chọn đúng một lệnh gọi để trả lời câu hỏi thay vì phải duyệt qua nhiều trang kết quả. Biết rằng câu hỏi top-N là một lệnh gọi có sắp xếp, và đếm thực thể không cần gọi metrics.
- **Thay đổi cấu trúc**: Tạo và cập nhật chiến dịch, nhóm quảng cáo, quảng cáo và từ khóa theo đúng thứ tự, đọc thực thể cha trước khi ghi thực thể con.
- **Làm việc với từ khóa**: Thêm và đặt lại giá thầu từ khóa theo lô, đồng thời thu thập các cụm từ tìm kiếm thành từ khóa và từ khóa phủ định.
- **Tự động hóa**: Thiết lập các quy tắc tự động hóa và chạy thử nghiệm trước khi áp dụng lên giá thầu thực.
- **Nghiên cứu đối thủ**: Lấy danh sách từ khóa mà các ứng dụng cạnh tranh đang đấu giá.

## Những gì nó sẽ không làm \{#what-it-will-not-do\}

Skill này coi mọi thao tác ghi là không thể hoàn tác, vì thực tế là như vậy — CLI không có lệnh xóa, và các thay đổi sẽ đến Apple trong vài giây.

- Nó đọc trước khi ghi, thay vì tự đoán ID hoặc ngân sách.
- Nó hỏi trước bất kỳ lệnh nào tốn tiền, và giữ nguyên lời nhắc xác nhận của chính CLI khi bạn là người chạy lệnh đó.
- Nó gắn một idempotency key cho mỗi lần ghi trong một chuỗi, để nếu chạy lại sau một kết quả không rõ ràng thì không tạo thêm campaign thứ hai.
- Nó ưu tiên các lô nhỏ, để khi Apple từ chối một phần thì vẫn dễ đọc.

:::note
Skill này đề xuất và chuẩn bị các lệnh. Việc đọc chỉ số và chạy thử không tốn chi phí, nhưng bạn vẫn chịu trách nhiệm phê duyệt mọi thay đổi ảnh hưởng đến tài khoản quảng cáo đang hoạt động.
:::

## Cài đặt skill \{#install-the-skill\}

[Kỹ năng ads-manager](https://github.com/adaptyteam/adapty-sdk-integration-skill) giúp công cụ AI của bạn vận hành Apple Ads thông qua các lệnh `adapty asa`. Nó biết thứ tự kết hợp các lệnh, những gì cần đọc trước khi thực hiện bất kỳ thay đổi nào, và những lệnh nào tiêu tốn tiền thật.

**Công cụ được hỗ trợ**: Claude Code, GitHub Copilot CLI, OpenAI Codex, Gemini CLI.

Kỹ năng này điều khiển Adapty CLI, vì vậy hãy cài đặt và xác thực CLI trước — xem [hướng dẫn quickstart](developer-cli-quickstart). Các lệnh `adapty asa` có trong **Adapty CLI 0.4.0 trở lên**; trên phiên bản cũ hơn, chúng không tồn tại. Kiểm tra bằng `adapty asa whoami`, lệnh này cũng cho biết tài khoản Apple Ads đã được kết nối chưa và công ty có đang đăng ký Ads Manager không.

Trong workspace Cowork của doanh nghiệp, quản trị viên phải thêm cả `adapty.io` và `*.adapty.io` vào danh sách cho phép tên miền. Hãy liệt kê cả hai: wildcard không bao gồm apex domain trong hầu hết các triển khai danh sách cho phép, và apex chính là nơi lưu trữ tài liệu mà kỹ năng cần đọc. Cho đến khi cả hai được cho phép, kỹ năng sẽ không thể kết nối đến Adapty.

Để cài đặt, chọn dạng phù hợp với công cụ của bạn. Danh sách đầy đủ có trong [README của kỹ năng](https://github.com/adaptyteam/adapty-sdk-integration-skill).

**Claude Code**

```bash
claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill
claude plugin install adapty-sdk-integration@adapty
```

Plugin này cũng bao gồm kỹ năng tích hợp SDK. Cả hai được cài đặt cùng nhau.

**GitHub Copilot CLI**

```bash
git clone https://github.com/adaptyteam/adapty-sdk-integration-skill.git
cp -r adapty-sdk-integration-skill/skills/* ~/.copilot/skills/
```

**Gemini CLI**

```bash
gemini skills install https://github.com/adaptyteam/adapty-sdk-integration-skill
```

**OpenAI Codex hoặc công cụ khác** — sử dụng [skills CLI](https://skills.sh) (lưu ý rằng các kỹ năng cài theo cách này không tự cập nhật):

```bash
npx skills add adaptyteam/adapty-sdk-integration-skill --all
```

`--all` cài đặt cả hai kỹ năng vào mọi agent được phát hiện. Để chỉ cài kỹ năng này, dùng `--skill ads-manager`.

Ngoài ra, bạn có thể clone repo và sao chép các thư mục trong `skills/` vào thư mục kỹ năng của công cụ — hoặc chỉ `skills/ads-manager/` nếu bạn chỉ muốn kỹ năng này.

Sau khi cài đặt, chạy kỹ năng trong dự án của bạn:

```bash
/ads-manager
```

Đọc số liệu và chạy thử (dry run) không tốn chi phí. Mọi lệnh khác đều tiếp cận Apple trong vài giây, tiêu tốn tiền thật và không thể hoàn tác — kỹ năng sẽ hỏi xác nhận trước mỗi lệnh, và bạn cũng nên làm vậy.

## Sự khác biệt so với AI Agent \{#how-it-differs-from-the-ai-agent\}

Adapty Ads Manager cũng có tích hợp sẵn [AI Agent](ads-manager-ai-agent) trong dashboard. Hai công cụ này phục vụ các nhu cầu khác nhau:

| | AI Agent | ads-manager skill |
|---|---|---|
| Chạy ở đâu | Adapty dashboard | Terminal của bạn, trong công cụ AI coding |
| Chức năng | Phân tích và đề xuất | Phân tích, đề xuất và thực thi lệnh |
| Thiết lập | Không cần | Adapty CLI cộng với skill |

Dùng AI Agent để tìm hiểu những gì đang xảy ra trong tài khoản của bạn. Dùng skill khi bạn muốn thay đổi đó được thực hiện luôn.

## Tiếp theo là gì \{#whats-next\}

- [Quản lý Ads Manager từ CLI](developer-cli-ads-manager) — thực hiện các thao tác tương tự theo cách thủ công, không cần công cụ AI.
- [Các lệnh Ads Manager](developer-cli-ads-manager-reference) — toàn bộ lệnh với các đối số, cờ và giá trị được chấp nhận.