Android UTM Kampanya Widget'ı Nasıl Çalışır ve Neden Gereklidir

Kerem Aydın·7 Temmuz 2026·⏱3 dk

Android UTM Kampanya Widget'ı, uygulama/SDK içindeki bir modül veya mantıktır; ilk açılışta UTM parametrelerini (Install Referrer API veya benzeri bir yöntemle) alır, bunları kaydeder ve kurulumun doğru atfedilmesi ile sonraki eylemler için analitikteki olaylara ekler.

Widget ne yapar ve neden önemlidir

Web'deki UTM'ler URL içinde yaşar; Android'de yol daha karmaşıktır: tıklama → mağaza → kurulum → açılış. Widget üç görevi çözer:

  • İlk açılışta referrer/utm verilerini yakalar.
  • Kurulum atamasını (source/medium/campaign ve ek alanlar) kaydeder.
  • Doğru raporlar ve LTV/CPA hesaplamaları için bu parametreleri temel olaylara (install, signup, purchase) karıştırır.

Android UTM Kampanya Widget'ı resmi bir standart değildir; bu, genellikle analiz SDK'larında (Firebase, AppsFlyer, Adjust vb.) uygulanan bir yaklaşım/desendir.

Pratikte nasıl çalışır (adım adım)

  1. Tıklamada etiket toplama: Reklam bağlantısı, Google Play URL'sine veya ara landing page'e referrer/utm ekler.
  2. Kurulumda aktarma: Google Play, Install Referrer API aracılığıyla uygulamaya referrer bilgisini iletir.
  3. İlk açılış ve kaydetme: Widget ilk açılışı bekler, utm_* değerlerini çıkarır ve kurulum ataması olarak yerel depolamaya kaydeder.
  4. Analitiğe gönderme: Olaylar tetiklendiğinde widget, kaydedilen utm alanlarını olay parametrelerine ekler.

Geliştiriciler için pratik öneriler:

  • Install Referrer API'yi bağlayın ve test edin.
  • Atamayı yalnızca bir kez sabitleyin (üzerine yazmayın).
  • Yerel olarak minimum seti saklayın: utm_source, utm_medium, utm_campaign, utm_content, utm_term.

Ayrı bir ortamda test edin: Benzersiz utm içeren bir test bağlantısı oluşturun → uygulamayı kurun → analitiğin parametreleri aldığını kontrol edin.

Nasıl uygulanır: Ekip için somut adımlar

  1. Aracı seçin: Firebase/GA4, AppsFlyer, Adjust, AppMetrica veya kendi backend'iniz.
  2. Referrer alımını uygulayın: Install Referrer API + ilk açılış işleyicisi.
  3. UTM adlandırma kurallarını belirleyin (web ve mobil için tek bir doküman).
  4. Tüm reklam bağlantılarında UTM tanımlayın (reklamlar, ortaklık ağları, landing sayfalar, e-postalar).
  5. UTM'yi temel olaylarla birlikte göndermeyi yapılandırın ve raporlar oluşturun: tıklama → kurulum → kayıt → satın alma.

Tablo: UTM kapsamında hangi verilerin toplanması gerekir

ParametreNe saklanmalıNe için gerekli
utm_sourcePlatform/kanal (vk, google, tiktok)Kanalları karşılaştırmak, bütçe dağılımı
utm_mediumTrafik türü (cpc, cpm, email)Satın alma formatını analiz etmek
utm_campaignKampanya adıKampanya etkinliğini değerlendirmek
utm_contentKreatif/varyantKreatiflerin A/B testleri
utm_termAnahtar kelime/kitleSegmentleri/anahtar kelimeleri analiz etmek

Sık yapılan hatalar

  • Web ve mobil arasında tutarsız adlandırma: parçalanmış raporlara yol açar.
  • Install Referrer API kullanılmaması → çoğu ücretli trafik organik olarak işaretlenir.
  • Her uygulama açılışında atamanın üzerine yazılması.
  • UTM'nin temel olaylarla birlikte gönderilmemesi (bu durumda yalnızca kurulum görünür, eylemlerin değeri görünmez).

UTM'nin doğru işlenmesi yapılandırılmazsa, ücretli trafik sıklıkla organik gibi görünür ve kampanya optimizasyonu için gereken verileri kaybedersiniz.

SSS

  • Kurulum atamasını ne kadar süre saklamalıyım?
    • Genellikle atama bir kez sabitlenir ve LTV analizi için süresiz saklanır; eski veriler için "fallback" mantığı kabul edilebilir.
  • Uygulama içi promosyonlarda UTM'yi çoğaltmak gerekir mi?
    • Evet — kurulum kaynağını ve uygulama içi kampanyayı ayırın (install_source_* vs inapp_source_*).
  • Hangisini kullanmalı: analiz SDK'sı mı yoksa kendi çözümüm mü?
    • Hızlı başlangıç için SDK'yı deneyin; kendi çözümünüz esneklik sağlar ancak referrer desteği ve tutarlı bir olay aktarım şeması gerektirir.

Android UTM Kampanya Widget'ını temel olarak kullanın: doğru kurulum ataması, CPA ve LTV hesaplamaları ile bütçe kararları için temel oluşturur.