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 skill’i 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 skill’i, 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önetmeyi öğretir. Üç skill içerir:

• apple-ads: Operatör. Performans okur, teklif ve bütçeleri değiştirir, anahtar kelime ve negatifler ekler, arama terimlerini toplar, kampanyaları başlatıp duraklatır — para harcayan her işlemden önce onay alır.
• apple-ads-audit: Salt okunur denetçi. Hesap sağlığını, yayın durumunu, yapıyı, trafik sahipliğini ve tam eşleşmeli yinelenen anahtar kelimeleri kontrol eder, hiçbir şey yazmaz.
• apple-ads-strategy: Hesap, CLI veya abonelik gerektirmeyen bir planlayıcı. Uygulamanızın açıklamasını hesap yapısına, anahtar kelime taksonomisine, başlangıç bütçelerine ve negatif anahtar kelime listesine dönüştürür.

Desteklenen araçlar: Claude Code, Claude uygulaması (eski adıyla Claude Cowork), GitHub Copilot CLI, OpenAI Codex, Gemini CLI ve skill desteği olan diğer tüm araçlar.

Operatör ve denetçi Adapty CLI’yi çalıştırır, bu yüzden önce CLI’yi kurup kimlik doğrulamasını yapın — hızlı başlangıç kılavuzuna bakın. adapty asa komutları Adapty CLI 0.4.0 ve üzeri sürümlerde gelir; daha eski sürümlerde hiç yoktur. adapty asa whoami komutuyla 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. Strateji skill’i bunların hiçbirini gerektirmez.

Claude uygulaması, CLI’yi izin listesi dışındaki tüm alan adlarını engelleyen bir sandbox içinde çalıştırır. Eklentiyi buraya kurmadan önce Adapty alan adlarına izin verin — Claude uygulamasında Adapty CLI’yi kurma bölümüne bakın. Claude uygulamasındaki her konuşma temiz bir makinede başlar, dolayısıyla CLI ve oturum bilgisi konuşmalar arasında aktarılmaz — eklentinin adapty-cli-setup skill’i her konuşmanın başında CLI’yi yeniden kurar ve kimlik doğrulamasını yapar.

Kurulum için aracınıza uygun biçimi seçin. Tam liste eklenti README dosyasında yer alır.

Claude Code

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

OpenAI Codex

codex plugin marketplace add adaptyteam/apple-ads-cli
codex plugin add apple-ads@adapty

Her iki eklenti yolu da skill’lerle birlikte /asa-* komutlarını da getirir — haftalık kontrol için /asa-review ve arama terimlerini anahtar kelime ile negatiflere dönüştürmek için /asa-harvest gibi yaygın işlere hazır komutlar. Claude Code bunları slash komutları olarak sunar; Codex ise adlarıyla talep edilen skill’ler olarak yükler.

Diğer araçlar — skills CLI’yi kullanın (bu yöntemle yüklenen skill’ler otomatik güncellenmez):

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

--all, tespit ettiği her agent’a üç skill’i de yükler. Tek bir skill için --skill kullanın; örneğin --skill apple-ads-strategy.

Kurulumun ardından projenizde bir skill çalıştırın — doğrudan ya da slash komutlarından biriyle:

/apple-ads

Metrik okuma 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 — skill’ler her birinden önce onay 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 skill’i 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 skill’i 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.