تتبع الإحالات لـ WPForms

كيف يمكنني تفعيل البرنامج المساعد؟

بعد شراء إضافة "تتبع مصادر الإحالة لـ WPForms"، ستحتاج إلى تثبيت الإضافة على موقعك الإلكتروني على ووردبريس. دعنا نستعرض هذه العملية.

الخطوة الأولىالتثبيت

قم بتسجيل الدخول إلى موقع ووردبريس الخاص بك وانتقل إلى الإضافات > إضافة إضافة > تحميل إضافة > قم بتثبيت ملف zip وقم بتفعيله.

الخطوة 2: قم بتسجيل الملحق

في قائمة التنقل على اليسار، انتقل إلى WPForms > تتبع الإحالات.

أدخل مفتاح الترخيص الخاص بك وقم بتفعيله.

الخطوة 3: تفعيل الميزة

بعد تفعيل ترخيصك، ستظهر علامة تبويب "عام" في صفحة إعدادات تتبع الإحالات، انقر فوقها ثم انقر فوق "حفظ التغييرات".

هذا كل شيء! الآن سيتم تفعيل خاصية تتبع مصدر الإحالة على أي نماذج موجودة أو نماذج جديدة تقوم بإنشائها.

تفاصيل الميزة

المصادر التي يكتشفها

نقوم بتسجيل عنوان URL المُحيل عندما يكون متاحًا ونخزنها في المدخل. كما نستخدم تسميات سهلة الفهم للمنصات الشائعة ليسهل فهم المصدر بنظرة سريعة.

فيما يلي قائمة المصادر التي يتم تصنيفها عند اكتشافها:

• جوجل: إعلانات جوجل، نتائج بحث جوجل العضوية، جيميني
• مايكروسوفت/بينغ: إعلانات مايكروسوفت، نتائج بحث بينغ العضوية
• فيسبوك: إعلانات فيسبوك، ونتائج البحث العضوية على فيسبوك
• لينكد إن: إعلانات لينكدإن، نتائج البحث العضوي على لينكدإن
• X (تويتر): إعلانات X، منتجات عضوية X
• ريديت: إعلانات ريديت، نتائج البحث العضوية على ريديت
• تيك توك: إعلانات تيك توك، تيك توك العضوي
• بينترست: إعلانات بينترست، نتائج البحث العضوية على بينترست
• سناب شات: إعلانات سناب شات، إعلانات سناب شات العضوية
• محركات بحث أخرى: ياهو، دك دك جو، ياندكس
• مساعدو الذكاء الاصطناعي (عند توفرهم): ChatGPT، Perplexity، Microsoft Copilot، Claude، Grok، DeepSeek
• منصات البريد الإلكتروني (تتبع الحملات): Mailchimp، وConstant Contact، وSalesforce Pardot، وHubSpot
• مباشر و غير معروف تُستخدم عند الاقتضاء.
• مخصص يمكن إضافة المصادر أيضاً!

معلمات UTM التي يلتقطها

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

تم التقاط معرفات النقرات

• gclid
• gbraid
• wbraid
• msclkid
• li_fat_id
• rdt_cid
• ttclid
• pin_cid
• snap_cid
• mc_cid
• mc_eid
• dclid

العلامات الذكية

{pb_ref_source} – تسمية مصدر الإحالة المكتشفة (يتم تعيينها افتراضيًا إلى "غير معروف" عندما يتعذر تصنيف الزيارة).

{pb_ref_params} – سلسلة كاملة من معلمات الإحالة التي تم التقاطها (يتم الاحتفاظ برموز UTM ومتغيرات الاستعلام الأخرى معًا).

{pb_ref_referrer} – مُحيل المتصفح الذي جلب الزائر إلى الموقع.

{pb_ref_utm_id} – تم القبض عليه utm_id.

{pb_ref_utm_source} – تم القبض عليه utm_source.

{pb_ref_utm_medium} – تم القبض عليه utm_medium.

{pb_ref_utm_campaign} – تم القبض عليه حملة utm.

{pb_ref_utm_term} – تم القبض عليه utm_term.

{pb_ref_utm_content} – تم القبض عليه محتوى utm.

{pb_ref_clid} – معرف النقرة الأول الذي تم اكتشافه (gclid، fbclid، msclkid، إلخ).

الترجمات

هذه الإضافة جاهزة تمامًا للترجمة. يمكنك ترجمتها إلى أي لغة باستخدام البرنامج المجاني ترجمة محلية إضافة أو أي أداة ترجمة أخرى لـ WordPress.

اللغة الافتراضية: الإنجليزية (en_US)

الأسئلة الشائعة

هل يعمل مع WPForms Lite؟

نعم. تعمل خاصية تتبع الإحالات ومعالجة العلامات الذكية مع WPForms Lite. ومع ذلك، فإن واجهة إدارة الإدخال في WPForms Lite محدودة مقارنة بـ Pro - أعمدة قائمة الإدخال، وشريط تتبع الإحالات للإدخال الفردي، وتكامل تصدير CSV تتطلب WPForms Pro.

هل يمكنني تصدير البيانات؟

نعم. يتم تضمين قيم التتبع في ملفات CSV المصدرة من WPForms. تُضاف جميع حقول الإحالة (المصدر، المُحيل، UTMs، مُعرّف النقرة، وغيرها) كأعمدة تصدير تلقائيًا.

ما الذي يلتقطه البرنامج المساعد تحديداً؟

نقوم بتسجيل حقول الإسناد الشائعة وتخزينها بجانب كل إدخال في نماذج WPForms، بما في ذلك معلمات UTM (المصدر، الوسيلة، الحملة، المصطلح، المحتوى)،, معرفات النقرات (gclid، msclkid، gbraid/wbraid، وما إلى ذلك)، فإن عنوان URL الأصلي للمُحيل, ، وسياق صفحة الهبوط ذات الصلة حتى تتمكن من رؤية مصدر كل عميل محتمل بوضوح.

هل يمكنني إضافة مصادر مخصصة؟

نعم! سواء كان موقع إحالة أو شراكة تابعة وما إلى ذلك، يمكنك إضافة مصادر مخصصة مع تسميات واضحة.

أين يتم حفظ بيانات الإحالة؟

يتم تخزين البيانات في قاعدة بيانات ووردبريس الخاصة بك ضمن جدول مخصص للملحقات مرتبط بإدخالات WPForms. لا نقوم بإرسال التحويلات أو الأحداث إلى منصات الإعلانات.

هل هذا إسناد أول لمسة أم إسناد آخر لمسة؟

تركز هذه الإضافة على إسناد اللمسة الأولى عن طريق تخزين إبداعي معلمات المُحيل والحملة التي جلبت الزائر إلى موقعك (خلال فترة الاحتفاظ).

كم من الوقت يحتفظ النظام ببيانات إسناد الزائر؟

فترة الاحتفاظ هي 7 أيام. إذا قام الزائر بإرسال نموذج في غضون 7 أيام من زيارته الأولى التي تم تتبعها، فسيتم تطبيق قيم الإسناد الأصلية على الإدخال.

هل يعمل مع التخزين المؤقت/شبكات توصيل المحتوى (CDN)؟

عادةً، نعم. يتم تتبع الطلبات من جانب العميل، لذا فإن معظم إعدادات التخزين المؤقت/شبكة توصيل المحتوى (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

هل يعمل مع نماذج WPForms التي تدعم تقنية AJAX؟

نعم. إنه يعمل مع نماذج AJAX (النموذج الافتراضي في WPForms) وعمليات الإرسال القياسية.

هل يمكنني تتبع أكثر من نموذج واحد؟

نعم. يعمل هذا عبر جميع نماذج WPForms الخاصة بك - حيث يحفظ كل إرسال قيم الإسناد الخاصة به لهذا الإدخال.

هل يحل هذا محل تتبع التحويلات في GA4 / إعلانات جوجل؟

لا. هذه الإضافة لا تُفعّل وحدات البكسل ولا تُرسل أحداث التحويل إلى GA4 أو منصات الإعلانات. إنها تخزن بيانات الإسناد. داخل إدخال WPForms, ، حتى يتمكن فريقك من رؤية بيانات مصدر العملاء المحتملين مباشرة في ووردبريس وعمليات التصدير.

هل يقوم بجمع البيانات الشخصية؟

بشكل افتراضي، يقوم البرنامج بالتقاط بيانات الإسناد (UTMs،, gclid, (عناوين URL المُحيلة). يفعل ذلك ليس يتم جمع معلومات التعريف الشخصية الإضافية افتراضيًا. يتم التحكم في حقول النموذج وأي معلمات مضمنة في عناوين URL من خلال موقعك وإعدادات التسويق الخاصة بك.

هل هو متوافق مع اللائحة العامة لحماية البيانات (GDPR) وقانون خصوصية المستهلك في كاليفورنيا (CCPA)؟

يمكن استخدامه بطريقة تتوافق مع لوائح حماية البيانات العامة (GDPR) وقانون خصوصية المستهلك في كاليفورنيا (CCPA). يخزن الملحق بيانات الإسناد مع مدخلاتك ولا يرسل أي معلومات إلى منصات الإعلانات. أنت مسؤول عن الحصول على الموافقة/المصلحة المشروعة والإفصاح المناسب لإعداداتك الخاصة.

هل يعمل مع شبكة ووردبريس متعددة المواقع؟

باختصار شديد

• رخصة غير محدودة: قم بتفعيل وضع الشبكة مرة واحدة؛ يمكنك إدارته بمفتاح واحد. كل إعدادات الموقع الفرعي + الدعم.
• يتم تفعيلها عبر الشبكة: جميع المواقع الفرعية مزودة بنظام تتبع الإحالات وتتلقى التحديثات على الفور.
• خطة محدودة / لا يوجد ترخيص للموقع الفرعي: يبقى التتبع مفعلاً، لكن إعدادات الموقع الفرعي للقراءة فقط.
• الدعم يتبع الترخيص: المواقع التي يغطيها المفتاح النشط مؤهلة.

نعم؛ يتم تشغيل الإضافة تلقائيًا على كل موقع فرعي بمجرد تفعيلها على الشبكة.لا يتطلب الأمر أي إعداد يدوي. يمكن لكل موقع فرعي استخدام نظام التتبع وتلقي التحديثات حتى بدون ترخيص محلي. لتغيير إعدادات النموذج أو الحصول على دعم مباشر لموقع فرعي، لا يزال يتعين عليك تفعيل ترخيص هناك.

إذا كنت تمتلك ترخيصًا غير محدود، يمكنك تفعيل وضع الشبكة من الموقع الرئيسي وإرسال هذا المفتاح الواحد إلى جميع المواقع الفرعية دفعة واحدة (مع متابعة التقدم مباشرةً). سترث هذه المواقع الفرعية الإعدادات والدعم المُدارين بالترخيص تلقائيًا.

خطافات

الإجراءات

pb_wpforms_referral_tracking_loaded

يتم تشغيل هذا الإجراء بعد اكتمال تهيئة الملحق بالكامل - حيث يتم تحميل جميع الفئات، وتسجيل الخطافات، وجاهزية واجهة برمجة التطبيقات. هذه هي نقطة التشغيل الموثوقة للإضافات أو الملحقات المصاحبة التي توسع نطاق تتبع مصادر الإحالة.

حدود:

• $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 (عدد صحيح) — معرف النموذج الحالي.
• $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 (عدد صحيح) — رقم تعريف المدخل.

مثال على الاستخدام:

// 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 (عدد صحيح) — رقم تعريف المدخل.

// 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 (مصفوفة) — مصفوفة إعدادات جافا سكريبت الكاملة.

// 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

قم بإدراج قواعد مصدر مخصصة برمجياً تعمل جنباً إلى جنب مع القواعد المُكوّنة في واجهة المستخدم الإدارية. يتم دمج القواعد من هذا الفلتر مع قواعد واجهة المستخدم المحفوظة وفرزها معاً حسب الأولوية قبل تمريرها إلى الواجهة الأمامية.

حدود:

• $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;
} );