Cognant kurulumu
Cognant, Adjust ile entegre bir reklam ağıdır. Entegrasyonumuz ile Cognant, attribution ve uygulama içi event verilerini otomatik callback'ler ile alabilir.
Bu makalede, Cognant ö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 Cognant 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 Cognant 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
MZ CODE
- Giriş bilgilerinizi bulmakta yardıma ihtiyacınız varsa Cognant temsilcinizle iletişime geçin.
Campaign Lab'de Cognant seçeneğini seçin ve uygulamanızı seçin
- Campaign Lab kısmında Partnerler seçeneğini seçin.
- Yeni partner > Cognant 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 Cognant ile veri paylaşımı için entegrasyonu etkinleştirin.
- İleri 'yi seçin.
Veri paylaşımını etkinleştir
Cognant entegrasyonu için veri paylaşımını etkinleştirin. Veri paylaşımını etkinleştirmek için:
- MZ CODE 'ınızı girin.
Cognant ile veri paylaşımını etkinleştirdiğinizde Adjust, varsayılan olarak aşağıdaki verileri Cognant partnerine otomatik olarak gönderecektir:
- click (tık)
- Kurulum
- session (oturum)
- 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 Cognant ile paylaştığı aktiviteleri kontrol edebilirsiniz:
- click (tık)
- Kurulum
- session (oturum)
- Reattribution
- event
Ek veriler göndermek
Cognant ile callback'ler aracılığıyla paylaşmak istediğiniz veri miktarını ve türünü seçin. Cognant, bu bilgileri performansı optimize etmek için kullanabilir.
- Hangi veri kaynaklarını paylaşmak istiyorsunuz? kısmında Cognant ile paylaştığınız verilerin attribution kaynağını seçin:
- Tüm attribution kaynaklarından gelen veriler
- Sadece Cognant ile attribute edilen veriler
Session'lar
Adjust, yüksek hacimli oturumlardan dolayı session callback'lerini otomatik olarak göndermez. Session'ları paylaştığınızda Cognant uygulamanızın session aktivitesini alacaktır.
Uygulama-içi revenue (uygulama-içi alışverişlerden)
Uygulama-içi revenue paylaşımı ile Cognant 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 Cognant ürünlerinin alabileceği değerler ile eşleştirin. Eşleştirilmemiş event'lere dair veriler Cognant ile paylaşılmaz.
Event'leri tekil eşleştirin
Multi-platform Uygulamanız varsa, Cognant 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 Cognant 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 Cognant ile paylaşmak istediğiniz Adjust event'ini seçin.
Partner event'i altında Adjust event'ine karşılık gelen Cognant 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.
Cognant artık bağlı event'lerinizin her biri için uygulama-içi event verilerini alacaktır.
Tüm event'leri eşleştir
Cognant, 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.
Cognant artık bağlı event'lerinizin her biri için uygulama-içi event verilerini alacaktır.
Parametreleri eşleştirmek
Özel verileri Cognant 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 Cognant'e göndermesini sağlar. Bu, Cognant 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 Cognant 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 Cognant 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 Cognant ile entegrasyon da sağlar.
Linkinizi oluşturduktan sonra kampanyalarınızda kullanmaları için Cognant ile paylaşın.
Partnerlere özgü yapılandırma yönergeleri
Modülü etkinleştirdiğinizde, callback'lerin hangi endpoint'e gönderilmesini istediğinizi seçebilirsiniz. Bunun için “Sadece Staging Endpoint” ve “Sadece Production Endpoint” anahtarlarını kullanabilirsiniz.
Bir ya da iki endpoint anahtarını da açık konuma getirebilirsiniz. Ancak iki anahtar da KAPALI konumdaysa HİÇBİR callback'in gönderilmeyeceğini unutmayın.
Cognant partnerine yönlendirilen tüm parametrelerin listesi
Cognant, 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_md5} | Küçük harflerle Android ID hex MD5 hash |
{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) |
{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ı |
{gclid} | Google Click ID |
{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_md5_hex} | IDFA hex MD5 hash |
{idfa_md5} | IDFA base64 MD5 hash |
{idfa_upper} | Büyük harflerle IDFA |
{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ı |
{label} | Tıklama ile gönderilen Adjust "label" parametresinin değeri |
{language} | Cihazın iki karakterlik dil kodu |
{last_time_spent} | Kullanıcının son session'ının saniye cinsinden süresi |
{mac_md5} | Büyük harfler, MAC MD5 hash |
{mac_sha1} | Büyük harfler, MAC SHA1 hash |
{match_type} | attribution metodu |
{nonce} | Küçük harflerden oluşan random alfanumerik string (her callback için benzersiz) |
{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. |
{publisher_parameters} | Özel yayıncı parametreleri Adjust SDK tarafından toplanır (Adjust dashboard'da görüntülenmez) |
{random} | Random sayı (her callback için benzersiz) |
{reattribution_attribution_window} | Reattribution için attribution penceresi ayarı (saat cinsinden) |
{referrer} | Google Play Store referrer (sadece Android) |
{reftag} | Rastgele cihaz referansı tag'i |
{region} | Cihazın bölge kodu |
{reporting_currency} | Dashboard raporlanan ISO 4217 para birimi kodu |
{reporting_revenue} | Adjust dashboard'unda raporlandığı gibi revenue, tam para biriminde |
{revenue_usd_cents} | ABD cent cinsinden revenue |
{revenue_usd} | Revenue, ABD doları cinsinden |
{revenue} | Revenue, Adjust SDK'dan gönderildiği gibi cent cinsinden |
{sdk_version} | Adjust SDK versiyonu (her uygulama için) |
{search_term} | Google Organik arama terimi |
{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 |
{tweet_id} | Benzersiz tweet ID'si |
{twitter_line_item_id} | Twitter line item ID |
{user_agent} | Gelen ham user agent |
{win_hwid} | Windows Store Hardware ID |
{win_udid} | Windows Phone benzersiz cihaz ID'si |
{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_name} | Uygulamanın 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) |
{campaign_name} | Kampanya adı, tracker'dan alındığı gibi |
{click_referer} | Tıklamanın referrer header'ı |
{click_time_hour} | Attribute edilmiş tıklama timestamp'inin en yakın saate yuvarlanmış hali |
{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_hour} | Aktivite timestamp'i, en yakın saate yuvarlanmış |
{created_at} | Aktivite timestamp'i |
{creative_name} | Kreatif adı, tracker'dan alındığı gibi |
{engagement_time_hour} | En yakın saate yuvarlanmış etkileşim timestamp'i |
{engagement_time} | Etkileşim timestamp'i |
{impression_based} | Gösterim bazlı etkileşim ise 1, değilse 0 |
{installed_at_hour} | Install (örn. ilk uygulama açılışı) timestamp'inin en yakın saate yuvarlanmış hali |
{installed_at} | Install (örn. ilk uygulama açılışı) timestamp'i |
{is_organic} | Organikse 1, organik değilse 0 |
{last_tracker_name} | Reattribute edilmiş kullanıcının önceki tracker adı |
{last_tracker} | Reattribute edilmiş kullanıcının önceki tracker'ının 6 karakterlik Adjust tracker token'ı |
{network_name} | Ağ adı, tracker'dan alındığı gibi |
{reattributed_at_hour} | Reattribution timestamp'i, en yakın saate yuvarlanmış |
{reattributed_at} | Reattribution timestamp |
{rejection_reason} | Attribution'ın reddedilme nedeni |
{store} | Tıklamanın hedef store'u |
{tracker_name} | Şu andaki tracker adı |
{tracker} | Altı karakterlik Adjust tracker token'ı |
{google_ads_adgroup_id} | Google Ads adgroup ID |
{google_ads_campaign_id} | Google Ads campaign ID |
{google_ads_campaign_name} | Google Ads kampanya adı |
{google_ads_campaign_type} | Google Ads kampanya türü |
{google_ads_creative_id} | Google Ads kreatif ID'si |
{google_ads_keyword} | Google Ads search keyword |
{google_ads_matchtype} | Google Ads search keyword ve eşleşme türü |
{google_ads_network_subtype} | Google Ads ağ alt türü |
{google_ads_network_type} | Google Ads ağ türü |
{google_ads_placement} | Google Ads ad placement |
{google_ads_video_id} | Google Ads video ID |