קובצי נתונים מובְנים (SDF) הם קובצי CSV בפורמט מיוחד. הם מאפשרים אחזור, יצירה ועריכה של משאבים בכמות גדולה ב-Display & Video 360. אפשר לעדכן משאבים בכמות גדולה על ידי הורדה, עריכה והעלאה מחדש של קובצי SDF.
ממשק המשתמש של Display & Video 360 תומך בהורדות והעלאות של SDF. Display & Video 360 API תומך בהורדות של SDF.
פורמטים
קובץ SDF משתמש באחד משני פורמטים בסיסיים: Standard ו-QA:
- אפשר להוריד ולהעלות קבצים בפורמט רגיל. יכול להיות שהנתונים בקבצים האלה יכללו מזהים מספריים כדי להבטיח דיוק בזמן ההעלאה. יכול להיות שיהיה צורך במידע להשוואה כדי לפרש את הנתונים.
- אפשר להוריד קבצים בפורמט QA. הקובצים האלה מספקים את אותם נתונים כמו קובצי פורמט רגיל, אבל הערכים בהם קריאים יותר לאנשים. לדוגמה, יכול להיות שבחלק מהעמודות יש שמות מוצגים במקום מזהים. בעמודות שספציפיות לפורמט הזה מופיע הסיומת Qa.
סוגי קבצים
SDF תומך בשבעה סוגים של משאבים. לכל סוג משאב יש סוג קובץ משלו עם מבנה עמודות משלו. סוגי המשאבים הנתמכים הם:
- קמפיין
- הזמנת קמפיין
- פריט
- קבוצת מודעות
- מודעה
- מקור מלאי
- מוצר מדיה
פורמט QA נתמך רק בסוגי הקבצים Line Item ו-Ad Group.
גרסאות חדשות של SDF מתפרסמות באופן קבוע וגרסאות קודמות מוצאות משימוש. בגרסאות החדשות, המבנה של עמודת סוג הקובץ עודכן. במקרה הצורך, גרסה חדשה של SDF תכלול מדריך להעברה עם ההשקה.
שגיאות הורדה
הורדות של קובצי SDF יכולות להוביל לשני סוגים של שגיאות: שגיאות ביצירת קבצים ומשאבים שנדלגו.
שגיאות ביצירת קבצים
יצירת קובץ SDF עלולה להסתיים בשגיאה. אם יצירת הדוח תיכשל כשמשתמשים ב-Display & Video 360 API, השדה error של המשימה שהסתיימה יוגדר עם אובייקט Status. אובייקט Status יכיל הודעה עם פרטים על הסיבה לשגיאה.
מידע נוסף על השגיאות האלה זמין במאמר בנושא שגיאות ואזהרות.
שגיאות שדילגנו עליהן
קבצי SDF לא תומכים בכל סוגי המשנה של משאבים. אם אי אפשר לכלול משאב בקובץ SDF, קובץ מסוג 'דילוג' (לדוגמה: SDF-LineItems-Skipped.csv) ייכלל בהורדה. המבנה של הקובץ הזה הוא של שתי עמודות. בעמודה הראשונה מופיע המשאב שדילגתם עליו. בעמודה השנייה מוסבר למה הם לא נכללים.
העלאת קבצים
מעלים קובצי SDF באמצעות ממשק המשתמש של Display & Video 360 כדי ליצור משאבים חדשים או לעדכן משאבים קיימים.
כדי לצמצם את הסיכוי לשגיאות כשמעדכנים או יוצרים משאבים באמצעות קובצי SDF, צריך לפעול לפי השלבים הבאים:
- הורדת קובצי SDF באמצעות Display & Video 360 API או ממשק המשתמש.
- לשנות רשומות קיימות בקובץ כדי לעדכן משאבים קיימים.
- הוספת רשומות של קבצים כדי ליצור משאבים חדשים.
- מסירים את כל הרשומות שלא חדשות או מעודכנות. כך מצטמצם גודל הקובץ ואין סיכוי לעדכונים לא מכוונים.
- מעלים את הקובץ לממשק המשתמש של Display & Video 360.
אחרי שמעלים ומעבדים קובץ SDF, אפשר להוריד קובץ SDF-ResultFile.zip. קובץ ZIP הזה יכול להכיל שני קבצים אפשריים:
-
SDF-{ResourceType}-Updated-ResultFile.csv, שבו מפורטים המשאבים שעודכנו או נוצרו בהצלחה. SDF-{ResourceType}-Failed-ResultFile.csv, שכולל רשימה של פעולות שנכשלו והודעות שגיאה רלוונטיות.
יכול להיות שהקובץ ZIP יכיל אחד מהקבצים או את שניהם.