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

עדכון אחרון: 18.10.2023

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

בנתוני הגרסה אפשר למצוא רשימה מקיפה של ההבדלים בין גרסה 6 לגרסה 7.

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

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

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

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

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

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

מוגדר בממשק

ברמת השותף

עוברים לשותף הרצוי. עוברים לדף Basic Details (פרטים בסיסיים) בתפריט Partner Settings (הגדרות השותף) בתפריט הניווט השמאלי. מעדכנים את ההגדרה של גרסת SDF בקטע Structured Data Files (קובצי נתונים מובנים) ל-v7.

ברמת המפרסם

עוברים למפרסם הרצוי. עוברים לדף Basic Details (פרטים בסיסיים) בתפריט Advertising Settings (הגדרות המפרסם) בתפריט הניווט הימני. מעדכנים את ההגדרה של גרסת SDF בקטע Structured Data Files (קובצי נתונים מובנים) ל-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, המרחבים המזהים שבהם נעשה שימוש בקבוצת משנה של עמודות עודכנו. הם מפרידים בין קובצי הנתונים המובְנים מהמוצר Entity Read Files שהוצא משימוש כדי ליישר קו עם כלים נתמכים כמו Display & Video 360 API.

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

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

סדר הכנסה

הוראות להעברת עמודות לגרסה 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 של Display & Video 360 API TargetingOption במשאבים של סוג הטירגוט TARGETING_TYPE_BROWSER. אחזור TargetingOption משאבים בנפרד או ברשימות עם חלוקה לדפים, באמצעות השירות targetingTypes.targetingOptions.
טירגוט לפי ספק - החרגה טירגוט לפי ספק - הכללה	העמודה הזו עודכנה ועכשיו היא משתמשת בערכים targetingOptionId של Display & Video 360 API TargetingOption במשאבים של סוג הטירגוט 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.
מכפילי הצעות מחיר	העמודה הזו עודכנה ועכשיו היא משתמשת במזהי קריטריונים חדשים עבור סוגי השורות אפליקציה ו-אתר. סוג השורה של אפליקציה עודכן כך שמזהי הקריטריונים יופיעו במחרוזות של ערכי מחרוזות של פלטפורמת האפליקציה ומזהה פלטפורמת האפליקציה, כשהם מופרדים בנקודתיים. פלטפורמות של אפליקציות מזוהות באמצעות ערך מחרוזת. מזהי האפליקציות הם המזהים שסופקו על ידי הפלטפורמה הרלוונטית, כמו מזהה חבילה מחנות Play של Android או מזהה אפליקציה מ-App Store של Apple. סוג השורה site עודכן כך שישתמש במחרוזות של כתובות URL כמזהי קריטריונים.
טירגוט לדפדפן - החרגה טירגוט לדפדפן - הכללה	העמודה הזו עודכנה ועכשיו היא משתמשת בערכים targetingOptionId של Display & Video 360 API TargetingOption במשאבים של סוג הטירגוט TARGETING_TYPE_BROWSER. אחזור TargetingOption משאבים בנפרד או ברשימות עם חלוקה לדפים, באמצעות השירות targetingTypes.targetingOptions.
טירגוט לפי ספק - החרגה טירגוט לפי ספק - הכללה	העמודה הזו עודכנה ועכשיו היא משתמשת בערכים targetingOptionId של Display & Video 360 API TargetingOption במשאבים של סוג הטירגוט 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

אם עוברים מ-v6 ל-v7, צריך להוסיף את העמודות הבאות לקבצים הרלוונטיים:

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

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

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

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

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

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

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

המלצות להפניות מזהים חדשים

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

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

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