Method: customers.generateAudienceCompositionInsights

แสดงผลคอลเล็กชันของแอตทริบิวต์ที่แสดงในกลุ่มเป้าหมายที่สนใจ พร้อมเมตริกที่เปรียบเทียบสัดส่วนของกลุ่มเป้าหมายแต่ละรายการของแอตทริบิวต์แต่ละรายการกับส่วนแบ่งฐานกลุ่มเป้าหมายของแอตทริบิวต์นั้นๆ

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

คำขอ HTTP

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

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

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

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

string

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

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

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

การแสดง JSON 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
ช่อง
audience

object (InsightsAudience)

ต้องระบุ กลุ่มเป้าหมายที่สนใจซึ่งมีการขอข้อมูลเชิงลึก
baselineAudience

object (InsightsAudience)

ฐานกลุ่มเป้าหมายที่มีการเปรียบเทียบกลุ่มเป้าหมายที่สนใจ
dataMonth

string

ข้อมูลประวัติในช่วง 1 เดือนที่จะใช้สำหรับข้อมูลเชิงลึกในรูปแบบ "ปปปป-ดด" หากไม่ได้ตั้งค่า ระบบจะแสดงข้อมูลเชิงลึกสำหรับข้อมูลใน 30 วันล่าสุด
dimensions[]

enum (AudienceInsightsDimension)

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

string

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

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

ข้อความตอบกลับสำหรับ AudienceInsightsService.GenerateAudienceCompositionInsights

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

การแสดง JSON 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
ช่อง
sections[]

object (AudienceCompositionSection)

เนื้อหาของรายงานข้อมูลเชิงลึก โดยแบ่งออกเป็นส่วนต่างๆ แต่ละส่วนจะเชื่อมโยงกับค่า AudienceInsightsDimension ค่าใดค่าหนึ่งในคําขอ และมิติข้อมูลหนึ่งอาจมีมากกว่า 1 ส่วนก็ได้

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

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

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

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

InsightsAudience

กลุ่มผู้ใช้ที่กำหนดโดยลักษณะต่างๆ ที่สามารถขอข้อมูลเชิงลึกได้ใน AudienceInsightsService

การแสดง JSON 
{
  "countryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "incomeRanges": [
    {
      object (IncomeRangeInfo)
    }
  ],
  "dynamicLineups": [
    {
      object (AudienceInsightsDynamicLineup)
    }
  ],
  "topicAudienceCombinations": [
    {
      object (InsightsAudienceAttributeGroup)
    }
  ]
}
ช่อง
countryLocations[]

object (LocationInfo)

ต้องระบุ ประเทศสำหรับผู้ชม
subCountryLocations[]

object (LocationInfo)

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

object (GenderInfo)

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

object (AgeRangeInfo)

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

object (ParentalStatusInfo)

สถานะความเป็นบิดามารดาสำหรับผู้ชม หากไม่มี กลุ่มเป้าหมายจะไม่ถูกจำกัดตามสถานะความเป็นบิดามารดา
incomeRanges[]

object (IncomeRangeInfo)

ช่วงเปอร์เซ็นไทล์ของรายได้ครัวเรือนสำหรับกลุ่มเป้าหมาย หากไม่มีกลุ่มเป้าหมาย กลุ่มเป้าหมายจะไม่จำกัดตามช่วงรายได้ครัวเรือน
dynamicLineups[]

object (AudienceInsightsDynamicLineup)

รายการช่องแบบไดนามิกที่แสดงเนื้อหา YouTube ที่กลุ่มเป้าหมายดู
topicAudienceCombinations[]

object (InsightsAudienceAttributeGroup)

ชุดค่าผสมของแอตทริบิวต์เอนทิตี หมวดหมู่ และความสนใจของผู้ใช้เป็นตัวกำหนดกลุ่มเป้าหมาย ชุดค่าผสมนี้มีโครงสร้าง AND-of-OR เชิงตรรกะ: แอตทริบิวต์ภายใน InsightsAudienceAttributeGroup แต่ละรายการจะรวมเข้ากับ "หรือ" และชุดค่าผสมเองจะนำมารวมกับ "และ" ตัวอย่างเช่น นิพจน์ (เอนทิตีหรือผู้สนใจ) และ (ผู้ที่มีแผนจะซื้อหรือหมวดหมู่) สามารถสร้างขึ้นโดยใช้ InsightsAudienceAttributeGroups 2 กลุ่มโดยแต่ละกลุ่มมีแอตทริบิวต์ 2 รายการ

InsightsAudienceAttributeGroup

รายการแอตทริบิวต์ AudienceInsights

การแสดง JSON 
{
  "attributes": [
    {
      object (AudienceInsightsAttribute)
    }
  ]
}
ช่อง
attributes[]

object (AudienceInsightsAttribute)

ต้องระบุ คอลเล็กชันของแอตทริบิวต์กลุ่มเป้าหมายที่จะรวมกับตรรกะ OR แอตทริบิวต์ไม่จำเป็นต้องเป็นมิติข้อมูลเดียวกันทั้งหมด บริบทนี้รองรับเฉพาะเอนทิตีกราฟความรู้ หมวดหมู่ผลิตภัณฑ์และบริการ รวมถึงกลุ่มเป้าหมายตามกลุ่มความสนใจและกลุ่มเป้าหมายที่มีแผนจะซื้อเท่านั้น

AudienceCompositionSection

คอลเล็กชันของแอตทริบิวต์ที่เกี่ยวข้องประเภทเดียวกันในรายงานข้อมูลเชิงลึกเกี่ยวกับองค์ประกอบกลุ่มเป้าหมาย

การแสดง JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
ช่อง
dimension

enum (AudienceInsightsDimension)

ประเภทของแอตทริบิวต์ในส่วนนี้
topAttributes[]

object (AudienceCompositionAttribute)

กลุ่มที่เกี่ยวข้องมากที่สุดสําหรับกลุ่มเป้าหมายนี้ หากมิติข้อมูลคือ GENDER, AGE_RANGE หรือ PARENTAL_STATUS รายการแอตทริบิวต์นี้จะครบถ้วนสมบูรณ์
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

แอตทริบิวต์เพิ่มเติมสำหรับกลุ่มเป้าหมายนี้ โดยจัดกลุ่มเป็นคลัสเตอร์ จะมีการสร้างข้อมูลก็ต่อเมื่อมิติข้อมูลเป็น YOUTUBE_CHANNEL เท่านั้น

AudienceCompositionAttribute

แอตทริบิวต์กลุ่มเป้าหมายที่มีข้อมูลเมตาและเมตริก

การแสดง JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
ช่อง
attributeMetadata

object (AudienceInsightsAttributeMetadata)

แอตทริบิวต์ที่มีข้อมูลเมตา
metrics

object (AudienceCompositionMetrics)

แชร์และจัดทำดัชนีเมตริกสำหรับแอตทริบิวต์

AudienceCompositionMetrics

เมตริกการแชร์และดัชนีที่เชื่อมโยงกับแอตทริบิวต์ในรายงานข้อมูลเชิงลึกเกี่ยวกับองค์ประกอบกลุ่มเป้าหมาย

การแสดง JSON 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
ช่อง
baselineAudienceShare

number

เศษส่วน (ตั้งแต่ 0 ถึง 1) ของฐานกลุ่มเป้าหมายที่ตรงกับแอตทริบิวต์
audienceShare

number

เศษส่วน (ตั้งแต่ 0 ถึง 1) ของกลุ่มเป้าหมายที่เฉพาะเจาะจงซึ่งตรงกับแอตทริบิวต์
index

number

อัตราส่วนของสัดส่วนกลุ่มเป้าหมายต่อฐานกลุ่มเป้าหมาย หรือเป็น 0 หากไม่มีการกำหนดอัตราส่วนหรือไม่มีความหมาย
score

number

คะแนนความเกี่ยวข้องตั้งแต่ 0 ถึง 1

AudienceCompositionAttributeCluster

คอลเล็กชันของแอตทริบิวต์ที่เกี่ยวข้องพร้อมข้อมูลเมตาและเมตริกในรายงานข้อมูลเชิงลึกเกี่ยวกับองค์ประกอบกลุ่มเป้าหมาย

การแสดง JSON 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
ช่อง
clusterDisplayName

string

ชื่อของแอตทริบิวต์คลัสเตอร์นี้
clusterMetrics

object (AudienceCompositionMetrics)

หากมิติข้อมูลที่เชื่อมโยงกับคลัสเตอร์นี้คือ YOUTUBE_CHANNEL แล้วclusterMetrics จะเป็นเมตริกที่เชื่อมโยงกับคลัสเตอร์โดยรวม สําหรับมิติข้อมูลอื่นๆ ระบบจะไม่ตั้งค่าช่องนี้
attributes[]

object (AudienceCompositionAttribute)

แอตทริบิวต์แต่ละรายการที่ประกอบขึ้นเป็นคลัสเตอร์นี้พร้อมข้อมูลเมตาและเมตริก