Smart Script'lerin yapılandırması

Kullanıcıların mobil web sitenizdeki bir düğme veya banner ile uygulamanızı install ettiği web kampanyaları yürütüyorsanız, install ile sonuçlanan kaynağa dair bilgileri kaybedebilirsiniz. Mobil web sitenizde çalışan Smart Script'ler ile attribution'a dair tüm bilgileri alabilirsiniz.

Başlamadan önce

Başlamadan önce bilmeniz gerekenler:

Gereklilikler

• Admin ve Editör izinleri
• (Opsiyonel) Android ve iOS Adjust SDK’daki deeplink’leri yapılandırın

Kullanılabilirlik

Yeni Script Oluşturmak

1. Campaign Lab'de Smart Scripts seçeneğini seçin.
2. Yeni Smart Script seçeneğini seçin.

Bir temel (base) link seçin

Baz link, gelen herhangi bir trafik kaynağı olmadığında (örneğin, kullanıcı bir kampanyadan değil de doğrudan web açılış sayfasına organik olarak ulaştıysa), tüm attribution'ın verileceği yedek bir fallback link token olarak işlev görür.

1. Açılır menüden istediğiniz uygulamayı seçin.
2. Bir baz link seçin.

Parametre eşleştirmesi

Gelen URL'den alınan parametreleri, giden URL'e (yani Adjust Link’ine) eşleştirin. Örneğin, utm_campaign mevcutsa, bunun değeri Adjust kampanya parametresine eşleştirilir. Mevcut değilse, tanımladığınız varsayılan fallback değeri kullanılır..

Partner eşleştirmesi

Bir trafik kaynağıysa, attribution verilmesi gereken partnerleri ve karşılık gelen link token'larını eşleştirin. Örneğin, trafik kaynağı Facebook (Meta) web kampanyaları ise (gelen URL’de fbclid veya fbpid olup olmadığına göre belirlenir), karşılık gelen ağ link token'ı attribution alır.

Script'i devreye almak

1. Script'i kopyalayın

Script oluşturulduğunda, "Script görünümü" sayfasına yönlendirilirsiniz ve burada Script'i kopyala seçeneğini seçebilirsiniz.

2. Script'i devreye alın

1. Script'i web sitenize entegre edin

1. Script'i eklemesi için web geliştiricinize gönderin.
2. 2. Smart Scripts'in oluşturduğu Adjust link'i (giden URL) ile ne yapmaları gerektiğini geliştiricinize bildirin. Örneğin, bu script'i "Uygulamayı indir" düğmesinin/CTA'nın arkasına yerleştirebilir ya da masaüstü web sitenizde bir QR kodu sunabilirsiniz.

2. Script'i Google Etiket Yöneticisi ile devreye alın

1. Google Etiket Yöneticisi'ne gidin.
2. Etiketler -> Yeni seçeneğini seçin. Bunun nasıl ekleneceği geliştiricilerinizin seçimine kalmıştır, ancak iki etiket oluşturmanızı öneririz:

"Smart Script'in yüklenmesi" için birinci etiket

    <script>
    // adjust-smart-script.min.js'in içeriğini buraya kopyalayın
    </script>

"Link oluştur ve indirmeye ekle" düğmesi için ikici etiket

    <script>
    // Eşleştirmeyi yapılandırın ve AdjustSmartScript.createLink'i çağırın
    </script>

1. Etiket Yapılandırması'nı seçin, ardından Özel HTML'yi seçin ve bir <script> ekleyin.
2. Etiket tetikleme/Başlatma seçeneklerini sadece belirli web'den uygulamaya açılış sayfalarında (web sitenizin her sayfasında değil) tetiklenecek şekilde yapılandırmanız gerekebilir.
3. Önce "Smart Script'i yükle" etiketini tetikleyin (her sayfada bir kere tetiklenir).
4. Ardından "Link oluştur ve indime düğmesine ekle" etiketini çalıştırın. Script, giden URL / Adjust link'ini döndürür ve bu link'i indirme düğmenizin arkasına ekleyebilirsiniz.
5. Bu aşama tamamlandıktan sonra, kullanıcı web açılış sayfasındaki "İndir" düğmesine tıkladığında Adjust link'i kullanıcıyı yönlendirir ve tüm uygulama dönüşümlerini web trafiğinin orijinal kaynağına attribute eder.

[Opsiyonel] Script'i güncellemek

Smart script’inizi web sitenize yerleştirdikten sonra düzenlemeyi seçerseniz, değişikliklerin geçerli olması için geliştiricinizin script’inizi manuel olarak yeniden eklemesi/güncellemesi gerekir. Bu otomatik olarak gerçekleşmez.

Smart script'leri test etmek

Smart script'ler, log'larını tarayıcının konsolunda görüntüler. Script'in belirtilen eşleştirme ile nasıl çalıştığını test etmenizi ve doğru link'lerin oluşturulduğundan emin olmanızı öneririz.

1. Tarayıcınızdaki Geliştirici Araçları konsoluna gidin.
2. Smart script'i uyguladığınız web sayfasına gidin.
3. [adjust-smart-script] prefix'ine sahip bir log yoksa, sayfayı yenileyin. Hala hiçbir log göremiyorsanız, aşağıdakileri kontrol edin:
   • Kodunuzun AdjustSmartScript.setLogLevel('error') ya da AdjustSmartScript.setLogLevel('none') çağırarak logging'e engel olmadığını kontrol edin.
   • Kodunuzun AdjustSmartScript.createLink(params) fonksiyonunu çağırdığından emin olun.

InputUrl property’sinin farklı değerleri ile farklı kullanım senaryolarını test edebilirsiniz. Örneğin, bir Meta kampanyası yürütüyorsanız ve organik kullanıcıların da açılış sayfanızı ziyaret etmesini bekliyorsanız, kampanya ve Meta parametrelerini içeren bir URL ve herhangi bir ek parametre içermeyen başka bir URL kullanabilirsiniz.

Örnek log'lar:

[adjust-smart-script]: Use defaultLinkToken to create adjust link
[adjust-smart-script]: Found value for campaign is new_campaign
[adjust-smart-script]: Found value for adgroup is some_adset
[adjust-smart-script]: Found value for creative is logo_image
[adjust-smart-script]: Transformed value for ref_code is id+my_product
[adjust-smart-script]: Misconfigured deep link: no valid androidAppSchema provided```