الحصة

يحدّ حصة Display & Video 360 API من معدّل إرسال مشروع للطلبات إلى واجهة برمجة التطبيقات.

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

تقديم طلبات إلى معلِنين متعدّدين في الوقت نفسه

يتم ضبط حصة واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" لكل مشروع ولكل معلِن. تحدّ حصص المشاريع من عدد الطلبات التي يقدّمها المشروع. تحدّ حصة المعلِن من الطلبات التي يقدّمها مشروع إلى معلِن.

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

استخدام مَعلمات طلب البحث list

استخدِم مَعلمات طلب البحث الخاصة بطريقة list لتضمين الموارد المطلوبة فقط. كلّما قلّ عدد الموارد، قلّ عدد الطلبات اللازمة لإدراجها.

توفّر طرق list ثلاث مَعلمات رئيسية:

• تحدّد pageSize عدد الموارد التي يمكن أن يعرضها الطلب. يعتمد حجم الصفحة التلقائي على الطريقة. اضبط هذا الخيار على أعلى قيمة لعرض المزيد من المراجع لكل طلب.
• يحدّ filter من الموارد المدرَجة حسب المعايير المقدَّمة. اضبط هذا الخيار لعرض مجموعة فرعية فقط من الموارد. اطّلِع على فلترة طلبات القوائم للحصول على مزيد من المعلومات.
• orderBy لترتيب المراجع المُدرَجة حسب السمة المحدّدة. اضبط هذه القيمة على لاسترداد الحدّ الأعلى أو الأدنى لقائمة الموارد بعدد أقل من الطلبات.

استخدام الدوال المجمّعة والدوال على مستوى المورد

تنفّذ الوظائف المجمّعة وعلى مستوى المورد مهام معقّدة. يمكن أن يحلّ طلب واحد إلى هذه الطرق محلّ طلبات متعددة إلى طرق أخرى.

لمزيد من المعلومات حول هذه الطرق، يُرجى الاطّلاع على الطلبات المجمّعة.

معرّفات ذاكرة التخزين المؤقت

تتطلّب العديد من إجراءات Display & Video 360 API أرقام تعريف يتم استردادها باستخدام واجهة برمجة التطبيقات. وتشمل الأمثلة معرّفات خيارات الاستهداف ومعرّفات جمهور Google. تخزين المعرّفات محليًا حتى لا تحتاج إلى استردادها باستمرار

قد يؤدي استخدام أرقام تعريف للموارد التي تم إيقافها نهائيًا أو حذفها إلى عرض رسالة خطأ. عليك استرداد المعرّفات المخزّنة مؤقتًا أسبوعيًا لتأكيد حالتها.

استخدام خوارزمية الرقود الأسي الثنائي

التمهّل بين عمليات إعادة المحاولة هو استراتيجية للتعامل مع الأخطاء. وتعيد محاولة الطلبات على مدار فترة زمنية متزايدة.

أثناء إجراء استطلاع لمهمة تستغرق وقتًا طويلاً، مثل مهمة تنزيل ملف SDF، يمكن أن تقلّل استراتيجية التراجع الأسي عدد الطلبات المُرسَلة.

تستخدم أمثلة الرموز البرمجية لتنزيل SDF أسلوب التراجع الأسي مع مكتبات العملاء. في ما يلي مثال على عملية التراجع الأسي:

• استرداد العنصر Operation باستخدام طلب get
  • إذا لم تكن قيمة done صحيحة، يعني ذلك أنّ المهمة لا تزال قيد التنفيذ.
  • انتظِر لمدة 5 ثوانٍ بالإضافة إلى عدد عشوائي من الثواني، ثم أعِد محاولة إجراء الطلب.
• استرداد العملية
  • إذا لم تكن القيمة done صحيحة، يعني ذلك أنّ المهمة لا تزال قيد التنفيذ.
  • انتظِر لمدة 10 ثوانٍ بالإضافة إلى عدد عشوائي من الثواني، ثم أعِد محاولة إجراء الطلب.
• استرداد العملية
  • إذا لم تكن القيمة done صحيحة، يعني ذلك أنّ المهمة لا تزال قيد التنفيذ.
  • انتظِر لمدة 20 ثانية بالإضافة إلى عدد عشوائي من الثواني، ثم أعِد محاولة إجراء الطلب.
• استرداد العملية
  • إذا لم تكن القيمة done صحيحة، يعني ذلك أنّ المهمة لا تزال قيد التنفيذ.
  • انتظِر لمدة 40 ثانية بالإضافة إلى عدد عشوائي من الثواني، ثم أعِد محاولة إجراء الطلب.
• استرداد العملية
  • إذا لم تكن القيمة done صحيحة، يعني ذلك أنّ المهمة لا تزال قيد التنفيذ.
  • انتظِر لمدة 80 ثانية بالإضافة إلى عدد عشوائي من الثواني، ثم أعِد محاولة إجراء الطلب.
• استمر في هذا النمط إلى أن تصبح قيمة done صحيحة أو إلى أن ينقضي الحد الأقصى للوقت.