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

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

שימו לב שקבצים של קריאה לישויות זמינים למשך 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, האצווה השנייה תהיה 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.
entity_typeסוג הקובץ: Partner, Advertiser, InsertionOrder, LineItem, Creative, Pixel, InventorySource, UserList, UniversalChannel וגם summary.
לדוגמה, אם ב-2 באפריל 2013 יצרתם שם קובץ כדי לאחזר את קובץ הקריאה של הישויות עבור שותף 123 שניגש לטבלה line_item, שם הקובץ ייראה בערך כך: 
gdbm-123/entity/20130402.0.LineItem.json