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 (tautan multi-platform) | Tautan platform tunggal | |
---|---|---|
Deskripsi dan kapan digunakan |
Gunakan saat:
|
Gunakan saat:
Pelajari lebih lanjut tentang cara menyiapkan mitra terintegrasi |
Prasyarat |
Tidak ada | |
Informasi wajib |
||
URL Dasar |
{subdomain}.onelink.me |
app.appsflyer.com |
Pengenal unik |
ID Templat |
app_id |
Struktur URL | https://{subdomain}.onelink.me/ |
|
Contoh | https://yourbrand.onelink.me/aAB1?pid=greatnetwork_int |
https://app.appsflyer.com/com.greatapp?pid=greatnetwork_int& |
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.
Parameter tautan atribusi — UA dan penargetan ulang
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 150 |
c | Kampanye | Disediakan oleh pemasang iklan atau penerbit. Lihat limit untuk nama kampanye. |
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 jendela lookback |
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 |
Kanal sumber media tempat iklan didistribusikan, misalnya, UAC_Search, UAC_Display, Instagram, Meta 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 kustom opsional yang ditentukan oleh pemasang iklan. Untuk informasi lebih lanjut tentang penggunaan parameter ini, periksa bagian Ciri dan batasan . |
String 100 |
af_r | N/A |
Digunakan dalam tautan platform tunggal untuk mengarahkan pengguna ke URL tertentu untuk kedua platform (Android dan iOS).
|
|
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_base_params_forward | N/A |
|
|
af_partner_account_id | ID Akun Jaringan | ID akun pengiklan dengan partner | String 100 |
redirect | N/A | Saataf_redirect=false , parameter ini memberitahu AppsFlyer bahwa ini adalah klik S2S dan mitra bertanggung jawab untuk mengalihkan pengguna yang mengeklik. |
|
af_ua | Pengguna |
Relevan untuk jaringan iklan yang mengirimkan klik dan impresi server-to-server. String pengguna dikirim sebagai:
Pengguna harus sama, baik di parameter URL dan header HTTP. Perhatian: Di Android, tugas pengguna terkadang dibatasi menjadi mengurus Client Hints. Hasilnya harus tetap dikirimkan.
|
|
af_ip | ip |
Relevan untuk jaringan iklan yang mengirimkan klik dan impresi server-to-server. Alamat IP Perangkat Rekomendasi: Jika tersedia, berikan IP perangkat berdasarkan parameter af_ip. Pilihan selanjutnya: Jika tersedia, AppsFlyer akan menggunakan IP di X-Forwarded-For. |
|
[Deprecated] af_os | Versi iOS |
[Khusus iOS] Versi sistem operasi perangkat. Parameter ini tidak digunakan lagi tetapi masih didukung oleh AppsFlyer. Rekomendasi: Gunakan parameter af_os_version parameter sebagai gantinya. |
|
af_os_version | Versi iOS |
|
|
af_model | Model perangkat |
|
|
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 diinginkan dalam kode. |
|
deep_link_value | N/A |
Nama untuk konten in-app tertentu yang akan diarahkan oleh pengguna. Pengembang menerapkan perilaku yang diinginkan dari deep_link_value dalam kode. |
|
af_og_title | N/A |
Saat tautan diposting ke media sosial, judul grafik terbuka (OG) akan menghasilkan pratinjau judul. |
String 40 |
af_og_description | N/A |
Saat tautan diposting ke media sosial, deskripsi grafik terbuka (OG) akan menghasilkan pratinjau deskripsi. |
String 300 |
af_og_image | N/A |
Saat tautan diposting ke media sosial, gambar grafik terbuka (OG) akan menghasilkan pratinjau gambar. |
Parameter tautan atribusi —khusus penargetan ulang
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.
Jenis iklan (af_ad_type)
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 |
|
af_android_store_csl |
store_product_page |
Listing toko kustom di Google Console |
string |
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 |
Gunakan ini untuk pengalihan ulang halaman arahan untuk mengalihkan pengguna iOS (iPhone atau iPad) ke URL berbeda dari halaman aplikasi di iTunes Catatan : Jika Anda memiliki daftar Pengalihan yang diizinkan aktif, pastikan domain URL ini ada dalam daftar. |
|
af_ios_store_cpp | store_product_page |
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 memiliki akhiran _int. Saat menggunakan tautan OneLink , Anda dapat menyetel PID ke nilai apa pun yang Anda inginkan, asalkan belum ditentukan oleh mitra terintegrasi. Untuk menghindari konflik, jangan gunakan akhiran _int.
Contoh ID penerbit terintegrasi yang penting: organik, googleadwords_int (Google AdWords), Meta ads (iklan Meta), dan 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 legal. Jika parameter PID di Tautan Atribusi berisi salah satu karakter berikut /<>*&?\
- Klik atau instal muncul di dashboard di bawah af_invalid_param
- Tautan atribusi tidak akan diatribusikan
- Kemampuan deep linking tidak akan berfungsi pada klik
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 dashboard, opsi pelaporan, dan postback.
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 |
Karakter khusus berikut tidak diperbolehkan dalam parameter atau nilai: ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ', >, <, /, {, }, % |
Batas karakter URL |
Panjang URL total tidak boleh melebihi 2.000 karakter |
Pengalihan tautan langsung WebView aplikasi sosial Android |
Lihat detail batasan di sini |
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:
Ini karena tautan atribusi menyertakan # karakter. Contoh: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.
Limit apa yang ada di nama kampanye?
- Panjang maksimal nama kampanye di URL link atribusi dibatasi hingga 100 karakter. Jika melebihi batas, nama kampanye diubah ke:
c_name_exceeded_max_length
- Nama kampanye tidak boleh dimulai dari atau diakhiri dengan spasi putih, karena dapat menyebabkan perbedaan di dashboard dan laporan