مهاجرت از DT v1.0

دریافت فایل‌ها

فرآیند دریافت اطلاعات برای DTv2 مشابه DTv1 است، اما نکات کلیدی وجود دارد که باید در طول مهاجرت خود تغییر دهید.

پردازش فایل‌ها

DTv2 فایل‌های ساعتی (تعداد نمایش، کلیک و رسانه‌های غنی) و فایل‌های روزانه (جداول فعالیت و تطابق) را پردازش می‌کند. فایل‌های ساعتی (نام فایل شامل YYYYMMDDHH است) بر اساس زمان UTC پردازش می‌شوند. فایل‌های روزانه (نام فایل شامل YYYYMMDD است) بر اساس منطقه زمانی گزارش‌دهی محلی شما پردازش می‌شوند. به فرمت نام فایل مراجعه کنید . اختلاف زمانی بین زمان محلی شما و UTC بسته به موقعیت مکانی شما متفاوت خواهد بود.

فایل‌ها همچنین به طور مستقل پردازش می‌شوند و زمان پردازش آنها می‌تواند متفاوت باشد. معمولاً یک فایل ساعت بعد، پردازش را قبل از یک فایل زودتر به پایان می‌رساند (مثلاً ساعت ۶ قبل از ساعت ۵). برای فرآیند جذب فایل، به ترتیب فایل‌ها تکیه نکنید، در غیر این صورت ممکن است فرآیند شما متوقف شود.

رویدادها می‌توانند نسبت به زمان وقوعشان در فایل‌های پردازش‌شده‌ی قبلی یا بعدی ظاهر شوند. رویدادها همیشه در ساعتی که رخ داده‌اند پردازش نمی‌شوند.

ترتیب ستون

لطفاً برای استفاده از فایل‌های خود به ترتیب ستون‌ها تکیه نکنید. ما می‌خواهیم پردازش شما در برابر تغییرات مقاوم باشد؛ اگر ستون‌های اضافی درخواست کنید یا اگر در آینده تغییراتی ایجاد کنیم، ترتیب و تعداد ستون‌های گزارش‌های شما می‌تواند تغییر کند. قبل از تلاش برای نوشتن داده‌ها، ردیف هدر هر فایل را بخوانید و آن را به فیلدهای انبار داده خود نگاشت کنید.

فایل‌های تکراری

گاهی اوقات فایل‌های تکراری برای تاریخ و ساعت یکسان نوشته می‌شوند. اگر بیش از یک فایل مهر تاریخ/ساعت یکسانی دارد، از فایلی که آخرین دقیقه/ثانیه را دارد، بر اساس مهر زمانی نام فایل، استفاده کنید. فایل‌های تکراری به این دلیل ایجاد می‌شوند که فرآیندهای پشتیبان تشخیص داده‌اند که مشکلی در فایل اصلی وجود دارد.

فیلدها

نام فیلدها و قالب نام فیلد همگی تغییر کرده‌اند، اما در مهاجرت فیلد 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
این فایل حاوی داده‌های مربوط به ۲۷ ژوئیه ۲۰۱۶ است و در ساعت ۳:۵۷:۵۰ در تاریخ ۲۸ ژوئیه ۲۰۱۶ ایجاد شده است.

روی فایل‌ها کلیک کنید

شما روزانه بیست و چهار فایل کلیک دریافت می‌کنید و نام فایل به این شکل است:
dcm_account1234_click_2016072717_20160728_012331_268381796.csv.gz
به ساعت UTC بعد از رشته تاریخ در نام فایل توجه کنید؛ ساعت‌ها از ۰ تا ۲۳ شماره‌گذاری شده‌اند، بنابراین عدد ۱۷ در اینجا نشان می‌دهد که رویدادهای این فایل برای ساعت ۱۷:۰۰ تا ۱۷:۵۹ (زمان ۲۴ ساعته) یا ۵:۰۰ تا ۶:۰۰ بعد از ظهر هستند.
این فایل حاوی داده‌های مربوط به ساعت ۵:۰۰ بعد از ظهر تا ۶:۰۰ بعد از ظهر، ۲۷ جولای ۲۰۱۶ است و در ساعت ۱:۲۳:۳۱ در تاریخ ۲۸ جولای ۲۰۱۶ ایجاد شده است.

فایل‌های ایمپرشن

شما روزانه بیست و چهار فایل Impression دریافت می‌کنید و نام فایل به این شکل است:
dcm_account7312_impression_2016072717_20160728_012355_268381795.csv.gz
به غیر از نام فایل، این دستور نیز مانند Click Files عمل می‌کند.

فایل‌های جدول تطابق

فایل‌های Match Table روزی یک بار تولید می‌شوند و نام فایل‌ها به این شکل است:
dcm_account1234_match_table_activity_cats_20160727_20160728_032226_268648829.csv.gz
این فایل حاوی داده‌های مربوط به ۲۷ ژوئیه ۲۰۱۶ است و در ساعت ۳:۲۲:۲۶ در ۲۸ ژوئیه ۲۰۱۶ ایجاد شده است.
توجه: برای برخی از جداول تطابق جدید، داده‌ها ایستا هستند و هیچ فایل قابل دانلود روزانه‌ای تولید نمی‌شود؛ می‌توانید داده‌های این فایل‌ها را از صفحات مرجع مانند انواع رویدادهای استاندارد Rich Media دریافت کنید.

فیلدهای انتقال داده

نام فیلد ۱.۰ نام فیلد DT نسخه ۲.۰
زمان منسوخ شده
شناسه کاربری شناسه کاربری
شناسه تبلیغ‌کننده شناسه آگهی‌دهنده
خرید-ID منسوخ شده
شناسه سفارش شناسه کمپین
شناسه تبلیغ شناسه آگهی
شناسه خلاق شناسه رندر
نسخه خلاقانه نسخه خلاقانه
شناسه-اندازه-خلاقانه منسوخ شده (برگرفته از جدول تطابق به عنوان اندازه پیکسل خلاقانه)
شناسه سایت شناسه سایت (DCM)
شناسه صفحه شناسه قرارگیری
کلمه کلیدی منسوخ شده
شناسه کشور کد کشور
ایالت/استان ایالت/منطقه
کد منطقه منسوخ شده
شناسه مرورگر شناسه مرورگر/پلتفرم
نسخه مرورگر نسخه مرورگر/پلتفرم
شناسه سیستم عامل شناسه سیستم عامل
شناسه DMA شناسه منطقه بازار تعیین‌شده (DMA)
شناسه شهر شناسه شهر
کد پستی کد پستی
زمان-UTC-ثانیه منسوخ شده
شناسه کاربر محلی منسوخ شده
نوع فعالیت منسوخ شده (برگرفته از جدول تطابق 'activity_cats')
زیرنوع فعالیت منسوخ شده (برگرفته از جدول تطابق 'activity_cats')
سایر داده‌ها سایر داده‌ها
ترتیبی مقدار ORD
زمان کلیک زمان تعامل
شناسه رویداد شناسه تبدیل
اس‌وی۱ مقدار بخش ۱
PartnerID1 شناسه همکار ۱
PartnerID2 شناسه همکار ۲
مقدار کل تبدیل‌ها
درآمد کل درآمد

نام فایل‌های جدول را مطابقت دهید

نام فایل ۱.۰ نام فایل ۲.۰
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

فیلدهای جدول را مطابقت دهید

فعالیت_گربه‌ها

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
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 عدد صحیح

انواع_فعالیت

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
Spot-ID Floodlight Configuration عدد صحیح
Activity-Group-ID Activity Group ID عدد صحیح
Activity-Type Activity Type رشته
Report-Name Activity Group رشته

تبلیغات

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
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-ID Ad ID عدد صحیح
Page-ID Placement ID عدد صحیح

تبلیغ کنندگان

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
Spot-ID Floodlight Configuration عدد صحیح
Advertiser-ID Advertiser ID عدد صحیح
Advertiser Advertiser رشته
Advertiser-Group-ID Advertiser Group ID عدد صحیح
Advertiser-Group Advertiser Group رشته

مرورگرها

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
Browser-ID Browser/Platform ID عدد صحیح
Browser Browswer/Platform رشته

کمپین‌ها

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
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 رشته

شهرها

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
City-ID City ID عدد صحیح
City City رشته
Creative-Library-Enabled Deprecated (now always 1) عدد صحیح

کشورها

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
Country-ID Deprecated عدد صحیح
Country Deprecated رشته

خلاقان

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
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

تکالیف_تبلیغ_خلاقانه

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
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 رشته

فیلدهای_خلاقانه_سفارشی

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
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 رشته

رسانه‌های غنی_سفارشی

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
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 رشته

مناطق_بازار_تعیین_شده

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
DMA-ID Designated Market Area (DMA) ID عدد صحیح
DMA Designated Market Area رشته

مقادیر_کلیدی

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
Ad-ID Ad ID عدد صحیح
Keyword-Expression Keyword رشته
نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
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 رشته

سیستم_عامل‌ها

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
OS-ID Operating System ID عدد صحیح
OS Operating System رشته

قرار دادن ها

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
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 شناور
CPA-Activity-ID Activity ID عدد صحیح

هزینه_جایگزینی

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
Page-ID Placement ID عدد صحیح
Effective-Date Placement Start Date تاریخ
End-Date Placement End Date تاریخ
Units Placement Total Booked Units عدد صحیح
Rate Placement Rate شناور
Comments Placement Comments رشته

سایت‌ها

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
Site-ID Site ID (DCM) عدد صحیح
Site Site (DCM) رشته
Directory-Site-ID Site ID (Site Directory) عدد صحیح
Directory-Site Site (Site Directory) رشته

ایالت‌ها

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
State/Province State/Region رشته
State/Province Name State/Region Full Name رشته

متغیرهای نورافکن سفارشی

نام فیلد ۱.۰ نام فیلد ۲.۰ نوع
Spot-ID Floodlight Configuration ID عدد صحیح
Variable-ID Floodlight Variable ID رشته
Variable-Name Floodlight Variable Name رشته