Method: customers.generateIvtReport

เริ่มดําเนินการค้นหาเพื่อเรียกดูข้อมูลสรุปการเข้าชมที่ไม่ถูกต้องในแต่ละวันสําหรับแพลตฟอร์มนั้นๆ ระบบจะเขียนผลลัพธ์ลงในตารางปลายทาง BigQuery ที่ระบุ สามารถใช้ชื่อการดําเนินการที่แสดงผลในการตรวจสอบสถานะการค้นหา

ตารางเอาต์พุตจะมี 5 แถวสําหรับแต่ละวันในช่วงวันที่ 1 แถวสําหรับอุปกรณ์แต่ละประเภท 4 แถว และ 1 แถวสําหรับอุปกรณ์ทุกประเภท แถว "ทั้งหมด" คือผลรวมของอุปกรณ์ 4 ประเภทในวันนั้น ดังนั้นแต่ละคอลัมน์จะมีจํานวนการแสดงผลรวมเป็น 2 เท่า หาก ADH ปกปิดแถวเนื่องจากข้อจํากัดด้านความเป็นส่วนตัว สรุปแถวที่กรอง (แถวที่ไม่มีวัน) จะมีผลรวมของแถวที่ปกปิด

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ลูกค้าที่ Ads Data Hub ส่งคําขอ โดยจะอยู่ในรูปแบบ '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' หากระบุไว้ โปรเจ็กต์ต้องได้รับอนุญาตพิเศษสําหรับบัญชี ADH ของลูกค้า หากไม่ได้ระบุโปรเจ็กต์ไว้ ให้ใช้โปรเจ็กต์เริ่มต้นสําหรับลูกค้าที่ระบุ หากไม่ได้ระบุทั้งโปรเจ็กต์และชุดข้อมูล ให้ใช้โปรเจ็กต์และชุดข้อมูลเริ่มต้น
ช่อง Union platform_dimensions แพลตฟอร์มที่ต้องการรายงานโดยใช้การแบ่งส่วนเฉพาะแพลตฟอร์ม หากไม่เลือกแพลตฟอร์ม จะเกิดข้อผิดพลาด platform_dimensions ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
googleAdsDimensions

object (GoogleAdsDimensions)

รายงานในแพลตฟอร์ม Google Ads
dv360YoutubeDimensions

object (Dv360Dimensions)

รายงานบนแพลตฟอร์ม DV360
ytReserveDimensions

object (YouTubeReserveDimensions)

รายงานบนแพลตฟอร์ม YTR

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Operation

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

มิติข้อมูลของ Google Ads

การกรองมิติข้อมูลสําหรับแพลตฟอร์ม Google Ads

การแสดง JSON 
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
ช่อง
campaignIds[]

string (int64 format)

รหัสแคมเปญ Google Ads ที่ไม่บังคับ หากว่างเปล่า รายงานเกี่ยวกับแคมเปญทั้งหมดในระยะเวลาที่ระบุ
metricType

enum (MetricType)

กําหนดแพลตฟอร์มที่จะวัดและรายงาน

ประเภทเมตริก

กําหนดแพลตฟอร์มที่จะวัดและรายงาน

Enum
METRIC_TYPE_UNSPECIFIED ประเภทเมตริกที่ไม่ระบุ
METRIC_TYPE_IMPRESSION ข้อมูลการแสดงผลใน Google Ads
METRIC_TYPE_YOUTUBE_VIEW การดู YouTube หรือที่เรียกว่า TrueView

มิติข้อมูล DV360

การกรองมิติข้อมูลสําหรับแพลตฟอร์ม DV360

การแสดง JSON 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
ช่อง
lineItemIds[]

string (int64 format)

รหัสรายการโฆษณา DV360 (ไม่บังคับ) หากว่างเปล่า รายงานเกี่ยวกับรายการโฆษณาทั้งหมดสําหรับช่วงเวลาที่ระบุ
metricType

enum (MetricType)

กําหนดแพลตฟอร์มที่จะวัดและรายงาน

มิติข้อมูลการจองใน YouTube

การกรองขนาดสําหรับแพลตฟอร์ม YouTube Reserve

การแสดง JSON 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
ช่อง
orderIds[]

string (int64 format)

รหัสคําสั่งซื้อที่ไม่บังคับของ YouTube Reserve หากว่างเปล่า จะรายงานเกี่ยวกับคําสั่งซื้อทั้งหมดในระยะเวลาที่ระบุ
metricType

enum (MetricType)

กําหนดแพลตฟอร์มที่จะวัดและรายงาน