Use Case ขั้นสูง

เอกสารนี้จะอธิบายฟีเจอร์ขั้นสูงของ Google Analytics Reporting API v4 สำหรับข้อมูลอ้างอิง API โดยละเอียด โปรดดูคู่มืออ้างอิง

เกริ่นนำ

หลังจากสร้างรายงานอย่างง่ายแล้ว ให้ใช้ฟีเจอร์เหล่านี้เพื่อสร้างรายงานขั้นสูง

บทความที่เกี่ยวข้อง

Google Analytics Reporting API v4 ช่วยให้คุณสร้างตาราง Pivot ได้ หากต้องการสร้างคำขอด้วยตาราง Pivot ให้กำหนดช่อง Pivot ใน ReportRequest ออบเจ็กต์ Pivot มีชุดมิติข้อมูลและเมตริกของตนเอง โดยมี startGroup และ maxGroupCount ที่ไม่บังคับเพื่อระบุจำนวนมิติข้อมูลที่จะรวมไว้ในตาราง Pivot

ส่งคำขอ

เซสชันคำขอการเรียก API ต่อไปนี้ตามประเทศและ Pivot ผลลัพธ์ในเบราว์เซอร์:

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
  "reportRequests":
  [
    {
      "viewId": "XXXX",
      "dateRanges":
      [
        {
          "startDate": "2014-11-01",
          "endDate": "2014-11-30"
        }
      ],
      "metrics":
      [
        {
          "expression": "ga:sessions"
        }
      ],
      "dimensions":
      [
        {
          "name": "ga:country"
        }
      ],
      "pivots":
      [
        {
          "dimensions":
          [
            {
              "name": "ga:browser"
            }
          ],
          "maxGroupCount": 3,
          "startGroup": 3,
          "metrics":
          [
            {
              "expression": "ga:sessions"
            }
          ]
        }
      ]
    }
  ]
}

ส่วนหัวของคอลัมน์การตอบกลับ

ในออบเจ็กต์ report ที่แสดงผลสำหรับคำขอ Pivot metricHeader จะมีรายการออบเจ็กต์ pivotHeaders ซึ่งมีช่อง pivotHeaderEntries กำหนดลำดับของมิติข้อมูล Pivot และค่าเมตริกที่สอดคล้องกัน เช่น

"columnHeader": {
    "dimensions": [
        "ga:country"
    ],
    "metricHeader": {
        "metricHeaderEntries": [
            {
                "name": "ga:sessions",
                "type": "INTEGER"
            }
        ],
        "pivotHeaders": [
            {
                "pivotHeaderEntries": [
                    {
                        "dimensionNames": [
                            "ga:browser"
                        ],
                        "dimensionValues": [
                            "Internet Explorer"
                        ],
                        "metric": {
                            "name": "ga:sessions",
                            "type": "INTEGER"
                        }
                    },
                    {
                        "dimensionNames": [
                            "ga:browser"
                        ],
                        "dimensionValues": [
                            "Firefox"
                        ],
                        "metric": {
                            "name": "ga:sessions",
                            "type": "INTEGER"
                        }
                    },
                    {
                        "dimensionNames": [
                            "ga:browser"
                        ],
                        "dimensionValues": [
                            "Android Browser"
                        ],
                        "metric": {
                            "name": "ga:sessions",
                            "type": "INTEGER"
                        }
                    }
                ],
                "totalPivotGroupsCount": 7
            }
        ]
    }
},

แถวคำตอบ

แต่ละแถวของออบเจ็กต์ reportData จะกำหนดอาร์เรย์ของออบเจ็กต์ dateRangeValue โดยแต่ละแถวจะมีชุดออบเจ็กต์ pivotValue ลำดับของค่าจะสอดคล้องกับลำดับของเมตริกที่ระบุไว้ในส่วนหัว Pivot ในส่วนหัวของคอลัมน์คำตอบ

"rows": [
    ...
    {
        "dimensions": [
            "United States"
        ],
        "metrics": [
            {
                "pivotValues": [
                    {
                        "values": [
                            "21",
                            "18",
                            "1"
                        ]
                    }
                ],
                "values": [
                    "192"
                ]
            }
        ]
    }
],

โปรดทราบว่าค่า Pivot มีค่าเพียง 3 ค่าในรายงานเนื่องจากในคำขอเดิม maxGroupCount คือ 3 อาจมีได้ถึง 7 ค่าเนื่องจาก "totalPivotGroupsCount": 7

ตัวอย่างแถวของตาราง Pivot

ในคำตอบตัวอย่างข้างต้น แถวที่เชื่อมโยงกับประเทศสหรัฐอเมริกา จะแสดงในตาราง Pivot ต่อไปนี้

ประเทศ เซสชันทั้งหมด
รายการ		 เซสชัน
ของ Internet Explorer		 FireFox
เซสชัน		 เซสชัน
ของเบราว์เซอร์ Android
อินเดีย 12 3 2 4
สหรัฐอเมริกา 283 21 18 1
สหราชอาณาจักร 35 12 2 0

กลุ่มประชากรตามรุ่น

กลุ่มประชากรตามรุ่นคือกลุ่มผู้ใช้ที่มีลักษณะอย่างหนึ่งเหมือนกัน เช่น ผู้ใช้ทั้งหมดที่คุณได้มาในวันเดียวกันจะถือว่าเป็นกลุ่มประชากรตามรุ่นกลุ่มเดียวกัน รายงานการวิเคราะห์ตามการได้มาจะช่วยให้คุณสามารถแบ่งแยกและวิเคราะห์พฤติกรรมกลุ่มประชากรตามรุ่นได้ ดูรายการมิติข้อมูลและเมตริกเฉพาะของกลุ่มประชากรตามรุ่นได้ที่มิติข้อมูลและเมตริกกลุ่มประชากรตามรุ่นและมูลค่าตลอดอายุการใช้งาน (LTV)

หากต้องการระบุคำขอกลุ่มประชากรตามรุ่น คุณต้องกำหนดออบเจ็กต์กลุ่มประชากรตามรุ่นด้วย name, type และ dateRange ดังนี้

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
  "reportRequests":
  [
    {
      "viewId": "XXXX",
      "dimensions":
      [
        {
          "name": "ga:cohort"
        },
        {
          "name": "ga:cohortNthDay"
        }
      ],
      "metrics":
      [
        {
          "expression": "ga:cohortActiveUsers"
        },
        {
          "expression": "ga:cohortTotalUsers"
        }
      ],
      "cohortGroup":
      {
        "cohorts":
        [
          {
            "name": "cohort 1",
            "type": "FIRST_VISIT_DATE",
            "dateRange":
            {
              "startDate": "2015-08-01",
              "endDate": "2015-08-01"
            }
          },
          {
            "name": "cohort 2",
            "type": "FIRST_VISIT_DATE",
            "dateRange":
            {
              "startDate": "2015-07-01",
              "endDate": "2015-07-01"
            }
          }
        ]
      }
    }
  ]
}

ดูตัวอย่างด้านบนในโปรแกรมสำรวจ API

ข้อจำกัดของกลุ่มประชากรตามรุ่น

คำขอของกลุ่มประชากรตามรุ่นที่ถูกต้องต้องเป็นไปตามข้อจำกัดต่อไปนี้

  • มิติข้อมูล ga:cohort จะรวมอยู่ก็ต่อเมื่อคำขอมีการกำหนดกลุ่มประชากรตามรุ่นอย่างน้อย 1 รายการเท่านั้น
  • ชื่อกลุ่มประชากรตามรุ่นต้องไม่ซ้ำกัน
  • จำนวนกลุ่มประชากรตามรุ่นในคำขอสูงสุดคือ 12 กลุ่ม
  • หากกำหนด ga:cohortNthWeek วันที่เริ่มต้นต้องเป็นวันอาทิตย์และวันที่สิ้นสุดต้องเป็นวันเสาร์ หากกำหนด ga:cohortNthMonth วันที่เริ่มต้นต้องเป็นวันแรกของเดือนและวันที่สิ้นสุดต้องเป็นวันสุดท้ายของเดือน หากกำหนด ga:cohortNthDay ช่วงวันที่จะต้องเป็น 1 วันพอดี
  • ไม่อนุญาตคำขอของกลุ่มประชากรตามรุ่นที่มีวันที่ปัจจุบัน
  • คำขอของกลุ่มประชากรตามรุ่นและที่ไม่ใช่กลุ่มประชากรตามรุ่นไม่ควรอยู่ในคำขอของ batchGet เดียวกัน
  • ช่วงวันที่ในกลุ่มประชากรตามรุ่นต้องอยู่หลังวันที่ 1 กุมภาพันธ์ 2015

มูลค่าตลอดอายุการใช้งาน (LTV)

รายงานมูลค่าตลอดอายุการใช้งานจะแสดงมูลค่าของผู้ใช้ (รายได้) และการมีส่วนร่วม (การดูแอป เป้าหมายที่สำเร็จ เซสชัน และระยะเวลาเซสชัน) เพิ่มขึ้นในช่วง 90 วันหลังจากที่ได้ผู้ใช้ ดูมิติข้อมูลและเมตริกที่เฉพาะเจาะจงของ LTV

คำขอ LTV จะได้รับการกำหนดเป็นกลุ่มประชากรตามรุ่นที่ตั้งค่าช่อง lifetimeValue เป็น true เช่น

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
  "reportRequests":
  [
    {
      "viewId": "XXXX",
      "dimensions":
      [
        {
          "name": "ga:cohort"
        },
        {
          "name": "ga:cohortNthWeek"
        }
      ],
      "metrics":
      [
        {
          "expression": "ga:cohortTotalUsersWithLifetimeCriteria"
        },
        {
          "expression": "ga:cohortRevenuePerUser"
        }
      ],
      "cohortGroup":
      {
        "cohorts":
        [
          {
            "name": "cohort 1",
            "type": "FIRST_VISIT_DATE",
            "dateRange":
            {
              "startDate": "2015-08-01",
              "endDate": "2015-09-01"
            }
          },
          {
            "name": "cohort 2",
            "type": "FIRST_VISIT_DATE",
            "dateRange":
            {
              "startDate": "2015-07-01",
              "endDate": "2015-08-01"
            }
          }
        ],
        "lifetimeValue": true
      }
    }
  ]
}

ดูตัวอย่างข้างต้นในโปรแกรมสำรวจ API

มิติข้อมูลและเมตริกกลุ่มประชากรตามรุ่นและมูลค่าตลอดอายุการใช้งาน (LTV)

ขนาด

ชื่อมิติข้อมูล คำจำกัดความ
ga:cohort ชื่อกลุ่มประชากรตามรุ่นของผู้ใช้ ผู้ใช้จะอยู่ในกลุ่มประชากรตามรุ่นหลายกลุ่ม ทั้งนี้ขึ้นอยู่กับวิธีกำหนดกลุ่มประชากรตามรุ่น ซึ่งคล้ายกับวิธีที่ผู้ใช้จะอยู่ในหลายกลุ่ม
ga:cohortNthDay ออฟเซ็ตวันที่แบบ 0 วันซึ่งสัมพันธ์กับวันที่กำหนดกลุ่มประชากรตามรุ่น ตัวอย่างเช่น หากกลุ่มประชากรตามรุ่นกำหนดโดยวันที่เข้าชมครั้งแรกเป็น 2015-09-01 สำหรับวันที่ 2015-09-04 ga:cohortNthDay จะเป็น 3
ga:cohortNthMonth การชดเชยเดือนแบบ 0 โดยอิงจากวันที่สำหรับการกำหนดกลุ่มประชากรตามรุ่น
ga:cohortNthWeek การชดเชยสัปดาห์แบบ 0 โดยอิงจากวันที่สำหรับการกำหนดกลุ่มประชากรตามรุ่น
ga:acquisitionTrafficChannel ช่องทางการเข้าชมที่ได้ผู้ใช้ใหม่ ซึ่งดึงมาจากเซสชันแรกของผู้ใช้ แชแนลการเข้าชมจะคำนวณตามกฎการจัด Channel Group เริ่มต้น (ที่ระดับข้อมูลพร็อพเพอร์ตี้ หากมี) ณ เวลาที่ได้ผู้ใช้ใหม่
ga:acquisitionSource แหล่งที่มาที่ได้ผู้ใช้มา มาจากเซสชันแรกของผู้ใช้
ga:acquisitionMedium สื่อที่ได้รับผู้ใช้มา มาจากเซสชันแรกของผู้ใช้
ga:acquisitionSourceMedium ค่ารวมของ ga:userAcquisitionSource และ ga:acquisitionMedium
ga:acquisitionCampaign แคมเปญที่ได้ผู้ใช้ใหม่ มาจากเซสชันแรกของผู้ใช้

เมตริก

ชื่อเมตริก คำจำกัดความ
ga:cohortActiveUsers เมตริกนี้มีความเกี่ยวข้องในบริบทของมิติข้อมูลออฟเซ็ตแบบ 0 (ga:cohortNthDay, ga:cohortNthWeek หรือ ga:cohortNthMonth) ซึ่งจะระบุจํานวนผู้ใช้ในกลุ่มประชากรตามรุ่นที่มีการใช้งานในกรอบเวลาซึ่งสอดคล้องกับวันที่/สัปดาห์/เดือนของกลุ่มประชากรตามรุ่น เช่น สำหรับ ga:cohortNthWeek = 1 จำนวนผู้ใช้ (ในกลุ่มประชากรตามรุ่น) ที่มีการใช้งานในสัปดาห์ที่ 2 หากคำขอไม่มี ga:cohortNthDay, ga:cohortNthWeek หรือ ga:cohortNthMonth เมตริกนี้จะมีค่าเท่ากับ ga:cohortTotalUsers
ga:cohortTotalUsers จำนวนผู้ใช้ในกลุ่มประชากรตามรุ่น หรือที่เรียกว่าขนาดกลุ่มประชากรตามรุ่น
ga:cohortAppviewsPerUser การดูแอปต่อผู้ใช้สำหรับกลุ่มประชากรตามรุ่น
ga:cohortGoalCompletionsPerUser เป้าหมายที่สำเร็จต่อผู้ใช้สำหรับกลุ่มประชากรตามรุ่น
ga:cohortPageviewsPerUser การดูหน้าเว็บต่อผู้ใช้สำหรับกลุ่มประชากรตามรุ่น
ga:cohortRetentionRate อัตราการคงผู้ใช้ไว้ของกลุ่มประชากรตามรุ่น
ga:cohortRevenuePerUser รายได้ต่อผู้ใช้สำหรับกลุ่มประชากรตามรุ่น
ga:cohortVisitDurationPerUser ระยะเวลาเซสชันต่อผู้ใช้สำหรับกลุ่มประชากรตามรุ่น
ga:cohortSessionsPerUser เซสชันต่อผู้ใช้สำหรับกลุ่มประชากรตามรุ่น

เมตริกมูลค่าตลอดอายุการใช้งาน (LTV)

ชื่อเมตริก คำจำกัดความ
ga:cohortTotalUsersWithLifetimeCriteria ซึ่งมีความเกี่ยวข้องในบริบทของคำขอซึ่งมีมิติข้อมูล ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium หรือ ga:acquisitionCampaign ซึ่งแสดงจำนวนผู้ใช้ในกลุ่มประชากรตามรุ่นที่ได้มาผ่านช่องทาง แหล่งที่มา สื่อ หรือแคมเปญปัจจุบัน เช่น สําหรับ ga:acquisitionTrafficChannel=Direct จะแสดงจํานวนผู้ใช้ในกลุ่มประชากรตามรุ่นซึ่งได้มาโดยตรง หากไม่มีมิติข้อมูลที่กล่าวถึง ค่าจะเท่ากับ ga:cohortTotalUsers (ข้อมูลพร็อพเพอร์ตี้แอปเท่านั้น)
ga:cohortAppviewsPerUserWithLifetimeCriteria การดูแอปต่อผู้ใช้ในมิติข้อมูลการได้ผู้ใช้ใหม่ของกลุ่มประชากรตามรุ่น (ข้อมูลพร็อพเพอร์ตี้แอปเท่านั้น)
ga:cohortGoalCompletionsPerUserWithLifetimeCriteria เป้าหมายที่สำเร็จต่อผู้ใช้สำหรับมิติข้อมูลการได้ผู้ใช้ใหม่ของกลุ่มประชากรตามรุ่น (การดูแอปเท่านั้น)
ga:cohortPageviewsPerUserWithLifetimeCriteria การดูหน้าเว็บต่อผู้ใช้ในมิติข้อมูลการได้ผู้ใช้ใหม่ของกลุ่มประชากรตามรุ่น (การดูแอปเท่านั้น)
ga:cohortRevenuePerUserWithLifetimeCriteria รายได้ต่อผู้ใช้ในมิติข้อมูลการได้ผู้ใช้ใหม่ของกลุ่มประชากรตามรุ่น (ข้อมูลพร็อพเพอร์ตี้แอปเท่านั้น)
ga:cohortSessionsPerUserWithLifetimeCriteria ระยะเวลาเซสชันต่อผู้ใช้สำหรับมิติข้อมูลการได้ผู้ใช้ใหม่ของกลุ่มประชากรตามรุ่น (การดูแอปเท่านั้น)