Adapty analitiğinizi düz bir dille yapay zeka kodlama ajanına sorun — gelir, dönüşümler, elde tutma, LTV — ve rakamları sizin için çeksin. Export Analytics API’ye API çağrısı yapabilen bir araç bağlayın; metriklerinizi anında sorgulasın.

Ne hakkında soru sorabilirsiniz

Export Analytics API, Adapty kontrol paneli grafiklerinde gördüğünüz metriklerin aynısını döndürür. Her metriğin kendine ait bir işlemi vardır:

Metrik	Kapsadığı alan	İşlem
Gelir, MRR, ARR, ARPU	Dönem, ülke veya kampanyaya göre gruplandırılmış, zaman içinde kazanılan para	retrieveAnalyticsData
Kohort tutma	Belirli bir kohorttan abonelerin ne kadar süre ödeme yaptığı	retrieveCohortData
Dönüşüm oranları	Kaç kullanıcının bir adımdan veya kanaldan bir sonrakine geçtiği	retrieveConversionData
Kayıp ve huni	Kullanıcıların nerede ayrıldığı ve abonelikten ne kadar hızlı çıktığı	retrieveFunnelData
Yaşam boyu değer (LTV)	Zaman içinde kullanıcı segmenti başına ortalama gelir	retrieveLTVData
Elde tutma	Belirli sayıda gün sonra hâlâ aktif olan kullanıcıların oranı	retrieveRetentionData
API referansının tam parametre ve filtre listesi için API referansına bakın.

Başlamadan önce

Üç şeye ihtiyacınız var:

• Veri içeren bir Adapty hesabı: API, kontrol panelinizin grafiklerindeki metriklerin aynısını döndürür; bu nedenle uygulamanızın zaten analitik verileri toplaması gerekir.
• Gizli bir API anahtarı: App settings → General sayfasındaki Secret key alanında bulabilirsiniz. Anahtarlar uygulamaya özgüdür; her uygulama için ayrı bir anahtar kullanın. Ajanınızın sohbete yapıştırmanıza gerek kalmadan okuyabilmesi için anahtarı bir ortam değişkeninde saklayın (örneğin ADAPTY_SECRET_KEY).
• API çağrısı yapabilen bir yapay zeka aracı: Örneğin Claude Code, Cursor veya fetch aracına sahip Claude Desktop. claude.ai veya ChatGPT gibi sıradan sohbet araçları API’yi doğrudan çağıramaz.

Aracınıza API Spesifikasyonunu Tanıtın

OpenAPI spesifikasyonu, her endpoint’i, kimlik doğrulama başlığını, istek gövdesini ve örnek yanıtları açıklar. Aracınız bu spesifikasyona sahip olduğunda, siz hiç kod yazmadan doğru istekleri oluşturabilir.

Spesifikasyonu URL ile aracınıza tanıtın:

• URL’yi yapıştırın: Aracınız URL’leri getirebiliyorsa, https://adapty.io/docs/tr/api-specs/export-analytics-api.yaml adresini verin ve spec’i okumasını isteyin.
• Bir fetch aracı kullanın: Aracınızda URL’leri getiren bir araç varsa (örneğin, bir MCP fetch sunucusu), aynı URL’yi gösterin.

Spec, temel URL’yi https://api-admin.adapty.io olarak ayarlar; dolayısıyla anahtarınız ortamda olduğunda aracınızın ihtiyacı olan her şey hazır olur.

Verileriniz Hakkında Soru Sorun

Spec yüklenmiş ve anahtarınız bir ortam değişkeninde tanımlıyken, istediğiniz metriği düz dille anlatın.

Örnek komutlar:

What was my MRR at the end of each month this year, and how does it compare to last year?

Show my trial-to-paid conversion rate for the last 90 days, broken down by product.

Which countries drive the most revenue from my yearly subscription? Top 10.

How is week-1 retention trending for subscribers who started in the last 6 months?

What's the refund rate on my annual plan since launch, by month?

Compare LTV for paid-campaign users vs. organic over the last year, and export it as CSV.

Ajan, isteğinizi doğru işleme eşler, anahtarı ortam değişkeninden okur ve veriyi döndürür. Yanıtlar varsayılan olarak JSON formatındadır. Elektronik tabloya uygun bir dosya istediğinizde CSV isteyin — ajan bu durumda istek gövdesinde format değerini csv olarak ayarlar.

Tekrarlayan kullanım için bir kez ayarlayın

Her oturumda tekrar ayarlama yapmamak için spec ve key’i ajanınızın yeniden kullanabileceği bir yere kaydedin:

• Spec linkini kaydedin: Spec URL’sini ajanınızın kurallar veya bellek dosyasına ekleyin (örneğin bir CLAUDE.md ya da Cursor kurallar dosyası), böylece her oturumda otomatik yüklenir.
• Anahtarı ortam değişkenlerinizde saklayın: ADAPTY_SECRET_KEY’i shell profilinizde veya aracın gizli deposunda tutun, böylece bir daha yapıştırmanıza gerek kalmaz.
• Yeniden kullanılabilir prompt’ları kaydedin veya özel bir beceri oluşturun: Sık kullandığınız soruları kayıtlı prompt olarak tutun ya da bunları özel bir beceri veya slash komutuyla sarmalayın; böylece ajanınız raporları isteğe bağlı çalıştırır.

Sınırlamalar

Bu kısıtlamaları aklınızda bulundurun:

• Rate limit: API, her API anahtarı için saniyede 2 istek yapılmasına izin verir. Bu sınırı aşmak 429 Too Many Requests hatası döndürür. Agent’ınıza 429 aldığında bekleyip tekrar denemesini söyleyin.
• Uygulamaya özgü anahtarlar: Her anahtar yalnızca bir uygulama için çalışır. Birden fazla uygulamanın verilerini çekmek için her biri için ilgili anahtarı sağlayın.
• Çıktı formatı: Yanıtlar varsayılan olarak JSON formatındadır. CSV dışa aktarımı için istek gövdesinde format değerini csv olarak ayarlayın.

Kimlik doğrulama ve istek kurallarının tamamı için bkz. Yetkilendirme ve istek formatı.