انتقل إلى المحتوى
تكامل

Meta Conversions API

حسّن جودة أحداث التحويل المُرسلة إلى Meta.

إعداد مدروسمراجعة الجودةتكامل منضبط
كيف يعمل Meta CAPI

من الأحداث المتحقَّق منها إلى إشارات أدق

نتحقق من الحدث والصلاحيات ثم نرسل إشارة التحويل الصحيحة.

عرض توضيحيبدون بيانات عملاء فعلية

ماذا يقدم هذا التكامل؟

اربط أحداث الطرف الأول المراجعة بقياس Meta بعد اختبار الإعداد.

وحّد أسماء أحداث الشراء والعملاء المحتملين. راجع معرفات أحداث المتصفح والسيرفر.

الفوائد الأساسية

خرائط أحداث أوضح

وحّد أسماء أحداث الشراء والعملاء المحتملين.

منع التكرار

راجع معرفات أحداث المتصفح والسيرفر.

متابعة الجودة

اختبر استقبال الأحداث والموافقات وجودة المطابقة.

خطوات الربط

01

حدد الأحداث المصرّح بها

ابدأ بالأحداث التي تدعم هدفك، لا بمجرد إرسال كل البيانات.

02

جهّز المعرفات والموافقات

وحّد أسماء الأحداث ومعرّفاتها قبل الربط بين الأنظمة.

03

اختبر الإرسال ومنع التكرار

راجع الصلاحيات والموافقات ومسار التعامل مع الأخطاء.

الأحداث والحقول المطلوبة

في تكامل Meta Conversions Api لا يكفي إرسال كل ما يتاح من بيانات. نحدد أولًا النتائج التجارية المطلوبة، ثم نختار الأحداث الملائمة، مثل: Lead, CompleteRegistration, InitiateCheckout, Purchase, and selected custom conversions. هذه أمثلة للمتطلبات التي ينبغي مراجعتها وليست وعدًا بأن كل حدث مدعوم تلقائيًا. نحدد مع العميل مصدر الحدث وصلاحيات استخدامه ونقطة تسجيله الصحيحة قبل بناء أي خريطة إرسال.

الحقول التي نراجع ملاءمتها بحسب طبيعة الحالة تشمل: event_name, event_time, event_id, action_source, approved matching data and order value. لا نجمع هذه الحقول كلها بالضرورة؛ نستخدم الحد الأدنى المسموح به فقط، ونمنع انتقال المعلومات الحساسة إلى منصات غير مناسبة. الأهم هو ثبات المعرّفات وتطابق القيمة والزمن مع السجل الأصلي حتى تكون المقارنة عادلة.

مثال عملي على رحلة البيانات

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

لتقييم نطاق Meta Conversions Api نبدأ بتقسيم الحالات إلى أحداث أساسية وأحداث اختيارية. الأحداث التي تستحق الإعداد أولًا هي: Lead, CompleteRegistration, InitiateCheckout, Purchase, and selected custom conversions. بعد ذلك نحدد ما الذي لا يجب إرساله أصلًا، ومن له حق الاطلاع على النتائج، وكيف تختلف الإجراءات بين الاختبار والإنتاج. وجود هذه الحدود يجعل تغيير الإعداد لاحقًا أكثر أمانًا.

خطة التنفيذ والاختبار

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

نضع قائمة مراجعة للحقول الخاصة بالمصدر: event_name, event_time, event_id, action_source, approved matching data and order value. لكل حقل نحدد النوع المتوقع والقيمة الافتراضية ومصدر الحقيقة وطريقة التأكد من سلامته. إذا تغيّر الاسم أو صيغة القيمة في النظام المصدر، ينبغي أن يظهر فشل واضح في الاختبار بدل إرسال نتائج لا يمكن الوثوق بها.

الأخطاء الشائعة وكيف نكتشفها

من المشكلات التي تستحق اختبارًا محددًا: missing event IDs, wrong currency, poor event matching, unapproved personal data and inconsistent value. نضع لكل مشكلة علامة تحذير أو اختبارًا قبل التفعيل. لا يكفي نجاح اختبار واحد؛ يفضل تجربة حالة صحيحة وحالة مكررة وحالة ناقصة أو ملغاة، ثم التأكد من أن النتيجة النهائية يمكن تفسيرها من سجل النظام.

عند الاستلام، نراجع ثلاثة سيناريوهات مرتبطة بـMeta Conversions Api: تنفيذ طبيعي، وإعادة إرسال الحدث نفسه، وحالة نقص أو إلغاء. مثال التحقق الأساسي: يُرسل حدث شراء من المتصفح والسيرفر باستخدام معرف الحدث نفسه. نراجع جودة الحدث ومنع التكرار حتى لا تُحتسب عملية الشراء مرتين. نقيس التأخير المحتمل بين المصدر والوجهة، ونتأكد من أن عمليات الإعادة لا تتحول إلى تحويلات إضافية.

معايير نجاح الربط

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

بعد التشغيل، نحدد مسؤولًا عن مراقبة الأرقام وأسباب الأخطاء. تشمل قائمة المراجعة: missing event IDs, wrong currency, poor event matching, unapproved personal data and inconsistent value. عند ظهور اختلاف، نبدأ برقم الحدث أو السجل الأصلي، ثم نفحص توقيت الإرسال وحالة الاستجابة، ونوثق أي تغيير في خرائط البيانات قبل إعادة الاختبار.

الخصوصية والصلاحيات

اجمع أقل قدر ضروري من البيانات وراجع الموافقة والصلاحيات ومنع التكرار قبل الإرسال.

تختلف الجاهزية حسب الحساب والتصاريح ومسار الربط. يتم اختبار الاتصال قبل التشغيل.

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

ما البيانات التي يمكن ربطها؟

يمكن البدء ببيانات وأحداث محددة تخص Meta Conversions API بعد مراجعة الإعداد والصلاحيات والموافقات.

كيف نعرف أن التكامل يعمل؟

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

هل التكامل جاهز للاستخدام المباشر؟

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

ابدأ بخطة تكامل مناسبة

اربط أحداث الطرف الأول المراجعة بقياس Meta بعد اختبار الإعداد.

راجع متطلبات التكامل معنا
Book a Demo WhatsApp