الوصول إلى ملفات قراءة الكيان

ملفات قراءة الكيان هي تمثيلات JSON لعناصر الحملة الخاصة بالشريك. ملفات قراءة الكيانات للقراءة فقط ولا يمكن استخدامها لكتابة تغييرات على "مساحة العرض والفيديو 360" من Google. لمعرفة المزيد من المعلومات عن استخدام ميزة "قراءة الملفات" الخاصة بالكيانات، يُرجى التواصل مع مدير الحساب الذي يمكنه مناقشة احتياجاتك بمزيد من التفصيل.

تجدر الإشارة إلى أنّ ملفات قراءة الكيانات تتوفّر فقط لمدة 60 يومًا من تاريخ معالجتها.

يمكن عرض تنسيق الملفات المقروءة الخاصة بالكيان في مرجع تنسيق الملف.

يتم تخزين الملفات المقروءة الخاصة بالكيان كمجموعتَين:

  • الجداول العلنية التي تحتوي على بيانات عامة، مثل معلومات عن إصدارات المتصفّح أو اللغات المخزّنة في حزمة gdbm-public
  • الجداول الخاصة التي تحتوي على معلومات حول الحملات والميزانيات وغيرها من البيانات الخاصة بالشريك. يتم تخزين الجداول الخاصة في مجموعات بيانات خاصة بالشركاء. على سبيل المثال، إذا كان رقم تعريف الشريك هو 123، ستكون الحزمة التي تحتوي على جداولك الخاصة هي gdbm-123.
يتوفّر كل من الجداول العامة والخاصة في دليل فرعي من النوع entity ضمن الحزمة. لمزيد من المعلومات عن معالجة الأدلة الفرعية، يُرجى الاطّلاع على مساحة اسم العنصر في Cloud Storage.
يتم إنشاء الجداول العلنية في الساعة 5 صباحًا بالتوقيت العالمي المنسّق. يتم إنشاء الجداول الخاصة في الساعة 5 صباحًا حسب المنطقة الزمنية لشريكك (على الرغم من حدوث تأخير في حالات نادرة)، ويتم تخزينها تلقائيًا وبأمان في Google Cloud Storage. ويتم إنشاء ملف ملخّص بعد إنشاء جميع الجداول العامة والخاصة.

طاولات عامة

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
الحقلالوصف
processing_dateالتاريخ الذي عالجت فيه "مساحة العرض والفيديو 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التاريخ الذي عالجت فيه "مساحة العرض والفيديو 360" البيانات. ولا يرتبط هذا التاريخ بالضرورة بالأحداث المضمَّنة في الملف. تنسيق التاريخ هو YYYYMMDD، على سبيل المثال 20120320 سيصبح 20 آذار (مارس) 2012. وسيتم إنشاء الملفات بين الساعة 4 صباحًا و6 صباحًا في المنطقة الزمنية للشريك.
batch_indexفهرس الدفعة بقيمة صفرية. في الوقت الحالي، هذه القيمة هي 0 دائمًا.
entity_typeنوع الملف: Partner وAdvertiser وInsertionOrder وLineItem وCreative وPixel وInventorySource وUserList وUniversalChannel وsummary.
على سبيل المثال، إذا كنت تنشئ اسم ملف لاسترداد ملف قراءة الكيان للشريك 123 الذي يصل إلى جدول line_item من 2 نيسان (أبريل) 2013، سيبدو اسم الملف على النحو التالي:
gdbm-123/entity/20130402.0.LineItem.json