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