Method: customers.generateIvtReport

اجرای یک پرس و جو را برای بازیابی خلاصه روزانه از تعداد ترافیک نامعتبر برای یک پلت فرم خاص شروع می کند. نتایج در جدول مقصد BigQuery مشخص شده نوشته می شود. نام عملیات بازگشتی را می توان برای نظرسنجی وضعیت تکمیل پرس و جو استفاده کرد.

جدول خروجی شامل 5 ردیف برای هر روز در محدوده تاریخ است. 1 ردیف برای هر یک از 4 نوع دستگاه و 1 ردیف برای همه انواع دستگاه. ردیف All مجموع 4 نوع دستگاه برای آن روز است. در نتیجه، هر ستون دو برابر تعداد نمایش‌ها را شامل می‌شود. اگر ADH ردیف‌ها را به دلیل محدودیت‌های حریم خصوصی ویرایش کند، خلاصه ردیف فیلتر شده (ردیف بدون روز) حاوی مجموع ردیف‌های ویرایش‌شده خواهد بود.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
name

string

مشتری Ads Data Hub درخواست را ارائه می دهد. این به شکل 'customers/[customerId]' است. به عنوان مثال 'مشتریان/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)

شناسه مشتری مرکز داده آگهی‌های پیوندی که مالک داده‌های تبلیغات است.

startDate

object ( Date )

روز اول گزارش تولید شده

endDate

object ( Date )

آخرین روز گزارش تولید شده، شامل.

timeZone

string

اختیاری. منطقه زمانی برای تاریخ شروع و پایان گزارش. اگر مشخص نشده باشد، پیش‌فرض «UTC» است.

destTable

string

جدول مقصد BigQuery برای نتایج پرس و جو با قالب «project.dataset.table_name». اگر مشخص شده باشد، پروژه باید به صراحت برای حساب ADH مشتری در لیست سفید قرار گیرد. اگر پروژه مشخص نشده باشد، از پروژه پیش فرض برای مشتری ارائه شده استفاده می کند. اگر نه پروژه و نه مجموعه داده مشخص نشده است، از پروژه و مجموعه داده پیش فرض استفاده می کند.

platform_dimensions فرم_ابعاد میدان اتحادیه . پلتفرمی برای گزارش با برش اختیاری پلتفرم خاص. عدم انتخاب پلت فرم منجر به خطا می شود. platform_dimensions فقط می تواند یکی از موارد زیر باشد:
googleAdsDimensions

object ( GoogleAdsDimensions )

گزارش در پلتفرم تبلیغات گوگل

dv360YoutubeDimensions

object ( Dv360Dimensions )

گزارش پلتفرم DV360.

ytReserveDimensions

object ( YouTubeReserveDimensions )

گزارش در پلتفرم YTR.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Operation است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

GoogleAdsDimensions

ابعاد فیلتر برای پلت فرم گوگل ادز.

نمایندگی JSON
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
زمینه های
campaignIds[]

string ( int64 format)

شناسه‌های کمپین Google Ads اختیاری. در صورت خالی بودن، گزارشی از همه کمپین ها برای بازه زمانی مشخص شده ارائه می دهد.

metricType

enum ( MetricType )

بستری را برای اندازه گیری و گزارش دهی تعیین می کند.

نوع متریک

بستری را برای اندازه گیری و گزارش دهی تعیین می کند.

Enums
METRIC_TYPE_UNSPECIFIED نوع متریک نامشخص
METRIC_TYPE_IMPRESSION داده‌های نمایش تبلیغات Google
METRIC_TYPE_YOUTUBE_VIEW بازدیدهای YouTube با نام TrueView views.

ابعاد Dv360

ابعاد فیلتر برای پلت فرم DV360.

نمایندگی JSON
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
زمینه های
lineItemIds[]

string ( int64 format)

شناسه مورد خط DV360 اختیاری. در صورت خالی بودن، گزارش در مورد تمام موارد خط برای دوره زمانی مشخص شده است.

metricType

enum ( MetricType )

بستری را برای اندازه گیری و گزارش دهی تعیین می کند.

YouTubeReserveDimensions

ابعاد فیلتر برای پلتفرم YouTube Reserve.

نمایندگی JSON
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
زمینه های
orderIds[]

string ( int64 format)

شناسه سفارش اختیاری YouTube Reserve. اگر خالی باشد، تمام سفارش‌ها را برای بازه زمانی مشخص گزارش می‌دهد.

metricType

enum ( MetricType )

بستری را برای اندازه گیری و گزارش دهی تعیین می کند.

،

اجرای یک پرس و جو را برای بازیابی خلاصه روزانه از تعداد ترافیک نامعتبر برای یک پلت فرم خاص شروع می کند. نتایج در جدول مقصد BigQuery مشخص شده نوشته می شود. نام عملیات بازگشتی را می توان برای نظرسنجی وضعیت تکمیل پرس و جو استفاده کرد.

جدول خروجی شامل 5 ردیف برای هر روز در محدوده تاریخ است. 1 ردیف برای هر یک از 4 نوع دستگاه و 1 ردیف برای همه انواع دستگاه. ردیف All مجموع 4 نوع دستگاه برای آن روز است. در نتیجه، هر ستون دو برابر تعداد نمایش‌ها را شامل می‌شود. اگر ADH ردیف‌ها را به دلیل محدودیت‌های حریم خصوصی ویرایش کند، خلاصه ردیف فیلتر شده (ردیف بدون روز) حاوی مجموع ردیف‌های ویرایش‌شده خواهد بود.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
name

string

مشتری Ads Data Hub درخواست را ارائه می دهد. این به شکل 'customers/[customerId]' است. به عنوان مثال 'مشتریان/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)

شناسه مشتری مرکز داده آگهی‌های پیوندی که مالک داده‌های تبلیغات است.

startDate

object ( Date )

روز اول گزارش تولید شده

endDate

object ( Date )

آخرین روز گزارش تولید شده، شامل.

timeZone

string

اختیاری. منطقه زمانی برای تاریخ شروع و پایان گزارش. اگر مشخص نشده باشد، پیش‌فرض «UTC» است.

destTable

string

جدول مقصد BigQuery برای نتایج پرس و جو با قالب «project.dataset.table_name». اگر مشخص شده باشد، پروژه باید به صراحت برای حساب ADH مشتری در لیست سفید قرار گیرد. اگر پروژه مشخص نشده باشد، از پروژه پیش فرض برای مشتری ارائه شده استفاده می کند. اگر نه پروژه و نه مجموعه داده مشخص نشده است، از پروژه و مجموعه داده پیش فرض استفاده می کند.

platform_dimensions فرم_ابعاد میدان اتحادیه . پلتفرمی برای گزارش با برش اختیاری پلتفرم خاص. عدم انتخاب پلت فرم منجر به خطا می شود. platform_dimensions فقط می تواند یکی از موارد زیر باشد:
googleAdsDimensions

object ( GoogleAdsDimensions )

گزارش در پلتفرم تبلیغات گوگل

dv360YoutubeDimensions

object ( Dv360Dimensions )

گزارش پلتفرم DV360.

ytReserveDimensions

object ( YouTubeReserveDimensions )

گزارش در پلتفرم YTR.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Operation است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

GoogleAdsDimensions

ابعاد فیلتر برای پلت فرم گوگل ادز.

نمایندگی JSON
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
زمینه های
campaignIds[]

string ( int64 format)

شناسه‌های کمپین Google Ads اختیاری. در صورت خالی بودن، گزارشی از همه کمپین ها برای بازه زمانی مشخص شده ارائه می دهد.

metricType

enum ( MetricType )

بستری را برای اندازه گیری و گزارش دهی تعیین می کند.

نوع متریک

بستری را برای اندازه گیری و گزارش دهی تعیین می کند.

Enums
METRIC_TYPE_UNSPECIFIED نوع متریک نامشخص
METRIC_TYPE_IMPRESSION داده‌های نمایش تبلیغات Google
METRIC_TYPE_YOUTUBE_VIEW بازدیدهای YouTube با نام TrueView views.

ابعاد Dv360

ابعاد فیلتر برای پلت فرم DV360.

نمایندگی JSON
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
زمینه های
lineItemIds[]

string ( int64 format)

شناسه مورد خط DV360 اختیاری. در صورت خالی بودن، گزارش در مورد تمام موارد خط برای دوره زمانی مشخص شده است.

metricType

enum ( MetricType )

بستری را برای اندازه گیری و گزارش دهی تعیین می کند.

YouTubeReserveDimensions

ابعاد فیلتر برای پلت فرم YouTube Reserve.

نمایندگی JSON
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
زمینه های
orderIds[]

string ( int64 format)

شناسه سفارش اختیاری YouTube Reserve. اگر خالی باشد، تمام سفارش‌ها را برای بازه زمانی مشخص گزارش می‌دهد.

metricType

enum ( MetricType )

بستری را برای اندازه گیری و گزارش دهی تعیین می کند.