تتبع الإحالات لنماذج جرافتي

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

بعد شراء إضافة تتبع مصادر الإحالة لـ Gravity Forms، قم بتثبيتها على موقع WordPress الخاص بك.

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

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

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

في قائمة التنقل على اليسار، انتقل إلى النماذج → الإعدادات → تتبع الإحالات.

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

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

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

يؤدي ترك هذا المربع غير مُحدد إلى إيقاف التتبع في كل مكان. يمكنك بدلاً من ذلك تفعيله لكل نموذج على حدة من خلال إعدادات النموذج ← خيارات النموذج.

هذا كل شيء! مع تفعيل خيار "التمكين افتراضيًا"، يصبح تتبع مصدر الإحالة نشطًا في أي نماذج موجودة وأي نماذج جديدة تقوم بإنشائها.

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

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

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

يُصنّف المصدر على أنه "إعلانات" فقط عندما تحمل الزيارة معرّف نقرة الإعلان الخاص بالمنصة (مثل gclid، msclkid، li_fat_id، ttclid، oppref، وما إلى ذلك). أما المنصة المعروفة التي تصل بدون معرّف نقرة، فتُصنّف على أنها "عضوية". ويُستثنى من ذلك فيسبوك وإنستغرام، حيث تُضيف Meta معرّف fbclid إلى كل نقرة، لذا تُصنّف هذه النقرات على أنها "إعلانات" عندما يصل معرّف fbclid مع أي مُعامل UTM.

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

• جوجل: إعلانات جوجل، نتائج بحث جوجل العضوية. حركة مرور جيميني utm_source=gemini يُصنف على أنه بحث عضوي من جوجل؛ ولا يوجد تصنيف منفصل لـ Gemini.
• مايكروسوفت/بينغ: إعلانات بينغ، نتائج بحث بينغ العضوية
• فيسبوك: إعلانات فيسبوك، ونتائج البحث العضوية على فيسبوك
• انستغرام: إعلانات إنستغرام، نتائج البحث العضوية على إنستغرام
• لينكد إن: إعلانات لينكدإن، نتائج البحث العضوي على لينكدإن
• X (تويتر): إكس أورجانيك
• ريديت: إعلانات ريديت، نتائج البحث العضوية على ريديت
• تيك توك: إعلانات تيك توك، تيك توك العضوي
• بينترست: إعلانات بينترست، نتائج البحث العضوية على بينترست
• سناب شات: إعلانات سناب شات، إعلانات سناب شات العضوية
• يوتيوب: نتائج البحث العضوية على يوتيوب. نقرة على إعلان يوتيوب تؤدي إلى gclid يتم تسجيلها كإعلانات جوجل ما لم يتم وضع علامة على عنوان URL أيضًا. utm_source=youtube, ، والتي تسجل إعلانات يوتيوب.
• محركات بحث أخرى: ياهو، دك دك جو، ياندكس
• مساعدو الذكاء الاصطناعي/الحاصلون على درجة الماجستير في القانون: إعلانات ChatGPT، ChatGPT العضوية، Perplexity، Copilot، Claude، Grok، DeepSeek
• منصات البريد الإلكتروني (تتبع الحملات): Mailchimp، وConstant Contact، وPardot (المصنفة) Salesforce)، هاب سبوت
• مباشر و غير معروف تُستخدم عند الاقتضاء.
• مخصص يمكن تحديد المصادر ضمن المصادر المخصصة لحركة مرور الشركاء والشركات التابعة والحملات الإعلانية.

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

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

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

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

مصادر مخصصة

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

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

كيفية تقييم القاعدة

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

الحقول، واحداً تلو الآخر

• ملصق – النص المحفوظ كمصدر للزيارة (مثلاً. Partner: Acme, Email: Newsletter, Campaign: Spring Saleهذا بالضبط ما يظهر في المدخل، في {pb_ref_source} قم بدمج العلامات في علامة تبويب التقارير، وفي أي عملية ربط في نظام إدارة علاقات العملاء. اختر علامة يسهل عليك التعرف عليها في شاشة إدخالات مزدحمة.
• ملعب المباراة – أين تبحث:
  • المضيف المُحيل – النطاق الموجود في مُحيل المتصفح (على سبيل المثال، التطابقات) acme.com عندما يصل شخص ما من https://www.acme.com/blog/post).
  • مصدر UTM / الوسيط / الحملة / المصطلح / المحتوى - المقابل ?utm_*= المعلمة الموجودة في عنوان URL الخاص بالصفحة المقصودة.
• نوع المطابقة – ما الذي يجب البحث عنه:
  • يتضمن – تتضمن قيمة الحقل قيمة المطابقة الخاصة بك في أي مكان بداخلها. غير حساسة لحالة الأحرف. مفيدة لاكتشاف الاختلافات مثل acme.com, blog.acme.com, partner.acme.com بقاعدة واحدة.
  • يساوي – قيمة الحقل هي بالضبط قيمة المطابقة المطلوبة (بغض النظر عن حالة الأحرف). إنها أكثر دقة، لذا استخدمها عندما تحتاج إلى مطابقة دقيقة مثل utm_source يساوي تمامًا newsletter.
• قيمة المطابقة – النص المطلوب البحث عنه. بدون علامات اقتباس، بدون علامات نجمية، فقط النص الحرفي.
• أولوية – رقم يتحكم في الترتيب. الجريات الأعلى أولاً, لذا، في حال تداخل القواعد، تفوز القاعدة ذات الأولوية الأعلى. الوضع الافتراضي هو 10; رفع إلى 20 أو 50 للاطلاع على القواعد التي يجب أن تتجاوز إعداداتك الافتراضية، انتقل إلى 5 لأغراض شاملة.

أمثلة محلولة

قم بتصنيف موقع الشريك حسب المُحيل

أي شخص يصل من أي نطاق فرعي من acme.com مُصنَّف Partner: Acme بدلاً من العام Referral.

حملة رسائل إخبارية مُصنّفة

استخدم هذا الخيار عندما تتحكم في عنوان URL من جانبك (مثل الروابط الموجودة داخل رسائل البريد الإلكتروني الأسبوعية المرسلة). ?utm_source=newsletter).

قم بتصنيف الحملة المدفوعة باستخدام اسم حملة UTM الخاصة بها

يمسك ?utm_campaign=spring-sale-2026, ?utm_campaign=spring-sale-google-ads, ، وصيغ مشابهة في قاعدة واحدة.

تجاوز خاصية الكشف المدمجة في جوجل لشريك تسويقي محدد

تضمن الأولوية القصوى أن تتفوق هذه القاعدة على القاعدة المدمجة utm_source=google → Google Ads يتم وضع العلامات كلما ورد المصدر الموسوم.

“"إضافة ملصقات المنتجات العضوية/الإعلانات" بمصادر مخصصة

تظهر المصادر المدمجة دائمًا على النحو التالي: Google Ads, Facebook Organic, إلخ. الـ إضافة ملصقات المنتجات العضوية/الإعلانات (مصادر مخصصة) يتحكم مربع الاختيار (أيضًا ضمن النماذج → الإعدادات → تتبع الإحالات) فيما إذا كانت التسميات المخصصة الخاصة بك تحصل على نفس اللاحقة.

• تم التحقق (افتراضي) - قاعدة مخصصة تحمل علامة Partner: Acme يصبح Partner: Acme Organic حول حركة المرور المُحالة و Partner: Acme Ads إذا كانت الزيارة تحمل معرّف نقرة مدفوع مثل gclid.
• غير مدقق – يتم عرض التسميات المخصصة الخاصة بك تمامًا كما كتبتها، ولا يضيف الملحق أي لاحقة.

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

إضافة القواعد برمجياً

إذا كنت تقوم بإنشاء إضافة أو تريد وضع القواعد تحت نظام التحكم في الإصدار، فإن pb_gforms_referral_tracking_custom_sources يقبل الفلتر نفس شكل واجهة المستخدم الإدارية ويدمجها معها. يقوم الملحق بترتيب القواعد من كلا المصدرين معًا حسب الأولوية قبل أن يقوم الواجهة الأمامية بتقييمها.

حقول المرآة

تُضاف حقول التتبع الخاصة بنا إلى نموذجك ديناميكيًا عند عرضه. وهي ليست جزءًا من قائمة الحقول المحفوظة للنموذج. هذا يحافظ على نظافة نماذجك، ولكن بعض إضافات إدارة علاقات العملاء والتسويق عبر البريد الإلكتروني وWebhook تُنشئ قوائم ربط الحقول المنسدلة الخاصة بها من الحقول المحفوظة فقط، لذا لا يمكنها "رؤية" حقولنا الديناميكية.

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

إذا كانت الإضافة التي تستخدمها تدعم خيار تعيين "قيمة مخصصة"، فلن تحتاج إلى حقول النسخ المتطابق على الإطلاق. ما عليك سوى تعيين علامات الدمج الخاصة بنا مباشرةً (على سبيل المثال، {pb_ref_source}, {pb_ref_utm_source}, {pb_ref_clid}).

إدارة الحقول المتطابقة:

• أضف حقول المرآة – يقوم بإنشاء المجموعة المرئية للمحرر.
• أضف N من حقول المرآة المفقودة يظهر هذا الإشعار عندما يحتوي النموذج على بعض حقول النسخ المتطابقة الحالية وليس كلها، ويُشير إلى عددها. يحدث ذلك عند حذف الحقول يدويًا، وكذلك بعد تفعيل خاصية إسناد آخر لمسة، والتي تُضيف مجموعة جديدة من التعريفات. لا يُغيّر الملحق معرّفات الحقول المتبقية، لذا تستمر عمليات الربط المحفوظة في العمل.
• قم بإزالة حقلي المرآة المكررين يظهر هذا الخيار فقط عند وجود نسخ مكررة، ويحدد عددها. ويحتفظ بأول ظهور لكل منها.
• إزالة الحقول المتطابقة – يحذف المجموعة (مع تأكيد). تبقى القيم المحفوظة مسبقًا في الإدخالات السابقة في قاعدة البيانات، لكن الإضافات لن تتمكن من رؤيتها بعد الآن عبر عمليات البحث عن معرف الحقل.

عند تفعيل خاصية إسناد اللمسة الأخيرة، يمكن أن تتضمن الحقول المتطابقة مجموعة اللمسة الأخيرة أيضًا. لن تتعرف النماذج التي تحتوي بالفعل على مجموعة اللمسة الأولى عليها تلقائيًا: استخدم أضف N من حقول المرآة المفقودة على كل واحدة منها لملئها.

التقارير

ابحث عن التقارير ضمن النماذج ← الإعدادات ← تتبع الإحالات ← التقارير. تعرض هذه الصفحة جميع الإدخالات المُتتبّعة التي وصلت خلال الفترة الزمنية التي تحددها، مُصنّفة حسب المصدر، وبُعد UTM، والمُحيل. لا تُحتسب الإدخالات المُرسلة قبل تفعيل الإضافة، والإدخالات في النماذج التي تم تعطيل التتبّع فيها، والإدخالات المحذوفة أو المُصنّفة كرسائل غير مرغوب فيها، لذا قد تكون هذه الإجماليات أقل من إجمالي إدخالات Gravity Forms. تغطي النطاقات أيامًا كاملة وتنتهي عند آخر إدخال مكتمل. التوقيت العالمي منتصف الليل، لذا تبقى المقارنات بين الفترات الزمنية متطابقة. وبحسب بُعد المنطقة الزمنية لموقعك عن التوقيت العالمي المنسق (UTC)، قد يقع هذا الحد الزمني في منتصف يومك المحلي.

نظرة سريعة على الرسوم البيانية

• تحليل المصدر – مخطط دائري يوضح نسبة عمليات الإرسال لكل مصدر مصنف (البحث العضوي في جوجل، إعلانات فيسبوك، مصادرك المخصصة، البحث المباشر، إلخ).
• عدد المشاركات عبر الزمن – رسم بياني خطي لإجمالي الإدخالات لكل فئة. مرر مؤشر الماوس فوق نقطة ما، وستظهر لك نافذة منبثقة تقسم الإجمالي حسب المصدر. في الفترات الزمنية الأطول (90 و365 يومًا)، يتم تقسيم البيانات حسب الشهر للحفاظ على وضوح المحور؛ أما في الفترة الزمنية التي تبلغ 30 يومًا، فيتم رسم تسمية التاريخ كل سبعة أيام لتجنب الازدحام.
• أفضل مصدر / وسيط / حملة UTM – مخططات شريطية أفقية للقيم التي تحتوي على أكبر عدد من الإدخالات في كل بُعد من أبعاد UTM.
• أفضل المُحيلين – رسم بياني أفقي يوضح النطاقات المُحيلة التي تُساهم في جلب أكبر عدد من الطلبات. يخزن الملحق بيانات الزيارات المباشرة مع المُحيل. Direct, لذلك يظهر هنا كشريط مستقل بدلاً من كونه نطاقًا.

الفلاتر

• استمارة - حدد نطاق العرض لنموذج واحد، أو اتركه على "جميع النماذج" لعرض الموقع بأكمله.
• نطاق التاريخ – فترات زمنية محددة مسبقًا (آخر 7، 30، 90، و365 يومًا).
• مقارنة بالفترة السابقة – يعرض إجمالي الفترة مع نسبة التغير فيها مقارنةً بالفترة السابقة المكافئة (آخر 7 مقابل آخر 7، آخر 30 مقابل آخر 30، إلخ)، ويُظهر تلك الفترة السابقة كخط متقطع على الرسم البياني الزمني. لا تتم مقارنة مخططات UTM ومخططات الأعمدة المرجعية.
• إخفاء غير المنسوب – يخفي خانتي "غير مُحدد" و"غير معروف" لتتمكن من التركيز على المصادر المنسوبة. يبقى الاتصال المباشر.

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

الأداء والتخزين المؤقت

تقوم الإضافة بحساب التقارير من إدخالات نماذج Gravity Forms الخاصة بك وتخزين النتيجة مؤقتًا، مما يجعل عمليات التحميل المتكررة سريعة. تقوم الإدخالات الجديدة بإبطال صلاحية ذاكرة التخزين المؤقت تلقائيًا، مع تأخير لمدة 60 ثانية لمنع تحميلها الزائد في النماذج ذات الحجم الكبير. يمكن للمطورين ضبط نافذة التأخير (أو تعطيلها تمامًا) باستخدام pb_gforms_rt_invalidate_debounce فلتر. انظر قسم الخطافات أدناه.

ملخص البريد الإلكتروني

إذا كنت تفضل استلام ملخصات الإسناد بدلاً من فتح لوحة التحكم، فقم بتمكين ملخص البريد الإلكتروني ضمن النماذج ← الإعدادات ← تتبع الإحالات ← تقارير البريد الإلكتروني. يتم تقييم اليوم والساعة اللذين تختارهما وفقًا للمنطقة الزمنية لموقعك، ولكن يتم قياس الفترة المبلغ عنها بالكامل. التوقيت العالمي أيام، تنتهي عند آخر منتصف ليل بتوقيت UTC قبل إرسال البريد الإلكتروني. في المواقع البعيدة عن توقيت UTC، يكون نطاق التغطية مختلفًا عن أيامك المحلية.

الإيقاع والتوقيت

• أسبوعي - اختر يوم الأسبوع (من الأحد إلى السبت) والساعة التي يتم فيها إرسال البريد الإلكتروني.
• شهريا - اختر يوم الشهر (بحد أقصى 28 حتى تصل الرسالة الإلكترونية دائمًا، حتى في شهر فبراير) والساعة.
• يتبع جدول الإرسال جدولك الزمني المنطقة الزمنية للموقع (ووردبريس ← الإعدادات ← عام)، وتعرض صفحة الإعدادات الإعداد الحالي بجوار مُحدد الساعة. ولا تزال نافذة التقارير تُقاس بأيام التوقيت العالمي المنسق (UTC).

المستفيدون

عنوان بريد إلكتروني واحد لكل سطر. اترك الحقل فارغًا وسيعود الملخص إلى... البريد الإلكتروني لمسؤول الموقع عند الإرسال. هذا مفيد عندما قد يتغير بريد المسؤول الإلكتروني لاحقًا وتريد أن يتبعه الملخص تلقائيًا.

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

خيارات المحتوى

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

علامات الدمج

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

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

{pb_ref_referrer} – عنوان URL المُحيل للزيارة. هذا هو المُحيل الفعلي، وليس قيمة المتصفح الخام. عند استخدام مُعرّف نقرة أو مُعرّف مُعترف به utm_source بدلاً من تحديد المنصة، يقوم الملحق بتخزين عنوان URL الأساسي للمنصة. ونتيجة لذلك، فإن gclid سجلات الزيارة https://www.google.com/ حتى عندما يأتي النقر من بريد إلكتروني. يتم تسجيل الزيارات من نفس النطاق والزيارات بدون مُحيل. Direct. لا تكشف علامة الدمج عن مُحيل المتصفح الذي لم يتم تعديله.

{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، ومعرفات نقر المنصات الأخرى).

{pb_ref_custom_source} - ملصقك الخاص بالزيارة، مكتوب بواسطة pb_gforms_referral_tracking_source_label الفلتر (انظر قسم الخطافات). لا يظهر الوسم إلا عند إرفاق دالة رد نداء بهذا الفلتر. يخزن الملحق المصدر المكتشف بشكل منفصل ولا يُجري عليه أي تغيير.

علامات الدمج الأخيرة

عند تفعيل خاصية إسناد اللمسة الأخيرة، يضيف الملحق مجموعة متوازية:

• {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}

كل منها يعكس نظيره في اللمسة الأولى ولكنه يخزن أحدث مصدر قبل الإرسال. {pb_ref_last_custom_source} يحتاج أيضًا إلى pb_gforms_referral_tracking_source_label فلتر، وهو نفسه الموجود في نظيره الذي يعمل باللمسة الأولى.

إرسال البيانات إلى جوجل أناليتكس

لا تتصل ميزة تتبع مصدر الإحالة بجوجل تلقائيًا. كل ما يتم جمعه يبقى في نموذج Gravity Forms الخاص بك. إذا قمت بتفعيل إعداد GA4، فإن علامة جوجل الخاصة بك هي التي ترسل الحدث.

ابتداءً من الإصدار 1.6.0، يمكنك الاشتراك في حدث GA4. فعّل GA4 / مدير العلامات من خلال النماذج ← الإعدادات ← تتبع الإحالات ← عام. عند التأكيد، يرسل الملحق حدثًا مخصصًا باسم pb_referral_submit (أعد تسميته في نفس الإعدادات) مع المصدر، والمُحيل، ومعرّف النقرة، ومعلمات UTM، بالإضافة إلى قيم آخر لمسة عند تفعيلها. لا يتم إرسال أي بيانات في حال فشل التحقق. تتطلب عمليات إعادة التوجيه وتأكيدات صفحة الشكر الإصدار 1.7.1.

تحقق من GA4 Realtime أو DebugView لمعرفة الحدث. لست بحاجة إلى مُشغّل Tag Manager. يقوم وسم Google الخاص بك بإرسال البيانات؛ ولا يتصل الملحق بجوجل مطلقًا.

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

ما يحمله الحدث

تتطابق مفاتيح المعلمات مع أسماء علامات الدمج. يتم استبعاد القيم الفارغة من الحمولة تمامًا، ويتم تشغيل الحدث مرة واحدة على الأكثر لكل عرض صفحة.

اختياري: مرر القيم على رابط الشكر

1. افتح تأكيدات النموذج الخاص بك ضمن النماذج ← [نموذجك] ← الإعدادات ← التأكيدات, ثم قم بتحرير (أو إضافة) إعادة التوجيه تأكيد.
2. في عنوان URL لإعادة التوجيه في الحقل المخصص، أدخل عنوان URL لصفحة الشكر الخاصة بك متبوعًا بسلسلة استعلام تم إنشاؤها من علامات دمج التتبع:

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 بتعبئة كل قيمة وتشفيرها باستخدام عنوان URL عند وقت الإرسال، بحيث يصل الزائر الذي وصل من خلال نقرة على إعلانات Google إلى عنوان URL مثل:

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

يقوم إعداد Google Analytics 4 أو Google Tag Manager في صفحة الشكر بقراءة هذه المعلمات بنفس طريقة معالجة أي رابط حملة، حيث يُفعّل حدث التحويل أو العميل المحتمل مع إرفاق المصدر والحملة ومعرّف النقرة. أما القيم التي لم يتم جمعها لزيارة معينة فتظهر فارغة.

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

لماذا تستخدم علامات الدمج بدلاً من الحقول المخفية الخاصة بك؟

إذا كنتَ تُمرِّر بيانات الحملة إلى صفحة الشكر من حقولك المخفية، فوجه سلسلة الاستعلام إلى علامات الدمج الخاصة بنا. عندئذٍ، تأتي كلٌّ من القيمة المحفوظة في الإدخال والقيمة المُرسَلة إلى GA4 من نفس المصدر، فلا يمكن أن يختلفا. يُظهر الإدخال وGA4 دائمًا نفس الحملة. وهذا يعني أيضًا تقليل عدد الحقول التي تحتاج إلى صيانتها.

ملاحظة حول معرّفات النقرات

{pb_ref_clid} يحتوي على معرّف النقرة الأول الذي تم اكتشافه أثناء الزيارة، بغض النظر عن المنصة التي جاءت منها: gclid بالنسبة لجوجل، ولكن أيضاً msclkid (مايكروسوفت)،, fbclid (ميتا)، وغيرها. إذا كنت تقوم بربطها تحديدًا بـ gclid= بالنسبة لمعامل إعلانات جوجل، فإن الزيارة من خارج جوجل ستضع معرّف النقرة في هذا الموضع. إذا كنت ترغب في تضمين معرّف النقرة فقط في زيارات إعلانات جوجل، فأضف منطقًا شرطيًا إلى التأكيد بحيث gclid= يتم إرسال المعلمة فقط عندما مصدر يكون إعلانات غوغل.

التحقق من أنه يعمل

يمكنك تأكيد السلسلة بأكملها في أربع خطوات:

1. أضف معلمات الاختبار إلى أي عنوان URL لصفحة الهبوط (على سبيل المثال) ?gclid=TEST123&utm_source=google&utm_medium=cpcثم قم بإرسال النموذج.
2. في صفحة الشكر، تحقق من شريط العنوان: يجب أن تكون قيمك موجودة في عنوان URL.
3. افتح أدوات مطوري المتصفح، وانتقل إلى شبكة علامة تبويب، وقم بالتصفية لـ collect. يجب أن يتضمن الطلب المقدم إلى جوجل ما يلي: gclid و utm قيم.
4. تأكيد الاستلام في GA4 عرض التصحيح أو في الوقت الحالى تقرير.

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

تتحقق هذه الخطوات الأربع من طريقة سلسلة الاستعلام الاختيارية. بالنسبة للحدث المخصص المدمج، أرسل النموذج، ثم في صفحة التأكيد أو صفحة الشكر، افتح أدوات المطورين ← الشبكة، وقم بتصفية النتائج. g/collect, وابحث عن en=pb_referral_submit (أو اسم الحدث الخاص بك). أو استخدم أداة عرض تصحيح الأخطاء في GA4. إذا كان الحدث موجودًا في علامة تبويب الشبكة ولكنه غير موجود في GA4، فإن الفجوة هي علامة جوجل الخاصة بك. إذا لم يكن موجودًا في علامة تبويب الشبكة، فهذا يعني أن الإضافة لم يتم تفعيلها.

إرسال الحدث إلى GA4

منذ الإصدار 1.6.0، يمكنك إرسال المصدر الموجود مسبقًا في إدخال Gravity Forms إلى GA4 كحدث مخصص. هذه الميزة معطلة افتراضيًا. يقوم وسم Google الخاص بك بإرسال الحدث، ولا يتصل الملحق بجوجل مباشرةً. تحقق من GA4 Realtime أو DebugView لمعرفة الحدث. لست بحاجة إلى مُشغّل Tag Manager.

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

الترجمات

هذه الإضافة جاهزة للترجمة وتتضمن ترجمات مجمعة لما يلي:

1. عربي (ar)
2. البنغالية (bn_BD)
3. الفلبيني (fil)
4. الألمانية (de_DE)
5. الإسبانية (es_ES)
6. الإسبانية (es_MX)
7. فرنسي (fr_FR)
8. الهندية (hi_IN)
9. الإندونيسية (id_ID)
10. إيطالي (it_IT)
11. اليابانية (ja)
12. البرتغالية (pt_BR)
13. الروسية (ru_RU)
14. الأردية (ur)
15. الصينية المبسطة (zh_CN)
16. التقاليد الصينية (zh_HK)

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

إذا لم تكن لغتك مدرجة ضمن الترجمات يمكنك ترجمة الإضافة بنفسك، فهي جاهزة للترجمة. استخدم النسخة المجانية. إضافة ترجمة لوكو لإنشاء ترجمة للغة/موقع موقعك. هل أنت جديد على Loco Translate؟ إليك دليل تعليمي مناسب للمبتدئين.

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

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

نعم. يتم حفظ قيم التتبع في كل إدخال في نماذج Gravity Forms، لذا تظهر في عمليات تصدير الإدخالات.

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

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

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

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

لا يظهر حقل التتبع في قائمة الربط المنسدلة الخاصة بإضافات نظام إدارة علاقات العملاء/البريد الإلكتروني/الويب هوك. ماذا أفعل؟

تُضاف حقول التتبع الخاصة بنا إلى نموذجك ديناميكيًا عند عرضه، ولا تُحفظ في قائمة حقول النموذج، لذا لا يمكن للإضافات التي تُنشئ قوائمها المنسدلة من الحقول المحفوظة فقط رؤيتها. لديك خياران. إذا كانت إضافتك تحتوي على تعيين "قيمة مخصصة"، فقم بتعيين علامات الدمج الخاصة بنا مباشرةً ({pb_ref_source}, {pb_ref_utm_source}, {pb_ref_clid}, وهكذا). إذا كان يدعم فقط قائمة منسدلة للحقول، فافتح إعدادات النموذج ← خيارات النموذج ← حقول النسخ المتطابق وانقر فوق أضف حقول المرآة. يؤدي هذا إلى إضافة حقول مخفية مرئية للمحرر، ويقوم الملحق بتعبئتها. راجع قسم حقول المرآة للاطلاع على الشرح الكامل.

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

في قاعدة بيانات ووردبريس الخاصة بك، داخل إدخالات نماذج Gravity Forms. لا يقوم الملحق بإرسالها إلى أي مكان تلقائيًا. إذا كنت ترغب في تضمين القيم المُجمّعة في GA4، فعّل إعداد GA4. يبقى الملحق هو مصدر البيانات؛ بينما يقوم وسم Google الخاص بك بإرسالها.

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

كلاهما. يستخدم النظام افتراضيًا خاصية إسناد التفاعل الأول، حيث يخزن المُحيل الأصلي ومعلمات الحملة التي جلبت الزائر إلى موقعك لأول مرة (ضمن نافذة الإسناد). يوجد مربع اختيار لتجاهل الزيارات المباشرة العائدة، لذا يحتفظ نظام إسناد التفاعل الأخير بالإعلان أو الإحالة السابقة. يتم تخزين معرّفات نقرات الزيارات العائدة في معرّف النقرة (التفاعل الأخير) فقط. وهذا يمنحك مجموعة متوازية من {pb_ref_last_*} دمج العلامات، وأعمدة قائمة الإدخالات، وأعمدة تصدير ملفات CSV. تتضمن علامة تبويب التقارير مفتاح تبديل "الأول/الأخير" الذي يسمح بالتبديل بين العرضين في كل مخطط.

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

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

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

عادةً، نعم. يتم تتبع العمليات من جانب العميل، لذا فإن معظم إعدادات التخزين المؤقت/شبكات توصيل المحتوى (CDN) تعمل بشكل جيد. إذا كنت تستخدم تحسينًا متقدمًا للبرامج النصية (التصغير أو التأجيل)، فضع علامة صح. حماية البرامج النصية من التحسين من خلال النماذج ← الإعدادات ← تتبع الإحالات ← خيارات متقدمة، امسح ذاكرة التخزين المؤقت. سيؤدي ذلك إلى وضع علامات على نصوص الإضافة بحيث يتم تخطيها، وإضافتها تلقائيًا إلى قوائم الاستثناء الخاصة بـ WP Rocket وLiteSpeed Cache وSG Optimizer وAutoptimize وCloudflare Rocket Loader. إذا كنت تستخدم Breeze أو أي أداة تصغير أخرى غير مدرجة في هذه القائمة، فاستبعد الملفين أدناه يدويًا، ثم امسح ذاكرة التخزين المؤقت لشبكة توصيل المحتوى (CDN) الخاصة بهما بعد التحديث.

بالنسبة لأي مُحسِّن لا يشمله هذا الإعداد، استبعد هذين الملفين يدويًا واختبر عملية الإرسال:

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

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

نعم. يعمل مع نماذج AJAX وعمليات الإرسال العادية (غير AJAX). تتطلب عمليات إعادة التوجيه وتأكيدات صفحة الشكر في Gravity Forms 2.9 والإصدارات الأحدث الإصدار 1.7.1 لحدث GA4.

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

نعم. يعمل هذا مع جميع نماذج Gravity Forms الخاصة بك. كل عملية إرسال تحفظ قيم الإسناد الخاصة بها في ذلك الإدخال.

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

لا، إنه مصدر بيانات، وليس بكسل تحويل، ولا يقوم بتفعيل أي بكسلات أو الاتصال بجوجل نفسها. إذا كنت ترغب في الحصول على الإسناد داخل GA4، فإن إعداد الاشتراك في GA4 / مدير العلامات يرسله كحدث مخصص عبر علامة جوجل الخاصة بك عند تأكيد النموذج.

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

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

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

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

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

باختصار شديد

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

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

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

مرجع الإعدادات

كل ما هو أدنى يعيش تحته النماذج ← الإعدادات ← تتبع الإحالات, ، في علامة التبويب المسماة في كل عنوان.

البيانات والخصوصية

متقدم

بوابة الموافقة

لا يوجد مربع اختيار لهذا الخيار. بوابة الموافقة هي خيار خاص بالمطورين: تعيين consentRequired من خلال pb_gforms_referral_tracking_js_config فلتر. يحتوي برنامج التتبع على بيانات اللمسة الأولى في sessionStorage إلى حين الحصول على الموافقة، ثم يتم نقلها إلى التخزين الدائم.

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

قم بالإشارة إلى موافقتك من خلال لافتة ملفات تعريف الارتباط الخاصة بك بأي من هذه الطرق الثلاث التي تناسبك:

• تعيين window.PBReferralTrackingConsent = true.
• إرسال الحدث: window.dispatchEvent( new Event( 'pb-ref-tracking:consent-granted' ) ).
• قم بتعيين consentGranted دالة رد نداء تُرجع القيمة "صحيح" بمجرد الحصول على الموافقة.

خطافات

الإجراءات

pb_gforms_referral_tracking_loaded

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

حدود:

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

الفلاتر

pb_gforms_referral_tracking_enabled

يمكنك تجاوز ما إذا كان تتبع الإحالات مُفعّلاً لنموذج مُحدد. أعد القيمة "صحيح" لتفعيل التتبع، و"خطأ" لإيقافه، بغض النظر عن خيار التفعيل/الإيقاف الخاص بكل نموذج أو الإعداد الافتراضي العام.

حدود:

• $enabled (بول) – ما إذا كان التتبع مفعلاً حالياً.
• $form_id (عدد صحيح) – معرف النموذج الحالي.
• $form (مصفوفة|لا شيء) – مصفوفة البيانات الوصفية للنموذج، أو قيمة فارغة إذا لم تكن متوفرة.

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

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

حدود:

• $fields (مصفوفة) – مصفوفة من مصفوفات تعريف الحقول.
• $form (مصفوفة) – بيانات النموذج الحالية.

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

قم بتصفية مصفوفة النموذج بالكامل بعد أن يُضيف الملحق جميع حقول التتبع الخاصة به. يمكنك تعديل كائن النموذج النهائي قبل عرضه.

حدود:

• $form (مصفوفة) – مصفوفة النموذج مع حقول التتبع المضافة مسبقًا.
• $field_definitions (مصفوفة) – تعريفات الحقول التي تم استخدامها.

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

قم بتعديل خريطة علامات الدمج التي تحدد علامات الدمج المتاحة ومعرفات الحقول التي تُشير إليها. استخدم هذه الخريطة لإضافة علامات دمج مخصصة بالكامل أو لإعادة تسمية العلامات الموجودة.

حدود:

• $map (مصفوفة) – مصفوفة ترابطية للوسم => [ 'label' => سلسلة نصية، 'field_id' => سلسلة نصية].
• $base_id (خيط) – بادئة معرف الحقل الأساسي.
• $constants (ثوابت) – مثيل ثوابت الملحق.

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

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

حدود:

• $value (خيط) – قيمة الحقل الخام.
• $tag (خيط) – مفتاح علامة الدمج (على سبيل المثال pb_ref_source).
• $data (مصفوفة) – بيانات تعريف علامة الدمج (التسمية، معرف الحقل).
• $entry (مصفوفة) – المدخل الحالي.
• $form (مصفوفة) – الشكل الحالي.

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

قم بتصفية قيمة علامة الدمج المنسقة بالكامل بعد أن يقوم Gravity Forms بتشغيل مسار التنسيق الخاص به عليها (الهروب، ترميز عنوان URL، إلخ).

حدود:

• $formatted (خيط) – سلسلة الإخراج المنسقة.
• $tag (خيط) – مفتاح علامة الدمج.
• $data (مصفوفة) – بيانات تعريف علامة الدمج.
• $entry (مصفوفة) – المدخل الحالي.
• $form (مصفوفة) – الشكل الحالي.
• $url_encode (بول)
• $esc_html (بول)
• $nl2br (بول)
• $format (خيط)

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

قم بتجاوز القيمة الافتراضية المستخدمة عندما يكون حقل التتبع فارغًا وقت الإرسال. القيمة الافتراضية هي "غير معروف".

حدود:

• $default (خيط) – القيمة الافتراضية الحالية ("غير معروف").
• $key (خيط) – مفتاح السياق: المصدر، أو المُحيل، أو الواجهة الأمامية.

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

قم بتجاوز كائن تكوين جافا سكريبت الخاص بالواجهة الأمامية بالكامل قبل أن يمرره الملحق إلى برنامج التتبع. يتحكم رد الاتصال الخاص بك في إعدادات ملفات تعريف الارتباط، وخرائط المصدر (utmSourceMap و utmReferrerMapالمصادر المعروفة، و paidClickIds قائمة تحدد معلمات الاستعلام التي تثبت أن النقرة مدفوعة.

حدود:

• $config (مصفوفة) – مصفوفة إعدادات جافا سكريبت الكاملة.

المفاتيح، مع قيمها الافتراضية:

sourcePatterns تم استبعادها عمدًا من تلك القائمة. تتطلب إدخالاتها جافا سكريبت نشطة RegExp تصل الكائنات، وأي شيء تُرجعه دالة رد نداء PHP، كسلسلة نصية بمجرد ترميز التكوين بتنسيق JSON، مما يُسبب خطأً عند المطابقة. لتوسيع أنماط المُحيل، قم بتعيينها إلى window.PBReferralTrackingConfig من جافا سكريبت قبل تشغيل برنامج التتبع.

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

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

حدود:

• $sources (مصفوفة) – مصفوفة فارغة. تُرجع مصفوفة من مصفوفات القواعد المراد إضافتها.

يجب أن تحتوي كل قاعدة على: التسمية، حقل المطابقة (المُحيل، مصدر utm، وسيط utm، حملة utm، مصطلح utm، محتوى utm)، نوع المطابقة (يحتوي على أو يساوي)، قيمة المطابقة، والأولوية اختيارياً (الافتراضي 10، يتم تشغيل الأعلى أولاً).

يمكن أيضًا استخدام القواعد المضافة من خلال هذا الفلتر referrer_url يُستخدم حقل المطابقة (matchField) لمطابقة عنوان URL المُحيل بالكامل، بما في ذلك مساره واستعلامه، بدلاً من مُضيفه فقط. لا توفره واجهة المستخدم الإدارية، لذا فهو مُتاح هنا فقط.

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

اكتب تصنيفك الخاص في حقل "مصدر مخصص" منفصل عند الإرسال. لا يتغير المصدر المُكتشف، لذا يحتفظ الإدخال بكليهما: ما حدده البرنامج المساعد، وما قمتَ بإرجاعه. يُفيد هذا عندما يحتاج نظام إدارة علاقات العملاء (CRM) إلى تصنيف مُبسط أو داخلي ولا ترغب في فقدان المصدر الأصلي. منذ الإصدار 1.6.0.

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

حدود:

• $label (خيط) – على سبيل المثال، تسمية المصدر المكتشفة Google Ads.
• $key (خيط) – ما هي اللمسة التي يتم تصنيفها؟ source أو last_source.
• $form (مصفوفة) – كائن النموذج الحالي.

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

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

حدود:

• $enqueue (بول) – ما إذا كان سيتم وضع الأصول في قائمة الانتظار. القيمة الافتراضية: صحيح.

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

قم بتجاوز CSS المضمن الذي يخفي حقول التتبع في واجهة المستخدم ومعاينة محرر الكتل. يخفي CSS الافتراضي التتبع، ومتتبع إعلانات جوجل القديم، وأغلفة حقول النسخ المتطابق، والاستهداف .gform_wrapper .gfield مع بادئات الفئة pb-ref-tracking- و pb-gads-tracking- و pb-ref-mirror-.

حدود:

• $css (خيط) – سلسلة CSS المضمنة.

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

اضبط (أو عطّل) نافذة تأخير إبطال ذاكرة التخزين المؤقت للتقارير. بعد ورود إدخال جديد، تُعاد تهيئة ذاكرة التخزين المؤقت للتقارير مرة واحدة على الأكثر كل هذا العدد من الثواني، وذلك لتجنب إجهادها عند استخدام نماذج ذات حجم بيانات كبير. القيمة الافتراضية هي 60 ثانية؛ أعد القيمة 0 لإبطالها فورًا عند كل إدخال.

حدود:

• $seconds (عدد صحيح) – نافذة تأخير الاستجابة بالثواني. القيمة الافتراضية 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

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

يترك cssClass بمفرده. عند الإرسال، يقرأ الملحق مفتاح التتبع الأساسي منه، وكل شيء بعد ذلك pb-ref-mirror-, للعثور على القيمة المراد نسخها. أعد تسمية الفئة، وسيُرسل حقل النسخ فارغًا في كل مرة.

حدود:

• $fields (مصفوفة) – مصفوفة من مصفوفات تعريف حقول المرآة.
• $form (مصفوفة) – بيانات النموذج الحالية.

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

أعد توجيه رابط "تعرّف على المزيد في الوثائق" الظاهر في شاشة الإعدادات. يُفيد هذا في عمليات التثبيت ذات العلامات التجارية الخاصة أو عمليات التثبيت التي تُجريها الوكالات والتي تحتفظ بوثائقها الخاصة.

حدود:

• $url (خيط) – رابط التوثيق. أعد الرابط الخاص بك لاستبداله.

// 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/';
} );