الأخطاء والتحذيرات

تناقش هذه الصفحة الأنواع المختلفة من الأخطاء والتحذيرات التي قد تواجهها عند استخدام شاشة العرض Video 360 API:

أخطاء واجهة برمجة التطبيقات

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

تأخذ استجابة الخطأ التنسيق التالي وتتضمن رمز استجابة HTTP، ورسالة خطأ وحالة رمز RPC من Google:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

في ما يلي قائمة بالأخطاء الشائعة في واجهة برمجة التطبيقات بالإضافة إلى الإجراء المقترح اتخاذه في حال إرجاعها:

أخطاء SDF

الشاشة تستخدم واجهة برمجة تطبيقات Video 360 طريقة غير متزامنة إنشاء ملفات البيانات المنظَّمة (SDF) وتنزيلها. لهذا الغرض السبب، الأخطاء التي حدثت أثناء إنشاء SDF يتم إرجاعها في SDF النهائي مهمة التنزيل. اكتملت مهمة تنزيل SDF في error تم وضع علامة "تم" عليها، ولكنها تحتوي على حقل خطأ تمت تعبئته بدلاً من اسم مورد الوسائط في الحقل response، كما هو موضّح في المثال المقتطع:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

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

• تأكَّد من أنّ المستخدم لديه الأذونات المناسبة لحساب أحد الوالدَين. الشريك أو المعلن.
• تأكَّد من دقة المعرّفات المقدَّمة في الفلتر. مع نوع المورد المقصود، وتكون ضمن سياق تم تقديم معرف الجذر.
• تأكد من عدم تجاوز حد التنزيل المتزامن وهو عشرين من SDF مهام لكل مستخدم.

إذا استمرّت الأخطاء في الظهور، يُرجى التواصل مع فريق الدعم للإبلاغ. مشكلتك.

تحذيرات لا تؤدي إلى الحظر

يتم تعيين التحذيرات التي لا تؤدي إلى حظر إلى العناصر للإشارة إلى التي قد تؤثر في عرض تفاصيل الإعلان. يتم إرسال تحذيرات مشابهة في واجهة المستخدم من خلال بانر الإشعارات هذه التحذيرات سلبية مُدرجة في حقل warningMessages للعنصر.

على الرغم من أنها سلبية، يمكن أن تؤثر المشكلات التي تتسبب في هذه التحذيرات على عرض إلى حد منعه تمامًا.

الوقاية

يمكن تجنُّب العديد من المشاكل التي تؤدي إلى تحذيرات لا تؤدي إلى الحظر عن طريق اتّباع ضبط إعدادات تفاصيل الإعلان، بما في ذلك ما يلي:

• الرحلات الجوية: إذا كانت مدّة عرض إعلانات العنصر غير صالحة أو إذا كانت انتهت صلاحية عرض الطلب الخاص بطلب الإدراج الرئيسي، سيُنشئ العنصر تحذيرية ولن يتم عرضها. لتجنب المشكلة الأخيرة، تأكد من وجود سطر لا تنتهي رحلة العنصر بعد رحلة وصوله من القائمة الرئيسية طلبك.
• تصميمات الإعلانات المعيَّنة: في حال عدم وجود تصميم إعلان صالح المخصص لعنصر ما، فسينشئ البند تحذيرًا ولن
• الاستهداف: في حال عدم تحديد استهداف العنصر تعيينه بشكل صحيح، فقد ينتج عن البند تحذيرًا وقد يتم أو منعها تمامًا.

في حال تكرار الإعدادات من بند حالي، تأكَّد من أنّ لا ينشئ العنصر الحالي أي تحذيرات غير متوقعة.

المراقبة

قد تظهر مشاكل تسبب تحذيرات لا تؤدي إلى الحظر أثناء وجود أحد البنود رِحْلِةِ الطَّيَرَانْ. ولضمان عرض تفاصيل الإعلانات بشكل صحيح، راقِبها البنود النشطة للتحذيرات التي تم إنشاؤها حديثًا. يمكن استرداد تفاصيل الإعلان بشكل مجمّع باستخدام الدالة advertisers.lineItems.list. في حال حذف لنفترض أن هناك بندًا ينتج عنه تحذير غير متوقع، فيجب أن تحل المشكلة بشكل فوري للحدّ من تأثيرها على عرض الإعلانات

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