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

העדכון האחרון: 12 בנובמבר 2024

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

בהערות המוצר מופיעה רשימה מקיפה של ההבדלים בין גרסה 7.1 לבין גרסה 8.

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

כדי לעבור לגרסה 8 של קובצי נתונים מובְנים (SDF) מגרסה קודמת:

1. מעדכנים את המשאבים ואת הפעולות ליצירת SDF כך שישתמשו ב-v8.
2. מעדכנים את הלוגיקה של משאב המודעות כדי לזהות סוג בזמן היצירה.
3. הוספת לוגיקה חדשה לקריאה, ליצירה ולעדכון של משאבים ליצירת ביקוש.

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

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

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

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

הגדרה בממשק

ברמת השותף

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

ברמת המפרסם

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

הגדרה ב-API

ברמת השותף

אי אפשר להגדיר את גרסת ברירת המחדל של SDF ברמת השותף ב-API.

ברמת המפרסם

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

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

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

ציון הסוג במשאבים של מודעות

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

כשמעדכנים מודעות קיימות, לא צריך לשנות את הערך בעמודה הזו.

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

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

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

אימות חותמת זמן

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

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

עמודות נדרשות

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

פריט

העמודות הנדרשות לערכים הבאים של העמודה Type ב פריט
יצירת ביקוש	Pacing Amount TrueView Bid Strategy Type TrueView Bid Strategy Value

מודעה

העמודות הנדרשות לערכים הבאים של העמודה Ad Type במודעה: Ad Ad Type
קרוסלה ליצירת ביקוש	Business Name Call to Action Demand Gen Cards Description 1 Headline In-feed Video Headline Landing Page URL Logo Asset IDs
קמפיין ליצירת ביקוש עם מודעות תמונה	Business Name Call to Action Description 1 Headline In-feed Video Headline Landing Page URL Logo Asset IDs Marketing Image Asset Id
Demand Product	Business Name Description 1 Headline In-feed Video Headline Landing Page URL Logo Asset IDs
קמפיין וידאו ליצירת ביקוש	Business Name Call to Action Description 1 Headline In-feed Video Headline Landing Page URL Logo Asset IDs Video Id

הגבלות מעודכנות

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

יש הרבה הגבלות ספציפיות לעמודות הנדונות, ולכן המדריך הזה לא כולל רשימה מקיפה של ההגבלות. מומלץ לקרוא בעיון את מסמכי העזרה של גרסה 8 לגבי סוגי הקבצים Line Item,‏ Ad Group ו-Ad לפני שיוצרים או מעדכנים משאבים ליצירת ביקוש באמצעות העלאת SDF.