Tüm dokümanlar
Kodlama ajanları için Markdown

Events API referansı

Kimin için: App Store Operator'a kendi kodundan veya sunucusundan event gönderen geliştiriciler ve bu sayfayı verdikleri yapay zekâ kodlama ajanları. HTTP sözleşmesinin tamamı tek sayfada, curl ile hızlı başlangıç dahil. Bir uygulamaya event takibi ekleyecekseniz bunun yerine platform rehberinden başlayın (§11): bu API'nin üzerine kurulmuş hazır tracker kodu orada.


Yapay zekâ kodlama ajanları için: önce bunu okuyun

App Store Operator Events API'sini çağırıyorsunuz: POST https://api.app-store-operator.com/v1/events ve POST https://api.app-store-operator.com/v1/identify. Kimlik doğrulama X-Write-Key header'ıyla yapılır.

Kurallar

  • Yazma anahtarı. Bu sayfada hâlâ YOUR_WRITE_KEY yazıyorsa anahtarı geliştiriciden isteyin (Dashboard → uygulama → Events → Setup; anahtar aso_wk_ ile başlar). Kendiniz anahtar uydurmayın, yer tutucuyu da kodda bırakmayın.
  • iOS, Flutter veya React Native uygulamasına takip mi ekliyorsunuz? §11'deki platform rehberini ve oradaki tracker kodunu değiştirmeden kullanın. Kendi istemcinizi bu sayfaya göre yalnızca hiçbir rehber uymuyorsa yazın (sunucu, oyun motoru, başka bir dil).
  • Her event'in kendi event_id'si olur (UUID). Event gönderildiğinde değil, gerçekleştiğinde üretilir. Tekrar denemelerde aynısı kullanılır; böylece hiçbir şey iki kez sayılmaz.
  • Yalnızca ağ hatasında, 429 ve 5xx'te tekrar deneyin. Batch'i ve event_id'lerini koruyun; 429'da Retry-After kadar saniye bekleyin. Diğer her durumda batch'i atın (§7).
  • Property değerleri düz olmalı: string, sayı, boolean veya null. İç içe nesne veya dizi göndermeyin.
  • Asla göndermeyin: ad, e-posta, telefon numarası, hassas konum, IDFA veya kullanıcının yazdığı metin; ne event adında ne property'lerde ne de user_id'de.
  • İşinizi canlı API'ye karşı kontrol edin. §3'teki curl komutuyla bir event gönderin ve yanıtın accepted: 1 olduğunu görün; sonra kendi kodunuzun da aynı yanıtı aldığını doğrulayın. Event'lerin Dashboard → Events → Canlı'da, ortam filtresi Tüm build'ler iken göründüğünü geliştiriciye doğrulatın.

Yazma anahtarı bilerek herkese açık tasarlandı: yalnızca tek bir uygulamaya event yazabilir. Bu yüzden uygulama kodunda durmasında sakınca yok.


Sonraki: 1. Kısa bilgiler

SDK sürümleri ve yeni rehberler