نقل البيانات من الإصدار 1.0 من DT

الحصول على تطبيق Files

تشبه عملية استيعاب البيانات في الإصدار 2 من "نقل البيانات" عملية استيعاب البيانات في الإصدار 1، ولكن هناك بعض الأمور الرئيسية التي عليك تغييرها أثناء عملية نقل البيانات.

جارٍ معالجة الملفات

تعالج DTv2 الملفات كل ساعة (مرات الظهور والنقرات والوسائط التفاعلية المتقدّمة) والملفات اليومية (جداول الأنشطة والمطابقة). تتم معالجة الملفات كل ساعة (يحتوي اسم الملف على YYYYMMDDHH) بالتوقيت العالمي المنسَّق. تتم معالجة الملفات اليومية (يحتوي اسم الملف على YYYYMMDD) في المنطقة الزمنية المحلية لوقت تسجيل الحدث راجِع تنسيق اسم الملف. سيختلف الفرق بين التوقيت المحلي والتوقيت العالمي المنسَّق حسب موقعك الجغرافي.

تتم أيضًا معالجة الملفات بشكل مستقل، وقد يختلف الوقت المطلوب لمعالجتها. من الشائع أن تنتهي معالجة ملف ساعة لاحقة قبل ملف ساعة سابقة (مثل الساعة 6 قبل الساعة 5). لا تعتمد على ترتيب الملفات في عملية استيعاب البيانات، وإلا قد تتوقف العملية.

يمكن أن تظهر الأحداث في ملفات تمت معالجتها في وقت سابق أو لاحق مقارنةً بوقت الحدث. لا تتم معالجة الأحداث دائمًا في الساعة التي وقعت فيها.

ترتيب الأعمدة

يُرجى عدم الاعتماد على ترتيب الأعمدة كآلية لاستخدام ملفاتك. نريد أن تكون عملية المعالجة مرنة في مواجهة التغييرات، فإذا طلبت أعمدة إضافية أو أجرينا تغييرات في المستقبل، يمكن أن يتغيّر ترتيب الأعمدة وعددها في تقاريرك. اقرأ صف العناوين في كل ملف واربطه بالحقول في مستودع البيانات قبل محاولة كتابة البيانات.

ملفات مكرّرة

في بعض الأحيان، يتم إنشاء ملفات مكرّرة للتاريخ والساعة نفسها. إذا كان أكثر من ملف واحد يحمل الطابع الزمني نفسه للتاريخ/الساعة، استخدِم الملف الذي يتضمّن أحدث دقائق / ثوانٍ، استنادًا إلى الطابع الزمني لاسم الملف. يتم إنشاء ملفات مكررة لأنّ العمليات الخلفية حدّدت وجود مشكلة في الملف الأصلي.

الحقول

تم تغيير أسماء الحقول وتنسيق أسماء الحقول بالكامل، ولكن يتوفّر ربط من القديم إلى الجديد (حيثما كان ذلك متاحًا) في عملية نقل بيانات حقول "إدارة حملة DoubleClick"، بما في ذلك "جداول المطابقة". إذا لم تكن مستخدمًا لمنصة DBM، ستكون هذه الحقول فارغة ويمكنك تجاهلها.

قد تظهر لك أيضًا "حقول DBM" في ملفك. إذا كنت من مستخدمي "مدير حملة DoubleClick"، لن يتم ملء هذه الحقول إلا عند منح الإذن ذي الصلة على مستوى المعلِن في "مدير حملة DoubleClick" حيث يتم ربط المعلِنين. تتوفّر عملية ربط من القديم إلى الجديد (حيثما أمكن) في نقل حقول "إدارة حملة DoubleClick". سيستمر استخدام ملفات قراءة كيانات DBM لأغراض التعيين.

أسماء الحِزم

تختلف معايير التسمية في الإصدارَين 1 و2 من "العرض المباشر"، وتحديدًا لا يمكنك تغيير البادئة في اسم الحزمة الحالية لتحديد اسم حزمة الإصدار 2 من "العرض المباشر". سيقدّم لك ممثل خدمة الدعم اسم الحزمة عند إعداد حسابك.

بشكل عام، تبدو أسماء حِزم 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. هذه هي ساعة التوقيت العالمي المتفق عليه للأحداث في هذا الملف (يتم ترقيم الساعات من 0 إلى 23).يكون
20160225_234912 بالتنسيق YYYYMMDD_HHMMSS. هذا هو الوقت الذي تم فيه إنشاء التقرير.‫
218211994 هو رقم تعريف الملف.

ملفات النشاط

يمكنك الحصول على ملف نشاط واحد في اليوم، ويكون اسم الملف على النحو التالي:
dcm_account1234_activity_20160727_20160728_035750_268669761.csv.gz
يحتوي هذا الملف على بيانات بتاريخ 27 يوليو 2016 وتم إنشاؤه في الساعة 3:57:50 من يوم 28 يوليو 2016.

انقر على "الملفات".

يمكنك الحصول على أربعة وعشرين ملف Click في اليوم، ويكون اسم الملف على النحو التالي:
dcm_account1234_click_2016072717_20160728_012331_268381796.csv.gz
يُرجى الانتباه إلى ساعة التوقيت العالمي المتفق عليه بعد سلسلة التاريخ في اسم الملف، ويتم ترقيم الساعات من 0 إلى 23، لذا يشير الرقم 17 هنا إلى أنّ الأحداث في هذا الملف هي من الساعة 17:00 إلى الساعة 17:59 (التوقيت بنظام 24 ساعة) أو من الساعة 5:00 مساءً إلى الساعة 6:00 مساءً.
يحتوي هذا الملف على بيانات الفترة من الساعة 5:00 مساءً إلى الساعة 6:00 مساءً بتاريخ 27 يوليو 2016، وقد تم إنشاؤه في الساعة 1:23:31 صباحًا بتاريخ 28 يوليو 2016.

ملفات مرات الظهور

يمكنك الحصول على أربعة وعشرين ملفًا للانطباعات في اليوم، ويكون اسم الملف على النحو التالي:
dcm_account7312_impression_2016072717_20160728_012355_268381795.csv.gz
باستثناء اسم الملف، يتصرف هذا الملف بالطريقة نفسها التي تتصرف بها ملفات النقرات.

ملفات جدول المطابقة

يتم إنشاء ملفات "جدول المطابقة" مرة واحدة يوميًا، وتكون أسماء الملفات على النحو التالي:
dcm_account1234_match_table_activity_cats_20160727_20160728_032226_268648829.csv.gz
يحتوي هذا الملف على بيانات بتاريخ 27 يوليو 2016 وتم إنشاؤه في الساعة 3:22:26 من يوم 28 يوليو 2016.
ملاحظة: بالنسبة إلى بعض جداول المطابقة الجديدة، تكون البيانات ثابتة ولا يتم إنشاء ملف قابل للتنزيل يوميًا، ويمكنك الحصول على البيانات الخاصة بهذه الملفات من الصفحات المرجعية، مثل أنواع الأحداث العادية في "الوسائط التفاعلية".

حقول نقل البيانات

اسم الحقل 1.0 اسم حقل الإصدار 2.0 من "شجرة الأجهزة"
الوقت تم إيقافها نهائيًا
User-ID رقم تعريف المستخدم
Advertiser-ID الرقم التعريفي للمعلن
Buy-ID تم إيقافها نهائيًا
Order-ID الرقم التعريفي للحملة
معرِّف الإعلان معرّف الإعلان
Creative-ID الرقم التعريفي للعرض
Creative-Version إصدار تصميم الإعلان
Creative-Size-ID تم إيقافه نهائيًا (تم استرداده من "جدول المطابقة" كحجم تصميم الإعلان بالبكسل)
Site-ID رقم تعريف الموقع (DCM)
Page-ID رقم تعريف موضع الإعلان
الكلمة الرئيسية تم إيقافها نهائيًا
Country-ID رمز البلد
الولاية/المقاطعة الولاية/المنطقة
Areacode تم إيقافها نهائيًا
Browser-ID الرقم التعريفي لوسيط عرض الإعلان/المتصفح
Browser-Version إصدار النظام الأساسي/المتصفح
OS-ID الرقم التعريفي لنظام التشغيل
DMA-ID معرّف منطقة التسويق المصممة (DMA)
City-ID رقم تعريف المدينة
الرمز-البريدي الرمز البريدي
Time-UTC-Sec منهي العمل به
Local-User-ID تم إيقافها نهائيًا
Activity-Type متوقّف نهائيًا (تم استرداده من جدول المطابقة "activity_cats")
النشاط-النوع الفرعي متوقّف نهائيًا (تم استرداده من جدول المطابقة "activity_cats")
Other-Data بيانات أخرى
الترتيبية قيمة ORD
وقت النقرة وقت التفاعل
Event-ID رقم تعريف الإحالة الناجحة
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 عدد عائم
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 سلسلة