‏واجهة API التحويلات‏

أفضل الممارسات - واجهة API التحويلات

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

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

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

التنفيذ

عند إعداد حملتك الإعلانية، قم بتبسيط بنية الحساب واستخدم أفضل الممارسات التالية للحملة الإعلانية التي تم إنشاؤها:

إعداد الأحداث المتكررة

نوصيك باستخدام واجهة API التحويلات، بالإضافة إلى بيكسل Meta ومشاركة الأحداث نفسها باستخدام كلتا الأداتين. ونطلق على ذلك اسم إعداد الحدث المتكرر. فعلى سبيل المثال، إذا قمت بمشاركة الأحداث Purchase وInitiate Checkout وContact باستخدام بيكسل Meta، فيجب عليك أيضًا مشاركة الأحداث ذاتها من الخادم لديك باستخدام واجهة API التحويلات.

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

التأكد من إلغاء تكرار الأحداث المتكررة

عند إرسال الأحداث المتكررة باستخدام بيكسل Meta وواجهة API التحويلات، تأكد من أن كلا الحدثين يستخدمان event_name المطابق ويتضمنان event_id أو مزيج من external_id وfbp. نوصيك بتضمين كل هذه المعلمات لمساعدة Meta في إلغاء تكرار الأحداث بشكل صحيح وتقليل معدل الإبلاغ المزدوج عن الأحداث المتطابقة. تعرف على المزيد حول إلغاء التكرار عند الضرورة وكيفية إعداده.

إرسال المعلمات المطلوبة والموصى بها

تكون المعلمات التالية لحدث الخادم ومعلومات العميل مطلوبة:

المعلمةالنوعمتى يلزم توفرها

action_source

حدث خادم

كل الأحداث

event_source_url

حدث خادم

كل أحداث مواقع الويب

client_user_agent

معلومات عميل

كل أحداث مواقع الويب

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

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

  • عنوان البريد الإلكتروني (em)
  • عنوان IP (client_ip_address)
  • الاسم (fn وln)
  • رقم الهاتف (ph)

المتطلبات الأساسية للمطابقة

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

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

  • ct + country + st + zp + ge + client_user_agent
  • db + client_user_agent
  • fn + ge
  • ln + ge

على سبيل المثال، إذا كان الحدث يحتوي فقط على معلمات معلومات العميل ge وct وst وcountry (يمكن أن يتوافق هذا مع رجل، في مينلو بارك، كاليفورنيا، الولايات المتحدة الأمريكية)، فسيتم رفضه لأن معلمات معلومات العميل هذه هي مجموعة فرعية من إحدى المجموعات الأساسية المذكورة أعلاه.

التأكد من تحديث المعلمتين fbp وfbc

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

سيتم تعيين هذه القيم كملفات تعريف ارتباط الموقع الحالي عندما يتم تنفيذ بيكسل Meta على موقع الويب ويمكن استردادها لاستخدامها في طلبات واجهة API التحويلات.

مشاركة الأحداث الأقرب للوقت الفعلي

يمكن أن تساعد مشاركة الأحداث بمجرد وقوعها حملاتك الإعلانية في تحقيق أفضل النتائج. ويمكنك مشاركة أحداث الخادم باستخدام واجهة API التحويلات في الوقت الفعلي أو في دُفعات قريبة للوقت الفعلي.

استخدام الأحداث الاختبارية

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

يمكنك استخدام أداة الأحداث الاختبارية من أجل:

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

تعرف على كيفية اختبار أحداث الخادم باستخدام أداة الأحداث الاختبارية.

استخدام أداة مساعدة حمولة البيانات

املأ حقول معلمات البيانات المطلوبة والموصى بها في أداة مساعدة حمولة البيانات لمعرفة كيفية هيكلة حمولة البيانات والحصول على توصيات بشأن المعلمات المطلوب تضمينها.

استخدام مجموعة SDK للنشاط التجاري

تتضمن عينات الرموز البرمجية المتوفرة في وثائقنا أمثلة على مجموعة SDK للنشاط التجاري باللغات Python وJava وRuby وPHP وNode. ويمكنها توفير بعض جهود التطوير المبذولة، مثل تجزئة معلمات المستخدم التي يتم إجراؤها تلقائيًا في مجموعة SDK للنشاط التجاري.

إذا لم تكن تخطط لاستخدام مجموعة SDK للنشاط التجاري، فنوصيك بتنفيذ التجزئة.

استخدام واجهة API التحويلات في أحداث التحويل بلا اتصال

واجهة API التحويلات تدعم كل أحداث التحويل بلا اتصال ويجب استخدامها كحاوية شاملة لهذه الأنواع من الأحداث. تتضمن الأمثلة مبيعات المتجر الفعلي والمكالمات الهاتفية والإجراءات التي يتم اتخاذها على الأجهزة (مثل أجهزة التلفزيون الذكية أو وحدات التحكم في الألعاب) والاشتراكات غير المتصلة.

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

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

أفضل الممارسات الإضافية للشركاء

الوكالات: إرسال السلسلة partner_agent

يجب على الشركاء أو الوكالات التي تشارك الأحداث نيابة عن المُعلِنين لديها إرسال سلسلة partner_agent فريدة، بما في ذلك اسم المنصة كما هو موضح. وإذا أمكن، فيمكنك التعاون مع ممثل Meta لديك لتحديد سلسلة وكيل مناسبة.

منصات مواقع الويب: إعداد المعلنين

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

مرحلة ما بعد التنفيذ

التحقق من جودة مطابقة الحدث

إذا كنت تشارك أحداث الخوادم باستخدام واجهة API التحويلات، فيمكنك الاطّلاع على جودة مطابقة الحدث (EMQ) بالنسبة لكل حدث في مدير الأحداث. تشير نقاط جودة مطابقة الحدث (من إجمالي 10 نقاط) إلى مدى فعالية مطابقة معلومات العميل لحدث الخادم بحساب فيسبوك أو Meta. تعرف على المزيد حول أفضل ممارسات جودة EMQ من هنا.

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

إجراء اختبار

عند استخدام واجهة API التحويلات، نوصيك باختبار إستراتيجية الإعلانات على Meta وتحسينها. تتضمن بعض خيارات الاختبار ما يلي:

  • دراسة حول تحسين التحويل: تعرّف على تأثير الأداء التزايدي الناتج عن استخدام أحداث الخوادم.

  • اختبار التقسيم: تعرّف على إستراتيجية الحملة الإعلانية التي تحقق أفضل النتائج وأكثرها فعالية لتحسين الأداء.

معرفة المزيد