Apple Ads eklentisi, bir AI kodlama aracının Apple Ads hesabınızı Adapty CLI üzerinden yönetmesine olanak tanır. Düz bir dille soru sorun; hangi komutların yanıt vereceğini kendisi bulur, önce hesabı okur ve herhangi bir şey Apple’a ulaşmadan önce yapılacak işlemi size önerir.

Bir skill, yapay zeka aracınızın talep üzerine yüklediği bir dizi talimattır. Eklenti, hesabınızı yöneten bir operatör, salt okunur bir denetçi ve bir strateji planlayıcı olmak üzere üç skill ile birlikte gelir; bunların yanı sıra haftalık kontroller, kohort ROAS incelemeleri ve bütçe yeniden dağıtımı gibi rutin işler için playbook’lar, kategoriye özel anahtar kelime taksonomileri ve başlangıç ekonomileri içeren dikey kılavuzlar ve en yaygın işleri tek satıra indirgeyen slash komutları da içerir. Bunlar birlikte, Ads Manager arayüzünde hata yapılması kolay kısımları üstlenir: 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ıtlamak için tek bir çağrı seçer, sonuçları sayfalayarak geçmek yerine. Üst-N sorusunun sıralı bir çağrı olduğunu 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şturur ve 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.
• Hesap denetimleri: apple-ads-audit becerisi herhangi bir değişiklik yapmadan hesap sağlığını, yayın durumunu, yapıyı ve yinelenen anahtar kelimeleri kontrol eder.
• Sıfırdan planlama: apple-ads-strategy becerisi, uygulamanızın açıklamasından yola çıkarak bir hesap yapısı, anahtar kelime taksonomisi ve başlangıç bütçeleri tasarlar — Apple Ads hesabı veya CLI gerekmez.

Ne yapmaz

Eklenti her yazmayı geri döndürülemez olarak kabul eder, çünkü öyledir — CLI’nın silme komutu yoktur ve değişiklikler saniyeler içinde Apple’a ulaşır.

• Yazmadan önce okur; bir kimlik veya bütçe tahmin etmek yerine mevcut durumu kontrol eder.
• Para harcayan her komuttan önce onay ister ve komutu siz çalıştırıyorsanız CLI’nın kendi onay ekranını da açık bırakır.
• Bir zincirdeki her yazmaya bir idempotency anahtarı sabitler; bu sayede belirsiz bir sonuçtan sonra yeniden çalıştırma ikinci bir kampanya oluşturmaz.
• Küçük toplu işlemleri tercih eder; böylece Apple’dan gelen kısmi bir ret mesajını okumak kolaylaşır.

Eklentiyi yükleyin

Apple Ads eklentisi, AI kodlama aracınıza adapty asa komutları aracılığıyla Apple Ads’i yönetme yeteneği kazandırır. Üç beceri sunar:

• apple-ads: Operatör. Performansı okur, teklifleri ve bütçeleri değiştirir, anahtar kelime ve negatif anahtar kelime ekler, arama terimlerini toplar, kampanyaları başlatır ve duraklatır — para harcanacak her işlemde onay ister.
• apple-ads-audit: Salt okunur denetçi. Hesap sağlığını, yayın durumunu, yapıyı, trafik sahipliğini ve yinelenen tam eşleşme anahtar kelimelerini kontrol eder, hiçbir şey yazmaz.
• apple-ads-strategy: Hesap, CLI veya abonelik gerektirmeyen bir planlayıcı. Uygulamanızın açıklamasını alarak bir hesap yapısı, anahtar kelime taksonomisi, başlangıç bütçeleri ve negatif anahtar kelime listesi oluşturur.

Desteklenen araçlar: Claude Code, Claude Cowork, GitHub Copilot CLI, OpenAI Codex, Gemini CLI ve becerileri destekleyen diğer tüm araçlar.

Operatör ve denetçi, Adapty CLI’yi kullanır; bu nedenle önce CLI’yi yükleyin ve kimlik doğrulamasını yapın — bkz. hızlı başlangıç kılavuzu. adapty asa komutları Adapty CLI 0.4.0 ve daha yeni sürümlerde gelir; daha eski sürümlerde hiç yoktur. adapty asa whoami komutuyla kontrol edebilirsiniz; 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. Strateji becerisi bunların hiçbirini gerektirmez.

Claude Cowork, CLI’yi izin listesi dışındaki her alan adını engelleyen bir sandbox’ta çalıştırır. Eklentiyi oraya yüklemeden önce Adapty alan adlarına izin verin — bkz. CLI’yi Cowork’te çalıştırma. Cowork görevi aynı zamanda temiz bir makinede başlar; dolayısıyla CLI ve giriş bilgileri oturumlar arasında aktarılmaz — eklentinin adapty-cli-setup becerisi her oturumun başında CLI’yi yeniden yükler ve kimlik doğrulamasını yapar.

Yüklemek için aracınıza uygun formu seçin. Tam liste eklenti README’sinde yer almaktadır.

Claude Code

claude plugin marketplace add adaptyteam/apple-ads-cli
claude plugin install apple-ads@adapty

Becerilerin yanı sıra Claude Code eklentisi, haftalık kontrol için /asa-review ve arama terimlerini anahtar kelimelere ile negatiflere dönüştürmek için /asa-harvest gibi yaygın işler için hazır komut istemleri olan /asa-* eğik çizgi komutlarını da yükler.

Diğer araçlar — skills CLI’yi kullanın (bu şekilde yüklenen beceriler otomatik güncellenmez):

npx skills add adaptyteam/apple-ads-cli --all

--all üç becerinin tamamını algıladığı her agent’a yükler. Tek bir beceri için --skill kullanın, örneğin --skill apple-ads-strategy.

Yükledikten sonra projenizdeki bir beceriyi çalıştırın — doğrudan ya da eğik çizgi komutlarından biri aracılığıyla:

/apple-ads

Metrikleri okumak ve kuru çalıştırmalar ücretsizdir. Diğer tüm komutlar saniyeler içinde Apple’a ulaşır, gerçek para harcar ve geri alınamaz — beceriler her birinde önceden sorar, siz de sormalısınız.

Benchmarks eklentisi

Aynı marketplace’te isteğe bağlı bir yardımcı araç daha bulunuyor: apple-ads-benchmarks — Adapty’nin abonelik uygulamaları için yayımladığı Apple Ads temel verileri; AI aracınızın sorgulayabileceği yerel veriler olarak paketlenmiş: 90 ülke, 22 App Store kategorisi ve 59 niş genelinde tıklama oranı, dönüşüm oranı, CPT ve CPA ile birinci yıl LTV gibi abone ekonomisi verileri. Tamamen çevrimdışı çalışır; Apple Ads hesabı, CLI veya Adapty aboneliği gerektirmez.

Bir sayının sorun olup olmadığını hesaba dalmadan önce değerlendirmek için kullanın: “Almanya’daki bir fitness uygulaması için 4 $ CPT yüksek mi?” sorusu öncelikle bir kıyas ölçütü sorusudur.

Claude Code

claude plugin marketplace add adaptyteam/apple-ads-cli
claude plugin install apple-ads-benchmarks@adapty

Diğer araçlar

npx skills add adaptyteam/apple-ads-benchmarks --all

Slash komutları

Claude Code’da eklenti ayrıca dokuz /asa-* komutu ekler. Her biri, yaygın bir iş için doğru beceriyi ve playbook’u seçen hazır bir prompt’tur; böylece prompt’u kendiniz yazmak yerine komutu yazmanız yeterlidir:

Komut	Ne yapar
/asa-review	Haftalık kontrol — yön, kurulum karşılaştırması, aykırı değerler ve bir eylem önerisi
/asa-audit	Salt okunur hesap sağlığı veya canlı yapı denetimi
/asa-bids	Kohort ROAS’a göre teklifleri incele ve ayarla
/asa-budget	Kampanyalar arasında bütçeyi yeniden dağıt
/asa-harvest	Arama terimlerini tam eşleşme anahtar kelimelerine ve negatif anahtar kelimelere aktar
/asa-negatives	Arama terimlerinden en dar güvenli negatif anahtar kelimeleri çıkar
/asa-opportunities	Market Intelligence’tan rakip anahtar kelime fırsatlarını bul
/asa-cpp	Bir anahtar kelime niyetini mevcut bir Custom Product Page ve reklama yönlendir
/asa-launch	Yeni bir Apple Search Ads kampanyası planla ve başlat

Slash commands install with the Claude Code plugin. In other tools, ask for the same jobs in plain language — the skills carry the same playbooks.

Örnek prompt’lar

Yetenekler, komutları, sıralarını ve hangilerinin para harcadığını zaten içeriyor; dolayısıyla bir prompt’un bunları açıkça belirtmesi gerekmiyor. Prompt’u, bir yeteneğin kendi başına çözemeyeceği şeyler için yazın: kampanyaları neye göre değerlendirdiğiniz, karşılaştırma yaptığınız referans nokta ve istediğiniz yanıtın biçimi.

Zaten yönettiğiniz bir hesabı denetleyin

Kampanyalar yayındayken paranın nereye gittiğini öğrenmek istediğinizde bunu kullanın. İhtiyaç duyduğu her komut bir okuma işlemidir, dolayısıyla hesabınızda hiçbir şey değişmez.

Audit my Apple Search Ads account and tell me what needs my attention. This is
read-only — don't change anything.

Judge campaigns on cohort net ROAS over the last 30 days against a 3:1
benchmark, since Adapty attributes real subscription revenue back to the
campaign that drove it. Cover campaigns, keywords, the search terms I'm
matching on, and what my active automations do.

Serving status and the reasons a campaign isn't serving come back on the
metrics rows, not from campaigns list.

Then report back in plain language:
- what's blocked and how to unblock it
- net ROAS per campaign against the benchmark
- the top 3 places I'm wasting money
- the top 3 growth opportunities
- the changes you'd make, each as the exact command with its current and new
  value, for me to approve one at a time

I'm not an Apple Ads expert. Assume I'm smart but busy.

İlk kampanyalarınızı başlatın

Bunu Apple Ads hesabı boşken kullanın. Operatör becerisi kampanyaları varsayılan olarak duraklatılmış şekilde oluşturur ve bu prompt, planı okuyana kadar bu durumu korur.

I want to launch Apple Search Ads for my app from scratch. I'm not an Apple
Ads expert — guide me and build it for me. Create everything paused.

Interview me first, briefly: what my app does and who it's for, which
countries to start in, my monthly test budget, and my target cost per
subscriber. If I don't know that last one, work it back from my price and
expected trial conversion.

Then propose a starter structure as a table before you create anything: a
brand campaign, a generic campaign, a competitor campaign if I name
competitors, and a small discovery campaign to mine search terms. For each
one give me a one-line reason it exists, its share of the budget, its ad
groups, a starter keyword list with match types and bids, and the negative
keywords to share across all of them.

Build it once I approve, then show me what was created.

Finish with a launch checklist: what I still have to fix in the Apple Search
Ads console before anything can serve, such as a payment method or a pending
tax verification; how to switch the campaigns on when I'm ready; and one
automation rule worth adding after a week of data. Then tell me to come back
in 7 days for a performance review.

Yapay Zeka Ajanından farkı

Adapty Ads Manager’ın kontrol panelinde ayrıca yerleşik bir Yapay Zeka Ajanı da bulunur. İkisi farklı ihtiyaçlara yanıt verir:

	Yapay Zeka Ajanı	Apple Ads eklentisi
Nerede çalışır	Adapty kontrol paneli	Terminalinizde, yapay zeka kodlama aracınızda
Ne yapar	Analiz eder ve önerir	Analiz eder, önerir ve komutları çalıştırır
Kurulum	Yok	Adapty CLI ve eklenti

Hesabınızda neler olduğunu öğrenmek için Yapay Zeka Ajanını kullanın. Değişikliğin de gerçekleştirilmesini istediğinizde eklentiyi 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.