يمكنك استرداد عناصر YouTube و"الشركاء" ومجموعاتها الإعلانية ومواردها الإعلانية والاستهداف ذي الصلة بعرض الإعلانات على YouTube والشركاء باستخدام مساحة العرض والفيديو 360 API. يمكن إنشاء موارد واستهداف YouTube و"الشركاء" فقط أو تعديلها من خلال واجهة المستخدم.
توضّح هذه الصفحة طريقة استخدام واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" لتحديد موارد YouTube والشركاء واسترداد الاستهداف ذي الصلة، وكيفية إنشاء موارد YouTube و"الشركاء" وتعديلها بشكل مجمَّع باستخدام ملفات البيانات المنظَّمة (SDF) في واجهة المستخدم.
تحديد موارد YouTube والشركاء
تتألف مراجع YouTube والشركاء من أنواع معيّنة من العناصر والمجموعات الإعلانية والإعلانات.
العناصر
عناصر قيم LineItemType التالية هي عناصر YouTube
والشركاء ولا يمكن إنشاؤها أو تعديلها:
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTIONLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIOLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACHLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCYLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
يمكن استرداد الإعدادات الخاصة بعناصر YouTube والشركاء من الحقل
youtubeAndPartnersSettings في المرجع
LineItem.
المجموعات الإعلانية والإعلانات على YouTube
المجموعات الإعلانية والإعلانات على YouTube هي مراجع فرعية ضمن عناصر YouTube والشركاء تتيح وضع المزيد من المواصفات.
يمكن أن يتضمّن عنصر YouTube والشركاء عدة موارد
AdGroup تحته، ولكل منها استهدافًا
إضافيًا واستراتيجية عروض أسعار خاصة به. أسفل كل مورد
AdGroup يمكن أن يكون هناك موارد AdGroupAd
متعددة لها شكل الإعلان نفسه، ويتضمّن كل منها معلومات المواد الإبداعية الخاصة به وقائمة بعناوين URL
الإضافية للتتبّع.
استرداد الاستهداف
يتم تحديد الاستهداف المستخدَم لعرض الإعلانات على YouTube والشركاء على مستوى المعلِن وعلى مستوى العنصر وعلى مستوى المجموعة الإعلانية.
إنّ استهداف YouTube والشركاء المكتسَب من الموارد الرئيسية لا يظهر في إعدادات الاستهداف للموارد الفرعية، كما هو الحال في الموارد غير التابعة لمنصة YouTube والشركاء.
لاسترداد كل الاستهداف المرتبط بعرض إعلان على YouTube والشركاء، يجب:
- لاسترداد الاستهداف الذي تم تعيينه للمعلِن الرئيسي باستخدام
advertisers.listAssignedTargetingOptions، - استرداد الاستهداف الذي تم تعيينه لعنصره الرئيسي باستخدام
advertisers.lineItems.bulkListAssignedTargetingOptions - واسترداد الاستهداف الذي تم تعيينه لمجموعته الإعلانية الرئيسية باستخدام
advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions.
محاولة تعديل استهداف YouTube
كما هي الحال بالنسبة إلى مراجع YouTube و"الشركاء"، لا يمكنك تعديل استهداف YouTube والشركاء باستخدام واجهة برمجة التطبيقات "مساحة العرض والفيديو 360". ستؤدي أي محاولة لتعديل الاستهداف التالي إلى عرض خطأ:
- الاستهداف الذي تم تحديده على أي مستوى من أنواع الاستهداف التالية:
TARGETING_TYPE_SESSION_POSITIONوTARGETING_TYPE_YOUTUBE_CHANNELوTARGETING_TYPE_YOUTUBE_VIDEO. - تم تحديد الاستهداف لموارد تفاصيل الإعلان على YouTube و"الشركاء".
- تم تحديد الاستهداف لموارد
AdGroup.
الإنشاء والتحديث باستخدام تحميل واجهة مستخدم SDF
على الرغم من أنّه لا يمكنك إنشاء موارد YouTube والشركاء أو تعديلها باستخدام مساحة العرض والفيديو 360 API، يمكنك إنشاء أو تعديل العناصر والمجموعات الإعلانية والإعلانات في YouTube والشركاء بشكل مجمَّع باستخدام تحميل ملف البيانات المنظَّمة (SDF) من خلال واجهة مستخدم "مساحة العرض والفيديو 360".
ويتم تمثيل هذه الموارد في SDF من خلال تنسيقات الملفات Line Item (تفاصيل) وYouTube Ad Group وYouTube Ad.
يمكنك إنشاء ملفات البيانات المنظَّمة وتنزيلها باستخدام "مساحة العرض والفيديو 360 API". عدِّل الصفوف الحالية لإجراء تغييرات على الموارد الحالية أو أضِف صفوفًا جديدة لإنشاء موارد جديدة، وحمِّل الملفات المعدَّلة من خلال واجهة مستخدم "مساحة العرض والفيديو 360".