Method: customers.generateIvtReport

تبدأ في تنفيذ طلب بحث لاسترداد ملخّص يومي لعدد الزيارات غير الصالحة لنظام أساسي محدد. ستتم كتابة النتائج في جدول وجهة BigQuery المحدّدة. ويمكن استخدام اسم العملية المعروضة لاستطلاع حالة اكتمال طلب البحث.

يحتوي جدول النتائج على 5 صفوف لكل يوم في النطاق الزمني. صف واحد لكل نوع من أنواع الأجهزة الأربعة وصف واحد لكل أنواع الأجهزة. يمثل الصف "الكل" مجموع أنواع الأجهزة الأربعة لهذا اليوم. ونتيجةً لذلك، يحتوي كل عمود على ضعف إجمالي عدد مرات الظهور. في حال تنقيح Ads Data Hub للصفوف بسبب قيود الخصوصية، سيحتوي ملخص الصف الذي تمت فلترته (الصف بدون يوم) على مجموع الصفوف المخفيّة.

طلب HTTP

POST https://adsdatahub.googleapis.com/v1/{name=customers/*}:generateIvtReport

يستخدم عنوان URL بنية gRPC Transcoding.

معلّمات المسار

المَعلمات
name

string

عميل Ads Data Hub الذي يقدّم الطلب. ويظهر هذا في شكل #&39;customers/[customerId]'. على سبيل المثال: 'customers/123'.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "adsDataCustomerId": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "timeZone": string,
  "destTable": string,

  // Union field platform_dimensions can be only one of the following:
  "googleAdsDimensions": {
    object (GoogleAdsDimensions)
  },
  "dv360YoutubeDimensions": {
    object (Dv360Dimensions)
  },
  "ytReserveDimensions": {
    object (YouTubeReserveDimensions)
  }
  // End of list of possible types for union field platform_dimensions.
}
الحقول
adsDataCustomerId

string (int64 format)

الرقم التعريفي لعميل Ads Data Hub المرتبط ببيانات الإعلانات.
startDate

object (Date)

اليوم الأول من التقرير الذي تم إنشاؤه.
endDate

object (Date)

اليوم الأخير من التقرير الذي تم إنشاؤه، شاملاً.
timeZone

string

اختياريّ. المنطقة الزمنية لتقريرَي تاريخ البدء وانتهائه. إذا لم يتم تحديدها، سيتم ضبطها تلقائيًا على 'UTC'.
destTable

string

جدول BigQuery المقصود لنتائج طلب البحث بالتنسيق 'project.dataset.table_name' إذا تم تحديد المشروع، يجب أن يكون قد تمت إضافة المشروع إلى القائمة البيضاء بشكلٍ صريح لحساب Ads Data Hub للعميل. إذا لم يتم تحديد المشروع، سيتم استخدام المشروع التلقائي للعميل الذي تم تقديمه. إذا لم يتم تحديد أي من المشروع أو مجموعة البيانات، يتم استخدام المشروع ومجموعة البيانات التلقائيتين.
حقل الاتحاد platform_dimensions. النظام الأساسي المستخدَم في إعداد التقارير مع تقسيم اختياري إلى النظام الأساسي. وسيؤدي عدم اختيار نظام أساسي إلى حدوث خطأ. يمكن أن يكون platform_dimensions واحدًا فقط مما يلي:
googleAdsDimensions

object (GoogleAdsDimensions)

تقرير على منصّة "إعلانات Google".
dv360YoutubeDimensions

object (Dv360Dimensions)

الإبلاغ عن منصّة "مساحة العرض والفيديو 360"
ytReserveDimensions

object (YouTubeReserveDimensions)

الإبلاغ عن منصة YTR

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/adsdatahub

GoogleAdsالأبعاد

فلترة الأبعاد لمنصّة "إعلانات Google".

تمثيل JSON 
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
الحقول
campaignIds[]

string (int64 format)

أرقام تعريف الحملات الاختيارية في "إعلانات Google". وإذا كانت هذه البيانات فارغة، يتم الإبلاغ عن جميع الحملات خلال الفترة الزمنية المحدّدة.
metricType

enum (MetricType)

تحديد النظام الأساسي لقياس الأداء وإعداد التقارير.

نوع المقياس

تحديد النظام الأساسي لقياس الأداء وإعداد التقارير.

عمليات التعداد
METRIC_TYPE_UNSPECIFIED نوع المقياس غير محدّد.
METRIC_TYPE_IMPRESSION بيانات مرات الظهور في "إعلانات Google".
METRIC_TYPE_YOUTUBE_VIEW مشاهدات YouTube، المعروفة أيضًا باسم TrueView.

الأبعاد في "مساحة العرض والفيديو 360"

فلترة السمات لمنصّة "مساحة العرض والفيديو 360".

تمثيل JSON 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
الحقول
lineItemIds[]

string (int64 format)

معرّفات العناصر الاختيارية في "مساحة العرض والفيديو 360". وفي حال ترك هذا الحقل فارغًا، سيتم الإبلاغ عن جميع العناصر خلال الفترة الزمنية المحدّدة.
metricType

enum (MetricType)

تحديد النظام الأساسي لقياس الأداء وإعداد التقارير.

أبعاد YouTubeReserve

فلترة الأبعاد لمنصة YouTube Reserve

تمثيل JSON 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
الحقول
orderIds[]

string (int64 format)

معرّفات الطلبات الاختيارية في YouTube Reserve. يمكنك الإبلاغ عن جميع الطلبات خلال الفترة الزمنية المحدّدة إذا كان فارغًا.
metricType

enum (MetricType)

تحديد النظام الأساسي لقياس الأداء وإعداد التقارير.