Paylaş
Apple Ads Platform API uygulamalarınızın daha çok indirilmesi için kullanmanız gereken anahtar kelimeleri (keywords) listeleyen yeni bir Apple servisi.
Apple Ads Platform API v1 ve Arama Terimi Popülerliği
Apple, Campaign Management API v5’in yerine geçecek olan yeni Apple Ads Platform API’sinin ilk versiyonunu bu ay yayına aldı. Yeni API’nin en dikkat çekici özelliklerinden biri, daha önce sadece reklam arayüzünde görebileceğiniz search term popularity verisini programatik olarak çekmenize izin vermesi.
Ne döndürüyor? Her arama terimi için şunları alıyorsunuz:
- Tür içi sıralama (rankInGenre): O kategorideki en popüler 500 terimin sırası. 1 en popüler demek.
- Tür içi popülerlik (1–100): Aynı kategorideki diğer terimlere göre görece bir skor.
- Genel popülerlik (1–100): O ülkedeki tüm terimlere kıyasla genel skor.
- Basitleştirilmiş skor (1–5): Apple’ın eski sisteminden gelen özet gösterim.
Aylık ve haftalık granülaritede çekebiliyorsunuz. 15 aya kadar geçmiş aylık veri, 65 haftaya kadar haftalık veri mevcut. Yani tek bir anlık görüntü değil, trend analizi de yapabilirsiniz.
Reklam harcaması gerekmez mi?
Hayır. Bu benim de önce şüpheyle yaklaştığım bir noktaydı. Eski API, aktif kampanya olmadan neredeyse hiçbir şey vermiyordu. Yeni Platform API v1’i sıfır harcamalı, aktif kampanyası olmayan bir hesaptan test ettim ve veri geldi.
Yani Apple Ads hesabı açmanız yeterli reklam vermenize gerek yok. Hesap oluşturmak ücretsiz.
Kimlik doğrulama tarafı biraz teknik: OAuth 2.0 ile ES256 imzalı JWT kullanıyor. Client ID, Team ID, Key ID ve EC P-256 private key gerekiyor. Bunları searchads.apple.com → Settings → API üzerinden oluşturabilirsiniz.
Ama bir tavan var ve bu tavan önemli
Burada romantizmi bir kenara bırakalım.
Apple her kategori ve ülke kombinasyonu için en popüler 500 terimi yayınlıyor. Bunun altındaki her şey? Yok. Sorgulamaya çalışırsanız boş sonuç alırsınız. Yaklaşık 45/100’ün altında skoru olan terimler bu veri setinde hiç görünmüyor.
Pratik anlamı şu: Bu API, büyük oyuncuların hedeflediği “fat head” terimlere bakıyor. “habit tracker”, “vpn”, “pdf editor” gibi terimler listede yer alıyor. “pdf editor for students offline free” gibi uzun kuyruk terimler yani indie geliştiricilerin gerçekten sıralama alabileceği terimler bu 500’ün içine girmiyor.
Peki gerçekten ne işe yarar?
Şöyle düşünün, uygulamanızın adında veya başlığında ana bir terimi kullanmayı düşünüyorsunuz. Bu terimin gerçekten aranıp aranmadığını, kategorinizde kaçıncı sırada olduğunu ve zaman içinde popülerliğinin düşüp düşmediğini artık Apple’ın kendi verisinden, Apple Ads Platform API sayesinde görebiliyorsunuz.
Bu, daha önce mümkün değildi. Üçüncü parti araçların modele dayalı tahminlerinin yerine, en azından head terimler için, gerçek bir kıyaslama noktanız artık var oluyor. Metadata güncellemesi yapmadan önce, o terimin kategorinizdeki gerçek ağırlığını bir kez kontrol etmek mantıklı.
Bunun dışında mevsimsellik takibi için de güçlü: “back to school”, “tax calculator”, “workout” gibi terimlerin haftalık veriyle nasıl dalgalandığını görmek, metadata güncellemelerinizi ne zaman yapmanız gerektiğine dair net bir sinyal veriyor.
Sonuç: Heyecanlanalım mı, temkinli mi olalım?
İkisi de biraz. Apple’ın bu adımı, geliştiricilere yıllardır verilmesi gereken bir veriyi nihayet resmi kanaldan sunması açısından anlamlı. Özellikle “bu terimi title’a koyalım mı?” sorusunu tahmine değil veriye dayandırmak isteyenler için değerli.
Ama bunu “artık keyword araştırması çözüldü” şeklinde okumak hata olur. Uzun kuyruk hâlâ karanlıkta. Difficulty verisi hiç yok. Ve listenin tepesindeki 500 terim, çoğu indie geliştirici için zaten kazanılması en zor terimler.
Bu API’yi kullananlar için doğru çerçeve şu: Head term doğrulama ve mevsimsellik takibi için mükemmel, keyword discovery için yetersiz. İkisini karıştırmamak gerekiyor.
Teknik özet (geliştiriciler için)
- Base URL:
https://api.searchads.apple.com/api/v1/ - Endpoint:
POST /insights/search-term-popularity - Auth: OAuth 2.0, ES256 JWT (Client ID + Team ID + Key ID + EC P-256 private key)
- Hesap gereksinimi: Apple Ads hesabı — aktif kampanya veya harcama şart değil
- Veri aralığı: Aylık (15 ay geçmiş) veya haftalık (65 hafta geçmiş)
- Limit: Kategori başına ülke başına 500 terim
İstek
{ "genre": "PRODUCTIVITY", "countries": ["US", "GB", "DE"], "granularity": "MONTHLY", "limit": 500}
Yanıt her satırda searchTerm, rankInGenre, searchPopularityInGenre, searchPopularity1to100, searchPopularity1to5 döndürüyor.
Bir yanıt yazın