העברה לקובצי נתונים מובנים, גרסה 7

עדכון אחרון: 18 באוקטובר 2023

במדריך הזה נסביר איך עוברים ל-Structured Data Files (קבצי SDF) גרסה 7 מגרסה קודמת, ואילו שינויים נדרשים ומוצעים אפשר לבצע כדי לשפר את האופטימיזציה של השילוב.

בנתוני הגרסה מופיעה רשימה מפורטת של ההבדלים בין גרסה 6 לבין גרסה 7.

העברת הגרסה של קובצי הנתונים המובְנים

כדי לעבור לגרסה 7 של קובצי נתונים מובְנים מגרסה קודמת, צריך לציין את הגרסה החדשה, לעדכן את מרחבי המזהים של קבוצת משנה של עמודות קיימות ולהוסיף שילוב עם עמודות חדשות.

עדכון הגרסה של קבצי הנתונים המובְנים

כדי לעדכן לגרסה חדשה של קובצי נתונים מובְנים, צריך לעדכן את הגרסה שמקצים למשאבים של השותף והמפרסם ברמה ההורה, וגם את משימות ההורדה הנפרדות ב-Display & Video 360 API.

עדכון ההגדרות של משאב ההורה

גרסת ברירת המחדל של קבצים עם נתונים מובְנים מוגדרת ברמת המשאב של השותף ושל המפרסם. הגרסה הזו משמשת כברירת המחדל כשמורידים קובצי נתונים מובְנים דרך הממשק או ה-API.

הגדרה בממשק

ברמת השותף

עוברים לשותף הרצוי. עוברים לדף פרטים בסיסיים בתפריט הגדרות שותף שבתפריט הניווט הימני. מעדכנים את ההגדרה של גרסת ה-SDF בקטע קובצי נתונים מובְנים ל-v7.

ברמת המפרסם

עוברים למפרסם הרצוי. עוברים לדף פרטים בסיסיים בתפריט הגדרות המפרסם שבתפריט הניווט הימני. מעדכנים את ההגדרה של גרסת ה-SDF בקטע קובצי נתונים מובְנים ל-v7. אם הגרסה שמוגדרת כברירת מחדל מוגדרת ברמת השותף, יכול להיות שלא תוכלו לערוך את ההגדרה הזו.

הגדרה ב-API

ברמת המפרסם

שולחים בקשה advertisers.patch כדי לעדכן את הערך של dataAccessConfig.sdfConfig.sdfConfig.version לערך SDF_VERSION_7, ואם צריך, את הערך של dataAccessConfig.sdfConfig.overridePartnerSdfConfig לערך True.

עדכון בקשות sdfdownloadtasks.create ב-API

כששולחים בקשה מסוג sdfdownloadtasks.create באמצעות Display & Video 360 API, צריך להגדיר את השדה version בגוף הבקשה לערך SDF_VERSION_7.

עדכון המזהים בעמודות הנדרשות

בגרסה 7, מרחבי המזהים שבהם משתמשת קבוצת משנה של עמודות עודכנו כדי לבטל את הקישור בין קובצי הנתונים המובְנים למוצר קובצי הקריאה של ישויות שהוצא משימוש, וכדי להתאים את הפורמט לכלים נתמכים, כמו Display & Video 360 API.

אזהרה: יכול להיות שהמזהים המעודכנים לא יהיו תואמים לסקריפטים מותאמים אישית לבידינג. מומלץ לעיין במסמכי העזרה בנושא אותות של סקריפטים מותאמים אישית לבידינג כדי לקבל את המידע העדכני ביותר על המזהים שבהם צריך להשתמש לפני ההעברה.

בקטע הזה מפורטות כל העמודות עם מזהים שונים מאלה של גרסה 6, ומוסבר איך לאחזר מידע עזר לגבי הערכים החדשים.

הזמנת קמפיין

הוראות העברה של עמודות בגרסה 7
טירגוט לפי אפליקציה – החרגה טירגוט אפליקציות – הכללה	העמודות האלה עודכנו כך שישתמשו במזהי אפליקציות בפורמט App Platform:App ID. דוגמאות: APP:com.google.android.gm,‏ APP:422689480,‏ ANDROID_TV_APP:com.google.android.youtube.tvunplugged פלטפורמות של אפליקציות מזוהות באמצעות ערך מחרוזת. מזהי האפליקציות הם המזהים שמספקת הפלטפורמה הרלוונטית, כמו מזהה חבילה מחנות Play של Android או מזהה אפליקציה מ-App Store של Apple.
טירגוט לפי דפדפן – החרגה טירגוט לפי דפדפן – הכללה	העמודה הזו עודכנה כך שתשתמש בערכים של targetingOptionId במשאבים של TargetingOption ב-Display & Video 360 API בקטע סוג טירגוט TARGETING_TYPE_BROWSER. אחזור משאבי TargetingOption בנפרד או ברשימות שמחולקות לדפים באמצעות השירות targetingTypes.targetingOptions.
טירגוט לפי ספק – החרגה טירגוט לפי ספק – הכללה	העמודה הזו עודכנה כך שתשתמש בערכים של targetingOptionId במשאבים של TargetingOption ב-Display & Video 360 API בקטע סוג טירגוט TARGETING_TYPE_CARRIER_AND_ISP. אחזור משאבי TargetingOption בנפרד או ברשימות שמחולקות לדפים באמצעות השירות targetingTypes.targetingOptions.
טירגוט לערוצים – החרגה טירגוט ערוצים – הכללה	העמודה הזו עודכנה כך שתשתמש בערך channelId של המשאב Channel ב-Display & Video 360 API. אחזור של משאבי Channel בנפרד או ברשימות מחולקות לדפים באמצעות השירותים advertisers.channels ו-partners.channels.
טירגוט לפי מכשיר – החרגה טירגוט לפי מכשיר – הכללה	העמודה הזו עודכנה כך שתשתמש בערכים של targetingOptionId במשאבים של Display & Video 360 API‏ TargetingOption, בסוגי הטירגוט הבאים: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM אחזור משאבי TargetingOption בנפרד או ברשימות שמחולקות לדפים באמצעות השירות targetingTypes.targetingOptions.
מדידת ערוץ DAR	העמודה הזו עודכנה כך שתשתמש בערך channelId של המשאב Channel ב-Display & Video 360 API. אחזור של משאבי Channel בנפרד או ברשימות מחולקות לדפים באמצעות השירותים advertisers.channels ו-partners.channels.
טירגוט לאתרים – החרגה טירגוט לאתרים – הכללה	העמודה הזו עודכנה כדי לזהות אתרים באמצעות מחרוזות של כתובות URL.

פריט

הוראות העברה של עמודות בגרסה 7
טירגוט לפי אפליקציה – החרגה טירגוט אפליקציות – הכללה	העמודות האלה עודכנו כך שישתמשו במזהי אפליקציות בפורמט App Platform:App ID. דוגמאות: APP:com.google.android.gm,‏ APP:422689480,‏ ANDROID_TV_APP:com.google.android.youtube.tvunplugged פלטפורמות של אפליקציות מזוהות באמצעות ערך מחרוזת. מזהי האפליקציות הם המזהים שמספקת הפלטפורמה הרלוונטית, כמו מזהה חבילה מחנות Play של Android או מזהה אפליקציה מ-App Store של Apple.
מכפילי הצעות מחיר	העמודה הזו עודכנה כך שתשתמש במזהי קריטריונים חדשים לסוגים של שורות אפליקציה ואתר. סוג השורה app עודכן כך שייעשה בו שימוש בערכי מחרוזות מקושרות של פלטפורמת האפליקציה ומזהה פלטפורמת האפליקציה, המופרדים בפסיקים, למזהי הקריטריונים. פלטפורמות של אפליקציות מזוהות באמצעות ערך מחרוזת. מזהי האפליקציות הם המזהים שסופקו על ידי הפלטפורמה הרלוונטית, כמו מזהה חבילה מחנות Play של Android או מזהה אפליקציה מ-App Store של Apple. סוג השורה site עודכן כך שייעשה בו שימוש במחרוזות של כתובות URL בתור מזהי קריטריונים.
טירגוט לפי דפדפן – החרגה טירגוט לפי דפדפן – הכללה	העמודה הזו עודכנה כך שתשתמש בערכים של targetingOptionId במשאבים של TargetingOption ב-Display & Video 360 API בקטע סוג טירגוט TARGETING_TYPE_BROWSER. אחזור משאבי TargetingOption בנפרד או ברשימות שמחולקות לדפים באמצעות השירות targetingTypes.targetingOptions.
טירגוט לפי ספק – החרגה טירגוט לפי ספק – הכללה	העמודה הזו עודכנה כך שתשתמש בערכים של targetingOptionId במשאבים של TargetingOption ב-Display & Video 360 API בקטע סוג טירגוט TARGETING_TYPE_CARRIER_AND_ISP. אחזור משאבי TargetingOption בנפרד או ברשימות שמחולקות לדפים באמצעות השירות targetingTypes.targetingOptions.
טירגוט לערוצים – החרגה טירגוט ערוצים – הכללה	העמודה הזו עודכנה כך שתשתמש בערך channelId של המשאב Channel ב-Display & Video 360 API. אחזור של משאבי Channel בנפרד או ברשימות מחולקות לדפים באמצעות השירותים advertisers.channels ו-partners.channels.
טירגוט לפי מכשיר – החרגה טירגוט לפי מכשיר – הכללה	העמודה הזו עודכנה כך שתשתמש בערכים של targetingOptionId במשאבים של Display & Video 360 API‏ TargetingOption, בסוגי הטירגוט הבאים: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM אחזור משאבי TargetingOption בנפרד או ברשימות שמחולקות לדפים באמצעות השירות targetingTypes.targetingOptions.
טירגוט לאתרים – החרגה טירגוט לאתרים – הכללה	העמודה הזו עודכנה כדי לזהות אתרים באמצעות מחרוזות של כתובות URL.

מוצר מדיה

הוראות העברה של עמודות בגרסה 7
טירגוט לערוצים – החרגה טירגוט ערוצים – הכללה	העמודה הזו עודכנה כך שתשתמש בערך channelId של המשאב Channel ב-Display & Video 360 API. אחזור של משאבי Channel בנפרד או ברשימות מחולקות לדפים באמצעות השירותים advertisers.channels ו-partners.channels.
טירגוט לפי מכשיר – הכללה	העמודה הזו עודכנה כך שתשתמש בערכים של targetingOptionId במשאבים של Display & Video 360 API‏ TargetingOption, בסוגי הטירגוט הבאים: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM אחזור משאבי TargetingOption בנפרד או ברשימות שמחולקות לדפים באמצעות השירות targetingTypes.targetingOptions.

הוספת שילוב עם עמודות שנוספו מאז גרסה 6

אם עוברים מגרסה 6 לגרסה 7, צריך להוסיף את העמודות הבאות לקבצים הרלוונטיים:

סוג הקובץ	עמודה
פריט	ספירת תדירות הטירגוט של מודעות TrueView
פריט	חלון הזמן של תדירות הטירגוט ב-TrueView
קבוצת מודעות YouTube	אופטימיזציית טירגוט

אם אתם עוברים מגרסה קודמת של קובצי נתונים מובְנים, תוכלו לעיין בהערות המוצר של קובצי הנתונים המובְנים כדי לקבל מידע על עמודות נוספות שנוספו בין הגרסה הנוכחית לבין גרסת SDF 6.

שינויים נוספים

בגרסה 7 הוספנו גם כמה שינויים שטחיים שיעזרו לכם לפשט את השילוב ולהפסיק להשתמש ב-Entity Read Files לצורך עיון.

מיון רשימה חדש לקבוצת משנה של עמודות

גרסת SDF v7 מבטיחה סדר יציב של עמודות רשימה מסוימות במהלך יצירת הקובץ. כך ההתנהגות תהיה עקבית יותר והבדיקה תהיה קלה יותר. הסדר הזה לא נאכף בזמן העלאת הקובץ, אלא מיושם לאחר מכן בזמן יצירת הקובץ המעודכן.

בנתוני הגרסה של גרסה 7 מופיעה רשימה מלאה של העמודות שנוצרות עכשיו בסדר מספרי עולה או בסדר אלפביתי.

המלצות חדשות לגבי מסמכים מזהים

עדכנו את ההגדרות של מספר עמודות כדי להסיר את ההפניה לקובצי קריאה של ישויות שהוצאו משימוש, ובמקום זאת ממליצים על אמצעי אחרים לחיפוש מזהי חשבון.

הערכים שמוחזרים על ידי העמודות הבאות לא שונים מאלה של SDF בגרסה 6, אבל מומלץ לעדכן את השילוב כדי לאחזר את המזהים באמצעות השיטה המומלצת החדשה, שמפורטת בתיאור העמודות בגרסה 7.

סוגי הקבצים והעמודות שלהם
קמפיין	טירגוט גיאוגרפי – החרגה טירגוט גיאוגרפי – הכללה טירגוט לפי מקור מלאי – החרגה טירגוט לפי מקור מלאי – הכללה טירגוט לפי שפה – החרגה טירגוט לפי שפה – הכללה
הזמנת קמפיין	טירגוט לפי תחום עניין משותף וכוונת רכישה – החרגה טירגוט לפי תחום עניין משותף וכוונת רכישה – הכללה טירגוט של אוסף אפליקציות – החרגה טירגוט של אוסף אפליקציות – הכללה טירגוט לפי קהל – החרגה טירגוט לפי קהל – הכללה טירגוט לפי קטגוריה – החרגה טירגוט לפי קטגוריה – הכללה טירגוט לפי ז'אנר תוכן – החרגה טירגוט לפי ז'אנר תוכן – הכללה טירגוט לפי רשימה מותאמת אישית טירגוט גיאוגרפי – החרגה טירגוט גיאוגרפי – הכללה טירגוט לפי מקור מלאי – החרגה טירגוט לפי מקור מלאי – הכללה טירגוט לפי רשימת מילות מפתח – החרגה טירגוט לפי שפה – החרגה טירגוט לפי שפה – הכללה
פריט	טירגוט לפי תחום עניין משותף וכוונת רכישה – החרגה טירגוט לפי תחום עניין משותף וכוונת רכישה – הכללה טירגוט של אוסף אפליקציות – החרגה טירגוט של אוסף אפליקציות – הכללה טירגוט לפי קהל – החרגה טירגוט לפי קהל – הכללה טירגוט לפי קטגוריה – החרגה טירגוט לפי קטגוריה – הכללה טירגוט לפי קהל משולב טירגוט לפי ז'אנר תוכן – החרגה טירגוט לפי ז'אנר תוכן – הכללה מזהי פעילות ב-Floodlight של המרות הקצאת קריאייטיב טירגוט לפי רשימה מותאמת אישית טירגוט גיאוגרפי – החרגה טירגוט גיאוגרפי – הכללה טירגוט לפי מקור מלאי – החרגה טירגוט לפי מקור מלאי – הכללה טירגוט לפי רשימת מילות מפתח – החרגה טירגוט לפי שפה – החרגה טירגוט לפי שפה – הכללה
Media Product	טירגוט לפי קהל – החרגה טירגוט לפי קהל – הכללה טירגוט לפי קטגוריה – החרגה טירגוט לפי קטגוריה – הכללה טירגוט גיאוגרפי – הכללה טירגוט לפי שפה – החרגה טירגוט לפי שפה – הכללה
קבוצת מודעות ב-YouTube	טירגוט לפי תחום עניין משותף וכוונת רכישה – החרגה טירגוט לפי תחום עניין משותף וכוונת רכישה – הכללה טירגוט לפי קהל – החרגה טירגוט לפי קהל – הכללה טירגוט לפי קטגוריה – החרגה טירגוט לפי קטגוריה – הכללה טירגוט לפי רשימה מותאמת אישית