Pelacakan Rujukan untuk Gravity Forms

Bagaimana cara mengaktifkan plugin ini?

Setelah membeli Referral Source Tracking untuk Gravity Forms, instal di situs web WordPress Anda.

Langkah 1: Instalasi

Masuk ke situs WordPress Anda dan navigasikan ke Plugin → Tambah Plugin → Unggah Plugin → Instal file zip dan aktifkan.

Langkah 2: Daftarkan Plugin

Di navigasi sebelah kiri, buka Formulir → Pengaturan → Pelacakan Rujukan.

Masukkan kunci lisensi Anda dan aktifkan.

Langkah 3: Aktifkan Fitur

Setelah mengaktifkan lisensi Anda, tab Umum akan muncul. Klik tab tersebut, lalu centang Aktifkan secara default (“Aktifkan pelacakan sumber rujukan pada semua formulir secara default”), lalu klik Simpan Perubahan.

Jika kotak centang tersebut tidak dicentang, pelacakan akan terjadi di mana-mana. Sebagai gantinya, Anda dapat mengaktifkannya untuk setiap formulir di Pengaturan Formulir → Opsi Formulir.

Selesai! Dengan mengaktifkan "Aktifkan secara Default", pelacakan sumber rujukan akan aktif pada semua formulir yang sudah ada dan formulir baru yang Anda buat.

Detail fitur

Sumber yang dideteksinya

Kami menangkap URL perujuk jika tersedia dan menyimpannya pada entri. Untuk platform umum, kami juga menambahkan label yang mudah dipahami, sehingga sumbernya mudah dibaca.

Suatu sumber diberi label Iklan hanya ketika kunjungan tersebut membawa ID klik iklan platform itu sendiri (gclid, msclkid, li_fat_id, ttclid, oppref, dan sebagainya). Platform yang dikenal yang datang tanpa ID tersebut diberi label Organik. Facebook dan Instagram adalah pengecualian: Meta menambahkan fbclid ke setiap klik, sehingga keduanya terbaca sebagai Iklan ketika fbclid tiba dengan parameter UTM apa pun.

Berikut daftar sumber yang diberi label saat terdeteksi:

• Google: Google Ads, Google Organik. Lalu lintas Gemini yang diberi tag. utm_source=gemini diberi label Google Organic; tidak ada label Gemini terpisah.
• Microsoft/Bing: Bing Ads, Bing Organic
• Facebook: Iklan Facebook, Facebook Organik
• Instagram: Iklan Instagram, Instagram Organik
• LinkedIn: Iklan LinkedIn, Pencarian Organik LinkedIn
• X (Twitter): X Organik
• Reddit: Iklan Reddit, Reddit Organik
• TikTok: Iklan TikTok, TikTok Organik
• Pinterest: Iklan Pinterest, Pencarian Organik Pinterest
• Snapchat: Iklan Snapchat, Snapchat Organik
• YouTube: YouTube Organik. Klik iklan YouTube yang menghasilkan gclid akan tercatat sebagai Google Ads kecuali jika URL-nya juga diberi tag. utm_source=youtube, yang merekam Iklan YouTube.
• Mesin Pencari Lainnya: Yahoo, DuckDuckGo, Yandex
• Asisten AI/LLM: ChatGPT Ads, ChatGPT Organic, Perplexity, Copilot, Claude, Grok, DeepSeek
• Platform Email (pelacakan kampanye): Mailchimp, Constant Contact, Pardot (berlabel Salesforce), HubSpot
• Langsung dan Tidak dikenal digunakan bila sesuai.
• Kebiasaan Sumber dapat ditentukan di bawah Sumber Kustom untuk lalu lintas mitra, afiliasi, dan kampanye.

Parameter UTM yang ditangkapnya

• utm_source
• utm_medium
• utm_campaign
• utm_term
• utm_content
• utm_id

ID Klik yang Tercatat

Kami mencatat setiap ID klik di bawah ini ke dalam kolom ID Klik, dan masing-masing mengaitkan kunjungan tersebut ke platformnya kecuali jika baris tersebut menyatakan sebaliknya.

Sumber kustom

Deteksi sumber bawaan sudah mencakup mesin pencari utama, platform media sosial, asisten AI, dan alat pemasaran email. Sumber Kustom memungkinkan Anda menambahkan aturan berlabel sendiri di atasnya. Gunakan untuk situs mitra, rujukan afiliasi, kampanye bernama, pemendek tautan bermerek, tautan karyawan, dan apa pun di mana label "Rujukan" default atau sumber mentah tidak tersedia. utm_source Nilainya kurang spesifik.

Temukan mereka di bawah ini Formulir → Pengaturan → Pelacakan Rujukan di dalam Sumber Kustom bagian. Setiap baris adalah satu aturan.

Bagaimana suatu aturan dievaluasi

Pada setiap kunjungan, plugin akan memeriksa Sumber Kustom Anda. sebelum Deteksi bawaan. Aturan pertama yang cocok akan menang: plugin mengatur sumber pengunjung ke aturan tersebut. Label dan melewati deteksi bawaan untuk kunjungan tersebut. Jika tidak ada yang cocok, deteksi bawaan berjalan seperti biasa (Google, Facebook, Direct, dll.).

Ladang-ladang itu, satu per satu

• Label – Teks yang disimpan sebagai Sumber kunjungan (misalnya. Partner: Acme, Email: Newsletter, Campaign: Spring Sale). Inilah yang persis muncul dalam entri tersebut, di dalam {pb_ref_source} Gunakan tag gabungan (merge tag) di tab Laporan, dan di pemetaan CRM mana pun. Pilih sesuatu yang akan Anda kenali di layar entri yang ramai.
• Lapangan Pertandingan – Ke mana harus mencari:
  • Host Perujuk – domain di referer browser (misalnya, cocok dengan acme.com ketika seseorang datang dari https://www.acme.com/blog/post).
  • Sumber UTM / Media / Kampanye / Istilah / Konten – yang sesuai ?utm_*= parameter pada URL halaman arahan.
• Jenis Pertandingan – Hal yang perlu diperhatikan:
  • Berisi – Nilai kolom mencakup Nilai Pencocokan Anda di mana pun di dalamnya. Tidak peka huruf besar/kecil. Berguna untuk menangkap variasi seperti acme.com, blog.acme.com, partner.acme.com dengan satu aturan.
  • Sama dengan – Nilai kolom persis sama dengan Nilai Pencocokan Anda (tidak peka huruf besar/kecil). Lebih ketat, jadi gunakan saat Anda membutuhkan pencocokan yang tepat seperti utm_source persis sama dengan newsletter.
• Nilai Pertandingan – Teks yang harus dicari. Tanpa tanda kutip, tanpa tanda bintang, hanya string literalnya.
• Prioritas – Sebuah nomor yang mengontrol urutan. Lari lebih tinggi terlebih dahulu, jadi jika aturan saling tumpang tindih, aturan dengan prioritas lebih tinggi akan menang. Nilai default adalah 10; benturan ke 20 atau 50 Untuk aturan yang harus mengalahkan pengaturan default Anda, turun ke 5 untuk keperluan umum.

Contoh soal

Beri label pada situs mitra berdasarkan perujuk.

Siapa pun yang datang dari subdomain mana pun dari acme.com diberi label Partner: Acme alih-alih yang generik Referral.

Beri label pada kampanye buletin yang telah diberi tag.

Gunakan ini ketika Anda mengontrol URL di pihak Anda (misalnya tautan di dalam email mingguan yang Anda kirim). ?utm_source=newsletter).

Beri label pada kampanye berbayar dengan nama kampanye UTM-nya.

Tangkapan ?utm_campaign=spring-sale-2026, ?utm_campaign=spring-sale-google-ads, dan varian serupa dalam satu aturan.

Mengesampingkan deteksi bawaan Google untuk afiliasi tertentu

Prioritas tinggi memastikan aturan ini mengalahkan aturan bawaan. utm_source=google → Google Ads memberi label setiap kali sumber yang ditandai muncul.

“Tambahkan Label Organik/Iklan” dengan sumber khusus

Sumber bawaan selalu ditampilkan sebagai Google Ads, Facebook Organic, dll. Itu Tambahkan Label Organik/Iklan (Sumber Kustom) Kotak centang (juga terdapat di Formulir → Pengaturan → Pelacakan Rujukan) mengontrol apakah label khusus Anda mendapatkan akhiran yang sama.

• Diperiksa (default) – aturan khusus berlabel Partner: Acme menjadi Partner: Acme Organic pada lalu lintas rujukan dan Partner: Acme Ads jika kunjungan tersebut membawa ID klik berbayar seperti gclid.
• Tidak diperiksa – Label kustom Anda akan ditampilkan persis seperti yang Anda ketik, dan plugin tidak menambahkan akhiran apa pun.

Pilih mana yang sesuai dengan kebutuhan pelaporan Anda. Sebagian besar tim menginginkan akhiran tersebut agar dapat membandingkan lalu lintas berbayar versus lalu lintas organik dari mitra, tetapi jika Anda menggunakan Label itu sendiri untuk membawa identitas lengkap, matikan saja.

Menambahkan aturan secara terprogram.

Jika Anda sedang membuat add-on atau menginginkan aturan di bawah kendali versi, maka pb_gforms_referral_tracking_custom_sources Filter menerima bentuk yang sama dengan UI admin dan menggabungkannya. Plugin mengurutkan aturan dari kedua tempat tersebut berdasarkan prioritas sebelum dievaluasi oleh front-end.

Bidang cermin

Kolom pelacakan kami ditambahkan ke formulir Anda secara dinamis pada saat rendering. Kolom tersebut bukan bagian dari daftar kolom tersimpan formulir. Hal ini menjaga formulir Anda tetap rapi, tetapi beberapa add-on CRM, pemasaran email, dan webhook hanya membangun dropdown pemetaan kolom mereka dari kolom tersimpan, sehingga mereka tidak dapat "melihat" kolom dinamis kami.

Fitur pencermian kolom memperbaiki masalah itu. Di bawah Formulir → [formulir Anda] → Pengaturan → Opsi Formulir, klik Tambahkan bidang cermin Plugin ini menambahkan serangkaian kolom Tersembunyi yang terlihat oleh editor ke formulir Anda. Kolom pelacakan asli tetap menjadi sumber kebenaran; plugin menyalin nilai yang diambil ke kolom cermin saat entri dibuat, sehingga add-on Anda dapat memetakannya dari dropdown kolom normalnya. Blok Kolom Cermin hanya muncul setelah tombol pelacakan rujukan formulir tersebut diaktifkan.

Jika add-on Anda mendukung opsi pemetaan “Nilai Kustom”, Anda tidak memerlukan kolom cermin sama sekali. Cukup petakan tag gabungan kami secara langsung (misalnya {pb_ref_source}, {pb_ref_utm_source}, {pb_ref_clid}).

Mengelola bidang cermin:

• Tambahkan bidang cermin – membuat set yang terlihat oleh editor.
• Tambahkan N kolom cermin yang hilang – muncul setiap kali formulir memiliki beberapa, tetapi tidak semua, bidang cermin saat ini, dan menyebutkan jumlahnya. Itu terjadi jika seseorang menghapus bidang secara manual, dan juga setelah Anda mengaktifkan atribusi sentuhan terakhir, yang menambahkan serangkaian definisi baru. Plugin ini membiarkan ID bidang yang tersisa tidak berubah, sehingga pemetaan yang tersimpan tetap berfungsi.
• Hapus 2 kolom cermin duplikat – hanya muncul jika terdapat duplikat, dan menyebutkan jumlahnya. Mempertahankan kemunculan pertama dari masing-masing.
• Hapus bidang cermin – Menghapus set (dengan konfirmasi). Nilai yang sudah tersimpan pada entri sebelumnya tetap ada di database, tetapi add-on tidak akan lagi dapat melihatnya melalui pencarian ID field.

Saat atribusi sentuhan terakhir diaktifkan, kolom cermin juga dapat menyertakan kumpulan sentuhan terakhir. Formulir yang sudah memiliki kumpulan sentuhan pertama tidak akan mengambilnya secara otomatis: gunakan Tambahkan N kolom cermin yang hilang pada masing-masing untuk mengisinya kembali.

Laporan

Temukan Laporan di bawah ini Formulir → Pengaturan → Pelacakan Rujukan → Laporan. Tab ini memvisualisasikan setiap entri yang dilacak yang masuk selama rentang tanggal yang Anda pilih, yang dipecah berdasarkan sumber, dimensi UTM, dan perujuk. Entri yang dikirim sebelum plugin aktif, entri pada formulir dengan pelacakan dimatikan, dan entri yang dihapus atau spam tidak dihitung, sehingga total ini dapat berada di bawah jumlah entri Gravity Forms Anda. Rentang mencakup hari penuh dan berakhir pada entri lengkap terakhir. UTC tengah malam, jadi perbandingan periode tetap sama. Tergantung seberapa jauh zona waktu situs Anda dari UTC, batas waktu tersebut dapat jatuh di tengah hari lokal Anda.

Grafik sekilas

• Rincian Sumber – Bagan donat yang menunjukkan persentase pengajuan per sumber yang diberi label (Google Organik, Iklan Facebook, Sumber Kustom Anda, Langsung, dll.).
• Entri dari Waktu ke Waktu – Grafik garis total entri per kelompok. Arahkan kursor ke suatu titik dan tooltip akan membagi total tersebut berdasarkan sumber. Jendela waktu yang lebih panjang (90 dan 365 hari) membagi kelompok berdasarkan bulan agar sumbu tetap mudah dibaca; pada jendela waktu 30 hari, grafik menampilkan label setiap tanggal ke-7 agar tidak terlalu padat.
• Sumber UTM Teratas / Media / Kampanye – Bagan batang horizontal yang menampilkan nilai-nilai dengan entri terbanyak di setiap dimensi UTM.
• Pemberi Referensi Teratas – Bagan batang horizontal dari domain perujuk yang menghasilkan pengajuan terbanyak. Plugin ini menyimpan lalu lintas langsung dengan perujuk. Direct, jadi di sini muncul sebagai bar tersendiri dan bukan sebagai domain.

Filter

• Membentuk – Pilih opsi "cakupan ke satu formulir" saja, atau biarkan pada "Semua formulir" untuk tampilan seluruh situs.
• Rentang tanggal – jendela preset (7, 30, 90, dan 365 hari terakhir).
• Bandingkan dengan periode sebelumnya – Menunjukkan total periode dengan perubahan persentasenya dibandingkan dengan periode sebelumnya yang setara (7 hari terakhir dibandingkan dengan 7 hari sebelumnya, 30 hari terakhir dibandingkan dengan 30 hari sebelumnya, dll.), dan menempatkan periode sebelumnya tersebut sebagai garis putus-putus pada grafik waktu. Grafik batang UTM dan referrer tidak dibandingkan.
• Sembunyikan tanpa atribusi – menyembunyikan kategori "Tidak Diatur" dan "Tidak Diketahui" agar Anda dapat fokus pada sumber yang diatribusikan. Kategori "Langsung" tetap ada.

Plugin ini mengingat pilihan rentang tanggal, periode perbandingan, dan sembunyikan data yang tidak teratribut untuk setiap pengguna, sehingga Anda tidak perlu mengaturnya lagi pada kunjungan berikutnya.

Performa dan caching

Plugin ini menghitung laporan dari entri Gravity Forms Anda dan menyimpan hasilnya dalam cache, sehingga pemuatan berulang menjadi cepat. Entri baru secara otomatis membatalkan cache tersebut, dengan penundaan (debounce) di balik penguncian 60 detik agar formulir bervolume tinggi tidak membebani cache. Pengembang dapat menyesuaikan jendela penundaan (atau menonaktifkannya sepenuhnya) dengan pb_gforms_rt_invalidate_debounce Filter. Lihat Hooks di bawah.

Ringkasan email

Jika Anda lebih suka menerima ringkasan atribusi melalui email daripada membuka dasbor, aktifkan ringkasan email di bawah ini. Formulir → Pengaturan → Pelacakan Rujukan → Laporan Email. Hari dan jam yang Anda pilih dievaluasi berdasarkan zona waktu situs Anda, tetapi periode yang dilaporkan itu sendiri diukur secara keseluruhan. UTC hari, berakhir pada tengah malam UTC terakhir sebelum email dikirim. Di situs yang jauh dari UTC, rentang waktu yang dicakup diimbangi dari hari lokal Anda.

Irama dan pengaturan waktu

• Mingguan – Pilih hari dalam seminggu (Minggu hingga Sabtu) dan jam pengiriman email.
• Bulanan – Pilih tanggal dalam bulan (maksimal tanggal 28 agar email selalu terkirim, bahkan di bulan Februari) dan jamnya.
• Jadwal pengiriman mengikuti Anda. zona waktu situs (WordPress → Pengaturan → Umum), dan halaman pengaturan menampilkan yang terbaru tepat di sebelah pemilih Jam. Jendela pelaporan itu sendiri masih diukur dalam hari UTC.

Penerima

Satu alamat email per baris. Biarkan kolom kosong dan ringkasan akan kembali ke default. email admin situs pada saat pengiriman. Itu membantu jika email admin mungkin berubah di kemudian hari dan Anda ingin ringkasan email tersebut mengikutinya secara otomatis.

Itu Kirim email uji coba kepada saya sekarang. tombol memberikan ringkasan yang sama menggunakan milik Anda tersimpan pengaturan. Ada dua hal yang berbeda dari pengiriman terjadwal: subjeknya diberi awalan. [TEST], dan itu mengabaikan Lewati ringkasan kosong, Jadi, pengujian selama periode tenang tetap menghasilkan hasil, sementara ringkasan sebenarnya akan tetap diam. Tombol akan dinonaktifkan secara otomatis jika ada perubahan yang belum disimpan; simpan terlebih dahulu, lalu uji.

Opsi konten

• Lewati ringkasan kosong – jangan kirim email sama sekali jika total ringkasan untuk periode tersebut adalah nol. Pada formulir yang jarang dikunjungi, itu akan menghemat ringkasan kosong pada minggu-minggu yang sepi. Dengan Sembunyikan tanpa atribusi Selain itu, total tersebut mengabaikan entri "Tidak Ditetapkan" dan "Tidak Diketahui", sehingga periode yang hanya berisi entri tanpa atribut dianggap kosong dan dilewati.
• Bandingkan dengan periode sebelumnya – Tampilkan persentase perubahan dibandingkan periode yang sama sebelumnya di bagian atas email (minggu lalu dibandingkan minggu sebelumnya, bulan lalu dibandingkan bulan sebelumnya, dll.).
• Sembunyikan tanpa atribusi – Hilangkan nilai "Tidak Diatur" dan "Tidak Diketahui" dari tabel email agar fokus tetap pada sumber yang diatribusikan.

Tag gabungan

{pb_ref_source} – nilai yang tersimpan di kolom tersembunyi “Sumber” (secara default bernilai “Tidak Diketahui” jika kunjungan tidak dapat diklasifikasikan).

{pb_ref_params} – rangkaian lengkap parameter rujukan yang diambil (UTM dan variabel kueri lain yang kami simpan bersama).

{pb_ref_referrer} – URL perujuk untuk kunjungan tersebut. Ini adalah perujuk yang efektif, bukan nilai mentah dari browser. Ketika ID klik atau yang dikenali utm_source Saat mengidentifikasi platform, plugin menyimpan URL platform kanonik sebagai gantinya. Akibatnya, gclid catatan kunjungan https://www.google.com/ bahkan ketika klik berasal dari email. Catatan kunjungan domain yang sama dan tanpa perujuk Direct. Tidak adanya tag penggabungan akan menampilkan referer browser yang tidak diubah.

{pb_ref_utm_id} – utm_id.

{pb_ref_utm_source} – utm_source.

{pb_ref_utm_medium} – utm_medium.

{pb_ref_utm_campaign} – utm_campaign.

{pb_ref_utm_term} – utm_term.

{pb_ref_utm_content} – utm_content.

{pb_ref_clid} – ID klik pertama yang terdeteksi untuk kunjungan tersebut (gclid, fbclid, msclkid, dan ID klik platform lainnya).

{pb_ref_custom_source} – label kunjungan Anda sendiri, yang ditulis oleh pb_gforms_referral_tracking_source_label filter (lihat Hooks). Tag hanya ada jika filter tersebut memiliki callback yang terpasang. Plugin menyimpan Source yang terdeteksi secara terpisah dan tidak pernah mengubahnya.

Tag penggabungan sentuhan terakhir

Saat atribusi sentuhan terakhir diaktifkan, plugin menambahkan serangkaian paralel:

• {pb_ref_last_source}
• {pb_ref_last_referrer}
• {pb_ref_last_params}
• {pb_ref_last_clid}
• {pb_ref_last_utm_source}
• {pb_ref_last_utm_medium}
• {pb_ref_last_utm_campaign}
• {pb_ref_last_utm_term}
• {pb_ref_last_utm_content}
• {pb_ref_last_utm_id}
• {pb_ref_last_custom_source}

Masing-masing mencerminkan versi sentuhan pertamanya tetapi menyimpan sumber terbaru sebelum pengiriman. {pb_ref_last_custom_source} juga membutuhkan pb_gforms_referral_tracking_source_label filter, sama seperti versi sentuhan pertamanya.

Mengirim data ke Google Analytics

Pelacakan Sumber Rujukan tidak pernah menghubungi Google secara otomatis. Semua yang ditangkap tetap berada di entri Gravity Forms Anda. Jika Anda mengaktifkan pengaturan GA4, tag Google Anda sendiri yang akan mengirimkan peristiwa tersebut.

Sejak versi 1.6.0, Anda dapat memilih untuk ikut serta dalam event GA4. Aktifkan GA4 / Tag Manager di bawah Formulir → Pengaturan → Pelacakan Rujukan → Umum. Setelah konfirmasi, plugin akan mengirimkan event khusus bernama pb_referral_submit (ganti namanya di pengaturan yang sama) dengan parameter sumber, perujuk, ID klik, dan UTM, ditambah nilai sentuhan terakhir saat sentuhan terakhir diaktifkan. Validasi yang gagal tidak akan terkirim. Konfirmasi pengalihan dan ucapan terima kasih halaman memerlukan versi 1.7.1.

Periksa GA4 Realtime atau DebugView untuk event tersebut. Anda tidak memerlukan pemicu Tag Manager. Tag Google Anda sendiri yang melakukan pengiriman; plugin ini tidak pernah menghubungi Google.

Opsional: Anda juga dapat meneruskan tag gabungan pada string kueri konfirmasi Pengalihan (di bawah) jika Anda sudah melakukan konversi dari parameter kampanye pada URL terima kasih. Itu terpisah dari acara khusus.

Apa yang dibawa oleh acara tersebut

Kunci parameter sesuai dengan nama tag penggabungan. Nilai kosong dihilangkan sepenuhnya dari muatan data, dan peristiwa ini dipicu paling banyak satu kali per tampilan halaman.

Opsional: kirimkan nilai pada URL terima kasih

1. Buka konfirmasi formulir Anda di bawah ini Formulir → [formulir Anda] → Pengaturan → Konfirmasi, lalu edit (atau tambahkan) sebuah Pengalihan konfirmasi.
2. Di dalam URL Pengalihan Pada kolom ini, masukkan URL halaman terima kasih Anda diikuti dengan string kueri yang dibuat dari tag gabungan pelacakan:

https://yoursite.com/thank-you/?gclid={pb_ref_clid}&utm_source={pb_ref_utm_source}&utm_medium={pb_ref_utm_medium}&utm_campaign={pb_ref_utm_campaign}&utm_term={pb_ref_utm_term}&utm_content={pb_ref_utm_content}

Gravity Forms mengisi dan mengkodekan setiap nilai menjadi URL pada saat pengiriman, sehingga pengunjung yang datang dari klik Google Ads akan diarahkan ke URL seperti:

https://yoursite.com/thank-you/?gclid=EAIaIQ...&utm_source=google&utm_medium=cpc&utm_campaign=spring-sale

Pengaturan GA4 atau Google Tag Manager Anda di halaman terima kasih kemudian membaca parameter tersebut dengan cara yang sama seperti menangani URL kampanye lainnya, memicu konversi atau peristiwa prospek Anda dengan sumber, kampanye, dan ID klik yang terekam. Nilai yang tidak terekam untuk kunjungan tertentu akan muncul kosong.

Anda dapat menggunakan salah satu tag gabungan pelacakan di sini. Lihat Tag gabungan untuk daftar lengkapnya. (Jika Anda lebih suka, Meneruskan Data Bidang melalui String Kueri (Opsi pada konfirmasi Pengalihan yang sama menerima tag gabungan yang sama ini.)

Mengapa menggunakan tag gabungan (merge tags) alih-alih kolom tersembunyi (hidden fields) Anda sendiri?

Jika Anda sudah mengirimkan data kampanye ke halaman terima kasih Anda dari kolom tersembunyi Anda sendiri, arahkan string kueri ke tag gabungan kami sebagai gantinya. Baik nilai yang disimpan pada entri maupun nilai yang dikirim ke GA4 kemudian berasal dari sumber yang sama, sehingga keduanya tidak dapat berbeda. Entri dan GA4 selalu menampilkan kampanye yang sama. Ini juga berarti satu set kolom yang lebih sedikit untuk dikelola.

Catatan tentang ID klik

{pb_ref_clid} menyimpan ID klik pertama yang terdeteksi pada kunjungan tersebut, dari platform mana pun asalnya: gclid untuk Google, tetapi juga msclkid (Microsoft), fbclid (Meta), dan lainnya. Jika Anda memetakannya secara khusus ke gclid= Sebagai parameter untuk Google Ads, kunjungan non-Google akan menempatkan ID kliknya di slot tersebut. Jika Anda hanya ingin ID klik disertakan pada kunjungan Google Ads, tambahkan logika bersyarat ke konfirmasi sehingga... gclid= parameter hanya dikirim ketika Sumber adalah Google Ads.

Memverifikasi bahwa itu berfungsi

Anda dapat memverifikasi seluruh rangkaian dalam empat langkah:

1. Tambahkan parameter pengujian ke URL halaman arahan mana pun (misalnya, ?gclid=TEST123&utm_source=google&utm_medium=cpc), lalu kirimkan formulirnya.
2. Di halaman terima kasih, periksa bilah alamat: nilai-nilai Anda seharusnya ada di URL.
3. Buka alat pengembang browser Anda, lalu masuk ke Jaringan tab, dan filter untuk collect. Permintaan ke Google harus menyertakan informasi Anda. gclid dan utm nilai-nilai.
4. Konfirmasi penerimaan di GA4. Tampilan Debug atau Waktu nyata laporan.

Uji coba di jendela pribadi atau saat Anda tidak masuk. Saat Anda masuk sebagai administrator, plugin sengaja berjalan dalam mode sesi saja, menulis cookie tanpa masa berlaku, sehingga jendela atribusi tidak dapat direproduksi dari sesi admin.

Keempat langkah tersebut memeriksa metode query-string opsional. Untuk event kustom bawaan, kirim formulir, lalu di halaman konfirmasi atau terima kasih, buka DevTools → Jaringan, filter untuk g/collect, dan carilah en=pb_referral_submit (atau nama acara Anda). Atau gunakan GA4 DebugView. Jika acara tersebut ada di tab Jaringan tetapi tidak ada di GA4, celah tersebut adalah tag Google Anda. Jika tidak ada di tab Jaringan, plugin tidak aktif.

Mengirimkan acara tersebut ke GA4

Sejak versi 1.6.0, Anda dapat mengirimkan sumber yang sudah ada di entri Gravity Forms ke GA4 sebagai event kustom. Secara default, fitur ini dinonaktifkan. Tag Google Anda sendiri yang melakukan pengiriman – plugin tidak pernah menghubungi Google secara langsung. Periksa GA4 Realtime atau DebugView untuk event tersebut. Anda tidak memerlukan pemicu Tag Manager.

Pergi ke Formulir → Pengaturan → Pelacakan Rujukan → Umum. Centang Kirim parameter yang diambil ke GA4 sebagai event khusus saat konfirmasi formulir.. Biarkan nama acara tetap seperti semula. pb_referral_submit kecuali jika Anda memiliki alasan untuk mengubahnya, maka klik Simpan Perubahan.

Terjemahan

Plugin ini siap diterjemahkan dan menyertakan terjemahan bawaan untuk:

1. Bahasa Arab (ar)
2. Bahasa Bengali (bn_BD)
3. Filipina (fil)
4. Jerman (de_DE)
5. Bahasa Spanyol (es_ES)
6. Bahasa Spanyol (es_MX)
7. Bahasa Prancis (fr_FR)
8. Bahasa Hindi (hi_IN)
9. Bahasa Indonesia (id_ID)
10. Bahasa Italia (it_IT)
11. Bahasa Jepang (ja)
12. Bahasa Portugis (pt_BR)
13. Rusia (ru_RU)
14. Bahasa Urdu (ur)
15. Bahasa Mandarin Sederhana (zh_CN)
16. Tradisional Cina (zh_HK)

Bahasa default: Inggris (en_US)

Jika bahasa Anda tidak tercantum di bawah Terjemahan Di atas, Anda masih dapat menerjemahkan plugin tersebut sendiri. Plugin ini siap diterjemahkan. Gunakan versi gratisnya. Plugin Loco Translate untuk membuat terjemahan untuk bahasa/lokal situs Anda. Baru mengenal Loco Translate? Berikut caranya tutorial yang ramah bagi pemula.

FAQ

Bisakah saya mengekspor datanya?

Ya. Nilai pelacakan disimpan di setiap entri Gravity Forms, sehingga muncul dalam ekspor entri.

Apa sebenarnya yang ditangkap oleh plugin ini?

Kami mencatat kolom atribusi umum dan menyimpannya pada entri Gravity Forms. Itu 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 dari mana setiap prospek berasal.

Bisakah saya menambahkan sumber kustom?

Ya. Tambahkan aturan di bawah ini. Formulir → Pengaturan → Pelacakan Rujukan → Sumber Kustom untuk memberi label pada situs mitra, lalu lintas afiliasi, kampanye bermerek, dan kunjungan serupa berdasarkan nama. Setiap aturan mencocokkan host perujuk atau parameter UTM dan menerapkan Label yang Anda pilih. Lihat Sumber kustom bagian untuk panduan lapangan demi lapangan dan contoh soal yang telah dikerjakan.

Add-on CRM/email/webhook saya tidak melihat kolom pelacakan di menu dropdown pemetaannya. Apa yang harus saya lakukan?

Kolom pelacakan kami ditambahkan ke formulir Anda secara dinamis pada saat rendering, bukan disimpan ke daftar kolom formulir, sehingga add-on yang membuat dropdown hanya dari kolom yang tersimpan tidak dapat melihatnya. Anda memiliki dua pilihan. Jika add-on Anda memiliki pemetaan “Nilai Kustom”, petakan tag gabungan kami secara langsung ({pb_ref_source}, {pb_ref_utm_source}, {pb_ref_clid}, dan seterusnya). Jika hanya mendukung dropdown kolom, buka Pengaturan Formulir → Opsi Formulir → Cermin kolom dan klik Tambahkan bidang cermin. Ini menambahkan kolom Tersembunyi yang terlihat oleh editor, dan plugin akan mengisinya. Lihat bagian Kolom Cermin untuk panduan lengkapnya.

Di mana data rujukan disimpan?

Di dalam basis data WordPress Anda, di dalam entri Gravity Forms Anda. Plugin ini tidak pernah mengirimkannya ke mana pun secara otomatis. Jika Anda menginginkan nilai yang ditangkap di GA4, aktifkan pengaturan GA4. Plugin tetap menjadi sumber data; tag Google Anda sendiri yang melakukan pengiriman.

Apakah ini atribusi sentuhan pertama atau sentuhan terakhir?

Keduanya. Secara default, ia menggunakan atribusi sentuhan pertama, menyimpan perujuk asli dan parameter kampanye yang pertama kali membawa pengunjung ke situs Anda (dalam jendela atribusi). Terdapat kotak centang untuk mengabaikan kunjungan kembali langsung sehingga sentuhan terakhir menyimpan iklan atau rujukan sebelumnya. ID klik kunjungan kembali hanya disimpan di ID Klik (Sentuhan terakhir). Itu memberi Anda serangkaian paralel {pb_ref_last_*} Tag penggabungan, kolom daftar entri, dan kolom ekspor CSV. Tab Laporan menyertakan tombol Pertama/Terakhir yang mengalihkan setiap bagan antara dua tampilan.

Berapa lama data atribusi pengunjung diingat?

Jendela atribusi default adalah 7 hari, dan Anda dapat mengubahnya di bawah Formulir → Pengaturan → Pelacakan Rujukan. Jika pengunjung mengirimkan formulir dalam jendela tersebut pada kunjungan pertama mereka yang dilacak, entri tersebut akan membawa nilai atribusi sentuhan pertama yang asli.

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 (minify atau deferral), centang Lindungi Skrip dari Pengoptimalan Di bawah Formulir → Pengaturan → Pelacakan Rujukan → Lanjutan, lalu bersihkan cache Anda. Ini menandai skrip plugin sehingga dilewati, dan menambahkannya ke daftar pengecualian WP Rocket, LiteSpeed Cache, SG Optimizer, Autoptimize, dan Cloudflare Rocket Loader secara otomatis. Jika Anda menggunakan Breeze atau minifier lain yang tidak ada dalam daftar tersebut, kecualikan kedua file di bawah ini secara manual dan bersihkan cache CDN untuk file tersebut setelah pembaruan.

Untuk pengoptimal apa pun yang tidak tercakup oleh pengaturan tersebut, kecualikan kedua file ini secara manual dan uji pengiriman:

• /wp-content/plugins/pb-gforms-referral-tracking/assets/js/front-end.js
• /wp-content/plugins/pb-gforms-referral-tracking/assets/dist/js.cookie.min.js

Apakah ini berfungsi dengan Gravity Forms yang mendukung AJAX?

Ya. Ini berfungsi dengan formulir AJAX dan pengiriman standar (non-AJAX). Pengalihan dan konfirmasi ucapan terima kasih halaman pada Gravity Forms 2.9+ memerlukan versi 1.7.1 untuk acara GA4.

Bisakah saya melacak lebih dari satu formulir?

Ya. Ini berfungsi di semua Gravity Forms Anda. Setiap pengajuan menyimpan nilai atribusi masing-masing ke entri tersebut.

Apakah ini menggantikan pelacakan konversi GA4 / Google Ads?

Tidak. Ini adalah sumber data, bukan piksel konversi, dan tidak pernah mengaktifkan piksel atau menghubungi Google secara langsung. Jika Anda menginginkan atribusi di dalam GA4, pengaturan GA4/Tag Manager yang bersifat opsional akan mengirimkannya sebagai event khusus melalui tag Google Anda sendiri saat konfirmasi formulir.

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?

Jika Anda memerlukan persetujuan sebelum data atribusi apa pun diambil, aktifkan gerbang persetujuan opsional. Gerbang ini menyimpan data sentuhan pertama di browser hingga pengunjung memberikan persetujuan melalui banner cookie Anda (melalui flag jendela, callback, atau event), lalu menerapkannya.

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 tidak aktif di sub-situs tersebut. Tidak ada kolom pelacakan, tag gabungan, atau data entri yang diambil sampai kunci diaktifkan di sana, atau Mode Jaringan mengirimkannya.
• Dukungan mengikuti lisensi: Situs-situs yang tercakup oleh kunci aktif memenuhi syarat.

Ya, setelah setiap sub-situs dilisensikan dan diaktifkan. Mengaktifkan plugin di seluruh jaringan akan menginstalnya di mana saja dan pembaruan akan ditangani di seluruh jaringan, tetapi sub-situs memerlukan lisensi aktifnya sendiri (atau kunci Unlimited yang dikirimkan melalui Mode Jaringan) sebelum plugin menambahkan bidang pelacakan atau menangkap nilai apa pun. Setelah itu, aktifkan opsi Aktifkan secara Default di sana, atau aktifkan pelacakan per formulir.

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.

Referensi pengaturan

Segala sesuatu di bawah ini hidup di bawahnya Formulir → Pengaturan → Pelacakan Rujukan, pada tab yang disebutkan di setiap judul.

Data & Privasi

Lanjutan

Gerbang persetujuan

Tidak ada kotak centang untuk yang ini. Gerbang persetujuan adalah pilihan pengembang: atur consentRequired melalui pb_gforms_referral_tracking_js_config filter. Skrip pelacakan menyimpan data sentuhan pertama di sessionStorage sampai persetujuan diperoleh, kemudian dipindahkan ke penyimpanan permanen.

add_filter( 'pb_gforms_referral_tracking_js_config', function( $config ) {
    $config['consentRequired'] = true;
    return $config;
} );

Berikan persetujuan Anda melalui banner cookie dengan salah satu dari tiga cara berikut yang sesuai:

• Mengatur window.PBReferralTrackingConsent = true.
• Kirimkan acara tersebut: window.dispatchEvent( new Event( 'pb-ref-tracking:consent-granted' ) ).
• Tetapkan consentGranted Fungsi callback yang mengembalikan nilai true setelah persetujuan diperoleh.

Kait

Tindakan

pb_gforms_referral_tracking_loaded

Dipicu setelah plugin sepenuhnya diinisialisasi: kelas dimuat, hook terdaftar, API siap. Ini adalah titik awal yang andal untuk add-on atau plugin pendamping yang memperluas Referral Source Tracking.

Parameter:

• $plugin (Plugin) – Instans plugin.

add_action( 'pb_gforms_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_gforms_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 (array|null) – Meta array formulir, atau null jika tidak tersedia.

// Disable tracking on a specific form (e.g. an internal staff-only form).
add_filter( 'pb_gforms_referral_tracking_enabled', function( $enabled, $form_id, $form ) {
    $excluded_form_ids = [ 12, 27 ];
    if ( in_array( $form_id, $excluded_form_ids, true ) ) {
        return false;
    }
    return $enabled;
}, 10, 3 );

pb_gforms_referral_tracking_field_definitions

Saring array definisi kolom pelacakan tersembunyi sebelum plugin menyuntikkannya ke dalam formulir. Gunakan ini untuk menambahkan, menghapus, atau memodifikasi setiap kolom pelacakan.

Parameter:

• $fields (array) – Array dari array definisi field.
• $form (array) – Bentuk meta saat ini.

// Remove the Referral Parameters field from all forms.
add_filter( 'pb_gforms_referral_tracking_field_definitions', function( $fields, $form ) {
    return array_filter( $fields, function( $field ) {
        return ! isset( $field['cssClass'] ) || $field['cssClass'] !== 'pb-ref-tracking-ref-params';
    } );
}, 10, 2 );

pb_gforms_referral_tracking_form

Saring seluruh array formulir setelah plugin menambahkan semua kolom pelacakannya. Objek formulir akhir dapat Anda ubah sebelum ditampilkan.

Parameter:

• $form (array) – Formulir array dengan kolom pelacakan yang sudah ditambahkan.
• $field_definitions (array) – Definisi bidang yang digunakan.

// Log which forms have tracking fields injected (useful for debugging).
add_filter( 'pb_gforms_referral_tracking_form', function( $form, $field_definitions ) {
    error_log( 'Referral tracking fields added to form ID: ' . $form['id'] );
    return $form;
}, 10, 2 );

pb_gforms_referral_tracking_merge_tag_map

Ubah peta tag gabungan yang menentukan tag gabungan mana yang tersedia dan ID bidang mana yang dituju. Gunakan ini untuk menambahkan tag gabungan yang sepenuhnya kustom atau mengganti nama tag gabungan yang sudah ada.

Parameter:

• $map (array) – Array asosiatif tag => [ 'label' => string, 'field_id' => string ].
• $base_id (rangkaian) – Awalan ID bidang dasar.
• $constants (Konstanta) – Instance konstanta plugin.

// Rename the "Source" merge tag label as it appears in the GF dropdown.
add_filter( 'pb_gforms_referral_tracking_merge_tag_map', function( $map, $base_id, $constants ) {
    if ( isset( $map['pb_ref_source'] ) ) {
        $map['pb_ref_source']['label'] = 'Traffic Source';
    }
    return $map;
}, 10, 3 );

pb_gforms_referral_tracking_value

Saring nilai bidang pelacakan mentah sebelum plugin memformatnya dan menggunakannya untuk mengganti tag gabungan dalam pemberitahuan atau konfirmasi. Di sinilah Anda dapat membersihkan atau mengubah nilai tertentu.

Parameter:

• $value (rangkaian) – Nilai mentah kolom tersebut.
• $tag (rangkaian) – Kunci tag penggabungan (misalnya pb_ref_source).
• $data (array) – Metadata tag gabungan (label, field_id).
• $entry (array) – Entri saat ini.
• $form (array) – Bentuk saat ini.

// Truncate long referrer URLs in merge tag output.
add_filter( 'pb_gforms_referral_tracking_value', function( $value, $tag, $data, $entry, $form ) {
    if ( $tag === 'pb_ref_referrer' && strlen( $value ) > 100 ) {
        return substr( $value, 0, 100 ) . '…';
    }
    return $value;
}, 10, 5 );

pb_gforms_referral_tracking_formatted_value

Saring nilai tag gabungan yang telah diformat sepenuhnya setelah Gravity Forms menjalankan alur pemformatannya sendiri (pengkodean escape, pengkodean URL, dll.).

Parameter:

• $formatted (rangkaian) – String keluaran yang diformat.
• $tag (rangkaian) – Kunci tag penggabungan.
• $data (array) – Metadata tag penggabungan.
• $entry (array) – Entri saat ini.
• $form (array) – Bentuk saat ini.
• $url_encode (bool)
• $esc_html (bool)
• $nl2br (bool)
• $format (rangkaian)

// Wrap the source value in a bold tag in HTML-format notifications.
add_filter( 'pb_gforms_referral_tracking_formatted_value', function( $formatted, $tag, $data, $entry, $form, $url_encode, $esc_html, $nl2br, $format ) {
    if ( $tag === 'pb_ref_source' && $format === 'html' && ! $url_encode ) {
        return '<strong>' . $formatted . '</strong>';
    }
    return $formatted;
}, 10, 9 );

pb_gforms_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) – Kunci konteks: sumber, perujuk, atau front_end.

// Use "Direct" instead of "Unknown" for the source field fallback.
add_filter( 'pb_gforms_referral_tracking_default_value', function( $default, $key ) {
    if ( $key === 'source' ) {
        return 'Direct';
    }
    return $default;
}, 10, 2 );

pb_gforms_referral_tracking_js_config

Timpa seluruh objek konfigurasi JavaScript front-end sebelum plugin meneruskannya ke skrip pelacakan. Callback Anda mengontrol pengaturan cookie, peta sumber (utmSourceMap dan utmReferrerMap), sumber yang diketahui, dan paidClickIds Daftar yang menentukan parameter kueri mana yang membuktikan klik berbayar.

Parameter:

• $config (array) – Array konfigurasi JS lengkap.

Tombol-tombolnya, beserta nilai default-nya:

sourcePatterns sengaja tidak dimasukkan dalam daftar tersebut. Entri-entrinya memerlukan JavaScript aktif. RegExp objek, dan apa pun yang dikembalikan oleh callback PHP akan tiba sebagai string setelah konfigurasi dienkode JSON, yang akan menimbulkan kesalahan pada saat pencocokan. Untuk memperluas pola referrer, tetapkan ke window.PBReferralTrackingConfig dari JavaScript sebelum skrip pelacakan dijalankan.

// Extend cookie lifetime to 30 days and add a custom paid medium.
add_filter( 'pb_gforms_referral_tracking_js_config', function( $config ) {
    // Extend the first-touch attribution window to 30 days.
    $config['cookieExpiry'] = 30;

    // Turn on the cookieless localStorage fallback for visitors who block cookies.
    $config['fallbackStorage'] = 'local';

    return $config;
} );

pb_gforms_referral_tracking_custom_sources

Secara terprogram, plugin ini menyuntikkan aturan sumber kustom yang berjalan bersamaan dengan aturan yang dikonfigurasi di UI admin. Plugin ini menggabungkan aturan dari filter ini dengan aturan UI yang tersimpan, mengurutkan kumpulan gabungan berdasarkan prioritas, dan meneruskannya ke front-end.

Parameter:

• $sources (array) – Array kosong. Mengembalikan array berisi array aturan yang akan ditambahkan.

Setiap aturan harus memiliki: label, matchField (referrer, utm_source, utm_medium, utm_campaign, utm_term, utm_content), matchType (contains atau equals), matchValue, dan opsional priority (default 10, nilai lebih tinggi dijalankan terlebih dahulu).

Aturan yang ditambahkan melalui filter ini juga dapat digunakan referrer_url seperti matchField, yang mencocokkan URL referrer lengkap termasuk path dan query-nya, bukan hanya host-nya. UI admin tidak menawarkannya, jadi hanya tersedia di sini.

// Add partner and affiliate sources without touching the admin UI.
add_filter( 'pb_gforms_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_gforms_referral_tracking_source_label

Tulis label Anda sendiri ke dalam kolom Sumber Kustom terpisah pada saat pengiriman. Sumber yang terdeteksi tidak pernah diubah, sehingga entri tersebut menyimpan keduanya: apa yang dihitung oleh plugin, dan apa yang Anda kembalikan. Berguna ketika CRM membutuhkan label yang disederhanakan atau internal dan Anda tidak ingin kehilangan sumber aslinya. Sejak versi 1.6.0.

Menambahkan fungsi callback adalah cara untuk mengaktifkan fitur ini. Tanpa fungsi yang terhubung, kolom Sumber Kustom dan tag penggabungannya tidak ada. Tambahkan satu fungsi callback dan plugin akan mulai menambahkan kolom Sumber Kustom ke formulir Anda, ditambah kolom Sumber Kustom (Sentuhan terakhir) ketika atribusi sentuhan terakhir diaktifkan. Kembalikan string kosong untuk membiarkan kolom kosong untuk kunjungan tertentu; ini tidak akan kembali ke label yang terdeteksi.

Parameter:

• $label (rangkaian) – Label sumber yang terdeteksi, misalnya Google Ads.
• $key (rangkaian) – Sentuhan mana yang diberi label: source atau last_source.
• $form (array) – Objek formulir saat ini.

// Roll the detected source up into a few buckets for the CRM.
add_filter( 'pb_gforms_referral_tracking_source_label', function( $label, $key, $form ) {
    if ( 0 === strpos( $label, 'Google' ) || 0 === strpos( $label, 'Bing' ) ) {
        return 'Search';
    }
    if ( 0 === strpos( $label, 'Facebook' ) || 0 === strpos( $label, 'Instagram' ) ) {
        return 'Social';
    }

    // Anything else: leave the Custom Source field empty.
    return '';
}, 10, 3 );

pb_gforms_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. Nilai default adalah true.

// Disable tracking assets on the homepage only.
add_filter( 'pb_gforms_referral_tracking_enqueue_assets', function( $enqueue ) {
    if ( is_front_page() ) {
        return false;
    }
    return $enqueue;
} );

pb_gforms_referral_tracking_inline_css

Timpa CSS inline yang menyembunyikan kolom pelacakan di bagian depan dan pratinjau editor blok. CSS default menyembunyikan pelacakan, pelacak Google Ads lama, dan pembungkus kolom mirror, serta penargetan. .gform_wrapper .gfield dengan awalan kelas pb-ref-tracking-, pb-gads-tracking-, dan pb-ref-mirror-.

Parameter:

• $css (rangkaian) – String CSS inline.

// Replace the default hide rule with a more specific selector.
add_filter( 'pb_gforms_referral_tracking_inline_css', function( $css ) {
    return '.my-theme .gform_wrapper .gfield[class*="pb-ref-tracking-"] { display: none !important; }';
} );

pb_gforms_rt_invalidate_debounce

Sesuaikan (atau nonaktifkan) jendela penundaan pembatalan cache Laporan. Setelah entri baru masuk, cache Laporan akan dibangun ulang paling banyak sekali setiap sekian detik agar formulir bervolume tinggi tidak membebani cache. Nilai default adalah 60 detik; kembalikan 0 untuk membatalkan cache segera pada setiap entri.

Parameter:

• $seconds (int) – Jendela penundaan (debounce) dalam detik. Default 60.

// Rebuild Reports data immediately on every new entry (no debounce).
add_filter( 'pb_gforms_rt_invalidate_debounce', function( $seconds ) {
    return 0;
} );

pb_gforms_referral_tracking_mirror_field_definitions

Sesuaikan definisi bidang cermin persisten yang dibuat saat bidang cermin ditambahkan ke formulir. label Ini adalah bagian yang dapat Anda ganti dengan aman.

Meninggalkan cssClass sendirian. Saat pengajuan, plugin membaca kembali kunci pelacakan kanonik darinya, semua yang ada setelahnya. pb-ref-mirror-, untuk menemukan nilai yang akan disalin. Ganti nama kelas dan kolom cermin akan selalu kosong.

Parameter:

• $fields (array) – Susunan array definisi bidang cermin.
• $form (array) – Bentuk meta saat ini.

// Prefix every mirror field label so they're easy to spot in the editor.
add_filter( 'pb_gforms_referral_tracking_mirror_field_definitions', function( $fields, $form ) {
    foreach ( $fields as &$field ) {
        $field['label'] = 'Tracking: ' . $field['label'];
    }
    return $fields;
}, 10, 2 );

pb_gforms_referral_tracking_docs_url

Arahkan ulang tautan “Pelajari selengkapnya di dokumentasi” yang ditampilkan di layar pengaturan. Berguna pada instalasi white-label atau agensi yang menyimpan dokumentasi mereka sendiri.

Parameter:

• $url (rangkaian) – URL dokumentasi. Masukkan URL Anda sendiri untuk menggantinya.

// Point the settings-screen docs link at our own handbook.
add_filter( 'pb_gforms_referral_tracking_docs_url', function( $url ) {
    return 'https://example.com/handbook/referral-tracking/';
} );