ממשק ה-API של Display & Video 360 מאפשר לאחזר את הפריטים של YouTube ו-Partners, של קבוצות המודעות ושל משאבי המודעות שלהם, ולטרגט פריטים שרלוונטיים להצגת המודעות ב-YouTube & Partners. ניתן ליצור משאבים ומיקוד של YouTube ו-Partners רק או לעדכן אותם דרך ממשק המשתמש.
בדף הזה נסביר איך להשתמש ב-Display & Video 360 API כדי לזהות משאבים של YouTube ושותפים ולאחזר טירגוט רלוונטי, ואיך ליצור ולעדכן כמות גדולה של משאבים ב-YouTube ובשותפים באמצעות קובצי נתונים מובנים (SDF) בממשק המשתמש.
זיהוי משאבים של YouTube ושותפים
המשאבים של YouTube ו-Partners כוללים סוגים מסוימים של פריטים, קבוצות של מודעות ומודעות.
פריטים
הפריטים של הערכים הבאים ב-LineItemType
הם פריטים של YouTube ו-Partners אי אפשר ליצור או לעדכן:
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
את ההגדרות הספציפיות לפריטי YouTube & Partners אפשר לאחזר מהשדה youtubeAndPartnersSettings
במשאב LineItem
.
קבוצות מודעות ומודעות YouTube
קבוצות מודעות ומודעות YouTube הן משאבים צאצאים שנכללים בפריטים של YouTube ו-Partner שמאפשרים פרטים נוספים.
לכל פריט של YouTube ו-Partners יכולים להיות מספר משאבים של AdGroup
, ולכל אחד מהם טירגוט נוסף ושיטת בידינג משלו. מתחת לכל משאב AdGroup
יכולים להיות מספר AdGroupAd
משאבים עם אותו פורמט מודעה, ולכל אחד מהם יש פרטי קריאייטיב ורשימה של כתובות URL נוספות למעקב.
אחזור המיקוד
הטירגוט להצגת מודעות של YouTube ו-Partners מוקצה ברמת המפרסם, ברמת הפריט וברמת קבוצת המודעות.
הגדרות הטירגוט של YouTube ושל שותפים שעברו בירושה ממשאבי ההורה לא משתקפות בהגדרות הטירגוט של משאבי הצאצא, כמו כפי שסטנדרטי למשאבים שאינם YouTube ו-Partners.
כדי לאחזר את כל הגדרות המיקוד הרלוונטיות להצגת מודעת YouTube ו-Partners, עליך:
- אחזור הטירגוט שהוקצה למפרסם ההורה באמצעות
advertisers.listAssignedTargetingOptions
, - אחזור הטירגוט שהוקצה לפריט ההורה באמצעות
advertisers.lineItems.bulkListAssignedTargetingOptions
, - ולאחזר טירגוט שהוקצה לקבוצת המודעות של ההורה באמצעות
advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions
.
מנסה לשנות את הטירגוט ב-YouTube
כמו במקרה של המשאבים YouTube ו-Partners, אי אפשר לשנות את הטירגוט של YouTube ושל שותפים באמצעות Display & Video 360 API. כל ניסיון לשנות את המיקוד הבא יחזיר שגיאה:
- הטירגוט מוקצה בכל רמה של סוגי הטירגוט הבאים:
TARGETING_TYPE_SESSION_POSITION
,TARGETING_TYPE_YOUTUBE_CHANNEL
ו-TARGETING_TYPE_YOUTUBE_VIDEO
. - טירגוט שהוקצה למשאבי פריטים של YouTube ו-Partners.
- הטירגוט הוקצה למשאבי
AdGroup
.
יצירה ועדכון באמצעות העלאה בממשק משתמש SDF
אי אפשר ליצור או לעדכן משאבים של YouTube ו-Partner באמצעות Display & Video 360 API, אבל אפשר ליצור ולעדכן פריטים, קבוצות של מודעות ומודעות בבת אחת ב-YouTube & Partners באמצעות קובץ נתונים מובנה (SDF) דרך ממשק המשתמש של Display & Video 360.
המשאבים האלה מיוצגים ב-SDF באמצעות הפורמטים של הקבצים פריט, קבוצת מודעות ב-YouTube ומודעות YouTube.
אפשר ליצור ולהוריד קובצי נתונים מובְנים באמצעות Display & Video 360 API. אפשר לערוך את השורות הקיימות כדי לבצע שינויים במשאבים קיימים או להוסיף שורות חדשות כדי ליצור משאבים חדשים, ולהעלות את הקבצים המעודכנים דרך ממשק המשתמש של Display & Video 360.