העדכון האחרון: 21 באוגוסט 2025
במדריך הזה מוסבר על התהליכים הבאים:
- מעדכנים את הגרסה של קובצי הנתונים המובנים שנבחרו לגרסה 9 באמצעות ממשק המשתמש או ה-API של Display & Video 360.
- העברת השילוב מגרסאות שהוצאו משימוש של קובצי נתונים מובְנים (v7, v7.1, v8 או v8.1) לגרסה v9. הוא מפנה אתכם לדפים עם פרטים על השינויים בין הגרסה הנוכחית לגרסה 9, שיכולים להשפיע על השילוב שלכם. במקרים מסוימים, תצטרכו להשתמש בגרסה 9 כדי להעלות קובצי SDF החל מ-8 בספטמבר 2025.
בדפי ההעברה שספציפיים לכל גרסה מופיעה רשימה מלאה של ההבדלים בין הגרסה שלכם לגרסה 9.
עדכון הגרסה של קובצי הנתונים המובְנים
כדי להשתמש בגרסה 9, צריך לעדכן את המשאבים ואת פעולות יצירת ה-SDF כדי להשתמש בגרסה 9 כשמורידים ומעלים קובצי נתונים מובְנים.
עדכון הגרסה של קובצי נתונים מובְנים
כדי להשתמש בגרסה חדשה של קובצי נתונים מובנים, צריך לעדכן את הגרסה שהוקצתה במשאבי האב של השותף והמפרסם, ולהשתמש בגרסה החדשה כשיוצרים משימות הורדה נפרדות ב-Display & Video 360 API.
עדכון הגדרות משאב הורה
אתם מגדירים את גרסת ברירת המחדל של קובצי נתונים מובנים ברמת השותף וברמת מקורות המידע של המפרסם. גרסה זו משמשת כברירת המחדל כשמורידים קבצים של נתונים מובְנים דרך הממשק או ה-API.
הגדרה בממשק
ברמת השותף:
- עוברים לשותף הרצוי.
- בתפריט הגדרות השותף שבניווט הימני, עוברים לדף פרטים בסיסיים.
- מעדכנים את ההגדרה SDF version (גרסת SDF) בקטע Structured Data Files (קבצים של נתונים מובְנים) ל-v9.
ברמת המפרסם:
- עוברים למפרסם הרצוי.
- בתפריט הניווט שמימין, עוברים לדף פרטים בסיסיים בקטע הגדרות המפרסם.
- בקטע Structured Data Files (קבצים של נתונים מובְנים), מעדכנים את ההגדרה SDF version (גרסת SDF) ל-v9. אם גרסת ברירת המחדל מוגדרת ברמת השותף, יכול להיות שלא תוכלו לערוך את ההגדרה הזו.
הגדרה ב-API
ברמת השותף: אי אפשר להגדיר את גרסת ברירת המחדל של SDF ברמת השותף ב-API.
ברמת המפרסם: שולחים בקשת advertisers.patch לעדכון dataAccessConfig.sdfConfig.sdfConfig.version לערך SDF_VERSION_9, ואם צריך, לעדכון dataAccessConfig.sdfConfig.overridePartnerSdfConfig לערך True.
עדכון בקשות sdfdownloadtasks.create ב-API
כששולחים בקשת sdfdownloadtasks.create באמצעות Display & Video 360 API, צריך להגדיר את השדה version בגוף הבקשה לערך SDF_VERSION_9.
מעבר מהגרסה הנוכחית של SDF
בדפים הבאים מוסבר אילו עדכונים צריך לבצע בשילוב כשעוברים מהגרסה הנוכחית לגרסה 9, ומוצגת רשימה מקיפה של כל השינויים בין הגרסאות: