Method: customers.generateInsightsFinderReport

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

รายการข้อผิดพลาด: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

คำขอ HTTP

POST https://googleads.googleapis.com/v16/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)

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