معلمات أحداث الخوادم

مطلوب.
طابع زمني بتنسيق Unix بالثواني يشير إلى الوقت الفعلي الذي وقع فيه الحدث. وقد يكون الوقت المحدد مبكرًا عن الوقت الذي ترسل فيه الحدث إلى فيسبوك. ذلك من أجل تمكين المعالجة المجمّعة وتحسين أداء الخادم. كما يجب إرسال هذا التاريخ بالمنطقة الزمنية بتوقيت جرينتش.

يمكن أن يصل event_time إلى 7 أيام قبل إرسال الحدث إلى فيسبوك. إذا كان event_time في data أكبر من 7 أيام في الماضي، فإننا نُرجع رسالة خطأ على الطلب بأكمله ولا نعالج أي أحداث.

اختياري.
خريطة تتضمن بيانات إضافية للنشاط التجاري حول الحدث. راجع معلمات البيانات المخصصة لمزيد من المعلومات.

اختياري.
علامة تشير إلى أنه يجب ألا نستخدم هذا الحدث بغرض تحسين عرض الإعلانات. إذا تم التعيين على القيمة true، فلن نستخدم الحدث إلا للإسناد فقط.

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

فيما يلي القيم التي يمكنك إرسالها في الحقل action_source:

• email — حدث التحويل عبر البريد الإلكتروني.
• website — تم إجراء التحويل على موقع الويب.
• app — تم إجراء التحويل عبر تطبيق الهواتف المحمولة.
• phone_call — تم إجراء التحويل عبر الهاتف.
• chat — تم إجراء التحويل عبر تطبيق مراسلة أو رسالة SMS أو ميزة المراسة على الإنترنت.
• physical_store — تم إجراء التحويل بصفة شخصية داخل متجرك الفعلي.
• system_generated — حدث التحويل تلقائيًا، على سبيل المثال، تجديد الاشتراك الذي يتم تعيينه إلى الدفع التلقائي كل شهر.
• business_messaging — تم التحويل من إعلانات النقر لفتح محادثة في Messenger أو Instagram أو واتساب.
• other — حدث التحويل بطريقة مختلفة عن الطرق المدرجة.

مطلوب، إذا أرسلت LDU ضمن data_processing_options.
البلد الذي تريد ربطه بخيار معالجة البيانات هذا. علمًا بأن القيم الحالية المقبولة هي 1 للولايات المتحدة الأمريكية، أو 0 لطلب تحديد الموقع الجغرافي لهذا الحدث. تعرف على المزيد حول خيارات معالجة البيانات. يمكنك الرجوع إلى أمثلة على تنفيذ واجهة API التحويلات.

app_data

مطلوب لأحداث التطبيق

معلمات مشاركة بيانات التطبيق ومعلومات الجهاز مع واجهة API التحويلات.

extinfo

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

ملاحظة:

• يجب أن يتوفر version بالقيمة a2 لنظام Android

• يجب أن يتوفر version بالقيمة i2 لنظام iOS

اختياري.
عنوان مرجع HTTP كما تعرضه الصفحة التي تقوم بتشغيل واجهة API التحويلات أو حدث بيكسل Meta. عادةً ما تكون هذه هي الصفحة السابقة في المتصفح.

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

يقبل هذا الحقل إحدى قيم التعداد التالية المحددة مسبقًا:

• new_customer_to_business: يمثل المستخدم عميلاً جديدًا لدى النشاط التجاري.
• new_customer_to_business_line: يمثل المستخدم عميلاً جديدًا لخط محدد لدى النشاط التجاري (على سبيل المثال، منتج أو خدمة).
• new_customer_to_product_area: يمثل المستخدم عميلاً جديدًا لمجال منتجات محدد (على سبيل المثال، التجارة الإلكترونية أو التمويل).
• new_customer_to_medium: يمثل المستخدم عميلاً جديدًا لوسيلة تسويق محددة (على سبيل المثال، وسائل التواصل الاجتماعي، البريد الإلكتروني).
• existing_customer_to_business: يمثل المستخدم عميلاً حاليًا لدى النشاط التجاري.
• existing_customer_to_business_line: يمثل المستخدم عميلاً حاليًا لخط محدد لدى النشاط التجاري (على سبيل المثال، منتج أو خدمة).
• existing_customer_to_product_area: يمثل المستخدم عميلاً حاليًا لمجال منتجات محدد (على سبيل المثال، التجارة الإلكترونية أو التمويل).
• existing_customer_to_medium: يمثل المستخدم عميلاً حاليًا لوسيلة تسويق محددة (على سبيل المثال، وسائل التواصل الاجتماعي، البريد الإلكتروني).
• customer_in_loyalty_program: يمثل المستخدم جزءًا من برنامج الولاء.

مثال على حمولة JSON:

{
 "event_name": "Purchase",
 "event_time": 1643723400,
 "user_data": {
   "em": "user@example.com"
 },
 "custom_data": {
   "currency": "USD",
   "value": 100.00,
   "customer_segmentation": "new_customer_to_business"
 }
}