Method: customers.generateAudienceCompositionInsights

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

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

คำขอ HTTP

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

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

อัตราส่วนของ AudienceShare กับ baseAudienceShare หรือเป็น 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)

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