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

Büyüme Çözümü:

Smart Scripts çözümü bir eklenti olarak kullanılabilir. Erişim için Adjust temsilcinizle ya da sales@adjust.com adresinden bizimle iletişime geçebilirsiniz.

Yeni Script Oluşturmak

Campaign Lab'de Smart Scripts seçeneğini seçin.
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.

Açılır menüden istediğiniz uygulamayı seçin.
Bir temel (base) link seçin
Tek bir platform link'i (örneğin Android) seçerseniz, bunu başka bir tek platform link'i (örneğin iOS) ile birleştirebilirsiniz. Bu sayede uygulamanız için her iki platformda da çalışan tek bir smart script'e sahip olabilirsiniz.

Fallback Attribution Mantığı yapılandırması

Daha önce gerçekleşen bir tıklamadan sonra link'iniz ile etkileşime geçen kullanıcıları nasıl attribute etmek istediğinizi seçin. İki seçenekten birini seçebilirsiniz:

Önceki reklama
Smart banner'a

Kullanıcıları bir önceki reklama attribute etmeyi seçerseniz, Adjust fallback_click parametresini link'e ekler. Adjust açısından fallback_click parametresine sahip link'ler, sadece başka bir link yoksa attribution için dikkate alınır. Bu, yalnızca aksi takdirde organik olacak kullanıcıların fallback click link'leri ile attribute edileceği anlamına gelir. Buna dair daha fazla bilgi için fallback attribution'ın nasıl çalıştığına göz atabilirsiniz.

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.

Bunu iki şekilde yapabilirsiniz:

Ön tanımlı partnerler listesinden bir seçim yapabilirsiniz: Bu durumda, trafik durumu önceden yapılandırıldığından link token'ını seçmeniz yeterlidir (örn. IF ttclid exists -> Partner = Tiktok)
Özel bir partner / kanal yapılandırabilirsiniz : Bu durumda, trafik koşulunu belirtmeniz (örn. utm_source contains social) ve karşılık gelen link token'ını eklemeniz gerekir. Bu, özellikle benzersiz tıklama ID'lerinin gelen URL'de mevcut olmadığı durumlarda sahip olunan/kazanılmış medya kanallarını yapılandırmak için kullanışlıdır.

Not: Bir partner için web'den uygulamaya doğru trafikte attribution için smart script'ler kullanıyorsanız, partner dashboard'unda (son URL'de ya da takip şablonu alanlarında) Adjust takip linki'ni yapılandırmanıza gerek yoktur. Kampanyayı, kullanıcıyı doğru parametreler (örneğin UTM’ler) eklenmiş açılış sayfası URL'ine yönlendirecek şekilde ayarlamanız yeterlidir. Bunun nedeni, doğru link token'ına sahip Adjust link'inin artık script tarafından oluşturulması ve açılış sayfasındaki CTA mesajına yerleştirilmesidir. İki yöntemin bir arada kullanılması, tıklamaların tekrarlanmasına ve raporlamada tutarsızlıklara neden olabilir.

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

Script'i eklemesi için web geliştiricinize gönderin.
Bir Adjust link'i (giden link) oluşturmak için Smart Script'in iki fonksiyon sunar: waitForEnrichedLink asenkron bir fonksiyondur ve birPromise döndürür. Mevcutsa Facebook Pixel ID eklenmiş bir Adjust link'i oluşturur.createLink bir Adjust link'ini hemen oluşturur, ancak çoğu durumda Facebook Pixel ID'yi okuyamaz.

Facebook Pixel ID sizin için önemliyse, waitForEnrichedLink kullanmanızı öneririz.

Adjust link'inin hemen oluşturulmasını istiyorsanız createLink fonksiyonunu ya da her iki fonksiyonu birlikte kullanabilirsiniz. Örneğin, önce "Uygulamayı indir/CTA" düğmesini createLink'in oluşturduğu link ile görüntüleyin ve waitForEnrichedLink çözümlendiğinde zengin link ile değiştirin.

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

Google Etiket Yöneticisi'ne gidin.
Etiketler -> Yeni seçeneğini seçin.
Etiket Yapılandırması'nı seçin, ardından Özel HTML seçeneğini seçin ve bir <script> ekleyin. Suite'ten kopyaladığınız kodu script tag'ine ekleyin ve script'i /script ile kapatmayı unutmayın.

    <script>
      // Paste Smart Script configuration you’ve copied from the Suite
      // The code contains the smart script, mapping and call for link creation
    </script>

Bu script, giden URL / Adjust link'ini döndürür ve bu link'i indirme düğmenizin arkasına ekleyebilirsiniz. Gerekirse geliştirici ekibinizle iletişime geçebilir ve oluşturulan Adjust link'ini "Uygulamayı indir" düğmesine/CTA mesajına nasıl bağlayabileceğinizi öğrenebilirsiniz.

Aşağıdaki örnek, sayfada download_button ID'sine sahip bir "İndir" düğmesi olduğunu varsayar ve bu düğme tıklandığında link'i açmak için bir eylem ekler. waitForEnrichedLink fonksiyonu Facebook Pixel ID'ye sahip Adjust link'ini oluşturduğunda, düğme handler'ı zengin link'i açmak üzere güncellenir. Facebook Pixel ID kullanım senaryonuz için önemli değilse, waitForEnrichedLink call'unu ve ilgili tüm kodu </script> tag'ine kadar kaldırabilirsiniz.

Örnekteki entegrasyon kodu

// Link creation
var link = AdjustSmartScript.createLink(mapping);

var downloadButton = document.getElementById('download_button');
var openLinkFn = function () { window.open(link) };

// İndir düğmesi tıklandığında link açılır
downloadButton.addEventListener('click', openLinkFn);
  
// Asenkron link oluşturulur
// Facebook Pixel ID'nin çözümlenmesini bekler. Facebook Pixel ID sizin için önemli değilse
//bunu kaldırabilirsiniz.
AdjustSmartScript.waitForEnrichedLink(mapping)
  .then(function (enrichedLink) {
    // Zengin link oluşturuldu
    // İndir düğmesi tıklandığında zengin link açılır
    downloadButton.addEventListener('click', function () { window.open(enrichedLink) });

    downloadButton.removeEventListener('click', openLinkFn);
  })
  .catch(function (error) {
    // Bir hata meydana geldi ve link oluşturulamadı
    console.log(error);
  });

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.
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.

Tarayıcınızdaki Geliştirici Araçları konsoluna gidin.
Smart script'i uyguladığınız web sayfasına gidin.
[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]: No networks configured
[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

Smart Scripts Test Aracı

SmartScript Test Araçları, SmartScript'in gelen bir açılış sayfası URL'ini nasıl işlemesi gerektiğini ve giden URL'i (Adjust link'i) nasıl oluşturduğunu simüle eden bir SmartScript test ortamıdır. Bu rehberi takip ettikten sonra SmartScript Test Araçlarını kullanarak partner mantığının, parametre işlemesinin ve link token mantığının bir web sitesine yerleştirilmeden önce veya yerleştirildiği zaman beklendiği gibi davrandığını doğrulamak için kullanabilirsiniz.

Smart script test aracı nedir?

SmartScript Test Araçları, belirli bir açılış sayfası URL'i için SmartScript'in çalışmasını simüle eder ve SmartScript yapılandırması tarafından oluşturulan giden URL'i (Adjust link'i) gösterir.

SmartScript Test Araçları iki seçeneği destekler:

Manuel olarak özel bir test URL'i girin
Ön tanımlı örnek URL'lerden birini seçin (örneğin Meta, Google ve TikTok gibi yaygın kaynakların UTM'lerini ve tıklama ID'lerini içeren URL'ler)

SmartScript Test Araçları, SmartScript yapılandırma davranışının doğrulanmasına yardımcı olur ve bunlara aşağıdakiler de dahildir:

Partner mantığı (örneğin SmartScript yapılandırmasına göre partner seçimi)
Parametre işlemesi (örneğin, hangi parametrelerin giden Adjust link'ine taşındığı)
Trafik koşulları davranışı (örneğin, bir koşulun gelen URL için geçerli olup olmadığı)
Giden Adjust link'inde kullanılan link token mantığı

Yaygın kullanım senaryoları:

Partner parametrelerinin ve gelen kampanya parametrelerinin giden Adjust link'ine taşınıp taşınmadığını doğrulamak
SmartScript yapılandırmasının tıklama ID'lerini ve kaynağa özgü parametreleri beklendiği gibi işleyip işlemediğini doğrulamak
Oluşturulan Adjust link'ini bir web sitesi canlıya geçmeden önce beklenen kampanya mantığıyla karşılaştırmak
Bir sorunun büyük olasılıkla yapılandırmadan mı yoksa web sitesine eklenme şeklinden mi kaynaklandığını belirlemek

Nasıl çalışır?

SmartScript Test Araçları, SmartScript'in bir açılış sayfası URL'ini nasıl işlediğini simüle eder.

Bir açılış sayfası URL'i (özelleştirilmiş bir URL ya da önceden doldurulmuş bir örnek URL) girersiniz.
SmartScript Test Araçları, SmartScript yapılandırmasını kullanarak SmartScript çalıştığında sonucu görmek için simülasyonunu yapar.
SmartScript Test Araçları, SmartScript yapılandırmasına dayalı olarak bir giden URL (Adjust link'i) oluşturur ve aşağıdakileri içerir:
- Partner mantığı
- Parametre işlenmesi
- Trafik koşulları
- Link token mantığı
Adjust link'inin beklenen yapılandırma davranışıyla eşleştiğini doğrulamak için bu link'i gözden geçirin.