מיגרציה מ-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
מלבד שם הקובץ, ההתנהגות של הקבצים האלה זהה להתנהגות של קבצים של קליקים.

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

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

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

שם השדה 1.0 שם השדה ב-DT v2.0
שעה הוצא משימוש
User-ID מזהה המשתמש
מזהה המפרסם מזהה מפרסם
מזהה הרכישה הוצא משימוש
מזהה הזמנה מזהה הקמפיין
קוד זיהוי מודעה מזהה המודעה
מזהה הקריאייטיב מזהה להצגה
Creative-Version גירסת קריאייטיב
מזהה גודל הקריאייטיב הוצא משימוש (מאוחזר מטבלת התאמה כגודל פיקסל של קריאייטיב)
מזהה אתר מזהה אתר (DCM)
Page-ID המזהה של מיקום המודעה
מילת מפתח הוצא משימוש
מזהה מדינה קוד המדינה
מדינה/אזור מדינה/אזור
קידומת הוצא משימוש
Browser-ID מזהה דפדפן/פלטפורמה
גרסת הדפדפן גרסת דפדפן/פלטפורמה
OS-ID מזהה מערכת הפעלה
מזהה DMA מזהה 'אזורי שוק ייעודיים (DMA)'
City-ID מזהה עיר
Zip-Code מיקוד דואר
Time-UTC-Sec הוצא משימוש
Local-User-ID הוצא משימוש
סוג הפעילות הוצא משימוש (נלקח מטבלת ההתאמה activity_cats)
סוג משנה של פעילות הוצא משימוש (נלקח מטבלת ההתאמה activity_cats)
Other-Data נתונים אחרים
סדרתי ערך 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 deprecated מספר שלם
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 מחרוזת