Dokumentasi
Bagaimana cara mengaktifkan plugin ini?
Setelah membeli Referral Source Tracking for WPForms, Anda perlu menginstal plugin tersebut di situs web WordPress Anda. Mari kita bahas prosesnya.
Langkah 1: Instalasi
Masuk ke situs web WordPress Anda dan navigasikan ke Plugin > Tambah Plugin > Unggah Plugin > Instal file zip dan aktifkan.
Langkah 2: Daftarkan Plugin
Pada navigasi sebelah kiri, arahkan ke WPForms > Pelacakan Rujukan.
Masukkan kunci lisensi Anda dan aktifkan.
Langkah 3: Aktifkan Fitur
Setelah mengaktifkan lisensi Anda, tab “Umum” akan muncul di halaman pengaturan Pelacakan Referensi, klik tab tersebut lalu klik “Simpan Perubahan”.
Selesai! Sekarang pelacakan sumber rujukan akan aktif pada formulir yang sudah ada atau formulir baru yang Anda buat.
Detail Fitur
Sumber yang Terdeteksi
Kami mencatat URL perujuk jika tersedia. dan menyimpannya pada entri tersebut. Kami juga menerapkan label yang mudah dipahami untuk platform umum sehingga sumbernya mudah dimengerti sekilas.
Berikut daftar sumber yang diberi label saat terdeteksi:
- Google: Google Ads, Google Organik, Gemini
- Microsoft/Bing: Iklan Microsoft, Bing Organik
- Facebook: Iklan Facebook, Facebook Organik
- LinkedIn: Iklan LinkedIn, Pencarian Organik LinkedIn
- X (Twitter): X Iklan, X Organik
- Reddit: Iklan Reddit, Reddit Organik
- TikTok: Iklan TikTok, TikTok Organik
- Pinterest: Iklan Pinterest, Pencarian Organik Pinterest
- Snapchat: Iklan Snapchat, Snapchat Organik
- Mesin Pencari Lainnya: Yahoo, DuckDuckGo, Yandex
- Asisten AI (jika tersedia): ChatGPT, Kebingungan, Microsoft Copilot, Claude, Grok, DeepSeek
- Platform Email (pelacakan kampanye): Mailchimp, Constant Contact, Salesforce Pardot, HubSpot
- Langsung dan Tidak dikenal digunakan bila sesuai.
- Kebiasaan Sumber juga bisa ditambahkan!
Parameter UTM yang Ditangkapnya
utm_sourceutm_mediumutm_campaignutm_termutm_contentutm_id
ID Klik yang Tercatat
gclidgbraidwbraidmsclkidli_fat_idrdt_cidttclidpin_cidsnap_cidmc_cidmc_eiddclid
Tag Pintar
{pb_ref_source} – label sumber rujukan yang terdeteksi (secara default "Tidak Diketahui" jika kunjungan tidak dapat diklasifikasikan).
{pb_ref_params} – rangkaian lengkap parameter rujukan yang diambil (UTM dan variabel kueri lainnya disimpan bersama).
{pb_ref_referrer} – perujuk peramban yang membawa pengunjung ke situs tersebut.
{pb_ref_utm_id} – ditangkap utm_id.
{pb_ref_utm_source} – ditangkap utm_source.
{pb_ref_utm_medium} – ditangkap utm_medium.
{pb_ref_utm_campaign} – ditangkap utm_campaign.
{pb_ref_utm_term} – ditangkap utm_term.
{pb_ref_utm_content} – ditangkap utm_content.
{pb_ref_clid} – ID klik pertama yang terdeteksi (gclid, fbclid, msclkid, dll.).
Terjemahan
Plugin ini sepenuhnya siap untuk diterjemahkan. Anda dapat menerjemahkannya ke dalam bahasa apa pun menggunakan layanan terjemahan gratis. Terjemahan Loco plugin atau alat terjemahan WordPress lainnya.
Bahasa default: Inggris (en_US)
FAQ
Apakah ini berfungsi dengan WPForms Lite?
Ya. Pelacakan rujukan dan pemrosesan Smart Tag berfungsi dengan WPForms Lite. Namun, WPForms Lite memiliki UI manajemen entri yang terbatas dibandingkan dengan versi Pro — kolom daftar entri, sidebar pelacakan rujukan entri tunggal, dan integrasi ekspor CSV memerlukan WPForms Pro.
Bisakah saya mengekspor datanya?
Ya. Nilai pelacakan disertakan dalam ekspor CSV WPForms. Semua kolom rujukan (sumber, perujuk, UTM, ID klik, dan lainnya) ditambahkan sebagai kolom ekspor secara otomatis.
Apa sebenarnya yang ditangkap oleh plugin ini?
Kami mencatat kolom atribusi umum dan menyimpannya bersama setiap entri WPForms, termasuk Parameter UTM (sumber, media, kampanye, istilah, konten), Klik ID (gclid, msclkid, gbraid/wbraid, dll.), the URL perujuk asli, dan konteks landing page terkait sehingga Anda dapat melihat dengan jelas dari mana setiap prospek berasal.
Bisakah saya menambahkan sumber kustom?
Ya! Baik itu situs rujukan, kemitraan afiliasi, dan lain sebagainya, Anda dapat menambahkan sumber khusus dengan label yang jelas.
Di mana data rujukan disimpan?
Data konversi atau peristiwa akan tersimpan di database WordPress Anda dalam tabel plugin khusus yang terhubung dengan entri WPForms. Kami tidak mengirimkan data konversi atau peristiwa ke platform iklan.
Apakah ini atribusi sentuhan pertama atau sentuhan terakhir?
Plugin ini berfokus pada atribusi sentuhan pertama dengan menyimpan asli Parameter perujuk dan kampanye yang membawa pengunjung ke situs Anda (dalam jangka waktu retensi).
Berapa lama data atribusi pengunjung diingat?
Jangka waktu penyimpanan adalah 7 hari. Jika pengunjung mengirimkan formulir dalam waktu 7 hari sejak kunjungan pertama mereka yang terlacak, nilai atribusi asli akan diterapkan pada entri tersebut.
Apakah ini berfungsi dengan caching/CDN?
Biasanya, ya. Pelacakan berjalan di sisi klien, jadi sebagian besar pengaturan caching/CDN berfungsi dengan baik. Jika Anda menggunakan optimasi skrip yang agresif (minifikasi/penundaan), kecualikan skrip plugin di bawah ini dan uji pengiriman:
/wp-content/plugins/pb-wpforms-referral-tracking/assets/dist/js.cookie.min.js/wp-content/plugins/pb-wpforms-referral-tracking/assets/js/front-end.js
Apakah ini berfungsi dengan WPForms yang mendukung AJAX?
Ya. Ini berfungsi dengan formulir AJAX (bawaan WPForms) dan pengiriman standar.
Bisakah saya melacak lebih dari satu formulir?
Ya. Ini berfungsi di semua WPForms Anda—setiap pengiriman menyimpan nilai atribusi masing-masing ke entri tersebut.
Apakah ini menggantikan pelacakan konversi GA4 / Google Ads?
Tidak. Plugin ini tidak mengaktifkan piksel atau mengirimkan peristiwa konversi ke GA4 atau platform iklan. Plugin ini hanya menyimpan data atribusi. di dalam entri WPForms, sehingga tim Anda dapat melihat data sumber prospek secara langsung di WordPress dan melakukan ekspor.
Apakah aplikasi ini mengumpulkan data pribadi?
Secara default, ia menangkap data atribusi (UTM, gclid, URL perujuk). Itu memang bukan Secara default, formulir akan menangkap informasi identitas pribadi (PII) tambahan. Kolom formulir Anda dan parameter apa pun yang disertakan dalam URL dikendalikan oleh situs dan pengaturan pemasaran Anda.
Apakah ini sesuai dengan GDPR/CCPA?
Plugin ini dapat digunakan dengan cara yang sesuai dengan GDPR/CCPA. Plugin ini menyimpan data atribusi bersamaan dengan entri Anda dan tidak mengirimkan peristiwa ke platform iklan. Anda bertanggung jawab atas persetujuan/kepentingan sah dan pengungkapan yang tepat untuk pengaturan spesifik Anda.
Apakah ini berfungsi dengan jaringan WordPress Multisite?
Ringkasan singkat:
- Lisensi tak terbatas: Aktifkan Mode Jaringan sekali; satu tombol dapat mengelola semuanya. setiap Pengaturan dan dukungan sub-situs.
- Diaktifkan oleh jaringan: Semua sub-situs menjalankan pelacakan rujukan dan menerima pembaruan secara langsung.
- Paket terbatas / tanpa lisensi sub-situs: Pelacakan tetap aktif, tetapi pengaturan sub-situs bersifat hanya baca.
- Dukungan mengikuti lisensi: Situs-situs yang tercakup oleh kunci aktif memenuhi syarat.
Ya; plugin ini langsung berfungsi di setiap sub-situs segera setelah Anda mengaktifkannya di jaringan.—tidak diperlukan pengaturan manual. Setiap sub-situs dapat menggunakan pelacakan dan menerima pembaruan bahkan tanpa lisensi lokal. Untuk mengubah pengaturan tingkat formulir atau mendapatkan dukungan langsung di sub-situs, Anda tetap perlu mengaktifkan lisensi di sana.
Jika Anda memiliki lisensi Unlimited, Anda dapat mengaktifkan Mode Jaringan dari situs utama dan mengirimkan kunci tunggal tersebut ke setiap sub-situs dalam satu batch (dengan kemajuan langsung). Sub-situs tersebut akan mewarisi pengaturan dan dukungan yang dikelola lisensi secara otomatis.
Kait
Tindakan
pb_wpforms_referral_tracking_loaded
Eksekusi ini terjadi setelah plugin sepenuhnya diinisialisasi — semua kelas dimuat, hook didaftarkan, dan API siap digunakan. Ini adalah titik awal yang andal untuk add-on atau plugin pendamping yang memperluas Referral Source Tracking.
Parameter:
$plugin(Plugin) — Instansi plugin.
add_action( 'pb_wpforms_referral_tracking_loaded', function( $plugin ) {
// Safe to interact with the plugin's classes and filters here.
// Example: register your own add-on after the plugin is ready.
if ( class_exists( 'MyReferralAddon' ) ) {
new MyReferralAddon( $plugin );
}
} );Filter
pb_wpforms_referral_tracking_enabled
Mengesampingkan apakah pelacakan rujukan diaktifkan untuk formulir tertentu. Kembalikan nilai true untuk memaksa pelacakan aktif, false untuk memaksanya nonaktif, terlepas dari tombol pengaktifan per formulir atau pengaturan default global.
Parameter:
$enabled(bool) — Apakah pelacakan saat ini diaktifkan.$form_id(int) — ID formulir saat ini.$form_data(array|null) — Array data formulir, atau null jika tidak tersedia.
Contoh Penggunaan:
// Disable tracking on a specific form (e.g. an internal staff-only form).
add_filter( 'pb_wpforms_referral_tracking_enabled', function( $enabled, $form_id, $form_data ) {
$excluded_form_ids = [ 12, 27 ];
if ( in_array( $form_id, $excluded_form_ids, true ) ) {
return false;
}
return $enabled;
}, 10, 3 );pb_wpforms_referral_tracking_merge_tag_map
Ubah peta Smart Tag yang menentukan Smart Tag mana yang tersedia dan kunci pelacakan mana yang terkait dengannya. Gunakan ini untuk menambahkan Smart Tag kustom sepenuhnya atau mengganti nama Smart Tag yang sudah ada.
Parameter:
$map(array) — Array asosiatif tag => kunci pelacakan (misalnya.'pb_ref_source' => 'source').
Contoh Penggunaan:
// Add a custom Smart Tag that maps to a custom tracking key.
add_filter( 'pb_wpforms_referral_tracking_merge_tag_map', function( $map ) {
$map['pb_ref_landing_page'] = 'landing_page';
return $map;
} );pb_wpforms_referral_tracking_value
Saring nilai pelacakan mentah sebelum digunakan untuk mengganti Smart Tag dalam notifikasi atau konfirmasi. Berguna untuk membersihkan atau mengubah nilai-nilai tertentu.
Parameter:
$value(rangkaian) — Nilai pelacakan mentah.$tag(rangkaian) — Kunci Smart Tag (misalnya).pb_ref_source).$form_data(array) — Larik data formulir.$fields(array) — Kolom input.$entry_id(int) — ID entri.
Contoh Penggunaan:
// Truncate long referrer URLs in Smart Tag output.
add_filter( 'pb_wpforms_referral_tracking_value', function( $value, $tag, $form_data, $fields, $entry_id ) {
if ( $tag === 'pb_ref_referrer' && strlen( $value ) > 100 ) {
return substr( $value, 0, 100 ) . '…';
}
return $value;
}, 10, 5 );pb_wpforms_referral_tracking_formatted_value
Saring nilai Smart Tag yang telah diformat lengkap setelah diproses.
Parameter:
$formatted(rangkaian) — String keluaran yang diformat.$tag(rangkaian) — Kunci Smart Tag.$form_data(array) — Larik data formulir.$fields(array) — Kolom input.$entry_id(int) — ID entri.
// Wrap the source value in a bold tag in HTML notifications.
add_filter( 'pb_wpforms_referral_tracking_formatted_value', function( $formatted, $tag, $form_data, $fields, $entry_id ) {
if ( $tag === 'pb_ref_source' ) {
return '<strong>' . esc_html( $formatted ) . '</strong>';
}
return $formatted;
}, 10, 5 );pb_wpforms_referral_tracking_default_value
Ganti nilai cadangan yang digunakan ketika kolom pelacakan kosong pada saat pengiriman. Nilai defaultnya adalah “Tidak Diketahui”.
Parameter:
$default(rangkaian) — Nilai default saat ini (“Tidak diketahui”).$key(rangkaian) — Keterangan konteks:source,referrer, ataufront_end.
// Use "Direct" instead of "Unknown" for the source field fallback.
add_filter( 'pb_wpforms_referral_tracking_default_value', function( $default, $key ) {
if ( $key === 'source' ) {
return 'Direct';
}
return $default;
}, 10, 2 );pb_wpforms_referral_tracking_js_config
Timpa seluruh objek konfigurasi JavaScript front-end sebelum diteruskan ke skrip pelacakan. Ini memberi Anda kendali penuh atas pengaturan cookie, pola deteksi sumber, sumber yang dikenal, media berbayar, dan banyak lagi.
Parameter:
$config(array) — Array konfigurasi JS lengkap.
// Extend cookie lifetime to 30 days and add a custom paid medium.
add_filter( 'pb_wpforms_referral_tracking_js_config', function( $config ) {
$config['cookieExpiry'] = 30;
// Add "social" as a paid medium indicator.
$config['paidMediums'][] = 'social';
// Add a custom source pattern for an internal platform.
$config['sourcePatterns']['custom_platforms'][] = [
'pattern' => 'myplatform\.com',
'name' => 'My Platform',
];
return $config;
} );pb_wpforms_referral_tracking_custom_sources
Secara terprogram, masukkan aturan sumber kustom yang berjalan bersamaan dengan aturan yang dikonfigurasi di UI admin. Aturan dari filter ini digabungkan dengan aturan UI yang tersimpan dan diurutkan berdasarkan prioritas sebelum diteruskan ke front-end.
Parameter:
$sources(array) — Array kosong. Mengembalikan array berisi array aturan yang akan ditambahkan.
Setiap peraturan harus memiliki: label, matchField (referrer, utm_source, utm_medium, utm_campaign, utm_term, utm_content), matchType (contains atau equals), matchValue, dan opsional priority (nilai default 10, nilai lebih tinggi dijalankan terlebih dahulu).
// Add partner and affiliate sources without touching the admin UI.
add_filter( 'pb_wpforms_referral_tracking_custom_sources', function( $sources ) {
$sources[] = [
'label' => 'Partner: Acme Corp',
'matchField' => 'referrer',
'matchType' => 'contains',
'matchValue' => 'acme.com',
'priority' => 20,
];
$sources[] = [
'label' => 'Campaign: Spring Sale',
'matchField' => 'utm_campaign',
'matchType' => 'contains',
'matchValue' => 'spring-sale',
'priority' => 10,
];
return $sources;
} );pb_wpforms_referral_tracking_enqueue_assets
Mengontrol apakah aset front-end plugin (pustaka cookie dan skrip pelacakan) diantrekan. Kembalikan false untuk menonaktifkan pemuatan sepenuhnya pada halaman atau kondisi tertentu.
Parameter:
$enqueue(bool) — Apakah aset akan dimasukkan ke dalam antrean. Defaulttrue.
// Disable tracking assets on the homepage only.
add_filter( 'pb_wpforms_referral_tracking_enqueue_assets', function( $enqueue ) {
if ( is_front_page() ) {
return false;
}
return $enqueue;
} );