الاختبار واستكشاف الأخطاء وإصلاحها

استخدم API هذه لإنشاء بيانات العملاء المحتملين الاختبارية، وحذفها.

استخدام أداة الاختبار

يمكنك استخدام هذه الأداة لإنشاء بيانات العملاء المحتملين الاختبارية وحذفها في النماذج المتوفرة لديك؛ ومع ذلك، لا يمكنك استخدام الأداة في وضع المطوِّر.

يمكنك إنشاء عميل محتمل اختباري واحد لكل نموذج. وسيتعين عليك حذف بيانات العميل المحتمل الحالي حتى تتمكّن من إنشاء بيانات أخرى جديدة.

تصحيح أخطاء دمج التحديث الفوري

استخدم هذه الأداة لاختبار ما إذا كان الدمج مع أحداث Webhooks فيسبوك ناجحًا. فيما يلي خطوات استخدام هذه الأداة لتصحيح أخطاء الدمج.

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

  1. انتقل إلى أداة الاختبار.

  2. تتضمن القائمة المنسدلة كل الصفحات التي تتوفر لدى المعلن إمكانية الوصول إليها.

  3. حدّد صفحة من القائمة المنسدلة.

  4. في القائمة المنسدلة نموذج، حدّد نموذجًا لاستخدامه في إنشاء بيانات العميل المحتمل.

  5. انقر على إنشاء بيانات العميل المحتمل لإنشاء بيانات العميل المحتمل. بشكل افتراضي، تتضمن بيانات العميل المحتمل التي يتم إنشاؤها بيانات وهمية داخلها.

  6. انقر على معاينة النموذج لتخصيص البيانات التي يتم إرسالها.

  7. أدخل البيانات المطلوبة على مستوى النموذج لإنشاء بيانات عميل محتمل تتضمن محتوى مخصص.

  8. بمجرد إنشاء بيانات العميل المحتمل، سيظهر الزر تتبع الحالة.

  9. انقر على تتبع الحالة لعرض حالة بيانات العملاء المحتملين. يستغرق الأمر بضع ثوانٍ لتشغيل RTU في نقطة النهاية لديك. وحتى ذلك الوقت، ستظهر لك RTU بالحالة معلقة. انقر على تتبع الحالة مرة أخرى حتى ترى الحالة تتغير.

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

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

اختبار بيانات العميل المحتمل

يمكنك اختبار بيانات العملاء المحتملين عبر الزر "اختبار" بعد إعداد أحداث Webhooks لتطبيقك. ويكون الزر موجودًا في لوحة معلومات أحداث Webhooks الخاصة بالتطبيق.

إنشاء بيانات العملاء المحتملين الاختبارية

يمكنك إنشاء بيانات عميل محتمل اختبارية عن طريق إرسال طلب POST إلى /{FORM_ID}/test_leads.

لضمان نجاح هذا الطلب، يتعين تلبية المتطلبات التالية:

  • يجب ألا تكون لديك بيانات العملاء المحتملين الاختبارية الحالية لنموذج إعلان تجميع بيانات العملاء المحتملين المحدد.
  • يجب أن تحصل على دور بالصفحةAdvertiser أو دور أعلى في الصفحة بحيث يتم إنشاء النموذج بموجبه.
curl \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

يمكنك تخصيص محتوى بيانات العميل المحتمل الاختبارية عن طريق إدخال المعلمات التالية:

  • field_data: معلمة متجه تتضمن الزوجين name وvalues.
  • custom_disclaimer_responses: معلمة متجه تتضمن الزوجين checkbox_key وis_checked.
curl \
  -F "field_data=[{'name': 'favorite_color?', 'values': ['yellow']}, {'name': 'email', 'values': ['test@test.com']}]" \
  -F "custom_disclaimer_responses=[{'checkbox_key': 'my_checkbox', 'is_checked': true}]" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

تكون بيانات العملاء المحتملين التي يتم إنشاؤها من الاستدعاءات الموضحة أعلاه عبارة عن بيانات زائفة للعملاء المحتملين، وبالتالي تكون غير مرتبطة بأي إعلانات.

قراءة بيانات العملاء المحتملين الاختبارية

يمكنك قراءة بيانات العملاء المحتملين الاختبارية المرتبطة بنموذج إعلانات تجميع بيانات عملاء محتملين عن طريق استدعاء GET إلى نقطة النهاية {FORM_ID}/test_leads.

curl \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

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

إذا كنت تختبر الدمج وتريد حذف بيانات العميل المحتمل بحيث يمكنك إعادة إرسالها، فيمكنك تنفيذ استدعاء API التالي:

curl -X DELETE \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<LEAD_ID>"

لا يمكن حذف بيانات العميل المحتمل سوى بواسطة مالك البيانات فقط.