Sekilas: Pelajari tentang struktur dan parameter tautan atribusi AppsFlyer.
Overview
Tautan atribusi memungkinkan pengiklan mengumpulkan data tentang interaksi pengguna dengan iklan. Tautan atribusi ditempatkan di belakang iklan dan memberi tahu AppsFlyer saat pengguna berinteraksi dengan iklan. Interaksi dapat terjadi melalui klik pada iklan atau saat pengguna melihat tayangan iklan Salinan URL atribusi dikirim ke AppsFlyer.
Tautan atribusi dibuat menggunakan OneLink atau tautan platform tunggal.
OneLink
OneLink adalah tautan tunggal yang dapat digunakan di seluruh perangkat, sistem operasi, saluran, atau platform.
Pilih OneLink jika:
- Anda menginginkan satu tautan untuk semua platform.
- Kemampuan deep linking diperlukan.
- Anda ingin menggunakan Tautan Aplikasi Android atau Tautan Universal iOS untuk membuka aplikasi.
Tautan platform tunggal
Tautan platform tunggal adalah tautan yang berfungsi dengan platform tertentu. Misalnya, satu tautan platform yang dibuat untuk iOS tidak berfungsi dengan Android.
Pilih tautan platform tunggal jika:
- Anda hanya menggunakan satu platform. Misalnya, Android dan bukan iOS.
- Anda hanya menggunakan skema URI untuk membuka aplikasi.
Untuk parameter tautan OneLink dan platform tunggal dengan data tambahan terkait interaksi disertakan dalam tautan. Parameter yang tersedia tercantum dalam tabel berikut.
Pertimbangan
Tautan platform tunggal harus berisi informasi minimum yang diperlukan untuk merekam klik:
- Titik akhir AppsFlyer: app.appslfyer.com
- app_id: Pengenal unik di platform AppsFlyer. Ini biasanya mengikuti format ID di Apple App Store atau Google Play.
- media_source: pengenal, yang dialokasikan oleh AppsFlyer, ke sumber media yang menempatkan iklan
- Misalnya:
https://app.appsflyer.com/{app_id}?pid={media_source}
Parameter link atribusi
- Parameter yang tercantum tersedia untuk digunakan di tautan atribusi.
- Kolom nilai jenis bidang adalah batas karakter dari nilai parameter. Temukan lebih lanjut tentang batasan panjang nilai parameter di sini.
Tabel berikut dapat diunduh sebagai file .csv
.
Parameter | Tampilkan nama dalam data lengkap | Deskripsi |
Jenis dan panjang bidang |
---|---|---|---|
pid | Media Source | Mengidentifikasi secara unik mitra terintegrasi AppsFlyer. Jangan mengubahnya. Rincian selengkapnya . |
String 50 |
c | Kampanye | Disediakan oleh pemasang iklan/penayangt. Nama kampanye yang panjangnya melebihi 100 karakter ditampilkan di dasbor sebagai "c_name_exceeded_max_length" |
String 100 |
af_prt |
Partner |
|
String 50 |
af_mp |
N/A |
|
|
clickid |
N/A |
Pengidentifikasi klik unik jaringan iklan |
|
af_siteid |
ID situs |
|
String 24 |
af_sub_siteid |
ID Sub Situs |
|
String 50 |
af_c_id |
ID kampanye |
Disediakan oleh pemasang iklan/penayang |
String 24 |
af_adset |
adset |
|
String 100 |
af_adset_id |
ID adset |
Disediakan oleh pemasang iklan/penayang |
String 24 |
af_ad |
ad |
Nama Iklan (lihat selengkapnya) disediakan oleh pengiklan/penayang |
String 100 |
af_ad_id |
ID iklan | Disediakan oleh pemasang iklan/penayang |
String 24 |
af_ad_type |
Jenis iklan |
Gunakan konvensi penamaan berikut:
|
String 24 |
af_click_lookback |
Atribusi jendelalookback |
Catatan : Hanya memengaruhi URL klik dan bukan URL tayangan. |
Maks. 3 karakter |
af_viewthrough_ |
N/A |
Catatan : Hanya memengaruhi URL tayangan dan bukan URL klik |
Maks. 3 karakter |
af_channel |
Channel |
Channel sumber media tempat iklan didistribusikan, misalnya, UAC_Search, UAC_Display, Instagram, Facebook Audience Network, dll. |
Dynamic Enum. String 20 |
af_keywords |
Keywords |
Daftar kata kunci untuk kampanye bertarget teks |
String 100 |
af_cost_model |
Model Biaya |
|
String 20 |
af_cost_currency |
Mata Uang Biaya |
|
jumlah. 3 karakter |
af_cost_value |
Nilai Biaya |
|
String 20 |
af_sub[n] (n=1-5) contoh: af_sub1 |
Sub param [n] |
Parameter personalisasi opsional yang ditentukan oleh pemasang iklan. Untuk informasi lebih lanjut tentang penggunaan parameter ini, lihat bagian FAQ (Pertanyaan Umum). |
String 100 |
af_r | N/A |
Digunakan dalam tautan platform tunggal untuk mengarahkan pengguna ke URL tertentu untuk kedua platform (Android dan iOS). Catatan:
|
|
af_web_dp | N/A |
URL untuk mengarahkan pengguna desktop (misalnya, Windows atau Mac) ke laman web yang berbeda dari yang dikonfigurasi di template OneLink. Gunakan cara ini untuk menyimpan data atribusi dari pengguna desktop di platform lain (mis. Google Analytics atau Omniture) Catatan : Jika Anda memiliki daftar Pengalihan yang diizinkan aktif, pastikan domain URL ini ada dalam daftar. |
|
af_dp | N/A | Nilai fallback skema URI untuk meluncurkan aplikasi, akan digunakan jika metode Tautan Universal atau Tautan Aplikasi Android gagal, dan untuk pengguna Android versi sebelum 6.0. Seharusnya ini hanya mengarah pada base path, yaitu aktivitas default. | |
af_force_deeplink | N/A | Force deep linking ke aktivitas yang ditentukan dalam nilai af_dp | |
af_ref | N/A |
Jaringan iklan yang bekerja dengan klik S2S dapat mengirim nilai perujuk unik menggunakan parameter berikut: &af_ref= ReferrerValue
Nilai af_ref harus terdiri dari nilai unik, terstruktur sebagai berikut:
NetworkName_UniqueClickValueForEachClick
Contoh: af_ref=networkname_123456789ABCDEF
Nama jaringan dapat berupa string apa pun yang valid. Nama ini dapat berupa networkname_int atau hanya nama jaringan.
AppsFlyer dapat menggunakan parameter ini untuk atribusi di perangkat Android. AppsFlyer tidak menggunakan parameter ini untuk atribusi di perangkat iOS atau Windows.
|
|
is_incentivized | N/A |
Boolean: true/false
Kampanye dengan insentif atau non-insentif
|
|
af_param_ forwarding |
N/A |
|
|
af_os | Versi iOS | [Khusus iOS] Versi sistem operasi (operating system/OS) perangkat | |
af_model | Jenis model iOS |
[Khusus iOS] Model perangkat. Nilai yang diizinkan:
|
|
af_media_type | Jenis media: |
Penempatan iklan yang membawa tautan sebagai berikut:
|
|
deep_link_sub1-10 | N/A |
Nilai deep link tambahan. Pengembang menerapkan perilaku nilai yang diinginkandalam kode. |
|
deep_link_value | N/A |
Nama untuk konten dalam aplikasi tertentu tempat pengguna akan diarahkan. Pengembang menerapkan perilaku yang diinginkan dari deep_link_value dalam kode. |
|
af_og_title | N/A |
Judul untuk pratinjau tautan saat diposting ke media sosial |
|
af_og_description | N/A |
Deskripsi untuk pratinjau tautan saat diposting ke media sosial |
|
af_og_image | N/A |
Gambar untuk pratinjau tautan saat diposting ke media sosial |
Parameter | Tampilkan nama dalam data lengkap | Deskripsi |
Jenis dan lebar bidang |
---|---|---|---|
is_retargeting |
Merupakan Penargetan ulang (kampanye) | URL klik dari semua kampanye penargetan ulang harus menyertakan &is_retargeting=true .Jika parameter tidak disertakan atau nilainya "false", kampanye dianggap sebagai kampanye akuisisi pengguna biasa. |
Enum 5 karakter |
af_reengagement_window |
Periode Waktu Re-engagement |
Ubah jendela atribusi interaksi ulang dengan menambahkan parameter ini ke tautan atribusi. Opsi rentang jendela yang mungkin adalah:
Nilai default: 30 hari Contoh: |
N/A |
Parameter jenis iklan
Bergantung pada jenis iklan, Anda juga dapat mengirim parameter visibilitas yang relevan yang merinci spesifikasi interaksi. Di bawah ini adalah daftar kemungkinan nilai untuk “af_ad_type” beserta perkiraan parameter visibilitas.
Parameter | Format nilai | Deskripsi |
---|---|---|
af_video_total_length | detik | Total kemungkinan durasi video |
af_video_played_length | detik | Berapa banyak video yang dilihat |
af_playable_played_length | detik | Berapa lama elemen yang dapat diputar dimainkan setelah terisi penuh |
af_ad_time_viewed | detik | Berapa lama unit iklan terlihat di layar |
af_ad_displayed_percent | % | Persentase maksimum unit iklan yang terlihat di layar perangkat |
af_audio_total_length | detik | Total kemungkinan durasi audio |
af_audio_played_length | detik | Berapa banyak audio yang didengar |
Parameter khusus Android
Parameter | Tampilkan nama dalam data lengkap | Deskripsi |
Jenis kolom |
---|---|---|---|
advertising_id |
ID Iklan |
ID Iklan Google - Memerlukan dukungan jaringan iklan |
Maksimal 40 karakter |
sha1_advertising_id |
N/A |
ID Iklan Google di-hash dengan SHA1 - Memerlukan dukungan jaringan iklan |
|
md5_advertising_id |
N/A |
ID Iklan Google di-hash dengan MD5 - Memerlukan dukungan jaringan iklan |
Hanya didukung dengan penginstalan dan atribusi ulang |
android_id |
ID Android |
Perangkat Android_id - Memerlukan dukungan jaringan iklan |
Maksimal 20 karakter |
sha1_android_id |
N/A |
Perangkat Android_id di-hash dengan SHA1 - Memerlukan dukungan jaringan iklan |
|
md5_android_id |
N/A |
Perangkat Android_id di-hash dengan MD5 - Memerlukan dukungan jaringan iklan |
Hanya didukung dengan penginstalan dan atribusi ulang |
imei |
IMEI |
ID IMEI perangkat |
|
sha1_imei |
N/A |
ID IMEI perangkat di-hash dengan SHA1 - Memerlukan dukungan jaringan iklan |
|
md5_imei |
N/A |
ID IMEI perangkat di-hash dengan MD5 - Memerlukan dukungan jaringan iklan |
|
oaid |
OAID |
Buka Pengidentifikasi Perangkat Anonim |
Tersedia di Android SDK versi 4.10.3 |
sha1_oaid |
N/A |
Buka Pengidentifikasi Perangkat Anonim yang di-hash dengan SHA1 - Memerlukan dukungan jaringan iklan |
Tersedia di Android SDK versi 4.10.3 |
md5_oaid |
N/A | Buka Pengidentifikasi Perangkat Anonim yang di-hash dengan MD5 - Memerlukan dukungan jaringan iklan | Tersedia di Android SDK versi 4.10.3 |
af_android_url |
N/A |
Mengarahkan pengguna Android ke URL selain dari halaman aplikasi pada Google Play. Gunakan untuk toko aplikasi pihak ketiga. Catatan: Jika Anda memiliki daftar Pengalihan yang diizinkan aktif , pastikan domain URL ini ada dalam daftar. |
|
sha1_el |
N/A |
Digunakan untuk atribusi desktop ke seluler - email di-hash dengan SHA1. Memerlukan dukungan jaringan iklan |
|
fire_advertising_id |
N/A |
ID Iklan Amazon Fire |
|
Parameter spesifik iOS
Parameter | Nama Tampilan | Deskripsi |
---|---|---|
idfa |
IDFA |
Gunakan huruf besar. Membutuhkan dukungan jaringan iklan Jenis bidang: maks 40 karakter |
idfv |
IDFV | Gunakan huruf besar. |
af_ios_url |
Arahkan pengguna iOS (iPhone atau iPad) ke URL yang berbeda dari laman aplikasi di iTunes |
Gunakan ini untuk diarahkan ke halaman tujuan. Catatan: Jika Anda memiliki daftar Pengalihan yang diizinkan aktif , pastikan domain URL ini ada dalam daftar. |
af_ios_store_cpp |
ID halaman produk kustom (ppid) |
|
af_ios_fallback [kedaluwarsa] |
N/A |
Kedaluwarsa: Pengguna diarahkan berdasarkan alur skema URI iOS. |
sha1_idfa |
N/A |
IDFA di-hash dengan SHA1. Membutuhkan dukungan jaringan iklan |
sha1_idfv |
N/A |
IDFV di-hash dengan SHA1. |
mac |
N/A |
Alamat mac perangkat. Membutuhkan dukungan jaringan iklan |
md5_idfv |
N/A |
IDFV di-hash dengan MD5 |
sha1_mac |
N/A |
Alamat mac perangkat di-hash dengan SHA1. Membutuhkan dukungan jaringan iklan |
Contoh
https://app.appsflyer.com/{app_id}/?pid=airpush_int&c=RedBanner&
af_siteid={publisher_id}&af_sub1=1.5&af_sub2=USD&af_sub3=burst_campaign
Semua parameter tersedia di Install report (Laporan penginstalan) dan Analytics (Analisis), Reports (Laporan), serta APIs.
Parameter Kustom
Selain parameter khusus default Android dan iOS, Anda juga dapat menentukan parameter personalisasi. Parameter personalisasi ini dapat membantu jika Anda ingin mempersonalisasi pengalaman pengguna dan konten sesuai tautan atribusi yang mengarah ke penginstalan.
Anda dapat menambahkan parameter khusus ke tautan atribusi dalam format parameter=value
. Contoh:
https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&af_adset=coats&af_ad=cashmere&my_custom_param=my_custom_value
Dua hal penting yang perlu diketahui tentang parameter khusus:
- Parameter khusus tidak muncul dalam data lengkap.
- Parameter khusus dapat diambil dari mendapatkan data konversi SDK API.
Parameter ID Mitra (Partner ID/PID)
Di antara semua parameter tautan atribusi yang tersedia, PID adalah wajib. PID adalah pengenal unik dari sumber media yang dialokasikan oleh AppsFlyer.
Setiap mitra terintegrasi memiliki nilai PID unik mereka sendiri. PID diakhiri dengan akhiran _int . Saat menggunakan tautan atribusi kustom , Anda dapat menyetel PID ke nilai apa pun yang Anda inginkan, selama tidak dipesan oleh mitra terintegrasi. Untuk menghindari konflik, jangan gunakan akhiran _int.
Contoh ID penerbit terintegrasi yang penting: organik, googleadwords_int (Google AdWords), iklan Facebook, Twitter. Anda dapat menggunakan nama apa pun untuk sumber yang tidak terintegrasi seperti email, sms, atau mail pigeon.
Hindari masalah PID umum
- Selalu sertakan PID di tautan atribusi Anda. Tanpa PID di tautan atribusi, pengguna secara otomatis diatribusi ke sumber media "Tidak Ada" dan sumber penginstalan aslinya hilang.
- Untuk Sumber Kustom, gunakan PID mitra yang tidak terintegrasi. Untuk setiap sumber terintegrasi, gunakan hanya PID yang ditentukan untuk atribusi yang benar dari penginstalannya. Untuk sumber media personalisasi apa pun, seperti email, SMS, atau bahkan postingan viral gratis di Facebook, gunakan nilai PID lain yang tidak terintegrasi.
- Gunakan hanya karakter yang valid. Jika parameter PID di Tautan Atribusi berisi salah satu karakter berikut " :<>*&?/" - klik / penginstalan muncul di dashboard di bawah invalid_media_source_name.
Tips
Hindari menggunakan spasi dalam nilai PID, atau pastikan URL mengkodekan tautan atribusi Anda sebelum menggunakannya.
Parameter ID situs
ID situs adalah pengenal unik penerbit yang menayangkan iklan. Dengan kata lain, situs web atau aplikasi yang menampilkan iklan. Jaringan iklan mengalokasikan ID situs unik untuk setiap penerbit.
ID ini disertakan dalam parameter af_siteid
yang diteruskan ke AppsFlyer di tautan atribusi dan tersedia melalui berbagai dasbor, opsi pelaporan, dan postback dari AppsFlyer.
ID situs harus diteruskan ke AppsFlyer di tautan atribusi karena ID ini:
- Memberikan kejelasan dan transparansi tentang penerbit.
- Digunakan oleh AppsFlyer untuk mengidentifikasi dan menghapus penayang palsu, dan kluster lalu-lintas lainnya.
Parameter ID situs hanya menyertakan ID penayang yang menayangkan iklan.
Untuk menyertakan informasi tambahan, seperti jenis iklan, penempatan, atau keduanya dalam aplikasi, misalnya spanduk, pengantara, atau video, gunakan parameter ID sub situs.
Contoh
Tautan atribusi berikut mencakup:
-
af_siteid
(ID situs): ID Penayang -
af_sub_siteid
(ID sub-situs): Informasi ID tambahan (dalam hal ini, sumber afiliasi dan penempatan jenis iklan)
https://app.appsflyer.com/com.yourapp?pid=mediaName_int&clickid={clickid}&advertising_id={gaid}&af_siteid=1234&af_sub_siteid=ABCD_4567
Di tautan contoh:
- 1234 = ID Penayang
- ABCD = Sumber afiliasi (sub-penayang) yang bekerja sama dengan penayang
- 4567 = Penempatan jenis iklan di dalam aplikasi, seperti spanduk, iklan interstisial, atau video
Pertanyaan Umum: Mengapa lalu-lintas menghasilkan banyak penginstalan yang diblokir?
Penginstalan yang diblokir dapat disebabkan oleh hal berikut:
-
ID situs tidak ada: Parameter
af_siteid
tidak ada di URL klik. Interaksi yang dikirim dengan ID situs yang kosong menandakan masalah teknis atau upaya yang disengaja untuk melewati mekanisme deteksi kecurangan. - Beberapa ID situs: Penayang yang sama dikirim ke beberapa URL klik, menggunakan ID situs yang berbeda. Ini dianggap perilaku curang yang menyembunyikan aktivitas penayang yang sebenarnya dan seringkali dikaitkan dengan click flooding (banjir klik).
- Pemformatan ID Situs yang salah: Mengirimkan format yang salah, dikombinasikan dengan indikasi kecurangan lainnya, dapat menyebabkan pemblokiran tidak hanya penayang tertentu, tetapi juga level kluster yang lebih tinggi, dan dapat memengaruhi volume aktivitas mitra yang lebih besar.
Untuk menghindari pemblokiran penginstalan, pastikan Anda mengirimkan satu parameter ID situs per penayang, seperti yang ditunjukkan pada contoh.
Tingkat perincian data
Anda dapat menggunakan hingga empat parameter URL untuk mengukur kinerja iklan Anda.
Menggunakan keempat parameter pada semua tautan atribusi aktif Anda memungkinkan Anda untuk:
- Mengatribusikan semua penginstgalan dan event pengguna ke iklan tertentu
- Telusuri dan bandingkan kinerja semua iklan Anda per ad set, per kampanye, dan per sumber media pada laporan gabungan untuk dioptimalkan di setiap tingkat
- Membandingkan semua iklan Anda di semua sumber media pada laporan data lengkap dan tabel Pivot
Parameternya adalah:
Sumber media (pid=)
nama kampanye (c=)
Set iklan (af_adset=)
Nama iklan (af_ad=)
Contoh
Tautan atribusi berikut menggunakan 4 tingkat perincian untuk mencatat iklan "kashmir" dalam set iklan "mantel" dalam kampanye "musim dingin" yang berjalan pada sumber media "jaringan" terintegrasi.
https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmere
Karakteristik dan batasan
Sifat | Catatan |
---|---|
Karakter khusus |
|
Batas karakter URL |
|
Pertanyaan Umum
Haruskah saya menggunakan huruf kecil atau huruf besar untuk parameter
Anda dapat menggunakan salah satunya tetapi Anda harus konsisten. Jika Anda menetapkan parameter khusus dengan karakter huruf besar atau kecil, pastikan untuk selalu menggunakan parameter itu.
Misalnya, jika Anda mengatur pid=MyMediaSource, pastikan untuk selalu menggunakannya. Jika Anda menggunakan pid=MyMediaSource di salah satu tautan atribusi dan pid=mymediasource di tautan atribusi lainnya, akan terjadi perbedaan data. Hal yang sama berlaku untuk semua parameter lainnya yang Anda atur di tautan atribusi.
Apakah tautan atribusi AppsFlyer statis atau dinamis?
Bagaimana cara mengetahui apakah suatu tautan dinamis atau statis?
Jika tautan atribusi berisi parameter, itu adalah tautan atribusi panjang yang telah ditentukan sebelumnya, dan karena itu statis.
Hanya URL singkat (misalnya,
yourbrand.onelink.me/HaT8/r5c2b371
), yang digunakan untuk tautan atribusi khusus, yang dinamis.Hal ini berarti bahwa begitu Anda mulai menggunakan tautan atribusi untuk mitra terintegrasi, atau URL panjang untuk media yang dimiliki, itu tidak akan berubah untuk setiap calon pengguna yang berinteraksi dengannya, bahkan jika Anda mengubah nilai tautan atribusi di dashboard AppsFlyer. Agar perubahan terjadi, selanjutnya Anda perlu menggunakan URL panjang baru.
Di sisi lain, URL singkat untuk media yang dimiliki, tidak secara langsung berisi parameter. Saat seorang calon pelanggan berinteraksi dengan URL singkat, calon pelanggan diarahkan ke AppsFlyer dan parameter yang diatur saat ini berlangsung secara dinamis.
Apa pesan kesalahan Play Store ini?
Jika Anda menemukan pesan kesalahan berikut di Play Store setelah mengikuti Tautan atribusi:
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#
Biasanya, karakter ini ada di tautan karena mereka adalah makro, dan secara dinamis diganti dengan nilai, jadi ini bukan masalah besar dan Anda bisa mengabaikan pesannya.
Apa gunanya parameter pelanggan?
Contoh
Aplikasi taksi online, Luber, memiliki materi iklan dengan 3 templat warna: biru, kuning, dan merah. Linda, pemasar seluler Luber ingin menguji templat warna mana yang menghasilkan lebih banyak penginstalan. Untuk melakukannya, dia menambahkan &af_sub3=blue
pada tautan atribusi dari semua iklan biru di SEMUA sumber media non-SRN. Hal yang sama juga dilakukan untuk templat iklan warna kuning dan merah. Dengan ditampilkannya rincian informasi ini di laporan data lengkap, Linda dapat menganalisis keberhasilan berbagai warna templat iklan, dan memilih iklan dengan konversi terbaik.
Berapa panjang maksimum untuk nama kampanye?
c_name_exceeded_max_length
Tips
Video: Noam Gohary dari Playtika mengungkapkan 3 metode terbaik untuk mengoptimalkan struktur tautan dan data Anda .