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
- Dapatkan file dari pemasar yang menyertakan skrip, kode inisialisasi, dan argumen.
- Test the script on the Smart Script test page. Ensure the correct outgoing URL is generated.
- Ikuti tes dan gunakan instruksi hasil Smart Script.
Lihat contoh integrasi di Github
Konfigurasikan skrip secara manual:
- Unduh skrip .
- Dapatkan argumen untuk memanggil skrip yang memetakan parameter masuk ke parameter keluar dari pemasar.
- Inisialisasi argumen Smart Script dan objek konfigurasi.
- 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
})
Periksa dan gunakan hasil Smart Script
- 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 kembalinull
, 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:
- Confirm that the marketer followed their instructions and placed the Smart Script code into GTM.
- 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 kembalinull
, 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();
}
- 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 :
- 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. - 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");
- 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 :
- Ikuti petunjuk untuk menjalankan Smart Script dan menghasilkan URL klik.
- Pastikan hasilnya valid (dan bukan null).
- Jalankan fungsi tayangan berikut:
window.AF_SMART_SCRIPT.fireImpressionsLink();
Argumen
Argumen | Catatan | Contoh | |
---|---|---|---|
oneLinkURL [wajib] |
|
|
|
afParameters (wajib)
|
mediaSource (wajib) |
Objek konfigurasi untuk sumber media |
|
campaign |
Objek konfigurasi untuk kampanye |
|
|
channel |
Objek konfigurasi untuk saluran |
|
|
ad |
Objek konfigurasi untuk iklan |
|
|
adSet |
Objek konfigurasi untuk adset |
|
|
deepLinkValue |
Objek konfigurasi untuk |
|
|
afSub1-5 |
Objek konfigurasi untuk |
||
googleClickIdKey |
Tentukan metode apa yang dipanggil untuk parameter yang membawa GCLID. |
||
Parameter kueri (khusus) lainnya |
|
|
|
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 |
|
|
overrideValues |
|
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 |
|
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.
Diperbarui 3 bulan yang lalu