دستاویزات
پلگ ان کو کیسے فعال کریں؟
WPForms کے لیے ریفرل سورس ٹریکنگ خریدنے کے بعد، آپ کو اپنی ورڈپریس ویب سائٹ پر پلگ ان انسٹال کرنے کی ضرورت ہوگی۔ آئیے اس عمل سے گزرتے ہیں۔.
مرحلہ 1: تنصیب
اپنی ورڈپریس ویب سائٹ پر لاگ ان کریں اور پلگ انز (Plugins) > پلگ ان شامل کریں (Add Plugin) > پلگ ان اپ لوڈ کریں (Upload Plugin) پر جائیں، زپ فائل انسٹال کریں اور اسے ایکٹیویٹ کریں۔.
مرحلہ 2: پلگ ان کو رجسٹر کریں۔
بائیں جانب نیویگیشن پر، WPForms > ریفرل ٹریکنگ پر جائیں۔.
اپنی لائسنس کی کلید درج کریں اور اسے چالو کریں۔.
مرحلہ 3: فیچر کو فعال کریں۔
آپ کے لائسنس کو چالو کرنے کے بعد، ریفرل ٹریکنگ سیٹنگز کے صفحہ میں ایک "جنرل" ٹیب ظاہر ہوگا، اس پر کلک کریں اور "تبدیلیاں محفوظ کریں" پر کلک کریں۔.
بس! اب ریفرل سورس ٹریکنگ آپ کی تخلیق کردہ کسی بھی موجودہ فارم یا نئی شکلوں پر فعال ہوگی۔.
خصوصیت کی تفصیلات
ذرائع کا پتہ لگاتا ہے۔
ہم ریفرر یو آر ایل کیپچر کرتے ہیں جب کوئی دستیاب ہوتا ہے۔ اور اسے اندراج پر محفوظ کریں۔ ہم عام پلیٹ فارمز کے لیے دوستانہ لیبل بھی لگاتے ہیں تاکہ ماخذ کو ایک نظر میں سمجھنا آسان ہو۔.
یہاں ان ذرائع کی فہرست ہے جن کا پتہ لگانے پر لیبل لگایا جاتا ہے:
- گوگل: گوگل اشتہارات، گوگل آرگینک، جیمنی۔
- مائیکروسافٹ/بنگ: مائیکروسافٹ اشتہارات، بنگ آرگینک
- فیس بک: فیس بک اشتہارات، فیس بک آرگینک
- LinkedIn: لنکڈ ان اشتہارات، لنکڈ ان آرگینک
- ایکس (ٹویٹر): X اشتہارات، X نامیاتی
- Reddit: Reddit اشتہارات، Reddit نامیاتی
- TikTok: TikTok اشتہارات، TikTok Organic
- Pinterest: Pinterest اشتہارات، Pinterest نامیاتی
- سنیپ چیٹ: اسنیپ چیٹ اشتہارات، اسنیپ چیٹ آرگینک
- دوسرے سرچ انجن: Yahoo، DuckDuckGo، Yandex
- AI معاونین (جب دستیاب ہوں): ChatGPT، Perplexity، Microsoft Copilot، Claude، Grok، DeepSeek
- ای میل پلیٹ فارمز (مہم سے باخبر رہنا): Mailchimp، مسلسل رابطہ، Salesforce Pardot، HubSpot
- براہ راست اور نامعلوم مناسب ہونے پر استعمال کیا جاتا ہے۔.
- حسب ضرورت ذرائع بھی شامل کیے جا سکتے ہیں!
UTM پیرامیٹرز یہ پکڑتا ہے۔
utm_sourceutm_mediumutm_campaignutm_termutm_contentutm_id
کیپچر کردہ IDs پر کلک کریں۔
gclidgbraidwbraidmsclkidli_fat_idrdt_cidttclidpin_cidsnap_cidmc_cidmc_eiddclid
اسمارٹ ٹیگز
{pb_ref_source} - دریافت شدہ حوالہ کے ذریعہ کا لیبل (جب وزٹ کی درجہ بندی نہیں کی جا سکتی تھی تو "نامعلوم" پر طے شدہ)۔.
{pb_ref_params} - کیپچرڈ ریفرل پیرامیٹرز کی پوری اسٹرنگ (UTMs اور دیگر استفسارات ایک ساتھ رکھے گئے)۔.
{pb_ref_referrer} - براؤزر ریفرر جو وزیٹر کو سائٹ پر لے آیا۔.
{pb_ref_utm_id} - قبضہ کر لیا utm_id.
{pb_ref_utm_source} - قبضہ کر لیا یو ٹی ایم ماخذ.
{pb_ref_utm_medium} - قبضہ کر لیا یو ٹی ایم میڈیم.
{pb_ref_utm_campaign} - قبضہ کر لیا یو ٹی ایم مہم.
{pb_ref_utm_term} - قبضہ کر لیا یو ٹی ایم ٹرم.
{pb_ref_utm_content} - قبضہ کر لیا یو ٹی ایم کونٹینٹ.
{pb_ref_clid} -پہلی شناخت شدہ کلک ID (gclid, fbclid, msclkid، وغیرہ)۔.
ترجمے
یہ پلگ ان مکمل طور پر ترجمہ کے لیے تیار ہے۔ آپ مفت کا استعمال کرتے ہوئے اسے کسی بھی زبان میں ترجمہ کر سکتے ہیں۔ لوکو ترجمہ پلگ ان یا کوئی دوسرا ورڈپریس ترجمہ ٹول۔.
پہلے سے طے شدہ زبان: انگریزی (en_US)
اکثر پوچھے گئے سوالات
کیا یہ WPForms Lite کے ساتھ کام کرتا ہے؟
جی ہاں ریفرل ٹریکنگ کیپچر اور اسمارٹ ٹیگ پروسیسنگ کے ساتھ کام کرتے ہیں۔ WPForms لائٹ. تاہم، WPForms Lite میں پرو کے مقابلے محدود اندراج کا انتظام UI ہے - اندراج کی فہرست کے کالم، سنگل انٹری ریفرل ٹریکنگ سائڈبار، اور CSV ایکسپورٹ انٹیگریشن کے لیے WPForms Pro کی ضرورت ہوتی ہے۔.
کیا میں ڈیٹا ایکسپورٹ کر سکتا ہوں؟
جی ہاں ٹریکنگ کی قدریں WPForms CSV برآمدات میں شامل ہیں۔ تمام ریفرل فیلڈز (ذریعہ، ریفرر، UTMs، کلک ID، اور مزید) خود بخود ایکسپورٹ کالم کے طور پر شامل ہو جاتے ہیں۔.
پلگ ان بالکل کیا پکڑتا ہے؟
ہم عام انتساب کے شعبوں پر قبضہ کرتے ہیں اور انہیں ہر WPForms اندراج کے ساتھ ذخیرہ کرتے ہیں، بشمول UTM پیرامیٹرز (ذریعہ، درمیانہ، مہم، اصطلاح، مواد), IDs پر کلک کریں۔ (gclid، msclkid، gbraid/wbraid، وغیرہ)، اصل حوالہ دینے والا URL, ، اور متعلقہ لینڈنگ پیج سیاق و سباق تاکہ آپ واضح طور پر دیکھ سکیں کہ ہر لیڈ کہاں سے آئی ہے۔.
کیا میں حسب ضرورت ذرائع شامل کر سکتا ہوں؟
جی ہاں! چاہے یہ ریفرل سائٹ ہو، ملحقہ شراکت داری وغیرہ، آپ واضح لیبلز کے ساتھ حسب ضرورت ذرائع شامل کر سکتے ہیں۔.
ریفرل ڈیٹا کہاں محفوظ ہے؟
WPForms اندراجات سے منسلک ایک وقف شدہ پلگ ان ٹیبل میں آپ کے ورڈپریس ڈیٹا بیس میں۔ ہم تبادلوں یا واقعات کو اشتہاری پلیٹ فارمز پر نہیں بھیجتے ہیں۔.
کیا یہ پہلا ٹچ ہے یا آخری ٹچ کا انتساب؟
یہ پلگ ان پر توجہ مرکوز کرتا ہے۔ پہلا ٹچ انتساب ذخیرہ کرکے اصل حوالہ دہندہ اور مہم کے پیرامیٹرز جو وزیٹر کو آپ کی سائٹ پر لائے (ریٹینشن ونڈو کے اندر)۔.
یہ وزیٹر کے انتساب ڈیٹا کو کتنی دیر تک یاد رکھتا ہے؟
برقرار رکھنے کی کھڑکی ہے۔ 7 دن. اگر کوئی وزیٹر اپنے پہلے ٹریک کردہ وزٹ کے 7 دنوں کے اندر فارم جمع کراتا ہے، تو اصل انتساب کی قدریں اندراج پر لاگو ہوں گی۔.
کیا یہ کیشنگ/CDNs کے ساتھ کام کرتا ہے؟
عام طور پر، ہاں۔ ٹریکنگ کلائنٹ کی طرف چلتا ہے، لہذا زیادہ تر کیشنگ/CDN سیٹ اپ ٹھیک کام کرتے ہیں۔ اگر آپ جارحانہ اسکرپٹ آپٹیمائزیشن (منفی/منفی) استعمال کرتے ہیں، تو ذیل میں پلگ ان اسکرپٹس کو خارج کریں اور جمع کرانے کی جانچ کریں:
/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
کیا یہ AJAX کے قابل WPForms کے ساتھ کام کرتا ہے؟
جی ہاں یہ AJAX فارمز (WPForms ڈیفالٹ) اور معیاری گذارشات کے ساتھ کام کرتا ہے۔.
کیا میں ایک سے زیادہ فارم کو ٹریک کر سکتا ہوں؟
جی ہاں یہ آپ کے تمام WPForms پر کام کرتا ہے — ہر جمع کرانے کی اپنی انتساب کی قدریں اس اندراج میں محفوظ ہوتی ہیں۔.
کیا یہ GA4 / Google Ads کنورژن ٹریکنگ کی جگہ لے لیتا ہے؟
نہیں، یہ پلگ ان پکسلز کو فائر نہیں کرتا ہے اور نہ ہی GA4 یا اشتہاری پلیٹ فارمز پر تبادلوں کے واقعات بھیجتا ہے۔ یہ انتساب کا ڈیٹا محفوظ کرتا ہے۔ WPForms اندراج کے اندر, ، تاکہ آپ کی ٹیم براہ راست ورڈپریس اور برآمدات میں لیڈ سورس ڈیٹا دیکھ سکے۔.
کیا یہ ذاتی ڈیٹا اکٹھا کرتا ہے؟
پہلے سے طے شدہ طور پر، یہ انتساب ڈیٹا (UTMs،, gclid, ، حوالہ دینے والے URLs)۔ یہ کرتا ہے نہیں بطور ڈیفالٹ اضافی PII کیپچر کریں۔ آپ کے فارم فیلڈز اور URLs میں شامل کوئی بھی پیرامیٹرز آپ کی سائٹ اور مارکیٹنگ سیٹ اپ کے ذریعے کنٹرول کیے جاتے ہیں۔.
کیا یہ GDPR/CCPA کے مطابق ہے؟
اسے GDPR/CCPA دوستانہ طریقے سے استعمال کیا جا سکتا ہے۔ پلگ ان آپ کے اندراجات کے ساتھ انتساب کا ڈیٹا اسٹور کرتا ہے اور ایونٹس کو اشتہاری پلیٹ فارمز پر منتقل نہیں کرتا ہے۔ آپ اپنے مخصوص سیٹ اپ کے لیے رضامندی/ جائز دلچسپی اور مناسب انکشاف کے ذمہ دار ہیں۔.
کیا یہ ورڈپریس ملٹی سائٹ نیٹ ورک کے ساتھ کام کرتا ہے؟
TL؛ DR
- لامحدود لائسنس: نیٹ ورک موڈ کو ایک بار فعال کریں۔ ایک کلید کا انتظام کر سکتے ہیں ہر سبسائٹ کی سیٹنگز + سپورٹ۔.
- نیٹ ورک فعال: تمام ذیلی سائٹیں ریفرل ٹریکنگ چلاتی ہیں اور فوراً اپ ڈیٹس وصول کرتی ہیں۔.
- محدود منصوبہ / کوئی سبسائٹ لائسنس نہیں: ٹریکنگ جاری رہتی ہے، لیکن سبسائٹ کی ترتیبات صرف پڑھنے کے لیے ہیں۔.
- سپورٹ لائسنس کی پیروی کرتا ہے: ایکٹیو کلید کے زیر احاطہ سائٹیں اہل ہیں۔.
ہاں؛ جیسے ہی آپ نیٹ ورک کو چالو کرتے ہیں پلگ ان ہر سبسائٹ پر باکس سے باہر ہو جاتا ہے۔- دستی سیٹ اپ کی ضرورت نہیں ہے۔ ہر سبسائٹ ٹریکنگ کا استعمال کر سکتی ہے اور مقامی لائسنس کے بغیر بھی اپ ڈیٹس حاصل کر سکتی ہے۔ فارم کی سطح کی ترتیبات کو تبدیل کرنے یا سبسائٹ پر براہ راست تعاون حاصل کرنے کے لیے، آپ کو اب بھی وہاں لائسنس کو فعال کرنے کی ضرورت ہے۔.
اگر آپ کے پاس لامحدود لائسنس ہے، تو آپ مرکزی سائٹ سے نیٹ ورک موڈ کو فعال کر سکتے ہیں اور اس ایک کلید کو ایک بیچ میں (لائیو پیشرفت کے ساتھ) ہر سبسائٹ پر دھکیل سکتے ہیں۔ وہ سبسائٹس لائسنس کے زیر انتظام سیٹنگز اور سپورٹ خود بخود وراثت میں ملتی ہیں۔.
کانٹے
اعمال
pb_wpforms_referral_tracking_loaded
پلگ ان کے مکمل طور پر شروع ہونے کے بعد آگ لگ جاتی ہے - تمام کلاسز بھری ہوئی ہیں، ہکس رجسٹرڈ ہیں، اور API تیار ہے۔ یہ ایڈ آنز یا ساتھی پلگ انز کے لیے قابل اعتماد بوٹ پوائنٹ ہے جو ریفرل سورس ٹریکنگ کو بڑھاتے ہیں۔.
پیرامیٹرز:
$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 );
}
} );فلٹرز
pb_wpforms_referral_tracking_enabled
اوور رائیڈ کریں کہ آیا ریفرل ٹریکنگ کسی مخصوص فارم کے لیے فعال ہے۔ فی فارم ٹوگل یا عالمی ڈیفالٹ سے قطع نظر، ٹریکنگ کو زبردستی آن کرنے کے لیے درست، اسے زبردستی بند کرنے کے لیے غلط پر واپس جائیں۔.
پیرامیٹرز:
$enabled(بول) - چاہے ٹریکنگ فی الحال فعال ہے۔.$form_id(int) - موجودہ فارم کی ID۔.$form_data(صفی | کالعدم) - فارم ڈیٹا اری، یا اگر دستیاب نہ ہو تو کالعدم۔.
استعمال کی مثال:
// 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
اسمارٹ ٹیگ کے نقشے میں ترمیم کریں جو اس بات کی وضاحت کرتا ہے کہ کون سے اسمارٹ ٹیگز دستیاب ہیں اور کون سے ٹریکنگ کیز کو وہ حل کرتے ہیں۔ اسے مکمل طور پر حسب ضرورت سمارٹ ٹیگز شامل کرنے یا موجودہوں کا نام تبدیل کرنے کے لیے استعمال کریں۔.
پیرامیٹرز:
$map(صفی) - ٹیگ کی ایسوسی ایٹیو صف => ٹریکنگ کلید (جیسے.'pb_ref_source' => 'source').
استعمال کی مثال:
// 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
نوٹیفکیشن یا تصدیق میں اسمارٹ ٹیگ کو تبدیل کرنے کے لیے استعمال ہونے سے پہلے خام ٹریکنگ ویلیو کو فلٹر کریں۔ مخصوص اقدار کو صاف کرنے یا تبدیل کرنے کے لیے مفید ہے۔.
پیرامیٹرز:
$value(تار) - خام ٹریکنگ قدر۔.$tag(تار) - اسمارٹ ٹیگ کلید (مثال کے طور پر.pb_ref_source).$form_data(صفی) - فارم ڈیٹا سرنی.$fields(صفی) - داخلے کے میدان۔.$entry_id(int) - اندراج کی شناخت۔.
استعمال کی مثال:
// 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
پروسیسنگ کے بعد مکمل فارمیٹ شدہ اسمارٹ ٹیگ ویلیو کو فلٹر کریں۔.
پیرامیٹرز:
$formatted(تار) - فارمیٹ شدہ آؤٹ پٹ سٹرنگ۔.$tag(تار) - اسمارٹ ٹیگ کلید۔.$form_data(صفی) - فارم ڈیٹا سرنی.$fields(صفی) - داخلے کے میدان۔.$entry_id(int) - اندراج کی شناخت۔.
// 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
جمع کرانے کے وقت ٹریکنگ فیلڈ خالی ہونے پر استعمال ہونے والی فال بیک قدر کو اوور رائیڈ کریں۔ پہلے سے طے شدہ "نامعلوم" ہے۔.
پیرامیٹرز:
$default(تار) - موجودہ ڈیفالٹ قدر ("نامعلوم")۔.$key(تار) - سیاق و سباق کی کلید:source,referrer, ، یاfront_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
پورے فرنٹ اینڈ جاوا اسکرپٹ کنفیگریشن آبجیکٹ کو ٹریکنگ اسکرپٹ میں منتقل کرنے سے پہلے اسے اوور رائیڈ کریں۔ یہ آپ کو کوکی کی ترتیبات، ماخذ کا پتہ لگانے کے نمونوں، معلوم ذرائع، ادا شدہ میڈیمز اور مزید پر مکمل کنٹرول فراہم کرتا ہے۔.
پیرامیٹرز:
$config(صفی) - مکمل JS کنفیگریشن سرنی۔.
// 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
پروگرامی طور پر حسب ضرورت ماخذ کے اصولوں کو انجیکٹ کریں جو منتظم UI میں ترتیب کردہ قواعد کے ساتھ چلتے ہیں۔ اس فلٹر کے قواعد کو محفوظ کردہ UI قواعد کے ساتھ ضم کیا جاتا ہے اور فرنٹ اینڈ پر منتقل کرنے سے پہلے ترجیح کے مطابق ترتیب دیا جاتا ہے۔.
پیرامیٹرز:
$sources(صفی) - خالی صف۔ شامل کرنے کے لیے اصولی صفوں کی ایک صف واپس کریں۔.
ہر ایک اصول پر ہونا ضروری ہے: label, matchField (referrer, utm_source, utm_medium, utm_campaign, utm_term, utm_content), matchType (contains یا equals), matchValue, ، اور اختیاری طور پر priority (پہلے سے طے شدہ 10، زیادہ رنز پہلے)۔.
// 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
کنٹرول کریں کہ آیا پلگ ان کے فرنٹ اینڈ اثاثے (کوکی لائبریری اور ٹریکنگ اسکرپٹ) قطار میں ہیں۔ کسی صفحہ یا حالت پر لوڈنگ کو مکمل طور پر غیر فعال کرنے کے لیے غلط پر واپس جائیں۔.
پیرامیٹرز:
$enqueue(بول) - چاہے اثاثوں کی قطار لگائی جائے۔ طے شدہtrue.
// 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;
} );