emالبريد الإلكتروني string أو list<string> (سلسلة أو قائمة) | التجزئة مطلوبة.
اقتطع أي مسافات سابقة أو زائدة. وحوّل كل الأحرف إلى أحرف صغيرة.
المثال: الإدخال: John_Smith@gmail.com
التنسيق الموحد: john_smith@gmail.com
الإخراج المتوقع بتشفير SHA256: 62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f |
phرقم الهاتف string أو list<string> (سلسلة أو قائمة) |
التجزئة مطلوبة قم بإزالة الرموز والأحرف وأي أرقام صفرية سابقة. ويجب أن تتضمن أرقام الهواتف كود البلد لاستخدامه للمطابقة (على سبيل المثال، يجب أن يسبق الرقم 1 رقم الهاتف في الولايات المتحدة). احرص دائمًا على تضمين كود البلد كجزء من أرقام هواتف العملاء حتى إذا كانت كل البيانات المتوفرة لديك من الدولة ذاتها.
المثال: الإدخال: رقم هاتف في الولايات المتحدة (650)555-1212
التنسيق الموحد: 16505551212
الإخراج المتوقع بتشفير SHA256: e323ec626319ca94ee8bff2e4c87cf613be6ea19919ed1364124e16807ab3176 |
fnالاسم الأول string أو list<string> (سلسلة أو قائمة) | التجزئة مطلوبة.
يوصى باستخدام حروف الأبجدية الرومانية من a إلى z. ويجب استخدام الأحرف الصغيرة فقط بدون علامات ترقيم. إذا تم استخدام أحرف خاصة، فيجب ترميز النص بتنسيق UTF-8.
المثال:
الإدخال: Mary
التنسيق الموحد: Mary
الإخراج المتوقع بتشفير SHA256: 6915771be1c5aa0c886870b6951b03d7eafc121fea0e80a5ea83beb7c449f4ec
الإدخال: 정
التنسيق الموحد: حرف "정" بتنسيق UTF-8
الإخراج المتوقع بتشفير SHA256: 8fa8cd9c440be61d0151429310034083132b35975c4bea67fdd74158eb51db14
الإدخال: Valéry
التنسيق الموحد: Valéry
الإخراج المتوقع بتشفير SHA256: 08e1996b5dd49e62a4b4c010d44e4345592a863bb9f8e3976219bac29417149c |
lnاسم العائلة string أو list<string> (سلسلة أو قائمة) | التجزئة مطلوبة.
يوصى باستخدام حروف الأبجدية الرومانية من a إلى z. ويجب استخدام الأحرف الصغيرة فقط بدون علامات ترقيم. إذا تم استخدام أحرف خاصة، فيجب ترميز النص بالتنسيق UTF-8.
راجع الاسم الأول (fn) للحصول على أمثلة. |
dbتاريخ الميلاد string أو list<string> (سلسلة أو قائمة) | التجزئة مطلوبة.
نقبل تنسيق YYYYMMDD الذي يستوعب نطاقًا من تركيبات الشهر واليوم والسنة، بعلامات ترقيم أو بدونها. العام: استخدم التنسيق "سنة" من 1900 إلى العام الحالي. الشهر: استخدم التنسيق "شهر": من 01 إلى 12. التاريخ: استخدم التنسيق "يوم": من 01 إلى 31.
المثال: الإدخال: 2/16/1997
التنسيق الموحد: 19970216
الإخراج المتوقع بتشفير SHA256: 01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c |
geالجنس string أو list<string> (سلسلة أو قائمة) | التجزئة مطلوبة.
نقبل كتابة الجنس في شكل حرف أولي بحروف صغيرة.
المثال: |
ctالمدينة string أو list<string> (سلسلة أو قائمة) | التجزئة مطلوبة.
يوصى باستخدام الأبجدية الرومانية من a إلى z. واستخدم الأحرف الصغيرة فقط ولا تستخدم أية علامات ترقيم أو أحرف خاصة أو مسافات. إذا تم استخدام أحرف خاصة، فيجب ترميز النص بالتنسيق UTF-8.
المثال:
paris
london
newyork |
stالولاية string أو list<string> (سلسلة أو قائمة) | التجزئة مطلوبة.
استخدم رمز اختصار ANSI المكوّن من حرفين بالأحرف الصغيرة. يجب كتابة الولايات التي تقع خارج الولايات المتحدة بأحرف صغيرة من دون استخدام علامات ترقيم أو أحرف خاصة أو مسافات.
مثال:
az
ca |
zpالرمز البريدي string أو list<string> (سلسلة أو قائمة) | التجزئة مطلوبة.
استخدم الأحرف الصغيرة بدون مسافات وبدون شرطة. واستخدم فقط أول 5 أرقام للرموز البريدية داخل الولايات المتحدة. استخدم تنسيق المنطقة والدائرة والقطاع للمملكة المتحدة.
المثال:
الرمز البريدي للولايات المتحدة: 94035
الرمز البريدي لأستراليا: 1987
الرمز البريدي لفرنسا: 75018
الرمز البريدي للمملكة المتحدة: m11ae |
countryالبلد string أو list<string> (سلسلة أو قائمة) | التجزئة مطلوبة.
استخدم أكواد البلدان المكوّنة من حرفين صغيرين بالتنسيق ISO 3166-1 alpha-2.
ملاحظة مهمة: احرص دائمًا على تضمين بلدان عملائك حتى إذا كانت كل أكواد البلدان المتوفرة لديك من البلد ذاتها. تتم المطابقة على نطاق عالمي، وتساعدنا هذه الخطوة البسيطة في مطابقة أكبر عدد ممكن من حسابات "مركز الحسابات" في قائمتك.
المثال:
الإدخال: United States
التنسيق الموحد: us
الإخراج المتوقع بتشفير SHA256: 79adb2a2fce5c6ba215fe5f27f532d4e7edbac4b6a5e09e1ef3a08084a904621 |
external_idالمعرف الخارجي string أو list<string> (سلسلة أو قائمة) | التجزئة مطلوبة.
تمثل أي معرف فريد من جانب المُعلن، مثل معرفات عضوية الولاء ومعرفات المستخدمين ومعرفات ملفات تعريف الارتباط الخارجية. ويمكنك إرسال معرف خارجي واحد أو أكثر لحدث معين.
إذا كان يتم إرسال معرف خارجي عبر قنوات أخرى، فيجب أن يكون بالتنسيق ذاته المتبع عند إرساله عبر واجهة API التحويلات. |
client_ip_addressعنوان IP العميل string (سلسلة) | بدون تجزئة.
يجب أن يكون عنوان IP للمتصفح المقابل للحدث عنوان IPV4 أو IPV6 صالحًا. يُفضل استخدام IPV6 على IPV4 بالنسبة للمستخدمين الذين يتوفر لديهم IPV6. ويجب ألا تتم تجزئة معلمة بيانات المستخدم client_ip_address.
يجب ألا يتم تضمين أي مسافات. احرص دائمًا على توفير عنوان IP الحقيقي لضمان إعداد تقارير دقيقة عن الأحداث.
الملاحظة: تتم إضافة هذه المعلومات تلقائيًا إلى الأحداث المرسلة من خلال المتصفح، ولكن يلزم تكوينها يدويًا بالنسبة للأحداث المرسلة عبر الخادم.
المثال:
IPV4: 168.212.226.204
IPV6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334 |
client_user_agentوكيل مستخدم العميل string (سلسلة) | بدون تجزئة.
تمثل وكيل المستخدم للمتصفح المقابل للحدث. يكون client_user_agent مطلوبًا لأحداث موقع الويب التي تتم مشاركتها باستخدام واجهة API التحويلات. وقد تساعد عملية إرسال كل من المعلمتين client_ip_address وclient_user_agent لكل الأحداث التي ترسلها عبر واجهة API التحويلات في تحسين مطابقة الحدث وقد تساعد أيضًا في تحسين عرض الإعلان بالنسبة لأي حملات إعلانية يتم تحسينها ضمن الأحداث التي ترسلها عبر واجهة API التحويلات.
ملاحظة: تتم إضافة هذه المعلومات تلقائيًا إلى الأحداث المرسلة عبر المتصفح، ولكن يلزم تكوينها يدويًا بالنسبة للأحداث المرسلة عبر الخادم.
المثال:
Mozilla/5.0 (Windows NT 10.0; Win64؛ x64)
AppleWebKit/537.36 (KHTML، مثل Gecko)
Chrome/87.0.4280.141
Safari/537.36 |
fbcمعرف النقرة string (سلسلة) | بدون تجزئة.
يتم تخزين قيمة معرف النقرة في فيسبوك ضمن معلمة ملفات تعريف ارتباط المتصفح _fbc المتوفرة في نطاقك. راجع إدارة المعلمتين fbc وfbp للتعرف على كيفية الحصول على هذه القيمة أو إنشاء هذه القيمة من معلمة استعلام fbclid. يكون التنسيق fb.${subdomain_index}.${creation_time}.${fbclid}.
المثال:
fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890 |
fbpمعرف المتصفح string (سلسلة) | بدون تجزئة.
يتم تخزين قيمة معرف المتصفح في فيسبوك ضمن معلمة ملفات تعريف ارتباط المتصفح _fbc المتوفرة في نطاقك. راجع إدارة المعلمتين fbc وfbp للتعرف على كيفية الحصول على هذه القيمة. يكون التنسيق fb.${subdomain_index}.${creation_time}.${random_number}.
المثال:
fb.1.1596403881668.1116446470 |
subscription_idمعرف الاشتراك string (سلسلة) | بدون تجزئة.
تمثل معرف الاشتراك لدى المستخدم في هذه المعاملة؛ ويكون مشابهًا لمعرف الطلب الخاص بمنتج فردي. |
fb_login_idمعرف تسجيل دخول فيسبوك integer (عدد صحيح) | بدون تجزئة.
المعرف الصادر بواسطة Meta عندما يسجل شخص ما الدخول لأول مرة إلى مثيل التطبيق. ويُعرف أيضًا باسم المعرف على مستوى التطبيق. |
lead_idمعرف بيانات العميل المحتمل integer (عدد صحيح) | بدون تجزئة.
المعرف المرتبط ببيانات العملاء المحتملين التي تم تجميعها بواسطة إعلانات تجميع بيانات العملاء المحتملين في Meta. |
anon_idstring (سلسلة) | بدون تجزئة.
معرف التثبيت. يمثل هذا الحقل مثيلات تثبيت التطبيق الفريدة.
ملاحظة: هذه المعلمة لأحداث التطبيقات فقط |
madidstring (سلسلة) | بدون تجزئة.
معرف المعلن على الهاتف المحمول أو معرف الإعلان من جهاز Android أو معرف الإعلان (IDFA) من جهاز Apple.
ملاحظة: هذه المعلمة لأحداث التطبيقات فقط |
page_idstring (سلسلة) | بلا تجزئة.
معرف الصفحة. تحدد معرف الصفحة المرتبط بالحدث. استخدم معرف صفحة فيسبوك الخاص بالصفحة المرتبطة بالبرنامج التلقائي. |
page_scoped_user_idstring (سلسلة) | بلا تجزئة.
تحدد معرف المستخدم على مستوى الصفحة المرتبط ببرنامج messenger التلقائي الذي يسجل الحدث. استخدم معرف المستخدم على مستوى الصفحة والمتوفر في حدث webhook لديك. |
ctwa_clidstring (سلسلة) | بلا تجزئة.
انقر على المعرف الذي تم إنشاؤه بواسطة Meta لإعلانات النقر لفتح محادثة في واتساب. |
ig_account_idstring (سلسلة) | بلا تجزئة.
معرف حساب Instagram المرتبط بالنشاط التجاري. |
ig_sidstring (سلسلة) | بلا تجزئة.
يتم تحديد المستخدمين الذين يتفاعلون مع Instagram بواسطة معرفات المستخدمين على مستوى Instagram(IGSID). يمكن الحصول على معرف IGSID من حدث webhook هذا. |
