Yapay Zeka Kodlama Aracıyla Apple Ads'i Yönetin
ads-manager skill’i, bir AI kodlama aracının Apple Ads hesabınızı Adapty CLI üzerinden yönetmesini sağlar. Düz bir dille soru sorun; hangi komutların yanıt vereceğini bulur, önce hesabı okur ve Apple’a bir şey ulaşmadan önce yapılacak yazma işlemini önerir.
Skill, yapması kolay hataları barındıran Ads Manager yüzeyinin bölümlerini taşıyan bir dizi talimattır: her flag’in hangi tanımlayıcıyı kabul ettiği, her listenin hangi filtreyi aldığı, bir toplu işleme kaç anahtar kelime sığdığı ve hangi çağrıların ücretli olduğu.
Ne işe yarar
- Okuma performansı: Bir soruyu yanıtlayan tek bir çağrıyı seçer; sonuçları sayfalayarak geçmek yerine. Üst-N sorusunun sıralı bir çağrı gerektirdiğini ve varlıkları saymanın hiç metrik çağrısı gerektirmediğini bilir.
- Yapısal değişiklikler: Kampanyaları, reklam gruplarını, reklamları ve anahtar kelimeleri doğru sırayla oluşturup günceller; alt öğeyi yazmadan önce üst öğeyi okur.
- Anahtar kelime çalışması: Anahtar kelimeleri toplu olarak ekler ve yeniden teklif verir; arama terimlerini anahtar kelimelere ve negatif anahtar kelimelere dönüştürür.
- Otomasyonlar: Kural tabanlı otomasyonları kurar ve canlı tekliflere dokunmadan önce bunları kuru çalıştırır.
- Rakip araştırması: Rakip uygulamaların teklif verdiği anahtar kelimeleri çeker.
Neler yapmaz
Bu beceri her yazma işlemini geri döndürülemez olarak değerlendirir, çünkü öyledir — CLI’ın silme komutu yoktur ve değişiklikler saniyeler içinde Apple’a ulaşır.
- Bir ID veya bütçeyi tahmin etmek yerine, yazmadan önce okur.
- Para harcayan her komuttan önce sorar ve komutu siz çalıştırırken CLI’ın kendi onay istemini yerinde bırakır.
- Zincirdeki her yazma işlemine bir idempotency anahtarı sabitler; böylece belirsiz bir sonucun ardından yeniden çalıştırmak ikinci bir kampanya oluşturmaz.
- Küçük gruplara öncelik verir; böylece Apple’dan gelen kısmi bir ret kolayca okunabilir kalır.
Skill, komutları önerir ve hazırlar. Metrikleri okumak ve kuru çalıştırmalar hiçbir şeye mal olmaz, ancak canlı bir reklam hesabını değiştiren her şeyi onaylamak sizin sorumluluğunuzdadır.
Skill’i yükleyin
ads-manager skill, AI kodlama aracınıza adapty asa komutları aracılığıyla Apple Ads’i yönetmeyi öğretir. Komutların hangi sırayla çalıştığını, herhangi bir şey yazmadan önce neyin okunması gerektiğini ve hangi çağrıların para harcadığını bilir.
Desteklenen araçlar: Claude Code, GitHub Copilot CLI, OpenAI Codex, Gemini CLI.
Skill, Adapty CLI’yi kullandığı için önce CLI’yi kurun ve kimlik doğrulaması yapın — bkz. hızlı başlangıç kılavuzu. adapty asa komutları Adapty CLI 0.4.0 ve sonrasında mevcuttur; eski bir sürümde bu komutlar hiç bulunmaz. adapty asa whoami ile kontrol edin; bu komut aynı zamanda bir Apple Ads hesabının bağlı olup olmadığını ve şirketin aktif bir Ads Manager aboneliğine sahip olup olmadığını da gösterir.
Kurumsal bir Cowork çalışma alanında, bir yöneticinin domain izin listesine hem adapty.io hem de *.adapty.io adreslerini eklemesi gerekir. Her ikisini de listeleyin: çoğu izin listesi uygulamasında wildcard, apex domaini kapsamaz ve skill’in okuduğu belgeler apex domaininde bulunur. Her ikisi de izin listesine alınmadan skill Adapty’e ulaşamaz.
Kurulum için aracınıza uygun formu seçin. Tam liste skill README dosyasında bulunmaktadır.
Claude Code
claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill
claude plugin install adapty-sdk-integration@adapty
Bu eklenti aynı zamanda SDK entegrasyon skill’ini de içerir. Her ikisi birlikte yüklenir.
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-skill
OpenAI Codex veya başka herhangi bir araç — skills CLI’yi kullanın (bu şekilde yüklenen skill’lerin otomatik güncellenmediğini unutmayın):
npx skills add adaptyteam/adapty-sdk-integration-skill --all
--all, her iki skill’i de tespit ettiği tüm agent’lara yükler. Yalnızca bu skill için --skill ads-manager kullanın.
Alternatif olarak, repoyu klonlayıp skills/ altındaki dizinleri aracınızın skills dizinine kopyalayabilirsiniz — ya da yalnızca bunu istiyorsanız skills/ads-manager/ dizinini.
Kurduktan sonra, projenizde skill’i çalıştırın:
/ads-manager
Metrikleri okumak ve kuru çalıştırmalar (dry run) ücretsizdir. Diğer her komut saniyeler içinde Apple’a ulaşır, gerçek para harcar ve geri alınamaz — skill her birinden önce onay ister; siz de öyle yapmalısınız.
AI Agent’tan farkı
Adapty Ads Manager’ın kontrol panelinde yerleşik bir AI Agent da bulunur. İkisi farklı ihtiyaçlara yanıt verir:
| AI Agent | ads-manager skill | |
|---|---|---|
| Nerede çalışır | Adapty kontrol paneli | Terminalinizde, AI kodlama aracınızda |
| Ne yapar | Analiz eder ve önerir | Analiz eder, önerir ve komutları çalıştırır |
| Kurulum | Yok | Adapty CLI ve skill |
Hesabınızda neler olduğunu öğrenmek için AI Agent’ı kullanın. Değişikliğin gerçekleştirilmesini de istediğinizde ise skill’i kullanın.
Sırada ne var
- CLI ile Ads Manager’ı yönetin — aynı işlemleri bir yapay zeka aracı olmadan elle yapın.
- Ads Manager komutları — her komut, argümanları, bayrakları ve kabul edilen değerleriyle.