מיגרציה מ-DT גרסה 1.0

הורדת Files

תהליך הטמעת הנתונים של DTv2 דומה לתהליך של DTv1, אבל יש כמה דברים שחשוב לדעת שישתנו במהלך ההעברה.

מתבצע עיבוד של הקבצים

DTv2 מעבד קבצים שעתיים (חשיפות, קליקים ומדיה עשירה) וקבצים יומיים (טבלאות פעילות והתאמה). קבצים השעתיים (שם הקובץ מכיל YYYYMMDDHH) מעובדים לפי שעון UTC. קבצים יומיים (שם הקובץ מכיל YYYYMMDD) מעובדים לפי זמן הדיווח המקומי תחום (לצפייה בפורמט של שם הקובץ). הקיזוז בין השעה המקומית לבין UTC ישתנה בהתאם למיקום שלכם.

הקבצים מעובדים גם בנפרד, וזמן העיבוד שלהם עשוי להשתנות. לעיתים קרובות קובץ של שעה מאוחרת יותר, שיסתיים העיבוד לפני קובץ קודם (למשל שעה 6 לפני שעה 5). לא כדאי להסתמך על סדר הקבצים בתהליך הטמעת הנתונים, אחרת התהליך עלול להיתקע.

אירועים יכולים להופיע בקבצים שעברו עיבוד מוקדם או מאוחר יותר, ביחס לזמן האירוע. המערכת לא תמיד מעבדת אירועים בשעה שבה הם התרחשו.

סדר עמודות

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

קבצים כפולים

לפעמים נכתבים קבצים כפולים עבור אותו תאריך ושעה. אם ביותר מקובץ אחד יש את אותה חותמת תאריך/שעה, צריך להשתמש בחותמת עם הדקות / השניות האחרונות, בהתאם לשם הקובץ חותמת זמן. קבצים כפולים נוצרים כי תהליכי הקצה העורפי זיהו בעיה עם הקובץ המקורי.

שדות

שמות השדות ופורמט שמות השדות השתנו, אבל יש מיפוי מהישן לחדש (אם האפשרות זמינה) בהעברת השדות של DCM, כולל טבלאות התאמות. אם אתם לא משתמשים ב-DBM, השדות האלה יהיו ריקים ותוכלו להתעלם מהשדה.

אפשר גם לראות בקובץ שדות ב-DBM. אם אתה משתמש ב-DBM, השדות האלה יאוכלסו רק כשההרשאה הרלוונטית ניתנה ברמת המפרסם ב-DBM, שבה המפרסמים מקושרים. יש מיפוי מהישן לחדש (אם הוא זמין) בהעברה של שדות ב-DBM. קובצי קריאה של ישות ב-DBM עדיין ישמשו למטרות מיפוי.

שמות של קטגוריות

הסטנדרטים למתן שמות ל-DTv1 ול-DTv2 שונים, באופן ספציפי אי אפשר לשנות את הקידומת את שם הקטגוריה הקיימת כדי לחשב את שם הקטגוריה של DTv2. שם הקטגוריה ייתן לך נציג התמיכה שלכם בזמן הגדרת החשבון.

בדרך כלל שמות של קטגוריות DTv2 נראים כמו gs://dcdt_-dcm_account1234

אפשר לראות את תוכן הקטגוריה בדפדפן https://cloud.google.com/console#/storage/browser/dcdt_-dcm_account1234

הפורמט של שם הקובץ

כל שם קובץ יכלול מחרוזת של מספרים, למשל:
dcm_account1234_impression_2016022601_20160225_234912_218211994.csv.gz
2016022601 הוא בפורמט YYYYMMDDHH. זוהי שעה (UTC) לאירועים (השעות ממוספרות מ-0 עד 23).
הקובץ 20160225_234912 הוא בפורמט YYYYMMDD_HHMMSS. זו השעה שבה הדוח שנוצר.
218211994 הוא מזהה הקובץ.

קובצי פעילות

אתם מקבלים קובץ פעילות אחד ביום, ושם הקובץ נראה כך:
dcm_account1234_activity_20160727_20160728_035750_268669761.csv.gz
הקובץ הזה מכיל נתונים מתאריך 27 ביולי 2016, והוא נוצר ב-28 ביולי 2016 בשעה 3:57:50.

לוחצים על 'קבצים'

מקבלים 24 קובצי קליקים ביום, ושם הקובץ נראה כך:
dcm_account1234_click_2016072717_20160728_012331_268381796.csv.gz
חשוב לשים לב לשעה UTC אחרי מחרוזת התאריך בשם הקובץ. השעות ממוספרות מ-0 עד 23, 17 כאן מציין שהאירועים בקובץ הזה הם מ-17:00 עד 17:59 (שעון שעון של 24 שעות) או 17:00 עד 18:00.
הקובץ הזה מכיל נתונים מ-17:00 עד 18:00, ב-27 ביולי 2016, והוא נוצר בשעה 1:23:31 בתאריך 28 ביולי 2016.

קובצי חשיפות

מקבלים 24 קובצי חשיפות ביום, ושם הקובץ נראה כך:
dcm_account7312_impression_2016072717_20160728_012355_268381795.csv.gz
מלבד שם הקובץ, ההתנהגות שלו זהה לזו של קובצי קליקים.

קבצים של טבלת התאמות

קובצי Match Table נוצרים פעם ביום, ושמות הקבצים נראים כך:
dcm_account1234_match_table_activity_cats_20160727_20160728_032226_268648829.csv.gz
הקובץ הזה מכיל נתונים מתאריך 27 ביולי 2016, והוא נוצר ב-28 ביולי 2016 בשעה 3:22:26.
הערה: בחלק מטבלאות ההתאמות החדשות, הנתונים הם סטטיים ולא נוצר קובץ יומי שניתן להורדה. עבורך יכול לקבל את הנתונים של הקבצים האלה מדפי העזר, למשל סוגי אירועים סטנדרטיים של מדיה עשירה.

שדות של העברת נתונים

שם שדה 1.0 שם שדה DT גרסה 2.0
שעה הוצא משימוש
מזהה משתמש מזהה המשתמש
מזהה מפרסם מזהה המפרסם
מזהה קנייה הוצא משימוש
מזהה הזמנה מזהה קמפיין
קוד זיהוי מודעה Ad ID
מזהה קריאייטיב מזהה להצגה
גרסת הקריאייטיב גירסת קריאייטיב
מזהה-גודל של קריאייטיב הוצא משימוש (אוחזר מטבלת ההתאמות כ'גודל פיקסל של קריאייטיב')
מזהה אתר מזהה אתר (DCM)
מזהה דף מזהה של מיקום המודעה
מילת מפתח הוצא משימוש
מזהה מדינה קוד המדינה
מדינה/אזור מדינה/אזור
קוד אזור הוצא משימוש
מזהה דפדפן מזהה דפדפן/פלטפורמה
Browser-Version גרסת דפדפן/פלטפורמה
מזהה מערכת הפעלה מזהה מערכת הפעלה
DMA-ID מזהה 'אזורי שוק ייעודיים (DMA)'
מזהה עיר מזהה עיר
מיקוד מיקוד דואר
שעה UTC-שניות הוצא משימוש
מזהה משתמש מקומי הוצא משימוש
סוג הפעילות הוצא משימוש (אוחזר מתוך טבלת ההתאמות 'activity_cats')
סוג המשנה של הפעילות הוצא משימוש (אוחזר מתוך טבלת ההתאמות 'activity_cats')
נתונים אחרים נתונים אחרים
Ordinal ערך ORD
זמן קליק זמן אינטראקציה
מזהה אירוע מזהה ההמרה
SV1 ערך פלח 1
PartnerID1 מזהה שותף 1
PartnerID2 מזהה שותף 2
כמות סה"כ המרות
הכנסה הכנסה כוללת

שמות הקבצים של טבלאות ההתאמות

שם קובץ 1.0 שם קובץ 2.0
activity_cat activity_cats
activity_type activity_types
ad ads
ad_page_assignments ad_placement_assignments
advertiser advertisers
browser browsers
campaign campaigns
cities cities
countries countries
creative creatives
creative_ad_assignments creative_ad_assignments
custom_creative_fields custom_creative_fields
dartsearch paid_search
designated_market_area designated_market_areas
keyval keyword_values
met_event rich_media_events
operating_system operating_systems
page placements
page_cost/page_flight_cost placement_cost
site sites
states states
user-defined_spot_vars custom_floodlight_variables

שדות בטבלת ההתאמות

activity_cats

שם שדה 1.0 שם שדה 2.0 סוג
Spot-ID Floodlight Configuration מספר שלם
Activity-Type-ID Activity Group ID מספר שלם
Activity-Type Activity Type מחרוזת
Activity-ID Activity ID מספר שלם
Activity Sub-Type Activity Sub-Type מחרוזת
Report-Name Activity מחרוזת
Tag-Method-ID Tag Counting Method ID מספר שלם

activity_types

שם שדה 1.0 שם שדה 2.0 סוג
Spot-ID Floodlight Configuration מספר שלם
Activity-Group-ID Activity Group ID מספר שלם
Activity-Type Activity Type מחרוזת
Report-Name Activity Group מחרוזת

ads

שם שדה 1.0 שם שדה 2.0 סוג
Advertiser-ID Advertiser ID מספר שלם
Buy-ID Campaign ID מספר שלם
Ad-ID Ad ID מספר שלם
Ad-Description Ad מחרוזת
Click-URL Ad Click URL מחרוזת
Ad-Type Ad Type מחרוזת
Creative-Size-ID Creative Pixel Size מחרוזת
Ad-Comments Ad Comments מחרוזת

ad_placement_assignments

שם שדה 1.0 שם שדה 2.0 סוג
Ad-ID Ad ID מספר שלם
Page-ID Placement ID מספר שלם

מפרסמים

שם שדה 1.0 שם שדה 2.0 סוג
Spot-ID Floodlight Configuration מספר שלם
Advertiser-ID Advertiser ID מספר שלם
Advertiser Advertiser מחרוזת
Advertiser-Group-ID Advertiser Group ID מספר שלם
Advertiser-Group Advertiser Group מחרוזת

דפדפנים

שם שדה 1.0 שם שדה 2.0 סוג
Browser-ID Browser/Platform ID מספר שלם
Browser Browswer/Platform מחרוזת

קמפיינים

שם שדה 1.0 שם שדה 2.0 סוג
Advertiser-ID Advertiser ID מספר שלם

Order-ID (לשעבר Buy-ID )

Campaign ID מספר שלם
Order (לשעבר Buy) Campaign מחרוזת
Start-Date Campaign Start Date תאריך
End-Date Campaign End Date תאריך
Billing-Invoice-Code Billing Invoice Code מחרוזת

ערים

שם שדה 1.0 שם שדה 2.0 סוג
City-ID City ID מספר שלם
City City מחרוזת
Creative-Library-Enabled Deprecated (now always 1) מספר שלם

ארצות

שם שדה 1.0 שם שדה 2.0 סוג
Country-ID Deprecated מספר שלם
Country Deprecated מחרוזת

פריטי קריאייטיב

שם שדה 1.0 שם שדה 2.0 סוג
Advertiser-ID Advertiser ID מספר שלם
Rendering-ID Rendering ID מספר שלם
UI-Creative-ID הוצא משימוש מספר שלם
Creative Creative מחרוזת
Last-Modified-Date Creative Last Modified Date תאריך
Creative-Type Creative Type מחרוזת
Creative-Sub-Type Deprecated מחרוזת
Creative-Size-ID Creative Pixel Size מחרוזת
Image-URL Creative Image URL מחרוזת
Creative-Version Creative Version integer

creative_ad_assignments

שם שדה 1.0 שם שדה 2.0 סוג
Ad-ID Ad ID מספר שלם
Creative-ID Creative ID מספר שלם
Start-Date Creative Start Date תאריך
End-Date Creative End Date תאריך
Rotation-Type Creative Rotation Type מחרוזת
Creative-Group-1 Creative Groups 1 מחרוזת
Creative-Group-2 Creative Groups 2 מחרוזת
Click-URL Ad Click URL מחרוזת

custom_creative_fields

שם שדה 1.0 שם שדה 2.0 סוג
Advertiser-ID Advertiser ID מספר שלם
Creative-ID Creative ID מספר שלם
Custom-Field-Number Creative Custom Field Number מספר שלם
Custom-Field-Name Creative Custom Field Name מחרוזת
Custom-Field-Value Creative Custom Field Value מחרוזת

custom_rich_media

שם שדה 1.0 שם שדה 2.0 סוג
Advertiser-ID Advertiser ID מספר שלם
Met-Event-ID Rich Media Event ID מספר שלם
Met-Event-Name Rich Media Event מחרוזת
Met-Event-Type-ID Rich Media Event Type ID מספר שלם
Met-Event-Type-Name Rich Media Event Type מחרוזת

designated_market_areas

שם שדה 1.0 שם שדה 2.0 סוג
DMA-ID Designated Market Area (DMA) ID מספר שלם
DMA Designated Market Area מחרוזת

keyword_values

שם שדה 1.0 שם שדה 2.0 סוג
Ad-ID Ad ID מספר שלם
Keyword-Expression Keyword מחרוזת
שם שדה 1.0 שם שדה 2.0 סוג
Ad-ID Ad ID מספר שלם
Advertiser-ID Advertiser ID מספר שלם
Buy-ID Campaign ID מספר שלם
DS-Ad-ID Paid Search Ad ID מספר שלם
Extended-Keyword-ID Paid Search Keyword ID מספר שלם
Keyword-ID Paid Search Legacy Keyword ID מספר שלם
DS-Campaign-Name Paid Search Campaign מחרוזת
KW-Ad-Group-Name Paid Search Ad Group מחרוזת
Bid-Strategy-Name Paid Search Bid Strategy מחרוזת
Landing-Page-URL Paid Search Landing Page URL מחרוזת
Keyword-Name Paid Search Keyword מחרוזת
Match-Type Paid Search Match Type מחרוזת

operating_systems

שם שדה 1.0 שם שדה 2.0 סוג
OS-ID Operating System ID מספר שלם
OS Operating System מחרוזת

מקומות

שם שדה 1.0 שם שדה 2.0 סוג
Buy-ID Campaign ID מספר שלם
Site-ID Site ID (DCM) מספר שלם
Page-ID Placement ID מספר שלם
Page Site keyname מחרוזת
Site-Placement Placement מחרוזת
Content-Category Content Category מחרוזת
Strategy Placement Strategy מחרוזת
Start-Date Placement Start Date תאריך
End-Date Placement End Date תאריך
Group-Type סוג קבוצת המיקומים מחרוזת
Group-Parent-ID מזהה חבילה/מחסום מספר שלם
Price-Type Placement Cost Structure מחרוזת
Cap-Cost Placement Cap Cost Option מספר ממשי (float)
CPA-Activity-ID Activity ID מספר שלם

placement_cost

שם שדה 1.0 שם שדה 2.0 סוג
Page-ID Placement ID מספר שלם
Effective-Date Placement Start Date תאריך
End-Date Placement End Date תאריך
Units Placement Total Booked Units מספר שלם
Rate Placement Rate מספר ממשי (float)
Comments Placement Comments מחרוזת

אתרים

שם שדה 1.0 שם שדה 2.0 סוג
Site-ID Site ID (DCM) מספר שלם
Site Site (DCM) מחרוזת
Directory-Site-ID Site ID (Site Directory) מספר שלם
Directory-Site Site (Site Directory) מחרוזת

מדינות

שם שדה 1.0 שם שדה 2.0 סוג
State/Province State/Region מחרוזת
State/Province Name State/Region Full Name מחרוזת

custom_floodlight_variables

שם שדה 1.0 שם שדה 2.0 סוג
Spot-ID Floodlight Configuration ID מספר שלם
Variable-ID Floodlight Variable ID מחרוזת
Variable-Name Floodlight Variable Name מחרוזת