- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- AudienceCompositionSection
- AudienceCompositionAttribute
- AudienceCompositionMetrics
- AudienceCompositionAttributeCluster
- ลองใช้งาน
แสดงผลคอลเล็กชันของแอตทริบิวต์ที่แสดงในกลุ่มเป้าหมายที่สนใจ พร้อมเมตริกที่เปรียบเทียบสัดส่วนของกลุ่มเป้าหมายแต่ละรายการของแอตทริบิวต์แต่ละรายการกับส่วนแบ่งฐานกลุ่มเป้าหมายของแอตทริบิวต์นั้นๆ
รายการข้อผิดพลาดที่พบ: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
คำขอ HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateAudienceCompositionInsights
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
customerId |
ต้องระบุ รหัสของลูกค้า |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "audience": { object ( |
ช่อง | |
---|---|
audience |
ต้องระบุ กลุ่มเป้าหมายที่สนใจซึ่งมีการขอข้อมูลเชิงลึก |
baselineAudience |
ฐานกลุ่มเป้าหมายที่มีการเปรียบเทียบกลุ่มเป้าหมายที่สนใจ |
dataMonth |
ข้อมูลประวัติในช่วง 1 เดือนที่จะใช้สำหรับข้อมูลเชิงลึกในรูปแบบ "ปปปป-ดด" หากไม่ได้ตั้งค่า ระบบจะแสดงข้อมูลเชิงลึกสำหรับข้อมูลใน 30 วันล่าสุด |
dimensions[] |
ต้องระบุ มิติข้อมูลกลุ่มเป้าหมายที่ควรแสดงผลข้อมูลเชิงลึกในการเรียบเรียง |
customerInsightsGroup |
ชื่อลูกค้าที่วางแผนไว้ ค่านี้เป็นค่าที่ผู้ใช้กำหนด |
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับ AudienceInsightsService.GenerateAudienceCompositionInsights
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"sections": [
{
object ( |
ช่อง | |
---|---|
sections[] |
เนื้อหาของรายงานข้อมูลเชิงลึก โดยแบ่งออกเป็นส่วนต่างๆ แต่ละส่วนจะเชื่อมโยงกับค่า AudienceInsightsDimension ค่าใดค่าหนึ่งในคําขอ และมิติข้อมูลหนึ่งอาจมีมากกว่า 1 ส่วนก็ได้ |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/adwords
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0
AudienceCompositionSection
คอลเล็กชันของแอตทริบิวต์ที่เกี่ยวข้องประเภทเดียวกันในรายงานข้อมูลเชิงลึกเกี่ยวกับองค์ประกอบกลุ่มเป้าหมาย
การแสดง JSON |
---|
{ "dimension": enum ( |
ช่อง | |
---|---|
dimension |
ประเภทของแอตทริบิวต์ในส่วนนี้ |
topAttributes[] |
กลุ่มที่เกี่ยวข้องมากที่สุดสําหรับกลุ่มเป้าหมายนี้ หากมิติข้อมูลคือ GENDER, AGE_RANGE หรือ PARENTAL_STATUS รายการแอตทริบิวต์นี้จะครบถ้วนสมบูรณ์ |
clusteredAttributes[] |
แอตทริบิวต์เพิ่มเติมสำหรับกลุ่มเป้าหมายนี้ โดยจัดกลุ่มเป็นคลัสเตอร์ จะมีการสร้างข้อมูลก็ต่อเมื่อมิติข้อมูลเป็น YOUTUBE_CHANNEL เท่านั้น |
AudienceCompositionAttribute
แอตทริบิวต์กลุ่มเป้าหมายที่มีข้อมูลเมตาและเมตริก
การแสดง JSON |
---|
{ "attributeMetadata": { object ( |
ช่อง | |
---|---|
attributeMetadata |
แอตทริบิวต์ที่มีข้อมูลเมตา |
metrics |
แชร์และจัดทำดัชนีเมตริกสำหรับแอตทริบิวต์ |
AudienceCompositionMetrics
เมตริกการแชร์และดัชนีที่เชื่อมโยงกับแอตทริบิวต์ในรายงานข้อมูลเชิงลึกเกี่ยวกับองค์ประกอบกลุ่มเป้าหมาย
การแสดง JSON |
---|
{ "baselineAudienceShare": number, "audienceShare": number, "index": number, "score": number } |
ช่อง | |
---|---|
baselineAudienceShare |
เศษส่วน (ตั้งแต่ 0 ถึง 1) ของฐานกลุ่มเป้าหมายที่ตรงกับแอตทริบิวต์ |
audienceShare |
เศษส่วน (ตั้งแต่ 0 ถึง 1) ของกลุ่มเป้าหมายที่เฉพาะเจาะจงซึ่งตรงกับแอตทริบิวต์ |
index |
อัตราส่วนของสัดส่วนกลุ่มเป้าหมายต่อฐานกลุ่มเป้าหมาย หรือเป็น 0 หากไม่มีการกำหนดอัตราส่วนหรือไม่มีความหมาย |
score |
คะแนนความเกี่ยวข้องตั้งแต่ 0 ถึง 1 |
AudienceCompositionAttributeCluster
คอลเล็กชันของแอตทริบิวต์ที่เกี่ยวข้องพร้อมข้อมูลเมตาและเมตริกในรายงานข้อมูลเชิงลึกเกี่ยวกับองค์ประกอบกลุ่มเป้าหมาย
การแสดง JSON |
---|
{ "clusterDisplayName": string, "clusterMetrics": { object ( |
ช่อง | |
---|---|
clusterDisplayName |
ชื่อของแอตทริบิวต์คลัสเตอร์นี้ |
clusterMetrics |
หากมิติข้อมูลที่เชื่อมโยงกับคลัสเตอร์นี้คือ YOUTUBE_CHANNEL แล้วclusterMetrics จะเป็นเมตริกที่เชื่อมโยงกับคลัสเตอร์โดยรวม สําหรับมิติข้อมูลอื่นๆ ระบบจะไม่ตั้งค่าช่องนี้ |
attributes[] |
แอตทริบิวต์แต่ละรายการที่ประกอบขึ้นเป็นคลัสเตอร์นี้พร้อมข้อมูลเมตาและเมตริก |