แสดงรายงาน Pivot ที่กำหนดเองของข้อมูลเหตุการณ์ Google Analytics รายงาน Pivot เป็นรูปแบบขั้นสูงและชัดเจนกว่ารายงานปกติ ในรายงาน Pivot มิติข้อมูลจะปรากฏต่อเมื่อรวมอยู่ใน Pivot เท่านั้น คุณสามารถระบุ Pivot ได้หลายจุดเพื่อวิเคราะห์ข้อมูลเพิ่มเติม
คำขอ HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runPivotReport
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
property |
ตัวระบุพร็อพเพอร์ตี้ GA4 ของ Google Analytics ที่มีการติดตามเหตุการณ์ ระบุไว้ในพาธ URL ไม่ใช่ส่วนเนื้อหา ดูข้อมูลเพิ่มเติมได้ในวิธีค้นหารหัสพร็อพเพอร์ตี้ ภายในคำขอแบบกลุ่ม พร็อพเพอร์ตี้นี้ไม่ควรระบุหรือสอดคล้องกับพร็อพเพอร์ตี้ระดับกลุ่ม ตัวอย่าง: พร็อพเพอร์ตี้/1234 |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "dimensions": [ { object ( |
ช่อง | |
---|---|
dimensions[] |
มิติข้อมูลที่ขอ ต้องใช้มิติข้อมูลที่ระบุทั้งหมดโดยค่าใดค่าหนึ่งต่อไปนี้ ได้แก่dimensionExpression, dimensionFilter, Pivot, orderBys |
metrics[] |
เมตริกที่ขอ ต้องระบุเมตริกอย่างน้อย 1 รายการ ต้องใช้เมตริกที่กำหนดทั้งหมดโดยรายการใดรายการหนึ่งต่อไปนี้ ได้แก่metric_expression, เมตริกFilter, orderBys |
dateRanges[] |
ช่วงวันที่ที่จะดึงข้อมูลเหตุการณ์สำหรับรายงาน หากระบุช่วงวันที่หลายช่วง ระบบจะใช้ข้อมูลเหตุการณ์จากช่วงวันที่แต่ละช่วงในรายงาน มิติข้อมูลพิเศษที่มีชื่อฟิลด์ "dateRange" สามารถรวมอยู่ในชื่อช่องของ Pivot ได้ หากรวมไว้ รายงานจะเปรียบเทียบระหว่างช่วงวันที่ ต้องระบุ |
pivots[] |
อธิบายรูปแบบภาพของมิติข้อมูลของรายงานในคอลัมน์หรือแถว การรวมค่าfieldNames (ชื่อมิติข้อมูล) ใน Pivot ทั้งหมดจะต้องเป็นชุดย่อยของชื่อมิติข้อมูลที่กำหนดไว้ในมิติข้อมูล ไม่มี Pivot 2 ตัวที่ใช้มิติข้อมูลร่วมกันได้ มิติข้อมูลจะปรากฏต่อเมื่อปรากฏใน Pivot เท่านั้น |
dimensionFilter |
ข้อความตัวกรองของมิติข้อมูล คุณต้องขอให้ใช้มิติข้อมูลในตัวกรองนี้ ใช้เมตริกในตัวกรองนี้ไม่ได้ |
metricFilter |
ข้อความตัวกรองของเมตริก ใช้ในขั้นตอนการรวมโพสต์ ซึ่งคล้ายกับเงื่อนไขการมีของ SQL ต้องขอเมตริกเพื่อใช้ในตัวกรองนี้ ใช้มิติข้อมูลในตัวกรองนี้ไม่ได้ |
currencyCode |
รหัสสกุลเงินในรูปแบบ ISO4217 เช่น "AED", "USD", "JPY" หากช่องว่างเปล่า รายงานจะใช้สกุลเงินเริ่มต้นของพร็อพเพอร์ตี้ |
cohortSpec |
กลุ่มประชากรตามรุ่นที่เชื่อมโยงกับคำขอนี้ หากมีกลุ่มประชากรตามรุ่นในคำขอ "กลุ่มประชากรตามรุ่น" ต้องมีมิติข้อมูล |
keepEmptyRows |
หากเป็นเท็จหรือไม่ได้ระบุ ระบบจะไม่แสดงผลแต่ละแถวที่มีเมตริกทั้งหมดเท่ากับ 0 หากจริง ระบบจะแสดงผลแถวเหล่านี้หากไม่มีการนำออกแยกต่างหากโดยตัวกรอง ไม่ว่าการตั้งค่า เช่น หากพร็อพเพอร์ตี้ไม่เคยบันทึกเหตุการณ์ |
returnPropertyQuota |
สลับว่าจะส่งคืนสถานะปัจจุบันของโควต้าของพร็อพเพอร์ตี้ Analytics นี้หรือไม่ โควต้าจะแสดงใน PropertyQuota |
comparisons[] |
ไม่บังคับ การกำหนดค่าของการเปรียบเทียบที่ขอและแสดง คำขอต้องมีทั้งช่องการเปรียบเทียบและมิติข้อมูลการเปรียบเทียบจึงจะได้รับคอลัมน์การเปรียบเทียบในคำตอบ |
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ RunPivotReportResponse
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics