التقط معلومات إضافية من معلمات الرابط عندما يقدّم العملاء النموذج.
ما هي البيانات الوصفية؟
البيانات الوصفية هي معلومات إضافية تُلتقط من معلمات استعلام الرابط عندما يزور شخص ما النموذج ويقدّمه. تُخزّن هذه البيانات مع الإرسالية وتظهر في عروض المحادثات.
كيف يعمل
أضف معلمات استعلام لرابط النموذج:
https://supportretriever.com/form/your-form-id?المصدر=النشرة الإخبارية&campaign=summer2024&userId=12345
عند تقديم العميل النموذج، تُعالَج هذه المعلمات تلقائياً:
- تُلتقط - تُخزّن مع الإرسالية
- تُنظّف - تُزال من الرابط (لروابط أنظف)
- تُخزّن - متاحة في بيانات وصفية للمحادثة
أمثلة استخدام
حملات التسويق
تتبع أي الحملات تدفع إرسالات النموذج:
https://supportretriever.com/form/your-id?utm_المصدر=facebook&utm_campaign=product_launch&utm_medium=social
سياق المستخدم
التقط معلومات المستخدم:
https://supportretriever.com/form/your-id?userId=12345&plan=premium&page=settings
تتبع الإحالة
تحديد مصدر العملاء:
https://supportretriever.com/form/your-id?referrer=blog&article=getting-started&المصدر=internal
صيغة الرابط
أضف المعلمات بصيغة سلسلة الاستعلام القياسية:
[form-url]?key1=value1&key2=value2&key3=value3
قواعد:
- استخدم
&لفصل معلمات متعددة - القيم تُرمّز تلقائياً للرابط
- أسماء المعلمات تُنظّف (أبجدية رقمية، شرطات سفلية، شرطات)
- القيم محدودة بـ 500 حرف
- أسماء المعلمات محدودة بـ 50 حرفاً
عرض البيانات الوصفية
تظهر البيانات الوصفية في عروض المحادثات:
- افتح محادثة في لوحة التحكم
- ابحث عن أيقونة البيانات الوصفية (أقواس:
{}) في الرأس - انقر لعرض البيانات الوصفية الملتقطة
John Doe
john@example.com
تم التقاطه في 15 يناير 2024
المصدر: النشرة الإخبارية
campaign: summer2024
userId: 12345
التكامل مع الإحصائيات
البيانات الوصفية متاحة أيضاً في الإحصائيات:
- انتقل إلى الإحصائيات (
/stats) - ابحث عن قسم تفصيل البيانات الوصفية
- راجع العدد لكل حقل وقيمة بيانات وصفية
يساعدك ذلك على فهم:
- أي الحملات تدفع أكثر الإرسالات
- من أين يأتي العملاء
- أي السياقات تؤدي لطلبات الدعم
أمثلة تنفيذ
في حملات البريد
<a href="https://supportretriever.com/form/your-id?المصدر=email&campaign=النشرة الإخبارية_jan">Contact Support</a>
في تنقل الموقع
<a href="https://supportretriever.com/form/your-id?المصدر=header&page=home">Contact</a>
في إعدادات التطبيق
const formUrl = `https://supportretriever.com/form/your-id?المصدر=app&page=settings&userId=${userId}`;
window.location.href = formUrl;
مع معلمات UTM
<a href="https://supportretriever.com/form/your-id?utm_المصدر=blog&utm_medium=article&utm_campaign=product_guide">Get Help</a>
أفضل الممارسات
- تسمية متسقة: استخدم أسماء معلمات متسقة عبر الموقع
- قيم ذات معنى: استخدم قيماً توفّر سياقاً مفيداً
- لا بيانات حساسة: لا تضمّن كلمات مرور أو بيانات حساسة
- توثيق: وثّق بنية المعلمات لفريقك
اعتبارات أمنية
- المعلمات تُنظّف تلقائياً
- المسموح في المفاتيح: أحرف أبجدية رقمية وشرطات سفلية وشرطات فقط
- القيم محدودة الطول
- لا ينبغي تمرير بيانات حساسة في الروابط
تنظيف الرابط
SupportRetriever يزيل المعلمات من الرابط تلقائياً بعد الالتقاط:
- قبل:
https://supportretriever.com/form/your-id?المصدر=النشرة الإخبارية - بعد:
https://supportretriever.com/form/your-id
هذا يحافظ على روابط أنظف للعملاء مع الاحتفاظ بالبيانات الوصفية.
