עדכון אחרון: 18.10.2023
במדריך הזה מפורט תהליך המעבר לגרסה קודמת של קובצי נתונים מובנים (SDF), ונסביר את השינויים (הנדרשים והמומלצים) שיעזרו לכם לשפר את השילוב.
נתוני הגרסה כוללים רשימה מקיפה של ההבדלים בין גרסה 6 לגרסה 7.
העברת הגרסה של קובצי הנתונים המובנים
כדי לעבור לגרסה 7 של קובצי נתונים מובנים לגרסה 7, צריך לציין את הגרסה החדשה, לעדכן את השטחים המזהים בקבוצת משנה של עמודות קיימות ולהוסיף שילוב עם עמודות חדשות.
עדכון הגרסה של קובצי הנתונים המובנים
כדי לעדכן לגרסה חדשה של קובצי נתונים מובְנים, צריך לעדכן את הגרסה שהקציתם למשאבים הראשיים של השותפים והמפרסמים, ואת משימות ההורדה הנפרדות ב-Display & Video 360 API.
עדכון ההגדרות של משאבי ההורה
גרסת ברירת המחדל של קובצי נתונים מובְנים מוגדרת ברמת המשאב של השותף והמפרסם. הגרסה הזו משמשת כברירת המחדל כשמורידים קובצי נתונים מובנים דרך הממשק או ה-API.
מוגדר בממשק
- ברמת השותף
- עוברים לשותף הרצוי. בתפריט הניווט הימני נכנסים לדף Basic Details בתפריט Partner Settings. בקטע קובצי נתונים מובְנים, מעדכנים את ההגדרה של גרסת SDF ל-v7.
- ברמת המפרסם
- עוברים למפרסם המיועד. נכנסים לדף Basic Details (פרטים בסיסיים) בתפריט Advertiser Settings (הגדרות המפרסם) בתפריט הניווט הימני. בקטע קובצי נתונים מובְנים, מעדכנים את ההגדרה של גרסת SDF ל-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 | |
|---|---|
|
טירגוט לאפליקציות – החרגה טירגוט לאפליקציות - הכללה |
העמודות האלה עודכנו כך שיכללו מזהי אפליקציות בפורמט " פלטפורמות של אפליקציות מזוהות לפי ערך מחרוזת. מזהי אפליקציות הם המזהים שהפלטפורמה הרלוונטית מספקת. למשל, מזהה חבילה מחנות Play ב-Android או מזהה אפליקציה מ-App Store של Apple. |
|
מיקוד לדפדפן - החרגה מיקוד לדפדפן - הכללה |
העמודה הזו עודכנה כך שייעשה שימוש בערכי
אחזור של |
|
טירגוט לפי ספק - החרגה טירגוט לפי ספק - הכללה |
העמודה הזו עודכנה כך שייעשה שימוש בערכי
אחזור של |
|
טירגוט לערוצים - החרגה מיקוד לערוצים - הכללה |
העמודה הזו עודכנה כדי להשתמש בערך
אחזור
|
|
טירגוט לפי מכשיר - החרגה טירגוט לפי מכשיר - הכללה |
העמודה הזו עודכנה כך שייעשה שימוש בערכי
אחזור של |
| מדידת ערוץ DAR |
העמודה הזו עודכנה כדי להשתמש בערך
אחזור
|
מיקוד לאתרים - החרגה מיקוד לאתרים - הכללה |
העמודה הזו עודכנה כדי לזהות אתרים באמצעות מחרוזות של כתובות URL. |
פריט
| הוראות העברה לעמודות, גרסה 7 | |
|---|---|
|
טירגוט לאפליקציות – החרגה טירגוט לאפליקציות - הכללה |
העמודות האלה עודכנו כך שיכללו מזהי אפליקציות בפורמט " פלטפורמות של אפליקציות מזוהות לפי ערך מחרוזת. מזהי אפליקציות הם המזהים שהפלטפורמה הרלוונטית מספקת. למשל, מזהה חבילה מחנות Play ב-Android או מזהה אפליקציה מ-App Store של Apple. |
| מכפילי הצעות מחיר |
העמודה הזו עודכנה כך שייעשה שימוש במזהי קריטריונים חדשים עבור סוגי השורות אפליקציה ואתר. סוג השורה app עודכן כך שישתמש בערכי מחרוזת משורשרים של פלטפורמת האפליקציה ומזהה הפלטפורמה של האפליקציה, כשהם מופרדים בנקודתיים, עבור מזהי הקריטריונים. פלטפורמות של אפליקציות מזוהות לפי ערך מחרוזת. מזהי אפליקציות הם המזהים שהפלטפורמה הרלוונטית מספקת. למשל, מזהה חבילה מחנות Play ב-Android או מזהה אפליקציה מ-App Store של Apple. סוג השורה site עודכן, ועכשיו הוא משתמש במחרוזות של כתובות URL כמזהי קריטריונים. |
|
מיקוד לדפדפן - החרגה מיקוד לדפדפן - הכללה |
העמודה הזו עודכנה כך שייעשה שימוש בערכי
אחזור של |
|
טירגוט לפי ספק - החרגה טירגוט לפי ספק - הכללה |
העמודה הזו עודכנה כך שייעשה שימוש בערכי
אחזור של |
|
טירגוט לערוצים - החרגה מיקוד לערוצים - הכללה |
העמודה הזו עודכנה כדי להשתמש בערך
אחזור
|
|
טירגוט לפי מכשיר - החרגה טירגוט לפי מכשיר - הכללה |
העמודה הזו עודכנה כך שייעשה שימוש בערכי
אחזור של |
מיקוד לאתרים - החרגה מיקוד לאתרים - הכללה |
העמודה הזו עודכנה כדי לזהות אתרים באמצעות מחרוזות של כתובות URL. |
מוצר מדיה
| הוראות העברה לעמודות, גרסה 7 | |
|---|---|
|
טירגוט לערוצים - החרגה מיקוד לערוצים - הכללה |
העמודה הזו עודכנה כדי להשתמש בערך
אחזור
|
| טירגוט לפי מכשיר - הכללה |
העמודה הזו עודכנה כך שייעשה שימוש בערכי
אחזור של |
הוספת שילוב עם עמודות שנוספו מגרסה 6
אם עוברים מגרסה 6 לגרסה 7, צריך להוסיף את העמודות הבאות לקבצים הרלוונטיים:
| סוג קובץ | עמודה |
|---|---|
| פריט | ספירת תדירות טירגוט של TrueView |
| פריט | חלון זמן לתדירות טירגוט במודעות TrueView |
| קבוצת מודעות YouTube | אופטימיזציית טירגוט |
אם עוברים מגרסה קודמת של קובצי נתונים מובְנים, כדאי לעיין בנתוני הגרסה של קובצי נתונים מובנים כדי לקבל מידע על עמודות נוספות שנוספו בין הגרסה הנוכחית לבין SDF v6.
שינויים נוספים
בגרסה 7, ביצענו גם כמה שינויים שטחיים שאמורים לעזור לכם לפשט את השילוב ולהפסיק להשתמש בקובצי קריאה של ישויות שהוצאו משימוש.
סדר חדש של רשימות בחלק מהעמודות
בעזרת SDF v7 אפשר לסדר באופן יציב עמודות מסוימות ברשימה אחרי יצירת הקבצים. התוצאה היא התנהגות עקבית יותר ותהליך בדיקה קל יותר. הסדר הזה לא נאכף כשמעלים את הקובץ, אלא הוא חל לאחר מכן כשיוצרים את הקובץ המעודכן.
בנתוני הגרסה 7 יש רשימה מלאה של העמודות שנוצרות עכשיו בסדר מספרי או אלפביתי עולה.
הפניות חדשות למזהה חדש
עדכנו את ההגדרות של מספר עמודות כדי להסיר הפניות לקובצי קריאות של ישויות שהוצאו משימוש, ובמקום זאת להמליץ על אמצעים אחרים לחיפוש מזהה.
הערכים שמוחזרים על ידי העמודות הבאות לא שונים מאלה שבגרסה 6 של SDF, אבל מומלץ לעדכן את השילוב כך שיאחזר את המזהים באמצעות השיטה המומלצת החדשה, שאותה אפשר למצוא בתיאורי העמודות v7.
| סוגי קבצים והעמודות שלהם | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| קמפיין |
|
|||||||||||||||||||||
| סדר הכנסה |
|
|||||||||||||||||||||
| פריט |
|
|||||||||||||||||||||
| מוצר מדיה |
|
|||||||||||||||||||||
| קבוצת מודעות ב-YouTube |
|
|||||||||||||||||||||