Awin kurulumu
Awin, Adjust ile entegre bir reklam ağıdır. Entegrasyonumuz ile Awin, attribution ve uygulama içi event verilerini otomatik callback'ler ile alabilir.
Bu makalede, Awin ö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 Awin 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 Awin 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
INSTALL COMMISSION GROUP
- Giriş bilgilerinizi bulmakta yardıma ihtiyacınız varsa Awin temsilcinizle iletişime geçin.
Campaign Lab'de Awin seçeneğini seçin ve uygulamanızı seçin
- Campaign Lab kısmında Partnerler seçeneğini seçin.
- Yeni partner > Awin 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 Awin ile veri paylaşımı için entegrasyonu etkinleştirin.
- İleri 'yi seçin.
Veri paylaşımını etkinleştir
Awin entegrasyonu için veri paylaşımını etkinleştirin. Veri paylaşımını etkinleştirmek için:
- INSTALL COMMISSION GROUP 'ınızı girin.
Awin ile veri paylaşımını etkinleştirdiğinizde Adjust, varsayılan olarak aşağıdaki verileri Awin partnerine otomatik olarak gönderecektir:
- install (sadece attribute edilmiş olanlar)
- event (sadece attribution'ı yapılmış olanlar)
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 Awin ile paylaştığı aktiviteleri kontrol edebilirsiniz:
- install (sadece attribute edilmiş olanlar)
- event (sadece attribution'ı yapılmış olanlar)
Ek veriler göndermek
Awin ile callback'ler aracılığıyla paylaşmak istediğiniz veri miktarını ve türünü seçin. Awin, bu bilgileri performansı optimize etmek için kullanabilir.
- Hangi veri kaynaklarını paylaşmak istiyorsunuz? kısmında Awin ile paylaştığınız verilerin attribution kaynağını seçin:
- Tüm attribution kaynaklarından gelen veriler
- Sadece Awin ile attribute edilen veriler
Uygulama-içi revenue (uygulama-içi alışverişlerden)
Uygulama-içi revenue paylaşımı ile Awin 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 Awin ürünlerinin alabileceği değerler ile eşleştirin. Eşleştirilmemiş event'lere dair veriler Awin ile paylaşılmaz.
Event'leri tekil eşleştirin
Multi-platform Uygulamanız varsa, Awin 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 Awin 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 Awin ile paylaşmak istediğiniz Adjust event'ini seçin.
Partner event'i altında Adjust event'ine karşılık gelen Awin 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.
Awin artık bağlı event'lerinizin her biri için uygulama-içi event verilerini alacaktır.
Tüm event'leri eşleştir
Awin, 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.
Awin artık bağlı event'lerinizin her biri için uygulama-içi event verilerini alacaktır.
Parametreleri eşleştirmek
Özel verileri Awin 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 Awin'e göndermesini sağlar. Bu, Awin 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 Awin 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 Awin 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 Awin ile entegrasyon da sağlar.
Linkinizi oluşturduktan sonra kampanyalarınızda kullanmaları için Awin ile paylaşın.
Partnerlere özgü yapılandırma yönergeleri
Awin entegrasyonu ile bir ön tanımlı parametre seti gönderebilirsiniz. Bu parametrelerden herhangi birini Adjust SDK'nızdaki bir event'e eklediğinizde, bunlar Awin'e gönderilir. Partner parametreleri eklemek hakkında daha fazla bilgi için, kullandığınız SDK ya da SDK'lar için spesifik SDK readme dosyasına göz atın. Awin'in kabul ettiği tanımlanmış parametrelerin listesini aşağıda bulabilirsiniz:
Parameter key> Value
- orderId> sipariş referansı (revenue event'lerinde zorunlu)
- cg> komisyon grubu ayrıntıları (revenue event'lerinde zorunlu)
- vc> indirim kodu
- custom[3,29]> özel parametre [3,29]
- özel[31,50]> özel parametre [31,50]
- commission_group> komisyon grubu (revenue event'lerinde zorunlu)
- awin_revenue
Awin platformundaki event'leri doğru bir şekilde ölçümlemek için lütfen Adjust SDK'nızdaki revenue event'lerine zorunlu parametreleri ekleyin.
Örnek Emplementasyon (Android SDK ile)
Adjust SDK emplementasyonunuzda bu partner parametrelerini yapılandırırken:
AdjustEvent adjustEvent = new AdjustEvent("abc123");
adjustEvent.addPartnerParameter("cg","AABBCC");
adjustEvent.addPartnerParameter("commission_group","DDEEFF");
Adjust.trackEvent(adjustEvent);
Adjust, bir aktiviteyi Awin Aff ID'ye sahip bir etkileşim ile attribute ettiğinde bu partner parametresi yapılandırmasını Awin'e "cg" olarak gönderir. ( örn. cg=AABBCC )
Awin ID bulunamazsa, "commission_group" olarak bir partner parametresi yapılandırması ararız. Bu yoksa, "cg" yapılandırmasına döneriz ve partner parametresini göndeririz. ( örn. commission_group=DDEEFF; fallback to cg=AABBCC )
Awin partnerine yönlendirilen tüm parametrelerin listesi
Awin, Adjust'ın bu parametreleri (veri noktaları) callback'ler ile birlikte göndermesini gerektirir:
Placeholder | Bilgi |
{adid} | Adjust cihaz ID'si (tüm platformlar) |
{currency} | Adjust SDK'dan gönderilen Orijinal ISO 4217 para birimi kodu |
{event_name} | Event adı, Dashboard'da olduğu gibi |
{os_name} | Cihazın işletim sistemi |
{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 |
{revenue_float} | Revenue, Adjust SDK'dan gönderildiği gibi tam para birimlerinde |
{click_time} | Attribute edilmiş tıklama timestamp'i |