توضّح هذه الصفحة الحدود القصوى وأفضل الممارسات لإدارة الاستهداف باستخدام واجهة برمجة التطبيقات الخاصة بـ "مساحة العرض والفيديو 360".
الاستهداف الذي يتم تحديده عند إنشاء البند الإعلاني
تتضمّن بعض أنواع الاستهداف قيمًا تلقائية يتمّ تحديدها عند إنشاء البند الإعلاني. أنواع الاستهداف هذه هي:
لتجنُّب الأخطاء، يجب أن تكون على دراية بحزمة الاستهداف الكاملة التي يتم تعيينها لعناصر حملتك عند إنشائها. يمكنك استرداد جميع خيارات الاستهداف المعيّنة لعنصر إعلان
على مستوى bulkListAssignedTargetingOptions.
يتم تضمين بعض الإعدادات عندما لا يتم تحديد أي استهداف من نوع معيّن. على سبيل المثال،
إذا لم تتضمّن تفاصيل الإعلان
TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
خيار استهداف محدّدًا، ستستخدِم تفاصيل الإعلان "البائعين المباشرين المعتمدين
والمورّدين" عند عرض الإعلانات.
قد يتم إيقاف خيارات الاستهداف نهائيًا
خيارات الاستهداف ليست ثابتة. قد يتم إيقاف عدد صغير من الخيارات نهائيًا من حين لآخر. لا تؤثر خيارات الاستهداف المتوقّفة نهائيًا في عرض إعلانات البند. وبعد إيقافها نهائيًا، سيتم إلغاء تعيين هذه الخيارات. وستؤدي الطلبات التي تحاول استرداد هذه الخيارات أو تعيينها إلى حدوث أخطاء.
لتجنُّب هذه الأخطاء، تحقَّق بانتظام من أرقام تعريف خيارات الاستهداف المخزّنة. للحفاظ على الحصة، ننصحك بتخزين المعرّفات المستخدَمة بشكل متكرّر مؤقتًا.
يعني تخزين أرقام التعريف أنّه قد لا تدرك أنّه تم إيقاف خيار استهداف نهائيًا. استخدِم طريقة get بانتظام لاسترداد جميع أرقام تعريف خيارات الاستهداف المخزّنة للتأكّد من أنّها لا تزال متوافقة مع "مساحة العرض والفيديو 360".
ستتعذّر طلبات الاستهداف المتزامنة لعنصر العرض نفسه
ستؤدي محاولة تعديل الإعدادات أو الاستهداف المعيّن لبند إعلاني باستخدام طلبات متزامنة إلى عرض خطأ.
لإضافة خيارات استهداف متعدّدة تم تعيينها أو إزالتها لمرة واحدة في طلب bulkEditAssignedTargetingOptions واحد، استخدِم طلب bulkEditAssignedTargetingOptions واحدًا. إذا أردت تعديل إعدادات واستهدف بند إعلاني، ضَع طلباتك في قائمة الانتظار لضمان إرسالها بالتسلسل.
الأخطاء الشائعة في الاستهداف
هناك ثلاثة أسباب شائعة لحدوث أخطاء عند إدارة الاستهداف باستخدام واجهة برمجة التطبيقات Display & Video 360 API.
أخطاء في الإعدادات
يخضع الاستهداف لقيود الضبط. إذا حاول طلب تعديل الاستهداف بشكل يخالف هذه القواعد، سيعرض الطلب رسالة خطأ.
غالبًا ما تحدث أخطاء الإعداد بسبب الاستهداف الحالي. لتجنُّب ذلك، اتّبِع الخطوات التالية:
- يمكنك الحصول على الاستهداف الحالي لنوع معيّن باستخدام طلب
list. - راجِع إعدادات الاستهداف الحالية. تقييم عناصر الاستهداف التي يجب إضافتها أو إزالتها للحصول على الإعداد المطلوب
- تعديل الاستهداف باستخدام طلب
bulkEditAssignedTargetingOptions
لا يمكن إزالة الاستهداف المكتسَب من الموارد الرئيسية، ولكن يمكن أن يتسبّب في حدوث هذه الأخطاء.
أخطاء YouTube والشركاء
لا يمكنك تعديل استهداف "YouTube والشركاء " باستخدام Display & Video 360 API. وستؤدي الطلبات التي تحاول تعديل هذا الاستهداف إلى عرض خطأ.
يتم تعريف هذا الاستهداف على النحو التالي:
- أي استهداف تمّ تعيينه لبند إعلان أو مجموعة إعلانية على YouTube ومنصات الشركاء
- استهداف المعلِنين لمواضع الجلسات والقنوات والفيديوهات الفردية على YouTube
أخطاء التزامن
قد يؤدي طلب تعديل إعدادات أو استهداف البند الإعلاني نفسه في الوقت نفسه إلى حدوث خطأ.
لتجنُّب ذلك:
- إدارة الاستهداف بشكل مجمّع باستخدام طلب تعديل مجمّع
- وضع الطلبات التي تعدّل عنصر السطر نفسه في قائمة الانتظار لا ترسِل طلبًا إلا بعد أن يعرض الطلب السابق ردًا.