Dokümantasyonumuzu sürekli güncel tutuyoruz, ancak bazı güncellemeler henüz tüm dillerde yayınlanmamış olabilir. En güncel bilgiler için lütfen İngilizce versiyonuna göz atın.

Firefly kurulumu

Firefly, Adjust ile entegre bir reklam ağıdır. Entegrasyonumuz ile Firefly, attribution ve uygulama içi event verilerini otomatik callback'ler ile alabilir.

Bu makalede, Firefly ölçümlemesini uygulamanız için nasıl yapılandırabileceğinizi bulabilirsiniz. Buna entegrasyonu etkinleştirmek, bir kampanya linki oluşturmak ve Adjust'ın Firefly ile hangi verileri paylaşabileceğini seçmek de dahildir.

Başlamadan önce

Gereklilikler

  • Adjust'ta Admin, Editör ya da Özel Editör izinlerine sahip olmak.
  • SDK parametrelerini Firefly parametreleri ile eşleştirmek için Adjust SDK v4.0.0 ve üstü. Bu özelliği kullanmak için aşağıdaki rehberleri takip edebilirsiniz.

iOS | Android | Pencereler | Unity | React Native | Flutter | Adobe Air | Kordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Giriş bilgileri

Firefly Account Id

  • Giriş bilgilerinizi bulmakta yardıma ihtiyacınız varsa Firefly temsilcinizle iletişime geçin.

Campaign Lab'de Firefly seçeneğini seçin ve uygulamanızı seçin

  1. Campaign Lab kısmında Partnerler seçeneğini seçin.
  2. Yeni partner > Firefly seçeneğini seçin. İleri'yi seçerek sonraki ekrana geçin.
  3. Uygulama seçimi ekranında linkini oluşturmak istediğiniz uygulamayı seçin ve Firefly ile veri paylaşımı için entegrasyonu etkinleştirin.
  4. İleri'yi seçin.

Veri paylaşımını etkinleştir

Firefly entegrasyonu için veri paylaşımını etkinleştirin. Veri paylaşımını etkinleştirmek için:

  1. Firefly Account Id 'ınızı girin.

Firefly ile veri paylaşımını etkinleştirdiğinizde Adjust, varsayılan olarak aşağıdaki verileri Fireflylerine otomatik olarak gönderecektir:

  • Kurulum
  • Uygulamayı Kaldırma (Uninstall)
  • Yeniden Kur
  • Reattribution
  • event
  • reddedilen kurulum
  • reddedilen reattribution

Veri paylaşımı seçeneklerinizi belirleyin

Veri paylaşımı birden fazla platformda etkin olan bir multi-platform uygulama ile çalışıyorsanız aşağıdakileri yapabilirsiniz:

  1. Platforma özgü ayarları kullan seçeneğini seçerek veri paylaşımı seçeneklerini platform seviyesinde ayırabilirsiniz.
  2. Birden fazla platformda aynı veri paylaşımı seçeneklerini kullanmak için Global ayarları kullan seçeneğini seçin.

Varsayılan olarak neler paylaşılır? kısmında Adjust'ın varsayılan olarak Firefly ile paylaştığı aktiviteleri kontrol edebilirsiniz:

  • Kurulum
  • Uygulamayı Kaldırma (Uninstall)
  • Yeniden Kur
  • Reattribution
  • event
  • reddedilen kurulum
  • reddedilen reattribution

Ek veriler göndermek

Firefly ile callback'ler aracılığıyla paylaşmak istediğiniz veri miktarını ve türünü seçin. Firefly, bu bilgileri performansı optimize etmek için kullanabilir.

  1. Hangi veri kaynaklarını paylaşmak istiyorsunuz? kısmında Firefly ile paylaştığınız verilerin attribution kaynağını seçin:
  • Tüm attribution kaynaklarından gelen veriler
  • Sadece Firefly ile attribute edilen veriler

Uninstall ve reinstall'lar

Uninstall ve reinstall'ları paylaşarak Firefly, uygulamanızın Adjust tarafından ölçümlenen tüm uninstall ve reinstall verilerini alabilir.

Not:

iOS uygulamaları için uninstall ve reinstall rakamlarının düşük olmasını bekleyebilirsiniz. Daha fazla bilgi için Uninstall ve reinstall ölçümlemesi makalesine göz atın.

Event eşleştirmesi

Paylaşmak istediğiniz event'leri Firefly ürünlerinin alabileceği değerler ile eşleştirin. Eşleştirilmemiş event'lere dair veriler Firefly ile paylaşılmaz.

Event'leri tekil eşleştirin

Multi-platform Uygulamanız varsa, Firefly ile her platformda farklı event'leri paylaşmayı seçebilirsiniz. Bu size aşağıdaki imkanları sunar:

  • Her platformun kampanya stratejilerini yönetmek için tekil event'ler belirleyin.
  • Veri paylaşımını her platform için özelleştirin.

Event eşleştirmesi kısmında bu adımları takip ederek Firefly partnerine doğrudan göndermek istediğiniz uygulama-içi event'leri seçin.

  1. Event eşleştirmesi'ni seçin.

  2. Adjust event'i listesinde Firefly ile paylaşmak istediğiniz Adjust event'ini seçin.

  3. Partner event'i altında Adjust event'ine karşılık gelen Firefly event'ini seçmeniz gerekir.

    1. Veri paylaşımının tek bir platformda etkinleştirildiği tek platformlu uygulamalar ve multi-platform uygulamalar için, sadece o platforma dair veri paylaşım seçeneklerini belirleyebilirsiniz. Veri paylaşımı birden fazla platformda etkin olan multi-platform uygulamalar için aşağıdakileri yapabilirsiniz:

      • Ayrı event'leri platform seviyesinde eşleştirmek için ya da event'leri belli platformların eşleştirmesini yapmamak için Platforma özgü eşleştirmeyi kullan seçeneğini seçin.
      • Tüm platformlar için aynı event'leri eşleştirmek için Global eşleştirmeyi kullan seçeneğini seçin.

    2. Partner event'i listesinde Adjust event'i ile eşleştirmek istediğiniz özel event adını girin ya da bir özel event seçin.

  4. Uygula'yı seçin.

Firefly artık bağlı event'lerinizin her biri için uygulama-içi event verilerini alacaktır.

Tüm event'leri eşleştir

Firefly, tüm event'lerin otomatik olarak eşleştirilmesini destekliyorsa, Event'leri eşleştir kısmında Tüm event'leri eşleştir seçeneğini seçin. Bu, event'leri tekil eşleştirirken zamandan tasarruf etmenizi sağlar.

Firefly artık bağlı event'lerinizin her biri için uygulama-içi event verilerini alacaktır.

Linkinizi ve ayarlarınızı yapılandırın

Ayar yapabilecekleriniz:

Linkinizi oluşturun ve Firefly ile paylaşın

Yaptığınız seçimleri Yapılandırma kontrolü ekranında kontrol edin. Bu noktada geri dönebilir ve aşağıdakilerde değişiklik yapabilirsiniz:

  • Seçtiğiniz uygulama
  • Veri paylaşımı seçenekleri
  • Link yapısı parametreleri
  • Kullanıcı hedefleri
  • Attribution ayarları

Tıklama URL'ini, gösterim URL'ini, QR kodunu ve link token'ınızı oluşturmak için Link oluştur'u seçin. Bir link oluşturmak aynı zamanda veri paylaşımını ve Firefly ile entegrasyon da sağlar.

Linkinizi oluşturduktan sonra kampanyalarınızda kullanmaları için Firefly ile paylaşın.

Firefly partnerine yönlendirilen tüm parametrelerin listesi

Firefly, Adjust'ın bu parametreleri (veri noktaları) callback'ler ile birlikte göndermesini gerektirir:

PlaceholderBilgi
{adid}Adjust cihaz ID'si (tüm platformlar)
{city}Cihaz şehri
{cost_amount}Kullanıcı etkileşiminin cost'u (sadece reklam harcaması takibi ile)
{cost_currency}Cost verisinin orijinal ISO 4217 para birimi kodu (sadece reklam harcaması takibi ile)
{cost_type}Kampanya fiyatlandırma modeli (sadece reklam harcaması takibi ile)
{country_subdivision}Ülkelerin alt bölümleri, örn. eyalet
{country}Cihazın iki karakterlik ülke kodu
{device_name}Cihaz modeli numarası
{device_type}Cihaz Tipi
{fire_adid}Fire OS reklam tanımlayıcısı
{gps_adid}Google Play Store reklam ID'si
{idfa||android_id}IDFA, ya da IDFA boşsa Android ID
{idfv}Büyük harflerle iOS ID for vendors
{ip_address}Cihazın IP adresi
{language}Cihazın iki karakterlik dil kodu
{os_name}Cihazın işletim sistemi
{os_version}İşletim sistemi versiyonu numarası
{postal_code}Cihazın IP adresinin posta kodu.
{region}Cihazın bölge kodu
{user_agent}Gelen ham user agent
{win_udid}Windows Phone benzersiz cihaz ID'si
{activity_kind}Kullanıcı aktivitesi türü
{app_id}Store App ID ya da Google Play Store
{app_name}Uygulamanın adı
{app_version}Uygulama versiyon numarası (Android), bundle için build versiyonu numarası (iOS)
{campaign_name}Kampanya adı, tracker'dan alındığı gibi
{created_at}Aktivite timestamp'i
{device_manufacturer}Cihaz üreticisi adı
{installed_at}Install (örn. ilk uygulama açılışı) timestamp'i
{tracker_name}Şu andaki tracker adı