KARTE kurulumu
KARTE, Adjust ile entegre bir analitik partneridir. Entegrasyonumuz ile KARTE, Adjust tarafından ölçümlenen verileri otomatik callback'ler ile alabilir. Ardından bu verileri içgörü edinmek ve analitik amacıyla partnerin araçları ile kullanabilirsiniz.
Bu makalede, KARTE ölçümlemesini uygulamanız için nasıl yapılandırabileceğinizi bulabilirsiniz. Buna entegrasyonu etkinleştirmek ve Adjust'ın KARTE ile paylaşabileceği verileri seçmek de dahildir.
Başlamadan önce
Gereklilikler
- Adjust'ta Admin, Editör ya da Özel Editör izinlerine sahip olmak.
- SDK parametrelerini KARTE 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 | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Giriş bilgileri
API KEY
- Giriş bilgilerinizi bulmakta yardıma ihtiyacınız varsa KARTE temsilcinizle iletişime geçin.
Campaign Lab'de KARTE seçeneğini seçin ve uygulamanızı seçin
- Campaign Lab kısmında Partnerler seçeneğini seçin.
- Yeni partner > KARTE seçeneğini seçin. İleri 'yi seçerek sonraki ekrana geçin.
- Uygulama seçimi ekranında link'ini oluşturmak istediğiniz uygulamayı seçin ve KARTE ile veri paylaşımı için entegrasyonu etkinleştirin.
- İleri 'yi seçin.
Veri paylaşımını etkinleştirin
KARTE entegrasyonu için veri paylaşımını etkinleştirin. Veri paylaşımını etkinleştirmek için:
- API KEY 'ınızı girin.
KARTE ile veri paylaşımını etkinleştirdiğinizde Adjust, varsayılan olarak aşağıdaki verileri KARTE partnerine otomatik olarak gönderecektir:
- Kurulum
- Yeniden Kur
- reattribution reinstall
- Reattribution
- event
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 KARTE ile paylaştığı aktiviteleri kontrol edebilirsiniz:
- Kurulum
- Yeniden Kur
- reattribution reinstall
- Reattribution
- event
Ek veriler göndermek
KARTE ile callback'ler aracılığıyla paylaşmak istediğiniz veri miktarını ve türünü seçin. KARTE, bu bilgileri performansı optimize etmek için kullanabilir.
Ek veriler göndermek için bu seçenekleri gözden geçirebilir ve özelleştirebilirsiniz:
Uninstall ve reinstall'lar
Uninstall ve reinstall'ları paylaşarak KARTE, 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 KARTE 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'leri eşleştirmek
Paylaşmak istediğiniz event'leri KARTE ürünlerinin alabileceği değerler ile eşleştirin. Eşleştirilmemiş event'lere dair veriler KARTE ile paylaşılmaz.
Tekil event'leri eşleştirmek
Multi-platform bir uygulamanız varsa, KARTE ile her platform için farklı event'ler paylaşmayı seçebilirsiniz. Bu size aşağıdaki imkanları sunar:
- Her platform için kampanya stratejilerini yönetmek üzere ayrı event'ler ayarlamak.
- Veri paylaşımını platform bazında özelleştirmek.
Event eşleştirmesi kısmında bu adımları takip ederek KARTE 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 KARTE ile paylaşmak istediğiniz Adjust event'ini seçin.
Partner event'i altında, Adjust event'iyle denk olan KARTE event'ini seçmeniz gerekir.
Tek platformlu uygulamalar ve veri paylaşımının yalnızca tek bir platform için etkinleştirildiği multi-platform uygulamalar için, yalnızca o platforma ait etkinlikleri eşlersiniz. Veri paylaşımı birden fazla platformda etkin olan multi-platform uygulamalar için aşağıdakileri yapabilirsiniz:
- Platform düzeyinde ayrı event'leri eşleştirmek veya belirli platformlara ilişkin event'leri eşlememek için Platforma özel eşleştirmeyi kullan 'ı seçin.
- Tüm platformlar için aynı event'leri eşlemek için Global eşleştirmeyi kullan 'ı 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.
KARTE artık bağlı event'lerinizin her biri için uygulama-içi event verilerini alacaktır.
Tüm event'leri eşleştirmek
KARTE, 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.
KARTE artık tüm bağlı event'lerinizin uygulama-içi event verilerini alacaktır.
Parametre eşleştirmesi
Özel verileri KARTE 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 KARTE'e göndermesini sağlar. Bu, KARTE 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 KARTE 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.
Uygulamanız için KARTE partnerini etkinleştirin
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
Partneri etkinleştir 'i seçerek KARTE partnerini uygulamanız için etkinleştirin. Analitik partnerleri, kampanya linkleri ile çalışmazlar. Entegrasyonumuz etkinleştirildiğinde attribution ve uygulama-içi event verileri otomatik callback'ler ile gönderilir.
Partnerlere özgü yapılandırma yönergeleri
Ön tanımlı parametreler
Karte ile bir ön tanımlı parametre seti gönderebilirsiniz. Bu parametrelerden herhangi birini Adjust SDK'nızdaki bir event'e eklediğinizde, bunlar Karte'ye gönderilir. Partner parametrelerini eklemek hakkında daha fazla bilgi için, kullandığınız SDK için spesifik SDK readme dosyasına göz atın. Karte'nin kabul ettiği tanımlanmış parametrelerin listesini aşağıda bulabilirsiniz:
Parameter key> Value
- visitor_id > callback'leri Karte'ye göndermek için zorunludur.
Event callback'lerini Karte'ye göndermek için visitor_id'yi Adjust SDK'ya bir session ve event partner parametresi olarak eklemeniz gerekir. Bunun için Parametre yönlendirmesinin Adjust dashboard'unda etkin olması gerekir.
Daha fazla bilgi için Karte Destek Sayfasına (JP) da göz atabilirsiniz.
KARTE partnerine yönlendirilen tüm parametrelerin listesi
KARTE, Adjust'ın bu parametreleri (veri noktaları) callback'ler ile birlikte göndermesini gerektirir:
Placeholder | Bilgi |
{adid} | Adjust cihaz ID'si (tüm platformlar) |
{android_id} | Android ID (sadece Android) |
{api_level} | API seviyesi (sadece Android) |
{city} | Cihaz şehri |
{click_attribution_window} | Cihaz eşleştirmesi için attribution penceresi ayarı (saat cinsinden) |
{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 |
{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 |
{environment} | Mevcut Adjust SDK ortam ayarı |
{fire_adid} | Fire OS reklam tanımlayıcısı |
{gps_adid_md5} | Google Play Store reklam ID'sinin küçük harflerle hex MD5 hash'i |
{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 |
{isp} | Cihazın internet servis sağlayıcısı |
{language} | Cihazın iki karakterlik dil kodu |
{last_time_spent} | Kullanıcının son session'ının saniye cinsinden süresi |
{lifetime_session_count} | Kullanıcının tüm hayat boyu kaydedilen session sayısı |
{match_type} | attribution metodu |
{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 |
{postal_code} | Cihazın IP adresinin posta kodu. |
{random_user_id} | Random kullanıcı ID'si (her cihaz için) |
{random} | Random sayı (her callback için benzersiz) |
{reattribution_attribution_window} | Reattribution için attribution penceresi ayarı (saat cinsinden) |
{reftag} | Rastgele cihaz referansı tag'i |
{reporting_cost} | Uygulamanızın raporlanan para birimine dönüştürülen ve Adjust dashboard'unda raporlandığı şekilde kullanıcı etkileşimi cost'u (sadece reklam harcaması takibi ile) |
{reporting_currency} | Dashboard raporlanan ISO 4217 para birimi kodu |
{reporting_revenue} | Adjust dashboard'unda raporlandığı gibi revenue, tam para biriminde |
{revenue_float} | Revenue, Adjust SDK'dan gönderildiği gibi tam para birimlerinde |
{revenue} | Revenue, Adjust SDK'dan gönderildiği gibi cent cinsinden |
{session_count} | Şu andaki Adjust SDK tarafından kaydedilen session sayısı |
{time_spent} | Kullanıcının şu andaki session'ının saniye cinsinden süresi |
{timezone} | Cihazın saat dilimi |
{tracking_enabled} | Takip etkinse 1, değilse 0 |
{tracking_limited} | Takip sınırlıysa 1, değilse 0 |
{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_dashboard} | Uygulamanın Adjust dashboard'undaki adı |
{app_version_raw} | Uygulama versiyon numarası (Android), bundle için build versiyonu numarası (iOS) |
{app_version_short} | Uygulama versiyon numarası (Android), bundle için release versiyonu numarası (iOS) |
{app_version} | Uygulama versiyon numarası (Android), bundle için build versiyonu numarası (iOS) |
{attribution_updated_at} | Updated attribution timestamp |
{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 |
{created_at} | Aktivite timestamp'i |
{creative_name} | Kreatif adı, tracker'dan alındığı gibi |
{engagement_time} | Etkileşim timestamp'i |
{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 |
{last_session_time} | Son session timestamp'i |
{network_name} | Ağ adı, tracker'dan alındığı gibi |
{reattributed_at} | Reattribution timestamp |
{referral_time} | Kullanıcının Play Store'da uygulama sayfasına gelmesinin timestamp'i (sadece Android ve Google Play Store) |
{reinstalled_at} | Reinstall timestamp |
{store} | Tıklamanın hedef store'u |
{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 |
{tracker_name} | Şu andaki tracker adı |
{uninstalled_at} | Uninstall timestamp'i (son session zamanına bağlı tahmin) |
{google_ads_creative_id} | Google Ads kreatif ID'si |