Kayzen kurulumu
Kayzen, Adjust ile entegre bir reklam ağıdır. Entegrasyonumuz ile Kayzen, attribution ve uygulama içi event verilerini otomatik callback'ler ile alabilir.
Bu makalede, Kayzen ö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 Kayzen 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 Kayzen 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
API_KEY
- Giriş bilgilerinizi bulmakta yardıma ihtiyacınız varsa Kayzen temsilcinizle iletişime geçin.
Campaign Lab'de Kayzen seçeneğini seçin ve uygulamanızı seçin
- Campaign Lab kısmında Partnerler seçeneğini seçin.
- Yeni partner > Kayzen seçeneğini seçin. İleri 'yi seçerek sonraki ekrana geçin.
- Uygulama seçimi ekranında linkini oluşturmak istediğiniz uygulamayı seçin ve Kayzen ile veri paylaşımı için entegrasyonu etkinleştirin.
- İleri 'yi seçin.
Veri paylaşımını etkinleştir
Kayzen entegrasyonu için veri paylaşımını etkinleştirin. Veri paylaşımını etkinleştirmek için:
- API_KEY 'ınızı girin.
Kayzen ile veri paylaşımını etkinleştirdiğinizde Adjust, varsayılan olarak aşağıdaki verileri Kayzen partnerine otomatik olarak gönderecektir:
- Kurulum
- session (oturum)
- Uygulamayı Kaldırma (Uninstall)
- Yeniden Kur
- reattribution reinstall
- Reattribution
- event
- reddedilen kurulum
- reddedilen reattribution
- reklam cirosu
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:
- Platforma özgü ayarları kullan seçeneğini seçerek veri paylaşımı seçeneklerini platform seviyesinde ayırabilirsiniz.
- 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 Kayzen ile paylaştığı aktiviteleri kontrol edebilirsiniz:
- Kurulum
- session (oturum)
- Uygulamayı Kaldırma (Uninstall)
- Yeniden Kur
- reattribution reinstall
- Reattribution
- event
- reddedilen kurulum
- reddedilen reattribution
- reklam cirosu
Ek veriler göndermek
Kayzen ile callback'ler aracılığıyla paylaşmak istediğiniz veri miktarını ve türünü seçin. Kayzen, bu bilgileri performansı optimize etmek için kullanabilir.
- Hangi veri kaynaklarını paylaşmak istiyorsunuz? kısmında Kayzen ile paylaştığınız verilerin attribution kaynağını seçin:
- Tüm attribution kaynaklarından gelen veriler
- Sadece Kayzen ile attribute edilen veriler
Ad revenue (reklam gösterimlerinden)
Ad revenue paylaşımı, Kayzen tarafından kullanıcı ad revenue verilerini almasını sağlar. Bu sayede Kayzen, ad revenue verilerini kullanıcı hedeflemesini ve kampanyaları optimize etmek için kullanabilir.
Bu özellik, Adjust'ın Ad Revenue paketi ile kullanılabilir. Ad Revenue paketimizi satın almak için satış temsilcimiz ile iletişime geçin.
Ad revenue bilgisini Kayzen ile paylaşmak için bir ya da birden fazla Ad Revenue Kaynağı seçin.
- Bu alan boş bırakıldığında, tüm entegre aracı kaynaklardan gelen Ad Revenue verileri gönderilir.
Session'lar
Adjust, yüksek hacimli oturumlardan dolayı session callback'lerini otomatik olarak göndermez. Session'ları paylaştığınızda Kayzen uygulamanızın session aktivitesini alacaktır.
Uninstall ve reinstall'lar
Uninstall ve reinstall'ları paylaşarak Kayzen, uygulamanızın Adjust tarafından ölçümlenen tüm uninstall ve reinstall verilerini alabilir.
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.
Uygulama-içi revenue (uygulama-içi alışverişlerden)
Uygulama-içi revenue paylaşımı ile Kayzen partnerinin revenue miktarlarını revenue event verileriniz ile birlikte almasını sağlayabilirsiniz. Bu verileri paylaşmak için revenue yaratan event'leri eşleştirmeniz gerekir.
Event eşleştirmesi
Paylaşmak istediğiniz event'leri Kayzen ürünlerinin alabileceği değerler ile eşleştirin. Eşleştirilmemiş event'lere dair veriler Kayzen ile paylaşılmaz.
Event'leri tekil eşleştirin
Multi-platform Uygulamanız varsa, Kayzen 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 Kayzen partnerine doğrudan göndermek istediğiniz uygulama-içi event'leri seçin.
Event eşleştirmesi 'ni seçin.
Adjust event'i listesinde Kayzen ile paylaşmak istediğiniz Adjust event'ini seçin.
Partner event'i altında Adjust event'ine karşılık gelen Kayzen event'ini seçmeniz gerekir.
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.
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.
Uygula 'yı seçin.
Kayzen artık bağlı event'lerinizin her biri için uygulama-içi event verilerini alacaktır.
Tüm event'leri eşleştir
Kayzen, 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.
Kayzen artık bağlı event'lerinizin her biri için uygulama-içi event verilerini alacaktır.
Parametreleri eşleştirmek
Özel verileri Kayzen ile paylaşmak için genellikle parametreleri eşleştirmeniz gerekir.
Partner parametreleri (Adjust SDK sürüm 4.0 ve üstü), Adjust'ın özelleştirilmiş veri noktalarını uygulamanızdan alıp Kayzen'e göndermesini sağlar. Bu, Kayzen partnerinin bağlı event'lerinizin her biri için özel event detaylarını almasını sağlar.
Yeni partner parametrelerini Adjust SDK'ya eklemeden önce gereksinimlerinizi karşılayan mevcut partner parametrelerinin olmadığını kontrol edin.
Partner parametrelerini Kayzen ile paylaşmak için bu adımları takip edin.
Adjust SDK içindeki partner parametrelerini ayarlayın.
- Tüm SDK geliştirme platform linkleri için Başlamadan önce'yi inceleyin.
Veri paylaşımı seçeneklerinizi belirleyin altından Parametreler seçimini yapın.
Parametre eşleştirmesi 'nin altında, SDK'da tanımlanan partner parametrelerini ağa nasıl göndermek istediğinizi belirleyebilirsiniz:
- Parametre eşleştirmesi 'ni seçin.
- SDK parametresi alanına ağ ile paylaşmak istediğiniz SDK parametresinin adını girin.
- Partner parametresi alanına SDK parametresine karşılık gelen ağ parametresini girin.
Partner parametrelerini Adjust SDK'da dashboard'daki parametre paylaşımını yapılandırmadan yapılandırırsanız Adjust, parametreleri Adjust SDK'daki isimleri ile gönderir.
Linkinizi ve ayarlarınızı yapılandırın
Ayar yapabilecekleriniz:
Linkinizi oluşturun ve Kayzen 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 Kayzen ile entegrasyon da sağlar.
Linkinizi oluşturduktan sonra kampanyalarınızda kullanmaları için Kayzen ile paylaşın.
Kayzen partnerine yönlendirilen tüm parametrelerin listesi
Kayzen, Adjust'ın bu parametreleri (veri noktaları) callback'ler ile birlikte göndermesini gerektirir:
| Placeholder | Bilgi |
{adid} | Adjust cihaz ID'si (tüm platformlar) |
{city} | Cihaz şehri |
{click_attribution_window} | Cihaz eşleştirmesi için attribution penceresi ayarı (saat cinsinden) |
{country} | Cihazın iki karakterlik ülke kodu |
{currency} | Adjust SDK'dan gönderilen Orijinal ISO 4217 para birimi kodu |
{deeplink} | Tıklama URL'ine eklenmiş deeplink URL |
{device_name} | Cihaz modeli numarası |
{device_type} | Cihaz Tipi |
{gps_adid} | Google Play Store reklam ID'si |
{idfa} | ID for advertisers (sadece iOS) |
{idfv} | Büyük harflerle iOS ID for vendors |
{impression_attribution_window} | Gösterim eşleştirmesi için attribution penceresi ayarı (saat cinsinden) |
{inactive_user_definition} | Reattribution için gereken inaktivite periyodu (saat cinsinden) |
{ip_address} | Cihazın IP adresi |
{is_reattributed} | Kullanıcı daha önceki bir kaynaktan en az bir kere reattribute edildiyse 1. Kullanıcı daha önce hiç reattribute edilmediyse 0. |
{isp} | Cihazın internet servis sağlayıcısı |
{language} | Cihazın iki karakterlik dil kodu |
{lifetime_session_count} | Kullanıcının tüm hayat boyu kaydedilen session sayısı |
{match_type} | attribution metodu |
{mcc} | Mobil ülke kodu: cihazın ülkesini tanımlayan üç haneli kod. Mobil ağ kodunu kullanarak cihazın operatörünü belirleyebilirsiniz. |
{mnc} | Mobil ağ kodu: iki haneli kod. Mobil ülke kodunu kullanarak cihazın operatörünü belirleyebilirsiniz. |
{nonce} | Küçük harflerden oluşan random alfanumerik string (her callback için benzersiz) |
{os_name} | Cihazın işletim sistemi |
{os_version} | İşletim sistemi versiyonu numarası |
{partner_parameters} | Adjust SDK ya da S2S request'i tarafından toplanan ve postback'ler ile üçüncü parti sağlayıcılara gönderilen özel partner parametreleri |
{random} | Random sayı (her callback için benzersiz) |
{reattribution_attribution_window} | Reattribution için attribution penceresi ayarı (saat cinsinden) |
{revenue_float} | Revenue, Adjust SDK'dan gönderildiği gibi tam para birimlerinde |
{revenue_usd_cents} | ABD cent cinsinden revenue |
{revenue_usd} | Revenue, ABD doları cinsinden |
{revenue} | Revenue, Adjust SDK'dan gönderildiği gibi cent cinsinden |
{time_spent} | Kullanıcının şu andaki session'ının saniye cinsinden süresi |
{timezone} | Cihazın saat dilimi |
{user_agent} | Gelen ham user agent |
{activity_kind} | Kullanıcı aktivitesi türü |
{adgroup_name} | Adgroup adı, tracker'dan alındığı gibi |
{app_id} | Store App ID ya da Google Play Store |
{app_name} | Uygulamanın adı |
{campaign_name} | Kampanya adı, tracker'dan alındığı gibi |
{click_time} | Attribute edilmiş tıklama timestamp'i |
{connection_type} | Internet bağlantı türü |
{conversion_duration} | Tıklama ve install ya da reattribution arasındaki saniye cinsinden zaman |
{cpu_type} | CPU türü |
{created_at} | Aktivite timestamp'i |
{creative_name} | Kreatif adı, tracker'dan alındığı gibi |
{device_manufacturer} | Cihaz üreticisi adı |
{engagement_time} | Etkileşim timestamp'i |
{hardware_name} | Donanım adı |
{impression_based} | Gösterim bazlı etkileşim ise 1, değilse 0 |
{impression_time} | Attribute edilmiş gösterim timestamp'i |
{install_begin_time} | Uygulama indirmesinin başladığı zamanın timestamp'i (sadece Android ve Google Play Store) |
{install_finish_time} | Uygulama indirmesinin bittiği zamanın timestamp'i |
{installed_at} | Install (örn. ilk uygulama açılışı) timestamp'i |
{is_organic} | Organikse 1, organik değilse 0 |
{network_name} | Ağ adı, tracker'dan alındığı gibi |
{network_type} | Ağ türü |
{reattributed_at} | Reattribution timestamp |
{reinstalled_at} | Reinstall timestamp |
{rejection_reason} | Attribution'ın reddedilme nedeni |
{time_to_reinstall} | En son uygulama uninstall'u ve sonrasındaki reinstall arasındaki saniye cinsinden zaman |
{time_to_uninstall} | En son uygulama install'u (ya da en son reinstall) ve sonrasındaki uninstall arasındaki saniye cinsinden zaman |
{uninstalled_at} | Uninstall timestamp'i (son session zamanına bağlı tahmin) |
{ad_impressions_count} | Son kullanıcılara servis edilen mobil reklam sayısı |
{ad_revenue_network} | Reklamı görüntüleyen reklam ağı |
{ad_revenue_unit} | Revenue oluşturan reklam birimi |
{ad_revenue_placement} | Platformda tanımlandığı gibi kullanıcı placement'ı |
{is_s2s} | sunucudan sunucuya etkileşim ise 1, değilse 0 |
{proxy_ip_address} | Kullanıcının proxy'sinin IP adresi |
{ad_mediation_platform} | Aracı platform adı |
{ad_revenue_payload} | JSON olarak gösterim seviyesi revenue verileri (ILRD) |