يمكنك استرداد تفاصيل الإعلانات على YouTube ومنصات الشركاء ومجموعاتها الإعلانية ومقاييسها الإعلانية واستهدافها ذي الصلة بعرض إعلانات YouTube ومنصات الشركاء باستخدام واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360". لا يمكن إنشاء مراجع واستهدافات YouTube والشركاء إلا أو تعديلها من خلال واجهة المستخدم.
توضّح هذه الصفحة كيفية استخدام Display & Video 360 API لتحديد موارد YouTube & Partners واسترداد الاستهداف ذي الصلة، وكيفية إنشاء موارد YouTube & Partners وتعديلها بشكلٍ مجمّع باستخدام ملفات البيانات المنظَّمة (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.bulkListAssignedTargetingOptions.
محاولة تعديل الاستهداف في YouTube
كما هو الحال مع مراجع YouTube والشركاء، لا يمكنك تعديل استهداف YouTube والشركاء باستخدام Display & Video 360 API. ستؤدي أي محاولة لتعديل الاستهداف التالي إلى ظهور خطأ:
- الاستهداف الذي تمّ تعيينه على أيّ مستوى من أنواع الاستهداف التالية:
TARGETING_TYPE_SESSION_POSITIONوTARGETING_TYPE_YOUTUBE_CHANNELوTARGETING_TYPE_YOUTUBE_VIDEO - الاستهداف الذي تمّ تعيينه لمصادر عناصر YouTube والشركاء
- الاستهداف الذي تمّ إسناده إلى موارد
AdGroup
الإنشاء والتحديث باستخدام واجهة المستخدم لتحميل ملف SDF
على الرغم من أنّه لا يمكنك إنشاء موارد YouTube والشركاء أو تعديلها باستخدام واجهة برمجة التطبيقات لمساحة العرض والفيديو 360، يمكنك إنشاء أو تعديل تفاصيل إعلانات YouTube والشركاء والمجموعات الإعلانية والإعلانات بشكلٍ مجمّع باستخدام تحميل ملف البيانات المنظَّمة (SDF) من خلال واجهة مستخدم "مساحة العرض والفيديو 360".
يتم تمثيل هذه المراجع في تنسيق SDF من خلال تنسيقات الملفات العنصر المجموعة الإعلانية على YouTube والإعلان على YouTube.
يمكنك إنشاء ملفات البيانات المنسّقة وتنزيلها باستخدام واجهة برمجة التطبيقات لمساحة العرض والفيديو 360. عدِّل الصفوف الحالية لإجراء تغييرات على مواردك الحالية أو أضِف صفوفًا جديدة لإنشاء موارد جديدة، وحمِّل الملفات المعدَّلة من خلال واجهة مستخدم "مساحة العرض والفيديو 360".