OneLink Smart Script V2

Sekilas : Sesuaikan OneLinks yang dibuat dan disematkan secara otomatis di balik tombol atau spanduk di situs web merek Anda.

Tentang OneLink Smart Script

OneLink Smart Script menggunakan URL masuk yang mengarah ke halaman web untuk secara otomatis menghasilkan URL OneLink keluar unik yang mengarah ke app store.

URL keluar dihasilkan menggunakan argumen yang Anda terima dari pemasar dan dimasukkan ke dalam skrip. Catatan: afParameters argumen memiliki struktur yang terdiri dari beberapa argumen (parameter) lain, masing-masing berisi objek konfigurasi yang memiliki kode, nilai penimpaan, dan nilai default.

Langkah-langkah implementasi

Untuk menyiapkan Smart Script, Anda dapat:

Embed the script in your website

Inisialisasi dan kode panggilan Smart Script dapat berasal dari generator Smart Script di dasbor AppsFlyer ( disarankan ), atau diimpor dan dipanggil secara manual oleh pengembang.

Gunakan kode yang dihasilkan oleh generator Smart Script

  1. Dapatkan file dari pemasar yang menyertakan skrip, kode inisialisasi, dan argumen.
  2. Test the script on the Smart Script test page. Ensure the correct outgoing URL is generated.
  3. Ikuti tes dan gunakan instruksi hasil Smart Script.

Lihat contoh integrasi di Github

Konfigurasikan skrip secara manual:

  1. Unduh skrip .
  2. Dapatkan argumen untuk memanggil skrip yang memetakan parameter masuk ke parameter keluar dari pemasar.
  3. Inisialisasi argumen Smart Script dan objek konfigurasi.
  4. buat URL dengan memanggil skrip di web/halaman arahan HTML menggunakan metode berikut:
var result = window.AF_SMART_SCRIPT.generateOneLinkURL({
  oneLinkURL,
  afParameters,
  referrerSkipList, // optional
  urlSkipList // optional
})
  1. Ikuti tes dan gunakan instruksi hasil Smart Script.

Periksa dan gunakan hasil Smart Script

  1. Periksa nilai pengembalian di result. Nilai pengembalian yang mungkin adalah:
    • An outgoing Onelink URL. Use the result value as needed. For example, to place it as a link under a CTA on your website.
    • null. Jika skrip kembali null, terapkan alur kesalahan yang Anda inginkan. Misalnya: URL yang ada di web/laman arahan tidak diubah.
      var result_url = "No output from script"
      if (result) {
            result_url = result.clickURL;            
            // Put the generated OneLink URL behind CTA buttons
            document.getElementById('andrd_link').setAttribute('href', result_url);
            document.getElementById('ios_link').setAttribute('href', result_url);
            // Optionally - Create QR code from the generated OneLink URL
            window.AF_SMART_SCRIPT.displayQrCode("my_qr_code_div_id");
            //The size of the QR code is defined in the CSS file under #my_qr_code_div_id
            // #my_qr_code_div_id canvas { 
            //  height: 200px;
            //  width: 200px;
            //}
            // Optionally - fire an impression.
            // The impression will fire to https://impressions.onelink.me//.... 
            window.AF_SMART_SCRIPT.fireImpressionsLink();
      }

Use Google Tag Manager

Untuk menyiapkan Smart Script di Pengelola Google Tag:

  1. Confirm that the marketer followed their instructions and placed the Smart Script code into GTM.
  2. Periksa nilai pengembalian di AF_SMART_SCRIPT_RESULT. Nilai pengembalian yang mungkin adalah:
    • URL Onelink keluar. Gunakan nilai hasil sesuai kebutuhan. Misalnya, untuk menempatkannya sebagai tautan di bawah CTA di situs web Anda.
    • null. Jika skrip kembali null, terapkan alur kesalahan yang Anda inginkan. Misalnya: URL yang ada di web/laman arahan tidak diubah.
      var result_url = AF_SMART_SCRIPT_RESULT.clickURL;
      if (result_url) {
            document.getElementById('andrd_link').setAttribute('href', result_url);
            document.getElementById('ios_link').setAttribute('href', result_url);
            // Optionally - Create QR code from the generated OneLink URL
            window.AF_SMART_SCRIPT.displayQrCode("my_qr_code_div_id");
            //The size of the QR code is defined in the CSS file under #my_qr_code_div_id
            // #my_qr_code_div_id canvas { 
            //  height: 200px;
            //  width: 200px;
            //}
            // Optionally - fire an impression.
            // The impression will fire to https://impressions.onelink.me//.... 
            window.AF_SMART_SCRIPT.fireImpressionsLink();            
      }
  1. Test the script on the Smart Script test page. Ensure the correct outgoing URL is generated.

Create a QR code with the Smart Script result

Prasyarat: Smart Script V2.1+

Untuk membuat kode QR :

  1. Buat tag div dengan ID tertentu di halaman HTML situs Anda untuk meng-hosting kode QR.
    Anda dapat membuat model tag div sesuai keinginan Anda.
  2. Setelah Anda menjalankan Smart Script dan membuat URL OneLink, panggil fungsi berikut dan berikan ID div:
window.AF_SMART_SCRIPT.displayQrCode("my_qr_code_div_id");
  1. Praktik terbaik: Setelah Anda mendapatkan hasilnya, tampilkan kode QR saat pengguna menggunakan desktop dan tampilkan tombol dengan tautan saat pengguna menggunakan ponsel.

Fire an impression

You can fire an impression when a page loads, a CTA or banner displays, etc. Note: Impressions can only be fired on mobile devices; not on desktop.

Prasyarat: Smart Script V2.1+

Untuk mengaktifkan tayangan :

  1. Ikuti petunjuk untuk menjalankan Smart Script dan menghasilkan URL klik.
  2. Pastikan hasilnya valid (dan bukan null).
  3. Jalankan fungsi tayangan berikut:
window.AF_SMART_SCRIPT.fireImpressionsLink();

Argumen

Argumen Catatan Contoh
oneLinkURL [wajib]
  • Berikan domain template OneLink + ID template. Catatan: Bukan URL tautan khusus OneLink!
  • yourbrand.onelink.me/A1b2
  • Contoh domain bermerek: click.yourbrand.com/A1b2

afParameters

(wajib)

 

 

 


mediaSource

(wajib)

Objek konfigurasi untuk sumber media

  • Kode: ['incoming_mediasource'' 'utm_source']
  • Nilai penimpaan: {twitter: 'twitter_int', orig_src: 'new_src'}
  • Nilai default: ['any_source']

campaign

Objek konfigurasi untuk kampanye

  • Kode: ['incoming_campaign', 'utm_campaign']
  • Nilai penimpaan: {campaign_name: 'new_campaign_name'}
  • Nilai default: ['any_campaign_name']

channel

Objek konfigurasi untuk saluran

  • Kode: ['saluran_masuk', 'saluran_utm']
  • Nilai penimpaan: {video: 'new_video'}
  • Nilai default: ['any_video']

ad

Objek konfigurasi untuk iklan

  • Kode: ['incoming_ad', 'utm_ad']
  • Nilai penimpaan: {ad_name: 'new_ad_name'}
  • Nilai default: ['any_ad_name']
adSet

Objek konfigurasi untuk adset

  • Kode: ['incoming_adset', 'utm_adset']
  • Nilai penimpaan: {'adset_name': 'new_adset_name'}
  • Nilai default: ['any_adset_name']
deepLinkValue

Objek konfigurasi untuk deep_link_value

  • Kode: ['product_id', 'page_name']
  • Nilai override: {twenty_percent_off: 'thirty_percent_off'}
  • Nilai default: 'new_offers_page'
afSub1-5

Objek konfigurasi untuk af_sub[1-5]

 
googleClickIdKey

Tentukan metode apa yang dipanggil untuk parameter yang membawa GCLID.
Catatan! Untuk ditampilkan dalam laporan data lengkap AppsFlyer, parameternya harus salah satu dari af_sub[1-5].

 
Parameter kueri (khusus) lainnya
  • Daftar parameter lain yang ingin Anda sertakan dalam URL OneLink keluar untuk atribusi atau deep linking, bersama dengan objek konfigurasinya.
  • Nama parameter khusus dicantumkan oleh pengembang sebagai paramKey di objek konfigurasi.
  • paramKey: 'deep_link_sub1'
  • Kode: ['page_id']
  • Nilai override: {page12: 'new_page12'}
  • Nilai default: 'halaman1'
 
referrerSkipList
Daftar string dalam pengarah HTTP untuk klik tertentu (misalnya Twitter atau Facebook) yang jika ditemukan, menyebabkan Smart Script mengembalikan null. Ini dapat berguna untuk SRN seperti Twitter dan Facebook, yang kliknya sudah dilaporkan.  
urlSkipList Daftar string dalam URL untuk klik tertentu (misalnya af_r) yang jika ditemukan, menyebabkan Smart Script mengembalikan null. Ini dapat berguna jika Anda menggunakan tautan atribusi AppsFlyer dengan af_r untuk mengarahkan pengguna ke situs web seluler, dan tidak ingin data dari klik aslinya hilang.  

Objek konfigurasi

OneLink Smart Script menggunakan argumen untuk menghasilkan URL keluar berdasarkan parameter URL masuk dan argumen yang ditentukan dalam skrip. Argumen afParameters memiliki struktur yang terdiri dari beberapa argumen (parameter) lain yang digunakan untuk atribusi dan deep linking, yang masing-masing berisi objek konfigurasi yang memiliki kode, nilai penimpaan (override), dan nilai default, seperti yang dijelaskan dalam tabel berikut.

Argumen Deskripsi Contoh
keys
  • Daftar string
  • Daftar kemungkinan parameter di URL masuk yang dicari skrip, yang nilainya ditempatkan sebagai nilai di URL keluar.
  • Script mencari dari kiri ke kanan dan berhenti pada kecocokan yang pertama.
  • Contoh: ['in_channel', 'utm_channel']
  • Untuk parameter saluran dalam skrip, skrip mencari tautan masuk untuk in_channel dan menggunakan nilai sebagai nilai untuk saluran.

overrideValues

  • Dictionary {string: string}
  • Untuk nilai yang ingin Anda ubah di tautan keluar, buat daftar nilai di URL masuk, selain apa yang Anda inginkan untuk menggantinya.
  • Skrip menggantikan nilai parameter dari URL yang masuk dengan nilai yang Anda tentukan. 

Contoh: {'video': 'video_new'}

Untuk parameter saluran dalam skrip, setiap kali nilai yang masuk adalah video, skrip mengubahnya menjadi video_new pada tautan keluar.

defaultValue
  • String
  • Nyatakan nilai "fallback" yang Anda inginkan.
  • Jika parameter tidak ditemukan dari daftar kode Anda, nilai defaultValue digunakan di URL keluar.
  • Anda dapat memaksa nilai default dengan memberikan daftar kode kosong.

Contoh: ['web_video']

Untuk parameter saluran dalam skrip, jika parameter in_channel tidak ditemukan, web_video digunakan sebagai nilai saluran.

Contoh

Basic attribution

Lihat contoh konversi dasar URL masuk ke URL OneLink keluar, dengan satu kode untuk media_source dan kampanye

Multiple keys

Lihat contoh konversi URL masuk ke URL OneLink keluar, dengan beberapa kode untuk media_source dan kampanye.

UTM parameters

Lihat contoh konversi URL masuk ke URL OneLink keluar, dengan parameter UTM untuk media_source dan kampanye.

Override values

Lihat contoh konversi URL masuk ke URL OneLink keluar, menggantikan nilai media_source masuk.

Default values

Lihat contoh konversi URL masuk ke URL OneLink keluar, menggunakan nilai default saat nilai media_source masuk tidak ditemukan.

Forced default values

Lihat contoh konversi URL masuk ke URL OneLink keluar, menggunakan nilai default bahkan ketika nilai media_source masuk ditemukan.

Google click ID passthrough to af_sub

Lihat contoh dari konversi URL masuk ke URL OneLink keluar yang meneruskan ID klik Google ke af_sub4. Catatan : Saat GCLID ditemukan, skrip mencari kata kunci parameter masuk, dan menempatkan nilai kata kunci di URL keluar sebagai nilai af_keywords.

Facebook click ID passthrough to af_sub

Lihat contoh dari konversi URL masuk ke URL OneLink keluar yang meneruskan ID klik Facebook ke af_sub2.

Set attribution and OneLink parameters

Lihat contoh dari konversi URL masuk ke URL OneLink keluar dengan atribusi AppsFlyer dan parameter OneLink.

Set additional custom parameters

Lihat contoh konversi URL masuk ke URL OneLink keluar dengan parameter khusus tambahan (termasuk parameter af_prt untuk agensi).

Referrer skip list

Lihat contoh cara menonaktifkan Smart Script untuk klik tertentu (misalnya, dari Twitter atau Facebook) dengan membuat daftar lewati. Jika salah satu string dalam daftar lewati muncul di pengarah HTTP klik, Smart Script menampilkan null.

URL skip list

Lihat contoh dari bagaimana Anda dapat menonaktifkan Smart Script untuk string tertentu di URL (contoh, af_r) dengan membuat daftar lewati. Jika salah satu string dalam daftar lewati muncul di URL klik, Smart Script kembali null.

Smart Script set up with Google Tag Manager

Lihat contoh konversi URL masuk ke URL OneLink keluar menggunakan OneLink Smart Script yang disiapkan menggunakan Google Tag Manager.

QR code

Lihat contoh cara Smart Script menghasilkan kode QR.

Impression

Lihat contoh tayangan.