Gestionar Apple Ads con una herramienta de codificación IA
Skill ads-manager permite que una herramienta de IA opere tu cuenta de Apple Ads a través de la CLI de Adapty. Hazle una pregunta en lenguaje natural, y la herramienta determina qué comandos la responden, lee primero la cuenta y propone la escritura antes de que nada llegue a Apple.
Un skill es un conjunto de instrucciones que tu herramienta de IA carga bajo demanda. Este incluye las partes de la superficie de Ads Manager donde es fácil equivocarse: qué identificador acepta cada flag, qué filtro acepta cada listado, cuántas palabras clave caben en un lote y qué llamadas cuestan dinero.
Qué gestiona
- Rendimiento de lectura: Elige la llamada exacta que responde a una pregunta en lugar de paginar resultados. Sabe que una pregunta de los N primeros requiere una llamada ordenada, y que contar entidades no necesita ninguna llamada de métricas.
- Cambios estructurales: Crea y actualiza campañas, grupos de anuncios, anuncios y palabras clave en el orden correcto, leyendo la entidad padre antes de escribir la hija.
- Trabajo con palabras clave: Añade y reajusta pujas de palabras clave en lotes, y convierte términos de búsqueda en palabras clave y palabras clave negativas.
- Automatizaciones: Configura automatizaciones basadas en reglas y las ejecuta en modo de prueba antes de que afecten a las pujas en producción.
- Investigación de competidores: Obtiene las palabras clave por las que pujan las apps de la competencia.
Qué no hará
La skill trata cada escritura como irreversible, porque lo es: la CLI no tiene función de eliminación y los cambios llegan a Apple en cuestión de segundos.
- Lee antes de escribir, en lugar de adivinar un ID o un presupuesto.
- Pide confirmación antes de cualquier comando que implique gasto, y mantiene el propio prompt de confirmación de la CLI cuando eres tú quien ejecuta el comando.
- Asigna una clave de idempotencia en cada escritura encadenada, de modo que volver a ejecutar tras un resultado incierto no cree una segunda campaña.
- Prefiere lotes pequeños, para que un rechazo parcial de Apple sea fácil de interpretar.
La habilidad recomienda y prepara comandos. Leer métricas y hacer simulaciones no tiene coste alguno, pero tú sigues siendo responsable de aprobar cualquier cambio en una cuenta publicitaria activa.
Instalar la habilidad
La habilidad ads-manager enseña a tu herramienta de codificación con IA a operar Apple Ads mediante los comandos adapty asa. Conoce el orden en que se componen los comandos, qué leer antes de escribir cualquier cosa y qué llamadas gastan dinero.
Herramientas compatibles: Claude Code, GitHub Copilot CLI, OpenAI Codex, Gemini CLI.
La habilidad utiliza el CLI de Adapty, así que instala y autentica el CLI primero; consulta la guía de inicio rápido. Los comandos adapty asa están disponibles a partir de Adapty CLI 0.4.0; en versiones anteriores no existen. Compruébalo con adapty asa whoami, que también te indica si hay una cuenta de Apple Ads conectada y si la empresa tiene una suscripción activa a Ads Manager.
En un espacio de trabajo corporativo Cowork, un administrador debe añadir tanto adapty.io como *.adapty.io a la lista de dominios permitidos. Añade ambos: un comodín no cubre el dominio raíz en la mayoría de las implementaciones de listas de permitidos, y el dominio raíz es donde vive la documentación que lee la habilidad. Hasta que ambos estén permitidos, la habilidad no puede acceder a Adapty.
Para instalar, elige la forma correspondiente a tu herramienta. La lista completa está en el README de la habilidad.
Claude Code
claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill
claude plugin install adapty-sdk-integration@adaptyEste plugin también contiene la habilidad de integración del SDK. Ambas se instalan juntas.
GitHub Copilot CLI
git clone https://github.com/adaptyteam/adapty-sdk-integration-skill.git
cp -r adapty-sdk-integration-skill/skills/* ~/.copilot/skills/Gemini CLI
gemini skills install https://github.com/adaptyteam/adapty-sdk-integration-skillOpenAI Codex u otra herramienta — usa el CLI de habilidades (ten en cuenta que las habilidades instaladas de esta forma no se actualizan automáticamente):
npx skills add adaptyteam/adapty-sdk-integration-skill --all--all instala ambas habilidades en todos los agentes que detecta. Para instalar solo esta habilidad, usa --skill ads-manager.
También puedes clonar el repositorio y copiar los directorios de skills/ en el directorio de habilidades de tu herramienta, o solo skills/ads-manager/ si únicamente quieres esta.
Tras instalar, ejecuta la habilidad en tu proyecto:
/ads-managerLeer métricas y hacer pruebas en seco no tiene ningún coste. Cualquier otro comando llega a Apple en segundos, gasta dinero real y no se puede deshacer — la habilidad pide confirmación antes de cada uno, y tú también deberías hacerlo.
Cómo se diferencia del agente de IA
Adapty Ads Manager también tiene un agente de IA integrado en el dashboard. Cada uno responde a necesidades distintas:
| Agente de IA | skill de ads-manager | |
|---|---|---|
| Dónde se ejecuta | El Adapty Dashboard | Tu terminal, en tu herramienta de IA para código |
| Qué hace | Analiza y recomienda | Analiza, recomienda y ejecuta los comandos |
| Configuración | Ninguna | CLI de Adapty más el skill |
Usa el agente de IA para saber qué está pasando en tu cuenta. Usa el skill cuando también quieras que el cambio se lleve a cabo.
¿Y ahora qué?
- Gestionar Ads Manager desde la CLI — las mismas tareas a mano, sin una herramienta de IA.
- Comandos de Ads Manager — todos los comandos con sus argumentos, flags y valores aceptados.