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

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

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

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

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

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

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

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

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

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

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

הגדרה בממשק

ברמת השותף

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

ברמת המפרסם

  1. עוברים למפרסם הרצוי.
  2. מרחיבים את התפריט Advertiser settings (הגדרות המפרסם) בתפריט הניווט הימני ועוברים לדף Basic details (פרטים בסיסיים).
  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 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.