Örnekler

Örnek bir oturum — ilk çalıştırma nasıl hissettirir

Siz: App Store Connect bağlantısını kontrol et, sonra uygulamalarımı listele.

Agent: (asc__status, sonra apps__list çağırır) Bağlı. 3 uygulamanız var: Acme (1234567890), Beta, Gamma.

Siz: Acme için mevcut sürüm gönderime hazır mı?

Agent: (apps__app_store_versions__list, app_store_versions__get çağırır) Sürüm 3.2, PREPARE_FOR_SUBMISSION durumunda. Ekran görüntüleri ve açıklama ayarlı; build ekli. Gönderimi engelleyen bir şey yok.

Siz: Uygulama içi etkinlikleri yönetecek bir araç var mı? (marketing'i yüklememişsiniz)

Agent: (asc__search_tools çağırır) Evet — app_events__* araçları, yüklü olmayan asc-marketing'te. Şununla ekle: claude mcp add -s user asc-marketing -- npx -y @erayendes/asc-mcp marketing (diğer istemcilerde setup'ı yeniden çalıştırın)

Sade dille

İstemcinizle sade bir dille konuşun:

• 3.2 sürümünü incelemeye gönder, onaylandıktan sonra kademeli yayına başla.
• Son bir haftadaki TestFlight crash gönderimlerini cihaz modeline göre grupla göster.
• Abonelik gruplarımı ve her katmanın Türkiye, Almanya ve ABD'deki fiyatını göster.
• Bu müşteri iki kez ücretlendirildiğini söylüyor — işlem ID'si 2000000891234567. Geçmişi ne gösteriyor, şu anda hak sahibi mi?

Senaryolar

TestFlight testçisi davet et

sara@example.com'u Insiders grubuna ekle ve en son build'i ver.

access (gruplar, testçiler) ve testflight (build yerelleştirmeleri, inceleme detayları) gerekir. Sıra önemli ve API bunu söylemiyor: testçi önce hesaba, sonra gruba ait olur, build ise gruba sunulur. Bir e-postayı gruba eklemek, testçi yoksa onu oluşturur.

Harici bir grup için Apple'ın build'i incelemesi gerekir; dahili grup için gerekmez. Testçiler "hiçbir şey görünmüyor" diyorsa sebep genelde budur.

Sürüm oluştur ve build bağla

3.2 sürümünü başlat, 412 build'ini bağla ve göndermeden önce ne eksik söyle.

distribution gerekir. Son cümle tek çağrı: preflight__check_version sürümü, build'ini, inceleme iletişimini, her yerelleştirmeyi ve ekran görüntülerini okuyup neyin eksik olduğunu ve her eksiği hangi aracın düzelteceğini söyler.

Bilinmeye değer iki arıza, ikisi de kendini bildirmiyor:

• Hâlâ PROCESSING olan bir build bağlanamaz ve Apple ne zaman biteceğini söylemez.
• usesNonExemptEncryption cevapsızsa sürüm gönderimden sonra WAITING_FOR_EXPORT_COMPLIANCE'ta bekler; hiçbir açıklama iliştirilmez.

Tek dilin anahtar kelimelerini güncelle

Türkçe anahtar kelimeleri bunlarla değiştir, diğer dillere dokunma.

distribution gerekir. Anahtar kelimeler sürüm yerelleştirmesinde yaşar, dil başına bir satır, 100 karakter sınırlı — ve sınır virgülleri de sayar. Ad ve alt başlık bambaşka bir yerde (app_info_localizations), çünkü sürüme değil uygulamaya aitler.

Tek bir dili adıyla isteyin. Elli dilli bir liste bütün hâlde 264 KB ve işe yarayan cevap onun tek satırı.

Yorumları triyaj et ve cevap taslağı yaz

Bu haftanın cevapsız 1 yıldızlı yorumlarını göster ve yorumun dilinde cevap taslağı yaz.

marketing gerekir. reviews_ai__triage onları gruplar, reviews_ai__draft_response cevabı yazar — sizin modeliniz yazar, istemcinizin sampling'i üzerinden. İkinci bir API anahtarı yok ve hiçbir metin başkasının modeline gitmiyor.

Cevaplar bir dil modeli gibi değil ekibiniz gibi konuşsun istiyorsanız ASC_REVIEWS_BRAND_VOICE, ASC_REVIEWS_BANNED_PHRASES ve ASC_REVIEWS_SUPPORT_URL ayarlayın.

Sandbox test kullanıcılarını yönet

Sandbox hesabımızın satın alma geçmişini temizle ve ülkesini Türkiye yap.

monetization gerekir. Sandbox testçileri App Store Connect'te oluşturduğunuz hesaplar, gerçek Apple ID değil; satın alma geçmişini temizlemek testte bir aboneliği yeniden satın alınabilir yapan şey ve testçiyi düzenlemekten ayrı bir çağrı.

Satış veya finans raporu çek

Geçen ayın satış raporunu indir ve adet bazında ilk beş ülkeyi söyle.

analytics ve ASC_VENDOR_NUMBER (setup sorar) gerekir. İki nokta takılıyor:

• Finans ve satış farklı raporlar. finance_reports__list Apple'ın size ödediği; bölge ve para birimi bazında. sales_reports__list adet ve hasılat; gün ya da hafta bazında. "Gelir" genelde birincisi demek.
• Gzip'li TSV olarak gelirler, JSON değil. parse=true isterseniz satır alırsınız; istemezseniz kimsenin okuyamayacağı bir base64 blob. Rapor büyükse tam kopyası MCP kaynağı olarak saklanır ve cevap ona bağlanır.