Method: customers.generateInsightsFinderReport

สร้างรายงานที่บันทึกไว้ซึ่งดูได้ในเครื่องมือเครื่องมือค้นหาข้อมูลเชิงลึก

รายการข้อผิดพลาดที่เกิดขึ้น: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

คำขอ HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateInsightsFinderReport

URL ใช้ไวยากรณ์การแปลง gRPC

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

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

string

ต้องระบุ รหัสของลูกค้า

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
ช่อง
baselineAudience

object (BasicInsightsAudience)

ต้องระบุ ฐานกลุ่มเป้าหมายสำหรับรายงานนี้ ซึ่งโดยทั่วไปจะเป็นผู้ใช้ทั้งหมดในภูมิภาคหนึ่งๆ
specificAudience

object (BasicInsightsAudience)

ต้องระบุ กลุ่มเป้าหมายที่สนใจของรายงานนี้ ข้อมูลเชิงลึกในรายงานจะอิงตามแอตทริบิวต์ที่พบได้บ่อยในกลุ่มเป้าหมายนี้มากกว่าในฐานกลุ่มเป้าหมายของรายงาน
customerInsightsGroup

string

ชื่อลูกค้าที่วางแผนไว้ ค่านี้เป็นค่าที่ผู้ใช้กำหนด

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

ข้อความตอบกลับสำหรับ AudienceInsightsService.GenerateInsightsFinderReport ซึ่งมี URL ที่แชร์ได้สำหรับรายงาน

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "savedReportUrl": string
}
ช่อง
savedReportUrl

string

HTTPS URL ที่มี Deep Link เป็น UI ของเครื่องมือค้นหาข้อมูลเชิงลึก พร้อมป้อนข้อมูลรายงานตามคำขอ

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

BasicInsightsAudience

คำอธิบายของกลุ่มเป้าหมายที่ใช้ในการขอข้อมูลเชิงลึก

การแสดง JSON 
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
ช่อง
countryLocation[]

object (LocationInfo)

ต้องระบุ ประเทศสำหรับกลุ่มเป้าหมายนี้
subCountryLocations[]

object (LocationInfo)

แอตทริบิวต์สถานที่ตั้งทางภูมิศาสตร์ของโดเมนย่อย หากมี แต่ละรายการเหล่านี้ต้องอยู่ในประเทศใดประเทศหนึ่งในกลุ่มเป้าหมายนี้
gender

object (GenderInfo)

เพศของผู้ชม หากไม่มี ระบบจะไม่จำกัดกลุ่มเป้าหมายตามเพศ
ageRanges[]

object (AgeRangeInfo)

ช่วงอายุสำหรับผู้ชม หากไม่มีข้อมูลดังกล่าว กลุ่มเป้าหมายจะแสดงแทนทุกคนที่มีอายุ 18 ปีขึ้นไปที่ตรงกับแอตทริบิวต์อื่นๆ
userInterests[]

object (UserInterestInfo)

ความสนใจของผู้ใช้ที่กำหนดกลุ่มเป้าหมายนี้ ระบบรองรับกลุ่มเป้าหมายตามกลุ่มความสนใจและกลุ่มเป้าหมายที่มีแผนจะซื้อ
topics[]

object (AudienceInsightsTopic)

หัวข้อที่แสดงโดยเอนทิตีกราฟความรู้และ/หรือหมวดหมู่ผลิตภัณฑ์และบริการที่กลุ่มเป้าหมายนี้สนใจ

AudienceInsightsTopic

เอนทิตีหรือหมวดหมู่ที่แสดงถึงหัวข้อที่กําหนดกลุ่มเป้าหมาย

การแสดง JSON 
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
ช่อง
ฟิลด์การรวม topic เอนทิตีหรือหมวดหมู่แอตทริบิวต์ topic ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
entity

object (AudienceInsightsEntity)

เอนทิตีกราฟความรู้
category

object (AudienceInsightsCategory)

หมวดหมู่ผลิตภัณฑ์และบริการ