גישה לקובצי קריאה של הישות

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

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

הפורמט של קובצי הקריאה של הישויות מפורט בחומר העזר בנושא פורמטים של קבצים.

הקבצים של קריאת הישות מאוחסנים כשתי קבוצות:

  • טבלאות ציבוריות, שמכילות נתונים ציבוריים נפוצים, כמו מידע על גרסאות דפדפנים או על שפות שמאוחסנות בקטגוריה gdbm-public.
  • טבלאות פרטיות, שמכילות מידע על הקמפיינים, התקציבים ונתונים פרטיים אחרים של השותף. טבלאות פרטיות מאוחסנות בקטגוריות ספציפיות לשותפים. לדוגמה, אם מזהה השותף שלכם הוא 123, הקטגוריה שמכילה את הטבלאות הפרטיות שלכם תהיה gdbm-123.
גם טבלאות ציבוריות וגם טבלאות פרטיות נמצאות בספריית המשנה entity בתוך הקטגוריה. למידע נוסף על טיפול בספריות משנה, ראו מרחב שמות של אובייקטים ב-Cloud Storage.
הטבלאות הציבוריות נוצרות בשעה 5:00 לפי שעון UTC. הטבלאות הפרטיות נוצרות בשעה 5:00 בבוקר לפי שעון השותף (אבל במקרים נדירים יכולים להיות עיכובים) ונשמרות באופן אוטומטי ומאובטח ב-Google Cloud Storage. קובץ הסיכום נוצר אחרי שיוצרים את כל הטבלאות הציבוריות והפרטיות.

טבלאות גלויות לכולם

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
שדהתיאור
processing_dateהתאריך שבו מערכת Display & Video 360 עיבדה את הנתונים, ולא בהכרח קשור לאירועים שמופיעים בקובץ. פורמט התאריך הוא YYYYMMDD. למשל, 20120320 הוא 20 במרץ 2012.
batch_index אינדקס של האצווה שמתחיל ב-0. לדוגמה, אם הנתונים נוצרים מדי שעה, האצווה הראשונה תהיה 0, האצווה השנייה תהיה 1 וכן הלאה.
entity_typeסוג הקובץ: SupportedExchange,‏ DataPartner, ‏ UniversalSite,‏ GeoLocation, ‏ Language, ‏ OperatingSystem, ‏ Browser,‏ Isp, ‏ summary ו-SiteIdToPlacementId.csv.
לדוגמה, אם יוצרים שם קובץ כדי לאחזר את קובץ הקריאה של הישות לטבלה browser מ-15 בינואר 2013, הנתיב לקובץ ייראה כך: 
gdbm-public/entity/20130115.0.Browser.json

שולחנות פרטיים

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
שדהתיאור
partner_idהמזהה המספרי של השותף.
processing_dateהתאריך שבו מערכת Display &Video 360 עיבדה את הנתונים. התאריך הזה לא קשור בהכרח לאירועים שמופיעים בקובץ. פורמט התאריך הוא YYYYMMDD. למשל, 20120320 הוא 20 במרץ 2012. הקבצים ייווצרו בין השעות 4:00 ל-6:00 לפי שעון השותף.
batch_indexאינדקס של האצווה שמתחיל ב-0. נכון לעכשיו, הערך הזה תמיד 0.
entity_typeסוג הקובץ: Partner, Advertiser, InsertionOrder, LineItem, Creative, Pixel, InventorySource, UserList, UniversalChannel ו-summary.
לדוגמה, אם יוצרים שם קובץ כדי לאחזר את קובץ הקריאה של הישות עבור שותף 123 שגישה לטבלה line_item החל מ-2 באפריל 2013, שם הקובץ ייראה כך: 
gdbm-123/entity/20130402.0.LineItem.json