نعمل حاليًا على نقل مجموعة فرعية من أنواع التقارير من التقارير بلا إنترنت إلى التقارير الفورية. بعد نقل بيانات المستخدِم، ستتضمّن ردود queries.list تقارير فورية حالية. ويمكنك الاطّلاع على مشاركة المدونة للحصول على مزيد من المعلومات.
تحدِّد هذه الأنواع الحقول المضمّنة في بعض الجداول، ولا تتضمّن هذه الحقول جداول خاصة بها.
نوع واحد (Numeric Id)
Scalar
الوصف
integer
هو رقم تعريف رقمي يُستخدم كمعرّف للكيانات. يجب عدم التعامل مع المعرّفات على أنّها فريدة على مستوى العالم، على سبيل المثال، قد تكون قيمة المعرّف نفسها المستخدَمة في حملة مستخدَمة أيضًا في وحدة البكسل.
نوع Enum
Scalar
الوصف
integer
قائمة بالعديد من الخيارات المحتملة يتم وصف الخيارات المختلفة بمزيد من التفصيل في نوع العنصر الرئيسي.
نوع واحد (Time)
Scalar
الوصف
integer
وقت نظام التشغيل Unix بالميكروسكوند (1/1,000,000 ثانية)، على سبيل المثال، 1330403779608570 يمثّل يوم الثلاثاء 28 شباط (فبراير) 2012 04:36:19.608570.
نوع Currency Micro
Scalar
الوصف
integer
المبلغ المحدد بالعملة بالمايكرو (1/1,000,000 وحدة عملة)، على سبيل المثال، إذا كانت العملة هي اليورو، فإن 75000000 تعني 75 يورو أو إذا كانت العملة بالدولار الأمريكي، فإن 250000 يعني 0.25 دولار أمريكي. لا يتم تحويل المبالغ إلى دولار أمريكي أو العكس.
نوع Percentage Milli
Scalar
الوصف
integer
نسبة مئوية معروضة بالملي ثانية (1/1,000 من النسبة المئوية)، على سبيل المثال، 100 تعني 0.1%.
نوع FileSummary
اسم الحقل
النوع
الوصف
name
string
اسم الملف (باستثناء اسم الحزمة أو الدليل)
num_records
integer
عدد الكيانات في الملف.
version
integer
رقم الإصدار الرئيسي للملف. قد يتغيّر هذا الرقم في حال إنشاء إصدارات جديدة من تنسيق بيانات العناصر في المستقبل.
معرّف فريد ضمن كل نوع من أنواع الكيانات: على سبيل المثال، مع الكيانات الشريكة، سيكون هذا المعرّف هو رقم تعريف الشريك، وبالنسبة إلى المعلِنين، سيكون رقم تعريف المعلِن، وما إلى ذلك.
name
string
اسم الكيان الظاهر في واجهة المستخدم.
active
boolean
الحالة التي ضبطها المستخدم: قد لا يكون الكيان معروضًا لأسباب أخرى، مثل ميزانية مستنفدة أو انتهاء فترة عرض الإعلانات وما إلى ذلك.
الحد الأقصى لعدد مرات الظهور لكل فاصل زمني لمعدل السرعة تم ضبطه من خلال pacing_type. في حال عدم توفّر هذا الحقل، لن يكون هناك حدّ أقصى لعدد مرّات الظهور.
pacing_max_spend_advertiser_micros
integer
الحد الأقصى للإنفاق (بوحدات ميكرو عملة المعلِن) لكل فاصل سرعة يحدّده pacing_type إذا لم يكن هذا الحقل متوفّرًا، لن يكون هناك حدّ أقصى للإنفاق.
مبلغ الأرباح في الميكروالإعلانات الحالية للمعلِن. لا يتم ضبط هذه القيمة إلا إذا كان النوع هو CPM.
media_cost_markup_percent_millis
integer
النسبة المئوية لزيادة الأرباح في Percentage Milli. لا يتم ضبط هذه القيمة إلا إذا كان النوع هو MEDIA_COST_MARKUP أو TOTAL_MEDIA_COST_MARKUP.
post_view_conversion_tracking_fraction
float
جزء من الإحالات الناجحة بعد الرؤية التي سيتم احتسابها لتتبُّع الإحالات الناجحة. إذا كانت القيمة 0، يتم احتساب الإحالات الناجحة بعد النقر فقط. وإذا كانت القيمة 1.0، يتم تتبُّع جميع الإحالات الناجحة.
Target يشير إلى موضع الإعلان على
صفحة الناشر قيم Target.criteria_id
هي 0=ALL_POSITIONS 1=ABOVE_THE_FOLD
2=BELOW_THE_FOLD 3=UNKNOWN_POSITION Target.parameter غير محدّدة.
Target يشير إلى سرعة الشبكة
قيم Target.criteria_id هي: 0=ALL_CONNECTION_SPEEDS 1=BROADBAND (2.0 ميغابت في الثانية أو أسرع). 2=DIALUP (56 كيلوبت في الثانية وأبطأ): 3=UNKNOWN_CONNECTION_SPEED 4=EDGE (Enhanced Data for GSM Evolution (2G). 57 كيلوبت في الثانية أو أسرع) 5=UMT (Universal Mobile Telecom System (3G). 384 كيلوبت في الثانية وأسرع). 6=DSL (خط المشترك الرقمي 768 كيلوبت في الثانية وأسرع). 7=HSDPA (High-Speed Downlink Packet Access (3.5G). 1.8 ميغابت في الثانية أو أسرع)
Target.criteria_id يمكن دمجه مع
UserList.id و
Target.parameter هي قيمة تكرار ظهور البكسل بالميكرو ثانية.
في حال عدم توفّر هذه القيمة، يعني ذلك استهداف جميع شرائح الجمهور.
صفيف من أنواع Target للمواقع الإلكترونية
يمكن الانضمام إلى Target.criteria_id باستخدام
UniversalSite.id أو لا يتم ضبطه إذا لم يكن الموقع الإلكتروني
في UniversalSite. Target.parameter
هو موقع إلكتروني مثل google.com، ولكن لا يمكن العثور عليه بالضرورة في
UniversalSite.
رقم تعريف عنصر الشريك الرئيسي. يمكن الانضمام باستخدام Partner.common_data.id.
currency_code
string
رمز العملة المكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217، مثل USD للدولار الأمريكي
timezone_code
string
رمز المنطقة الزمنية الرسمي، على سبيل المثال "America/Los_Angeles". إذا تم ضبط dfa_configuration على NORMAL أو HYBRID، ستكون هذه القيمة هي نفسها المنطقة الزمنية لمعلن Firebase المرتبط.
landing_page_url
string
عنوان URL التلقائي للصفحة المقصودة.
available_channel_ids
[integer]
مصفوفة من الأعداد الصحيحة تحتوي على القنوات المتاحة المرتبطة بهذا المعلِن. يمكن الانضمام إليه باستخدام UniversalChannel.id.
blacklist_channel_id
[integer]
مصفوفة من الأعداد الصحيحة التي تحتوي على قنوات القائمة السوداء لهذا المعلِن. يمكن الانضمام باستخدام UniversalChannel.id.
0=NONE (التكلفة لكل ألف ظهور قابل للعرض غير مفعّلة) 1=CPC 2=CPA 3=ROI 4=CPCV 5=CPM 6=AVCPM 7=IMP_VALUE_ROAS 8=CIVA 9=IVO_TEN 10=AV_VIEWED 11=INCREMENTAL_CONVERSIONS
goal_advertiser_micros
integer
هدف التكلفة لكل ألف ظهور قابل للعرض بالمايكرو بعملة المعلِن لن تظهر هذه القيمة إذا تم ضبط performance_goal على NONE.
0=Not Expandable 1=Expanding Up 2=Expanding Down 3=Expanding Left 4=Expanding Right 5=Expanding Up Left 6=Expanding Up Right 7=Expanding Down Left 8=Expanding Down Right 9=Expanding Up or Down 10=Expanding Left or Right 11=Expanding Any Diagonal
عند ضبط القيمة على true، سيتم تضمين جميع المستودعات غير المصنّفة.
inventory_name
string
اسم مصدر المستودع كما يظهر في واجهة المستخدم قد لا يكون هذا الحقل متوفّرًا. في حال عدم توفّر السمة inventory_name وكانت السمة unclassified صحيحة، يشير ذلك إلى المستودع غير المصنّف للتبادل. إذا لم يكن هذا الحقل متوفّرًا وكانت قيمة unclassified خاطئة، يكون مصدر المستودع هو المستودع على مستوى التبادل.
هناك مصفوفة من أرقام تعريف المعلنين، والتي يمكن الانضمام إليها مع Advertiser.common_data.id، والإذن باستخدام مصدر المستودع هذا.
ملاحظة: إذا كان مصدر المستودع الإعلاني متاحًا لجميع المعلِنين، لن يكون هذا الحقل متوفّرًا.
external_id
string
رقم التعريف الخارجي الذي يتم منحه لمصدر المستودع هذا والمحدّد من خلال عملية التبادل، ويُعرف عادةً باسم الصفقة أو الرقم التعريفي للبائع. قد يكون هذا الحقل غير متوفر.
min_cpm_micros
integer
السعر الأدنى الساري لمستودع الإعلانات هذا بالفئات الصغيرة للعملة
min_cpm_currency_code
string
رمز العملة المكوّن من 3 أحرف وفقًا لمعيار ISO 4217 والمستخدَم في min_cpm_micros.
صفيف من أرقام تعريف المعلِنين الذين يمكن الانضمام إليهم باستخدام Advertiser.common_data.id، والذين لديهم الإذن باستخدام هذه القناة.
ملاحظة: إذا كانت القناة متاحة لجميع المعلِنين، لن يظهر هذا الحقل.
is_deleted
boolean
عند ضبط القيمة على true، لن تتمكّن أيّ تفاصيل إعلان جديدة من استهداف هذه القناة، ولكن ستستمرّ تفاصيل الإعلان الحالية التي تستهدف هذه القناة في استهدافها.
is_brand_safe_channel
boolean
عند ضبطها على true، يمكن استخدام هذه القناة لفلترة أمان العلامة التجارية. يُرجى العِلم أنّ هذا السعر ينطبق حاليًا على true فقط للمستويات الأربعة المضمّنة لأمان العلامة التجارية.
إذا كانت القيمة هي true، سيغطي هذا المعيار الأجهزة الجوّالة فقط. إذا كان القيمة خطأ، لا يشمل هذا الإدخال سوى الأجهزة غير الجوّالة، حتى إذا كان اسمه (مثل "غير ذلك") لا يشير إلى ذلك.
إذا كان صحيحًا، لا يشمل هذا المعيار سوى الأجهزة الجوّالة. إذا كانت القيمة "false"، لا يشمل هذا الإدخال سوى الأجهزة غير الجوّالة، حتى إذا كان اسمها (مثل "غير ذلك") لا يشير إلى ذلك.
name
string
الاسم المألوف للمتصفّح، على سبيل المثال Safari 5. ولا يتضمّن سلسلة وكيل المستخدم الكاملة.
إذا كانت القيمة هي true، سيغطي هذا المعيار الأجهزة الجوّالة فقط. إذا كانت القيمة "false"، لا يشمل هذا الإدخال سوى الأجهزة غير الجوّالة، حتى إذا كان اسمها (مثل "غير ذلك") لا يشير إلى ذلك.
تاريخ التعديل الأخير: 2024-11-15 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-11-15 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Entity Read Files, providing data on advertisers, campaigns, and other entities, will be sunset on October 31, 2024, requiring migration to the Display & Video 360 API."],["Shared data types like `Numeric Id`, `Enum`, `Time`, and custom types like `Budget` and `FrequencyCap` are used across various entities to represent specific attributes."],["Data is organized into tables like `Advertiser`, `Campaign`, `LineItem`, and `Creative`, each containing specific fields relevant to their respective entities."],["Tables are interconnected via joinable fields, enabling linking and analysis of data across entities, such as joining `Advertiser` and `Campaign` using `advertiser_id`."],["The `InventorySource` table provides details about ad inventory, including its source, accessibility for advertisers, and associated costs."]]],[]]
