Method: properties.runFunnelReport

แสดงรายงาน Funnel ที่กำหนดเองของข้อมูลเหตุการณ์ Google Analytics ข้อมูลที่แสดงผลจาก API เป็นตารางที่มีคอลัมน์สำหรับมิติข้อมูลและเมตริกที่ขอ

การสำรวจกระบวนการจะช่วยให้คุณได้เห็นภาพขั้นตอนต่างๆ ที่ผู้ใช้ใช้ในการดำเนินงาน และดูว่าจะประสบความสำเร็จหรือล้มเหลวในแต่ละขั้นตอนได้อย่างรวดเร็ว เช่น ผู้มีโอกาสเป็นลูกค้าจะกลายเป็นผู้เลือกซื้อและกลายเป็นผู้ซื้อได้อย่างไร ผู้ซื้อจะกลายเป็นผู้ซื้อซ้ำได้อย่างไร คุณสามารถใช้ข้อมูลนี้เพื่อปรับปรุงเส้นทางของลูกค้าที่มีการออกกลางคันหรือมีประสิทธิภาพไม่ดีได้ ดูข้อมูลเพิ่มเติมได้ที่การสำรวจ Funnel ของ GA4

วิธีการนี้จะช่วยให้มีความเสถียรในเวอร์ชันอัลฟ่า โดยมีจุดประสงค์เพื่อรวบรวมความคิดเห็นเกี่ยวกับไวยากรณ์และความสามารถต่างๆ ก่อนเข้าสู่เวอร์ชันเบต้า หากต้องการแสดงความคิดเห็นเกี่ยวกับ API นี้ โปรดกรอกความคิดเห็นในการรายงาน Funnel ของ Google Analytics Data API

คำขอ HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport

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

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

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

string

ไม่บังคับ ตัวระบุพร็อพเพอร์ตี้ GA4 ของ Google Analytics ที่มีการติดตามเหตุการณ์ ระบุไว้ในพาธ URL ไม่ใช่ส่วนเนื้อหา ดูข้อมูลเพิ่มเติมได้ในวิธีค้นหารหัสพร็อพเพอร์ตี้ ภายในคำขอแบบกลุ่ม พร็อพเพอร์ตี้นี้ไม่ควรระบุหรือสอดคล้องกับพร็อพเพอร์ตี้ระดับกลุ่ม

ตัวอย่าง: พร็อพเพอร์ตี้/1234

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

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

การแสดง JSON
{
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "funnel": {
    object (Funnel)
  },
  "funnelBreakdown": {
    object (FunnelBreakdown)
  },
  "funnelNextAction": {
    object (FunnelNextAction)
  },
  "funnelVisualizationType": enum (FunnelVisualizationType),
  "segments": [
    {
      object (Segment)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "returnPropertyQuota": boolean
}
ช่อง
dateRanges[]

object (DateRange)

ไม่บังคับ ช่วงวันที่ของข้อมูลที่จะอ่าน หากมีการขอช่วงวันที่หลายช่วง แถวการตอบกลับแต่ละแถวจะมีดัชนีช่วงวันที่ที่ยึดตาม 0 หากช่วงวันที่ 2 ช่วงทับซ้อนกัน ข้อมูลกิจกรรมสำหรับวันที่ซ้อนทับกันจะรวมอยู่ในแถวการตอบกลับสำหรับช่วงวันที่ทั้งสอง

funnel

object (Funnel)

ไม่บังคับ การกำหนดค่าช่องทางของคำขอนี้ ต้องระบุการกำหนดค่า Funnel นี้

funnelBreakdown

object (FunnelBreakdown)

ไม่บังคับ หากระบุไว้ รายละเอียดนี้จะเพิ่มมิติข้อมูลลงในการตอบกลับรายงานย่อยของตาราง Funnel มิติข้อมูลรายละเอียดนี้จะขยายแต่ละขั้นตอนของ Funnel เป็นค่าที่ไม่ซ้ำกันของมิติข้อมูลรายละเอียด เช่น รายละเอียดตามมิติข้อมูล deviceCategory จะสร้างแถวสำหรับ mobile, tablet, desktop และผลรวม

funnelNextAction

object (FunnelNextAction)

ไม่บังคับ การดำเนินการถัดไปจะเพิ่มมิติข้อมูลลงในการตอบกลับรายงานย่อยของการแสดงภาพ Funnel หากระบุ มิติข้อมูลการดําเนินการถัดไปนี้จะขยายแต่ละขั้นตอนของ Funnel เป็นค่าที่ไม่ซ้ำกันของการดําเนินการถัดไป เช่น การดําเนินการถัดไปของมิติข้อมูล eventName จะสร้างแถวสําหรับหลายเหตุการณ์ (เช่น session_start และ click) และผลรวม

การดำเนินการถัดไปรองรับเฉพาะ eventName และมิติข้อมูลหน้าเว็บ / หน้าจอส่วนใหญ่ เช่น pageTitle และ pagePath

funnelVisualizationType

enum (FunnelVisualizationType)

ไม่บังคับ ประเภทภาพแสดง Funnel จะควบคุมมิติข้อมูลที่แสดงในการตอบกลับรายงานย่อยของการแสดงภาพ Funnel หากไม่ได้ระบุ ระบบจะใช้ STANDARD_FUNNEL

segments[]

object (Segment)

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

แต่ละกลุ่มที่ระบุในคำขอนี้จะสร้างแถวแยกต่างหากในคำตอบ ในคำตอบ แต่ละส่วนที่ระบุโดยชื่อ

คุณจะระบุพารามิเตอร์กลุ่มหรือไม่ก็ได้ คำขอถูกจำกัดไว้ที่ 4 กลุ่ม

limit

string (int64 format)

ไม่บังคับ จำนวนแถวที่จะแสดงผล หากไม่ระบุ ระบบจะแสดงผล 10,000 แถว API จะส่งกลับจำนวนแถวสูงสุด 250,000 แถวต่อคำขอ ไม่ว่าคุณจะขอกี่แถวก็ตาม limit ต้องเป็นค่าบวก

นอกจากนี้ API อาจแสดงผลแถวน้อยกว่า limit ที่ขอด้วย หากมีค่ามิติข้อมูลไม่มากเท่ากับ limit

dimensionFilter

object (FilterExpression)

ไม่บังคับ ตัวกรองมิติข้อมูลช่วยให้คุณขอเฉพาะค่ามิติข้อมูลที่ต้องการในรายงานได้ ดูตัวอย่างได้ในการสร้างรายงาน: ตัวกรองมิติข้อมูล ใช้เมตริกในตัวกรองนี้ไม่ได้

returnPropertyQuota

boolean

ไม่บังคับ สลับว่าจะส่งคืนสถานะปัจจุบันของโควต้าของพร็อพเพอร์ตี้ Analytics นี้หรือไม่ โควต้าจะแสดงใน PropertyQuota

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

การตอบกลับรายงาน Funnel ประกอบด้วยรายงานย่อย 2 ฉบับ รายงานย่อย 2 ฉบับเป็นการผสมผสานมิติข้อมูลและเมตริกที่แตกต่างกัน

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

การแสดง JSON
{
  "funnelTable": {
    object (FunnelSubReport)
  },
  "funnelVisualization": {
    object (FunnelSubReport)
  },
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
ช่อง
funnelTable

object (FunnelSubReport)

ตาราง Funnel คือรายงานที่มีขั้นตอน กลุ่ม มิติข้อมูลรายละเอียด ผู้ใช้ที่ใช้งานอยู่ อัตราความสำเร็จ การหยุดกลางคัน และอัตราการหยุดกลางคันของ Funnel

มิติข้อมูลกลุ่มจะแสดงในคำตอบนี้ก็ต่อเมื่อมีการขอกลุ่มเท่านั้น มิติข้อมูลรายละเอียดจะแสดงในคำตอบนี้ก็ต่อเมื่อมีการขอเท่านั้น

funnelVisualization

object (FunnelSubReport)

ภาพแสดง Funnel คือรายงานที่มีขั้นตอน กลุ่ม วันที่ มิติข้อมูลการดําเนินการถัดไป และผู้ใช้ที่ใช้งานอยู่ของ Funnel

มิติข้อมูลกลุ่มจะแสดงในคำตอบนี้ก็ต่อเมื่อมีการขอกลุ่มเท่านั้น มิติข้อมูลวันที่จะแสดงในคําตอบนี้หากมีการขอผ่านประเภท Funnel TRENDED_FUNNEL เท่านั้น มิติข้อมูลการดำเนินการถัดไปจะแสดงในคำตอบหากมีการขอเท่านั้น

propertyQuota

object (PropertyQuota)

สถานะโควต้าของพร็อพเพอร์ตี้ Analytics นี้รวมถึงคำขอนี้

kind

string

ระบุประเภทของแหล่งข้อมูลสำหรับข้อความนี้ kind นี้เป็นสตริง "analyticsData#runFunnelReport" แบบคงที่เสมอ มีประโยชน์ในการแยกความแตกต่างระหว่างประเภทการตอบกลับใน JSON

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

Funnel

กำหนดค่า Funnel ในคำขอรายงาน Funnel Funnel จะรายงานผู้ใช้ขณะที่ผ่านลำดับขั้นตอน

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

การแสดง JSON
{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}
ช่อง
isOpenFunnel

boolean

ใน Funnel แบบเปิด ผู้ใช้จะเข้าสู่ Funnel ในขั้นตอนใดก็ได้ และใน Funnel แบบปิด ผู้ใช้ต้องเข้าสู่ Funnel ในขั้นตอนแรก ไม่บังคับ หากไม่ระบุ ระบบจะใช้ Funnel แบบปิด

steps[]

object (FunnelStep)

ขั้นตอนตามลำดับของ Funnel นี้

FunnelStep

ขั้นตอนจะกําหนดเส้นทางของผู้ใช้ที่คุณต้องการวัด ขั้นตอนมีเงื่อนไขอย่างน้อย 1 รายการที่ผู้ใช้ต้องทำตามเพื่อให้อยู่ในขั้นตอนของเส้นทางใน Funnel นั้น

การแสดง JSON
{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}
ช่อง
name

string

ชื่อที่ไม่ซ้ำกันของขั้นตอนนี้ หากไม่ระบุ ระบบจะตั้งชื่อขั้นตอนโดยใช้ชื่อที่จัดทำดัชนีตาม 1 (เช่น "0 ", "1. " เป็นต้น) ชื่อนี้กำหนดค่าสตริงที่มิติข้อมูล funnelStepName แสดงผล ตัวอย่างเช่น การระบุ name = Purchase ในขั้นตอน Funnel ที่ 3 ของคำขอจะสร้าง 3. Purchase ในการตอบกลับรายงาน Funnel

isDirectlyFollowedBy

boolean

หากจริง ขั้นตอนนี้ต้องทําตามขั้นตอนก่อนหน้าโดยตรง หากเป็นเท็จ อาจมีเหตุการณ์ระหว่างขั้นตอนก่อนหน้ากับขั้นตอนนี้ หากไม่ระบุ ระบบจะถือว่า isDirectlyFollowedBy เป็น "เท็จ"

filterExpression

object (FunnelFilterExpression)

เงื่อนไขที่ผู้ใช้ต้องมีจึงจะรวมไว้ในขั้นตอนของเส้นทางใน Funnel นี้

withinDurationFromPriorStep

string (Duration format)

หากระบุไว้ จะต้องทำขั้นตอนนี้ให้เสร็จสมบูรณ์ภายในระยะเวลานี้หลังจากขั้นตอนก่อนหน้าเสร็จสมบูรณ์ withinDurationFromPriorStep รวมปลายทางที่รายละเอียดระดับไมโครวินาที เช่น ช่วงเวลา 5 วินาทีอาจเสร็จสมบูรณ์ที่ 4.9 หรือ 5.0 วินาที แต่ไม่ใช่ 5 วินาทีและ 1 ไมโครวินาที

คุณจะระบุ withinDurationFromPriorStep หรือไม่ก็ได้ และหากไม่ระบุ ก็อาจมีช่วงคั่นแต่ละขั้นในช่วงเวลาใดก็ได้

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" ตัวอย่างเช่น "3.5s"

FunnelFilterExpression

แสดงชุดค่าผสมของตัวกรอง Funnel

การแสดง JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of list of possible types for union field expr.
}
ช่อง
ช่องการรวม expr ระบุตัวกรอง 1 ประเภทสำหรับ FunnelFilterExpression expr ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
andGroup

object (FunnelFilterExpressionList)

FunnelFilterExpression ใน andGroup มีความสัมพันธ์แบบ AND

orGroup

object (FunnelFilterExpressionList)

FunnelFilterExpression ใน orGroup มีความสัมพันธ์แบบ OR

notExpression

object (FunnelFilterExpression)

FunnelFilterExpression ไม่ใช่ notExpression

funnelFieldFilter

object (FunnelFieldFilter)

ตัวกรอง Funnel สำหรับมิติข้อมูลหรือเมตริก

funnelEventFilter

object (FunnelEventFilter)

สร้างตัวกรองที่ตรงกับเหตุการณ์ของชื่อเหตุการณ์เดียว หากระบุนิพจน์ตัวกรองพารามิเตอร์ จะมีเพียงชุดย่อยของเหตุการณ์ที่ตรงกับทั้งชื่อเหตุการณ์เดียวและนิพจน์ตัวกรองพารามิเตอร์ที่ตรงกับตัวกรองเหตุการณ์นี้

FunnelFilterExpressionList

รายการนิพจน์ตัวกรอง Funnel

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

object (FunnelFilterExpression)

รายการนิพจน์ตัวกรอง Funnel

FunnelFieldFilter

นิพจน์เพื่อกรองค่ามิติข้อมูลหรือเมตริก

การแสดง JSON
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
ช่อง
fieldName

string

ชื่อมิติข้อมูลหรือชื่อเมตริก

ช่องการรวม one_filter ระบุตัวกรอง 1 ประเภท one_filter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
stringFilter

object (StringFilter)

ตัวกรองที่เกี่ยวข้องกับสตริง

inListFilter

object (InListFilter)

ตัวกรองสำหรับค่าในรายการ

numericFilter

object (NumericFilter)

ตัวกรองสำหรับค่าตัวเลขหรือวันที่

betweenFilter

object (BetweenFilter)

ตัวกรองสำหรับระหว่าง 2 ค่า

FunnelEventFilter

สร้างตัวกรองที่ตรงกับเหตุการณ์ของชื่อเหตุการณ์เดียว หากระบุนิพจน์ตัวกรองพารามิเตอร์ จะมีเพียงชุดย่อยของเหตุการณ์ที่ตรงกับทั้งชื่อเหตุการณ์เดียวและนิพจน์ตัวกรองพารามิเตอร์ที่ตรงกับตัวกรองเหตุการณ์นี้

การแสดง JSON
{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}
ช่อง
eventName

string

ตัวกรองนี้ตรงกับเหตุการณ์ของชื่อเหตุการณ์เดียวนี้ ต้องระบุชื่อเหตุการณ์

funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

หากระบุ ตัวกรองนี้จะจับคู่เหตุการณ์ที่ตรงกับทั้งชื่อเหตุการณ์เดียวและนิพจน์ตัวกรองพารามิเตอร์

ภายในนิพจน์ตัวกรองพารามิเตอร์ จะมีเพียงตัวกรองพารามิเตอร์เท่านั้นที่ใช้งานได้

FunnelParameterFilterExpression

แสดงชุดค่าผสมของตัวกรอง Funnel ในพารามิเตอร์

การแสดง JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
ช่อง
ช่องการรวม expr ระบุตัวกรอง 1 ประเภทสำหรับ FunnelParameterFilterExpression expr ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
andGroup

object (FunnelParameterFilterExpressionList)

FunnelParametersFilterExpression ใน andGroup มีความสัมพันธ์แบบ AND

orGroup

object (FunnelParameterFilterExpressionList)

FunnelParametersFilterExpression ใน orGroup มีความสัมพันธ์ OR

notExpression

object (FunnelParameterFilterExpression)

FunnelParametersFilterExpression ไม่ใช่ notExpression

funnelParameterFilter

object (FunnelParameterFilter)

ตัวกรองพารามิเตอร์ Funnel พื้นฐาน

FunnelParameterFilterExpressionList

รายการนิพจน์ตัวกรองพารามิเตอร์ Funnel

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

object (FunnelParameterFilterExpression)

รายการนิพจน์ตัวกรองพารามิเตอร์ Funnel

FunnelParameterFilter

นิพจน์ที่ใช้กรองค่าพารามิเตอร์ใน Funnel

การแสดง JSON
{

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
ช่อง
ช่องการรวม one_parameter ช่องที่ถูกกรองออก one_parameter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
eventParameterName

string

ระบบจะประเมินตัวกรองนี้ในพารามิเตอร์เหตุการณ์ที่ระบุ ระบบจะบันทึกพารามิเตอร์เหตุการณ์เป็นพารามิเตอร์ของเหตุการณ์ พารามิเตอร์เหตุการณ์มีช่อง เช่น "firebase_screen" และ "currency"

ใช้พารามิเตอร์เหตุการณ์ได้เฉพาะในกลุ่มและ Funnel และใช้ได้ในตัวกรองสืบทอดจาก EventFilter เท่านั้น ในตัวกรองสืบทอดจาก EventFilter ควรใช้เหตุการณ์หรือพารามิเตอร์รายการ

itemParameterName

string

ระบบจะประเมินตัวกรองนี้ตามพารามิเตอร์รายการที่ระบุ ระบบจะบันทึกพารามิเตอร์รายการเป็นพารามิเตอร์ในอาร์เรย์สินค้า พารามิเตอร์รายการมีช่องต่างๆ เช่น "item_name" และ "item_category"

ใช้พารามิเตอร์รายการได้ในกลุ่มและ Funnel และใช้ได้ในตัวกรองสืบทอดจาก EventFilter เท่านั้น ในตัวกรองสืบทอดจาก EventFilter ควรใช้เหตุการณ์หรือพารามิเตอร์รายการ

พารามิเตอร์สินค้าใช้ได้เฉพาะในเหตุการณ์อีคอมเมิร์ซ ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์อีคอมเมิร์ซได้จากคู่มือวัดอีคอมเมิร์ซ

ช่องการรวม one_filter ระบุตัวกรอง 1 ประเภท one_filter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
stringFilter

object (StringFilter)

ตัวกรองที่เกี่ยวข้องกับสตริง

inListFilter

object (InListFilter)

ตัวกรองสำหรับค่าในรายการ

numericFilter

object (NumericFilter)

ตัวกรองสำหรับค่าตัวเลขหรือวันที่

betweenFilter

object (BetweenFilter)

ตัวกรองสำหรับระหว่าง 2 ค่า

FunnelBreakdown

รายละเอียดจะเพิ่มมิติข้อมูลลงในคำตอบของรายงานย่อยของตาราง Funnel

การแสดง JSON
{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}
ช่อง
breakdownDimension

object (Dimension)

เพิ่มคอลัมน์มิติข้อมูลลงในการตอบกลับรายงานย่อยของตาราง Funnel มิติข้อมูลรายละเอียดจะแสดงรายละเอียดแต่ละขั้นตอนของ Funnel ต้องระบุ breakdownDimension ที่ถูกต้องหากระบุ funnelBreakdown แล้ว

limit

string (int64 format)

จำนวนสูงสุดของค่าที่ไม่ซ้ำกันของมิติข้อมูลรายละเอียดที่จะแสดงในคำตอบ ระบบจะใช้ limit เป็น 5 หากไม่ได้ระบุขีดจำกัด ขีดจำกัดต้องเกิน 0 และต้องไม่เกิน 15

FunnelNextAction

การกระทำถัดไปจะระบุค่าของมิติข้อมูลหลังจากที่ผู้ใช้ผ่านขั้นตอนหนึ่งแล้ว แต่ผู้ใช้รายเดียวกันจะดำเนินการในขั้นตอนถัดไป ตัวอย่างเช่น หาก nextActionDimension คือ eventName ดังนั้น nextActionDimension ในแถวขั้นตอนของ Funnel ที่ i จะแสดงเหตุการณ์แรกหลังจากเหตุการณ์ที่ทำให้ผู้ใช้เข้าสู่ขั้นตอนของ Funnel i แต่ก่อนที่ผู้ใช้จะถึงขั้นตอน Funnel i+1

การแสดง JSON
{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}
ช่อง
nextActionDimension

object (Dimension)

คอลัมน์มิติข้อมูลที่เพิ่มลงในการตอบกลับรายงานย่อยของการแสดงภาพ Funnel มิติข้อมูลการกระทำถัดไปจะแสดงค่ามิติข้อมูลถัดไปของมิติข้อมูลนี้หลังจากที่ผู้ใช้ได้มาถึงขั้นตอนที่ i ของ Funnel

ปัจจุบัน nextActionDimension รองรับเฉพาะ eventName และมิติข้อมูลหน้าเว็บ / หน้าจอส่วนใหญ่ เช่น pageTitle และ pagePath nextActionDimension เป็นนิพจน์มิติข้อมูลไม่ได้

limit

string (int64 format)

จำนวนสูงสุดของค่าที่ไม่ซ้ำกันของมิติข้อมูลรายละเอียดที่จะแสดงในคำตอบ ระบบจะใช้ limit เป็น 5 หากไม่ได้ระบุขีดจำกัด ขีดจำกัดต้องเกิน 0 และต้องไม่เกิน 5

FunnelVisualizationType

ควบคุมมิติข้อมูลที่แสดงในการตอบกลับรายงานย่อยของการแสดงภาพ Funnel

Enum
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED ไม่ได้ระบุประเภท
STANDARD_FUNNEL Funnel มาตรฐาน (ขั้นบันได) รายงานย่อยของการแสดงภาพ Funnel ในการตอบกลับจะไม่มีวันที่
TRENDED_FUNNEL Funnel แบบแนวโน้ม (แผนภูมิเส้น) รายงานย่อยของการแสดงภาพ Funnel ในการตอบกลับจะมีมิติข้อมูลวันที่

กลุ่ม

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

ดูข้อมูลเพิ่มเติมได้ที่ตัวสร้างกลุ่มของ GA4

การแสดง JSON
{
  "name": string,

  // Union field one_segment_scope can be only one of the following:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of list of possible types for union field one_segment_scope.
}
ช่อง
name

string

ชื่อของกลุ่มนี้ หากไม่ระบุ กลุ่มจะมีชื่อว่า "กลุ่ม" ชื่อนี้กำหนดค่าสตริงที่มิติข้อมูล segment แสดงผล มิติข้อมูล segment จะเพิ่มคํานําหน้าชื่อกลุ่มด้วยหมายเลขดัชนีที่อิงตาม 1 ของกลุ่มในคำขอ (เช่น "1. กลุ่ม", "2. Segment" เป็นต้น)

ช่องการรวม one_segment_scope มีการระบุกลุ่มใน 1 ขอบเขต one_segment_scope ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
userSegment

object (UserSegment)

กลุ่มผู้ใช้คือผู้ใช้ชุดย่อยที่มีส่วนร่วมกับเว็บไซต์หรือแอป

sessionSegment

object (SessionSegment)

กลุ่มเซสชันคือเซสชันชุดย่อยที่เกิดขึ้นในเว็บไซต์หรือแอปของคุณ

eventSegment

object (EventSegment)

กลุ่มเหตุการณ์คือชุดย่อยของเหตุการณ์ที่มีการทริกเกอร์ในเว็บไซต์หรือแอป

UserSegment

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

การแสดง JSON
{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}
ช่อง
userInclusionCriteria

object (UserSegmentCriteria)

กำหนดว่าผู้ใช้คนใดที่จะรวมไว้ในกลุ่มนี้ ไม่บังคับ

exclusion

object (UserSegmentExclusion)

กําหนดผู้ใช้ที่ได้รับการยกเว้นในกลุ่มนี้ ไม่บังคับ

UserSegmentCriteria

ผู้ใช้ตรงกับเกณฑ์หากเหตุการณ์ของผู้ใช้เป็นไปตามเงื่อนไขในเกณฑ์

การแสดง JSON
{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}
ช่อง
andConditionGroups[]

object (UserSegmentConditionGroup)

ผู้ใช้จะตรงกับเกณฑ์นี้หากผู้ใช้ตรงกับ andConditionGroups เหล่านี้และ andSequenceGroups แต่ละรายการ andConditionGroups อาจว่างเปล่าหากระบุ andSequenceGroups

andSequenceGroups[]

object (UserSegmentSequenceGroup)

ผู้ใช้จะตรงกับเกณฑ์นี้หากผู้ใช้ตรงกับ andSequenceGroups เหล่านี้และ andConditionGroups แต่ละรายการ andSequenceGroups อาจว่างเปล่าหากระบุ andConditionGroups

UserSegmentConditionGroup

เงื่อนไขจะบอกให้ Analytics ทราบถึงข้อมูลที่จะรวมในกลุ่มหรือยกเว้นออกจากกลุ่ม

การแสดง JSON
{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
ช่อง
conditionScoping

enum (UserCriteriaScoping)

การรวมหรือยกเว้นข้อมูลจากกลุ่มโดยพิจารณาว่าตรงกับกลุ่มเงื่อนไขหรือไม่ ขอบเขตนี้จะกำหนดจำนวนเหตุการณ์ที่ segmentFilterExpression ได้รับการประเมินก่อนที่จะพิจารณาว่ากลุ่มเงื่อนไขตรงกันหรือไม่ ตัวอย่างเช่น หาก conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION นิพจน์จะได้รับการประเมินในเหตุการณ์ทั้งหมดในเซสชัน จากนั้นจะพิจารณาว่ากลุ่มเงื่อนไขตรงกันหรือไม่สำหรับผู้ใช้รายนี้ ตัวอย่างเช่น หาก conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT นิพจน์จะได้รับการประเมินในเหตุการณ์เดียว จากนั้นจะพิจารณาว่ากลุ่มเงื่อนไขตรงกันหรือไม่สำหรับผู้ใช้รายนี้

ไม่บังคับ หากไม่ได้ระบุ ระบบจะใช้ conditionScoping = ACROSS_ALL_SESSIONS

segmentFilterExpression

object (SegmentFilterExpression)

การรวมหรือยกเว้นข้อมูลจากกลุ่มโดยพิจารณาจากหากตรงกับนิพจน์นี้ นิพจน์จะแสดงเกณฑ์ในมิติข้อมูล เมตริก และ/หรือพารามิเตอร์

UserCriteriaScoping

การกำหนดขอบเขตจะระบุเหตุการณ์ที่นำมาพิจารณาเมื่อประเมินว่าผู้ใช้มีคุณสมบัติตรงตามเกณฑ์หรือไม่

Enum
USER_CRITERIA_SCOPING_UNSPECIFIED กำหนดขอบเขตเกณฑ์ที่ไม่ได้ระบุ ไม่ระบุ
USER_CRITERIA_WITHIN_SAME_EVENT หากเป็นไปตามเกณฑ์ในเหตุการณ์เดียว ผู้ใช้ก็จะตรงตามเกณฑ์
USER_CRITERIA_WITHIN_SAME_SESSION หากเป็นไปตามเกณฑ์ใน 1 เซสชัน ผู้ใช้ก็จะตรงตามเกณฑ์
USER_CRITERIA_ACROSS_ALL_SESSIONS หากเหตุการณ์ของผู้ใช้ตรงกับเกณฑ์ ผู้ใช้ก็จะตรงตามเกณฑ์

SegmentFilterExpression

แสดงการใช้ตัวกรองกลุ่มร่วมกัน

การแสดง JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}
ช่อง
ช่องการรวม expr ระบุตัวกรอง 1 ประเภทสำหรับ SegmentFilterExpression expr ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
andGroup

object (SegmentFilterExpressionList)

SegmentFilterExpression ใน andGroup มีความสัมพันธ์แบบ "และ"

orGroup

object (SegmentFilterExpressionList)

SegmentFilterExpression ใน orGroup มีความสัมพันธ์ OR

notExpression

object (SegmentFilterExpression)

SegmentFilterExpression ไม่ใช่ notExpression

segmentFilter

object (SegmentFilter)

ตัวกรองกลุ่มพื้นฐาน

segmentEventFilter

object (SegmentEventFilter)

สร้างตัวกรองที่ตรงกับเหตุการณ์ของชื่อเหตุการณ์เดียว หากระบุนิพจน์ตัวกรองพารามิเตอร์ จะมีเพียงชุดย่อยของเหตุการณ์ที่ตรงกับทั้งชื่อเหตุการณ์เดียวและนิพจน์ตัวกรองพารามิเตอร์ที่ตรงกับตัวกรองเหตุการณ์นี้

SegmentFilterExpressionList

รายการนิพจน์ตัวกรองกลุ่ม

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

object (SegmentFilterExpression)

รายการนิพจน์ตัวกรองกลุ่ม

SegmentFilter

นิพจน์เพื่อกรองค่ามิติข้อมูลหรือเมตริก

การแสดง JSON
{
  "fieldName": string,
  "filterScoping": {
    object (SegmentFilterScoping)
  },

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
ช่อง
fieldName

string

ชื่อมิติข้อมูลหรือชื่อเมตริก

filterScoping

object (SegmentFilterScoping)

ระบุขอบเขตของตัวกรอง

ช่องการรวม one_filter ระบุตัวกรอง 1 ประเภทสำหรับ Filter one_filter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
stringFilter

object (StringFilter)

ตัวกรองที่เกี่ยวข้องกับสตริง

inListFilter

object (InListFilter)

ตัวกรองสำหรับค่าในรายการ

numericFilter

object (NumericFilter)

ตัวกรองสำหรับค่าตัวเลขหรือวันที่

betweenFilter

object (BetweenFilter)

ตัวกรองสำหรับระหว่าง 2 ค่า

SegmentFilterScoping

ขอบเขตจะระบุวิธีมิติข้อมูล คุณควรคำนึงถึงเมตริกของเหตุการณ์หลายรายการเมื่อประเมินตัวกรองกลุ่ม

การแสดง JSON
{
  "atAnyPointInTime": boolean
}
ช่อง
atAnyPointInTime

boolean

หาก atAnyPointInTime เป็นจริง ตัวกรองนี้จะประเมินว่าเป็นจริงสำหรับเหตุการณ์ทั้งหมดหากประเมินเป็น "จริง" สำหรับเหตุการณ์ใดก็ตามในช่วงวันที่ของคำขอ

พารามิเตอร์ atAnyPointInTime นี้ไม่ได้ขยายช่วงวันที่ของเหตุการณ์ในรายงาน หาก atAnyPointInTime เป็นจริง ระบบจะพิจารณาเฉพาะเหตุการณ์ภายในช่วงวันที่ของรายงานเมื่อประเมินตัวกรองนี้

จะระบุ atAnyPointInTime นี้ได้ก็ต่อเมื่อขอบเขตเกณฑ์คือ ACROSS_ALL_SESSIONS และไม่สามารถระบุเป็นลำดับได้

หากกำหนดขอบเขตเกณฑ์คือ ACROSS_ALL_SESSIONS ระบบจะใช้ atAnyPointInTime = เท็จ หากไม่ได้ระบุ

SegmentEventFilter

สร้างตัวกรองที่ตรงกับเหตุการณ์ของชื่อเหตุการณ์เดียว หากระบุนิพจน์ตัวกรองพารามิเตอร์ จะมีเพียงชุดย่อยของเหตุการณ์ที่ตรงกับทั้งชื่อเหตุการณ์เดียวและนิพจน์ตัวกรองพารามิเตอร์ที่ตรงกับตัวกรองเหตุการณ์นี้

การแสดง JSON
{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}
ช่อง
eventName

string

ตัวกรองนี้ตรงกับเหตุการณ์ของชื่อเหตุการณ์เดียวนี้ ต้องระบุชื่อเหตุการณ์

segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

หากระบุ ตัวกรองนี้จะจับคู่เหตุการณ์ที่ตรงกับทั้งชื่อเหตุการณ์เดียวและนิพจน์ตัวกรองพารามิเตอร์

ภายในนิพจน์ตัวกรองพารามิเตอร์ จะมีเพียงตัวกรองพารามิเตอร์เท่านั้นที่ใช้งานได้

SegmentParameterFilterExpression

แสดงชุดค่าผสมของตัวกรองกลุ่มในพารามิเตอร์

การแสดง JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of list of possible types for union field expr.
}
ช่อง
ช่องการรวม expr ระบุตัวกรอง 1 ประเภทสำหรับ SegmentParameterFilterExpression expr ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
andGroup

object (SegmentParameterFilterExpressionList)

SegmentParametersFilterExpression ใน andGroup มีความสัมพันธ์แบบ AND

orGroup

object (SegmentParameterFilterExpressionList)

SegmentParametersFilterExpression ใน orGroup มีความสัมพันธ์ OR

notExpression

object (SegmentParameterFilterExpression)

SegmentParametersFilterExpression ไม่ใช่ notExpression

segmentParameterFilter

object (SegmentParameterFilter)

ตัวกรองพารามิเตอร์กลุ่มพื้นฐาน

SegmentParameterFilterExpressionList

รายการนิพจน์ตัวกรองพารามิเตอร์ของกลุ่ม

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

object (SegmentParameterFilterExpression)

รายการนิพจน์ตัวกรองพารามิเตอร์ของกลุ่ม

SegmentParameterFilter

นิพจน์ที่ใช้กรองค่าพารามิเตอร์ในกลุ่ม

การแสดง JSON
{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
ช่อง
filterScoping

object (SegmentParameterFilterScoping)

ระบุขอบเขตของตัวกรอง

ช่องการรวม one_parameter ช่องที่ถูกกรองออก one_parameter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
eventParameterName

string

ระบบจะประเมินตัวกรองนี้ในพารามิเตอร์เหตุการณ์ที่ระบุ ระบบจะบันทึกพารามิเตอร์เหตุการณ์เป็นพารามิเตอร์ของเหตุการณ์ พารามิเตอร์เหตุการณ์มีช่อง เช่น "firebase_screen" และ "currency"

ใช้พารามิเตอร์เหตุการณ์ได้เฉพาะในกลุ่มและ Funnel และใช้ได้ในตัวกรองสืบทอดจาก EventFilter เท่านั้น ในตัวกรองสืบทอดจาก EventFilter ควรใช้เหตุการณ์หรือพารามิเตอร์รายการ

itemParameterName

string

ระบบจะประเมินตัวกรองนี้ตามพารามิเตอร์รายการที่ระบุ ระบบจะบันทึกพารามิเตอร์รายการเป็นพารามิเตอร์ในอาร์เรย์สินค้า พารามิเตอร์รายการมีช่องต่างๆ เช่น "item_name" และ "item_category"

ใช้พารามิเตอร์รายการได้ในกลุ่มและ Funnel และใช้ได้ในตัวกรองสืบทอดจาก EventFilter เท่านั้น ในตัวกรองสืบทอดจาก EventFilter ควรใช้เหตุการณ์หรือพารามิเตอร์รายการ

พารามิเตอร์สินค้าใช้ได้เฉพาะในเหตุการณ์อีคอมเมิร์ซ ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์อีคอมเมิร์ซได้จากคู่มือวัดอีคอมเมิร์ซ

ช่องการรวม one_filter ระบุตัวกรอง 1 ประเภท one_filter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
stringFilter

object (StringFilter)

ตัวกรองที่เกี่ยวข้องกับสตริง

inListFilter

object (InListFilter)

ตัวกรองสำหรับค่าในรายการ

numericFilter

object (NumericFilter)

ตัวกรองสำหรับค่าตัวเลขหรือวันที่

betweenFilter

object (BetweenFilter)

ตัวกรองสำหรับระหว่าง 2 ค่า

SegmentParameterFilterScoping

ขอบเขตจะระบุวิธีพิจารณาหลายๆ เหตุการณ์เมื่อประเมินตัวกรองพารามิเตอร์กลุ่ม

การแสดง JSON
{
  "inAnyNDayPeriod": string
}
ช่อง
inAnyNDayPeriod

string (int64 format)

สะสมพารามิเตอร์ในระยะเวลาที่ระบุก่อนใช้ตัวกรอง รองรับเฉพาะเมื่อกำหนดขอบเขตเกณฑ์เป็น ACROSS_ALL_SESSIONS หรือ WITHIN_SAME_SESSION รองรับเฉพาะเมื่อพารามิเตอร์คือ event_count

เช่น หาก inAnyNDayPeriod คือ 3 eventName คือ "purchase" พารามิเตอร์เหตุการณ์คือ "event_count" และเกณฑ์ของตัวกรองมากกว่า 5 ตัวกรองนี้จะรวบรวมจํานวนเหตุการณ์ของเหตุการณ์การซื้อทุกๆ 3 วันติดต่อกันในช่วงวันที่ของรายงาน ผู้ใช้ผ่านเกณฑ์ของตัวกรองนี้เพื่อรวมไว้ในกลุ่มนี้หากจำนวนเหตุการณ์การซื้อเกิน 5 วันในระยะเวลา 3 วันติดต่อกัน ตัวอย่างเช่น วันที่ 01-11-2021 ถึง 03-11-2021, 02-11-2021 ถึง 04-11-2021, 03-11-2021 ถึง 05-11-2021 และอื่นๆ

ไม่มีการขยายช่วงวันที่เพื่อให้มีกรอบเวลาเต็ม N วันใกล้จุดเริ่มต้นของช่วงวันที่ เช่น หากรายงานแสดงข้อมูลเหตุการณ์ในวันที่ 11-11-2021 ถึง 10-11-2021 และ inAnyNDayPeriod = 3 ระบบจะลดระยะเวลา 2 วันแรกได้อย่างมีประสิทธิภาพ เนื่องจากจะไม่มีการอ่านข้อมูลเหตุการณ์นอกช่วงวันที่ของรายงาน ตัวอย่างเช่น 4 ช่วงเวลาแรกจะมีประสิทธิภาพตั้งแต่ 01-11-2021 ถึง 01-11-2021, 01-11-2021 ถึง 02-11-2021, 01-11-2021 ถึง 03-11-2021 และ 1-11-2021 ถึง 11-2021

คุณจะระบุ inAnyNDayPeriod หรือไม่ก็ได้ หากไม่ได้ระบุไว้ ระบบจะใช้ segmentParameterFilter กับแต่ละเหตุการณ์แยกกัน

UserSegmentSequenceGroup

กำหนดเงื่อนไขที่จะต้องเกิดขึ้นตามลำดับที่เฉพาะเจาะจงเพื่อให้ผู้ใช้เป็นสมาชิกของกลุ่ม

การแสดง JSON
{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}
ช่อง
sequenceScoping

enum (UserCriteriaScoping)

ต้องเป็นไปตามเงื่อนไขของขั้นตอนทั้งหมดของลำดับที่กำหนดขอบเขตเพื่อให้ผู้ใช้จับคู่กับลำดับได้ เช่น หากเป็น sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION ขั้นตอนทั้งหมดของลำดับต้องดำเนินการให้เสร็จสิ้นภายใน 1 เซสชันเพื่อให้ผู้ใช้จับคู่กับลำดับได้ ไม่รองรับ sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT

ไม่บังคับ หากไม่ได้ระบุ ระบบจะใช้ conditionScoping = ACROSS_ALL_SESSIONS

sequenceMaximumDuration

string (Duration format)

กำหนดระยะเวลาที่ลำดับทั้งหมดต้องเกิดขึ้น เช่น 30 นาที sequenceMaximumDuration รวมปลายทางที่รายละเอียดระดับไมโครวินาที เช่น ลำดับที่มีระยะเวลาสูงสุด 5 วินาทีจะทำได้ที่ 4.9 หรือ 5.0 วินาที แต่ไม่ใช่ 5 วินาทีและ 1 ไมโครวินาที

sequenceMaximumDuration เป็นตัวเลือกที่ไม่บังคับ และถ้าไม่ระบุ อาจทำตามลำดับให้เสร็จสมบูรณ์ได้ตลอดช่วงเวลา

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" ตัวอย่างเช่น "3.5s"

userSequenceSteps[]

object (UserSequenceStep)

ลำดับขั้นตอนของเงื่อนไข เหตุการณ์ของผู้ใช้ต้องทำแต่ละขั้นตอนเพื่อให้ผู้ใช้จับคู่กับ UserSegmentSequenceGroup

UserSequenceStep

เงื่อนไขที่ต้องเกิดขึ้นตามลำดับขั้นตอนที่ระบุเพื่อให้ผู้ใช้รายนี้จับคู่กับลำดับ

การแสดง JSON
{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
ช่อง
isDirectlyFollowedBy

boolean

หากเป็นจริง เหตุการณ์ที่ผ่านขั้นตอนนี้จะต้องเป็นเหตุการณ์ถัดไปหลังจากที่เหตุการณ์ผ่านขั้นตอนสุดท้ายแล้ว หากเท็จ ขั้นตอนนี้จะเป็นไปตามขั้นตอนก่อนหน้าโดยอ้อม เช่น อาจมีเหตุการณ์ระหว่างขั้นตอนก่อนหน้ากับขั้นตอนนี้ isDirectlyFollowedBy ต้องเป็น "เท็จ" สำหรับขั้นตอนแรก

stepScoping

enum (UserCriteriaScoping)

ขั้นตอนของลำดับนี้ต้องเป็นไปตามการกำหนดขอบเขตเพื่อให้ผู้ใช้จับคู่ลำดับได้ ตัวอย่างเช่น หากเป็น sequenceScoping = WITHIN_SAME_SESSION ขั้นตอนของลำดับนี้ต้องดำเนินการให้เสร็จสิ้นภายใน 1 เซสชันเพื่อให้ผู้ใช้จับคู่กับลำดับได้ stepScoping = ACROSS_ALL_SESSIONS จะได้รับอนุญาตก็ต่อเมื่อ sequenceScoping = ACROSS_ALL_SESSIONS

ไม่บังคับ หากไม่ระบุ stepScoping จะใช้ UserCriteriaScoping เหมือนกับ sequenceScoping

segmentFilterExpression

object (SegmentFilterExpression)

ผู้ใช้จับคู่ขั้นตอนของลำดับนี้หากเหตุการณ์ของผู้ใช้ตรงกับนิพจน์นี้ นิพจน์จะแสดงเกณฑ์ในมิติข้อมูล เมตริก และ/หรือพารามิเตอร์

UserSegmentExclusion

ระบุว่าจะยกเว้นผู้ใช้รายใดในกลุ่มนี้

การแสดง JSON
{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}
ช่อง
userExclusionDuration

enum (UserExclusionDuration)

ระบุระยะเวลาของการยกเว้นหากผู้ใช้ตรงกับ userExclusionCriteria

ไม่บังคับ หากไม่ได้ระบุ ระบบจะใช้ userExclusionDuration จาก USER_EXCLUSION_TEMPORARY

userExclusionCriteria

object (UserSegmentCriteria)

หากผู้ใช้มีคุณสมบัติตรงตามเงื่อนไขนี้ ระบบจะยกเว้นผู้ใช้จากการเป็นสมาชิกในกลุ่มสำหรับ userExclusionDuration

UserExclusionDuration

แจกแจงตัวเลือกของระยะเวลาการใช้การยกเว้นหากผู้ใช้ตรงกับ userExclusionCriteria

Enum
USER_EXCLUSION_DURATION_UNSPECIFIED ระยะเวลาการยกเว้นที่ไม่ได้ระบุ ไม่ระบุ
USER_EXCLUSION_TEMPORARY ยกเว้นผู้ใช้จากกลุ่มชั่วคราวในระหว่างช่วงเวลาที่ผู้ใช้มีคุณสมบัติตรงตามเงื่อนไข userExclusionCriteria
USER_EXCLUSION_PERMANENT ยกเว้นผู้ใช้จากกลุ่มอย่างถาวรหากผู้ใช้มีคุณสมบัติตรงตามเงื่อนไข userExclusionCriteria

SessionSegment

กลุ่มเซสชันคือเซสชันชุดย่อยที่เกิดขึ้นในเว็บไซต์หรือแอปของคุณ เช่น เซสชันทั้งหมดที่เกิดจากแคมเปญการโฆษณาหนึ่งๆ

การแสดง JSON
{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
ช่อง
sessionInclusionCriteria

object (SessionSegmentCriteria)

กำหนดเซสชันที่รวมอยู่ในกลุ่มนี้ ไม่บังคับ

exclusion

object (SessionSegmentExclusion)

กำหนดเซสชันที่จะยกเว้นในกลุ่มนี้ ไม่บังคับ

SessionSegmentCriteria

เซสชันจะตรงกับเกณฑ์หากเหตุการณ์ของเซสชันเป็นไปตามเงื่อนไขในเกณฑ์

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

object (SessionSegmentConditionGroup)

เซสชันตรงกับเกณฑ์นี้หากเซสชันตรงกับ andConditionGroups แต่ละรายการเหล่านี้

SessionSegmentConditionGroup

เงื่อนไขจะบอกให้ Analytics ทราบถึงข้อมูลที่จะรวมในกลุ่มหรือยกเว้นออกจากกลุ่ม

การแสดง JSON
{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
ช่อง
conditionScoping

enum (SessionCriteriaScoping)

การรวมหรือยกเว้นข้อมูลจากกลุ่มโดยพิจารณาว่าตรงกับกลุ่มเงื่อนไขหรือไม่ ขอบเขตนี้จะกำหนดจำนวนเหตุการณ์ที่ segmentFilterExpression ได้รับการประเมินก่อนที่จะพิจารณาว่ากลุ่มเงื่อนไขตรงกันหรือไม่ ตัวอย่างเช่น หาก conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION นิพจน์จะได้รับการประเมินในเหตุการณ์ทั้งหมดในเซสชัน จากนั้นจะพิจารณาว่ากลุ่มเงื่อนไขตรงกันหรือไม่สำหรับเซสชันนี้ ตัวอย่างเช่น หาก conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT นิพจน์จะได้รับการประเมินในเหตุการณ์เดียว จากนั้นจะพิจารณาว่ากลุ่มเงื่อนไขตรงกันหรือไม่สำหรับเซสชันนี้

ไม่บังคับ หากไม่ได้ระบุ ระบบจะใช้ conditionScoping เป็น WITHIN_SAME_SESSION

segmentFilterExpression

object (SegmentFilterExpression)

การรวมหรือยกเว้นข้อมูลจากกลุ่มโดยพิจารณาจากหากตรงกับนิพจน์นี้ นิพจน์จะแสดงเกณฑ์ในมิติข้อมูล เมตริก และ/หรือพารามิเตอร์

SessionCriteriaScoping

การกำหนดขอบเขตจะระบุเหตุการณ์ที่นำมาพิจารณาเมื่อประเมินว่าเซสชันตรงตามเกณฑ์หรือไม่

Enum
SESSION_CRITERIA_SCOPING_UNSPECIFIED กำหนดขอบเขตเกณฑ์ที่ไม่ได้ระบุ ไม่ระบุ
SESSION_CRITERIA_WITHIN_SAME_EVENT หากเป็นไปตามเกณฑ์ในเหตุการณ์หนึ่ง เซสชันนั้นก็ตรงตามเกณฑ์
SESSION_CRITERIA_WITHIN_SAME_SESSION หากมีคุณสมบัติตรงตามเกณฑ์ภายใน 1 เซสชัน เซสชันนั้นๆ ก็ตรงตามเกณฑ์

SessionSegmentExclusion

ระบุเซสชันที่จะยกเว้นในกลุ่มนี้

การแสดง JSON
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
ช่อง
sessionExclusionDuration

enum (SessionExclusionDuration)

ระบุระยะเวลาของการยกเว้นหากเซสชันตรงกับ sessionExclusionCriteria

ไม่บังคับ หากไม่ได้ระบุ ระบบจะใช้ sessionExclusionDuration เป็น SESSION_EXCLUSION_TEMPORARY

sessionExclusionCriteria

object (SessionSegmentCriteria)

หากเซสชันเป็นไปตามเงื่อนไขนี้ เซสชันจะถูกยกเว้นจากการเป็นสมาชิกในกลุ่มสำหรับ sessionExclusionDuration

SessionExclusionDuration

แจกแจงตัวเลือกของระยะเวลาการใช้การยกเว้นหากเซสชันตรงกับ sessionExclusionCriteria

Enum
SESSION_EXCLUSION_DURATION_UNSPECIFIED ระยะเวลาการยกเว้นที่ไม่ได้ระบุ ไม่ระบุ
SESSION_EXCLUSION_TEMPORARY ยกเว้นเซสชันจากกลุ่มชั่วคราวในระหว่างช่วงเวลาที่เซสชันเป็นไปตามเงื่อนไข sessionExclusionCriteria
SESSION_EXCLUSION_PERMANENT ยกเว้นเซสชันจากกลุ่มอย่างถาวร หากเซสชันนั้นตรงกับเงื่อนไข sessionExclusionCriteria

EventSegment

กลุ่มเหตุการณ์คือชุดย่อยของเหตุการณ์ที่มีการทริกเกอร์ในเว็บไซต์หรือแอป เช่น เหตุการณ์การซื้อทั้งหมดที่เกิดขึ้นในสถานที่หนึ่งๆ เหตุการณ์ app_exception ที่เกิดขึ้นในระบบปฏิบัติการหนึ่งๆ

การแสดง JSON
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
ช่อง
eventInclusionCriteria

object (EventSegmentCriteria)

กําหนดเหตุการณ์ที่รวมอยู่ในกลุ่มนี้ ไม่บังคับ

exclusion

object (EventSegmentExclusion)

กําหนดเหตุการณ์ที่จะยกเว้นในกลุ่มนี้ ไม่บังคับ

EventSegmentCriteria

เหตุการณ์จะตรงกับเกณฑ์หากเหตุการณ์เป็นไปตามเงื่อนไขในเกณฑ์

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

object (EventSegmentConditionGroup)

เหตุการณ์ตรงกับเกณฑ์นี้หากเหตุการณ์ตรงกับ andConditionGroups แต่ละรายการเหล่านี้

EventSegmentConditionGroup

เงื่อนไขจะบอกให้ Analytics ทราบถึงข้อมูลที่จะรวมในกลุ่มหรือยกเว้นออกจากกลุ่ม

การแสดง JSON
{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
ช่อง
conditionScoping

enum (EventCriteriaScoping)

conditionScoping ควรเป็น EVENT_CRITERIA_WITHIN_SAME_EVENT เสมอ

ไม่บังคับ หากไม่ได้ระบุ ระบบจะใช้ conditionScoping เป็น EVENT_CRITERIA_WITHIN_SAME_EVENT

segmentFilterExpression

object (SegmentFilterExpression)

การรวมหรือยกเว้นข้อมูลจากกลุ่มโดยพิจารณาจากหากตรงกับนิพจน์นี้ นิพจน์จะแสดงเกณฑ์ในมิติข้อมูล เมตริก และ/หรือพารามิเตอร์

EventCriteriaScoping

การกำหนดขอบเขตจะระบุเหตุการณ์ที่นำมาพิจารณาเมื่อประเมินว่าเหตุการณ์ตรงตามเกณฑ์หรือไม่

Enum
EVENT_CRITERIA_SCOPING_UNSPECIFIED กำหนดขอบเขตเกณฑ์ที่ไม่ได้ระบุ ไม่ระบุ
EVENT_CRITERIA_WITHIN_SAME_EVENT หากเป็นไปตามเกณฑ์ใน 1 เหตุการณ์ เหตุการณ์นั้นจะตรงกับเกณฑ์

EventSegmentExclusion

ระบุเหตุการณ์ที่จะยกเว้นในกลุ่มนี้

การแสดง JSON
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
ช่อง
eventExclusionDuration

enum (EventExclusionDuration)

eventExclusionDuration ควรเป็น PERMANENTLY_EXCLUDE เสมอ

ไม่บังคับ หากไม่ได้ระบุ ระบบจะใช้ eventExclusionDuration เป็น EVENT_EXCLUSION_PERMANENT

eventExclusionCriteria

object (EventSegmentCriteria)

หากเหตุการณ์เป็นไปตามเงื่อนไขนี้ ระบบจะยกเว้นเหตุการณ์จากการเป็นสมาชิกในกลุ่มสำหรับ eventExclusionDuration

EventExclusionDuration

แจกแจงตัวเลือกสำหรับระยะเวลาที่จะยกเว้นหากเหตุการณ์ตรงกับ eventExclusionCriteria

Enum
EVENT_EXCLUSION_DURATION_UNSPECIFIED ระยะเวลาการยกเว้นที่ไม่ได้ระบุ ไม่ระบุ
EVENT_EXCLUSION_PERMANENT ยกเว้นเหตุการณ์จากกลุ่มอย่างถาวรหากเหตุการณ์นั้นเป็นไปตามเงื่อนไข eventExclusionCriteria เลย

FunnelSubReport

รายงานย่อยของ Funnel มีค่าข้อมูลมิติข้อมูลและเมตริก ตัวอย่างเช่น ผู้ใช้ 12 คนถึงขั้นตอนที่ 2 ของ Funnel

การแสดง JSON
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
ช่อง
dimensionHeaders[]

object (DimensionHeader)

อธิบายคอลัมน์มิติข้อมูล รายงาน Funnel จะรวมมิติข้อมูลขั้นตอน Funnel ในคำตอบของรายงานย่อยเสมอ มิติข้อมูลเพิ่มเติม เช่น รายละเอียด วันที่ และการดำเนินการถัดไปอาจแสดงในการตอบกลับหากมีการขอ

metricHeaders[]

object (MetricHeader)

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

rows[]

object (Row)

แถวของชุดค่าผสมมิติข้อมูลและค่าเมตริกในรายงาน

metadata

object (FunnelResponseMetadata)

ข้อมูลเมตาสำหรับรายงาน Funnel

FunnelResponseMetadata

ข้อมูลเมตาการตอบกลับของรายงาน Funnel จะมีข้อมูลเพิ่มเติมเกี่ยวกับรายงาน Funnel

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

object (SamplingMetadata)

หากผลลัพธ์ของรายงาน Funnel เป็นแบบสุ่มตัวอย่าง ข้อมูลนี้จะอธิบายเปอร์เซ็นต์ของเหตุการณ์ที่ใช้ในรายงาน Funnel นี้ ระบบจะป้อนข้อมูล samplingMetadatas 1 รายการสำหรับแต่ละช่วงวันที่ samplingMetadatas แต่ละรายการจะสอดคล้องกับช่วงวันที่ตามลำดับที่มีการระบุช่วงวันที่ในคำขอ

อย่างไรก็ตาม หากไม่มีการสุ่มตัวอย่างผลลัพธ์จะไม่มีการกำหนดช่องนี้

SamplingMetadata

หากผลลัพธ์ของรายงาน Funnel มีการสุ่มตัวอย่าง ข้อมูลเมตานี้จะอธิบายเปอร์เซ็นต์ของเหตุการณ์ที่ใช้ในรายงาน Funnel ของช่วงวันที่หนึ่งๆ การสุ่มตัวอย่างคือแนวทางปฏิบัติในการวิเคราะห์ชุดย่อยของข้อมูลทั้งหมด เพื่อค้นหาข้อมูลที่สื่อความหมายในชุดข้อมูลขนาดใหญ่

การแสดง JSON
{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}
ช่อง
samplesReadCount

string (int64 format)

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

samplingSpaceSize

string (int64 format)

จำนวนเหตุการณ์ทั้งหมดที่แสดงในข้อมูลของพร็อพเพอร์ตี้นี้ซึ่งอาจได้รับการวิเคราะห์ในรายงาน Funnel ของช่วงวันที่หนึ่งๆ การสุ่มตัวอย่างจะค้นพบข้อมูลที่มีประโยชน์เกี่ยวกับชุดข้อมูลที่ใหญ่กว่า และขนาดของชุดข้อมูลที่ใหญ่กว่า

หากต้องการคำนวณเปอร์เซ็นต์ของข้อมูลที่มีอยู่ซึ่งใช้ในรายงาน Funnel นี้ ให้คํานวณ samplesReadCount/samplingSpaceSize

PropertyQuota

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

การแสดง JSON
{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}
ช่อง
tokensPerDay

object (QuotaStatus)

พร็อพเพอร์ตี้ Analytics มาตรฐานใช้โทเค็นได้สูงสุด 200,000 รายการต่อวัน พร็อพเพอร์ตี้ Analytics 360 ใช้โทเค็นได้ 2,000,000 รายการต่อวัน คําขอส่วนใหญ่ใช้โทเค็นน้อยกว่า 10 รายการ

tokensPerHour

object (QuotaStatus)

พร็อพเพอร์ตี้ Analytics มาตรฐานใช้โทเค็นได้สูงสุด 40,000 รายการต่อชั่วโมง พร็อพเพอร์ตี้ Analytics 360 ใช้โทเค็นได้ 400,000 รายการต่อชั่วโมง คำขอ API จะใช้โทเค็นจำนวนเดียว และจะมีการหักเงินจำนวนดังกล่าวจากโควต้ารายชั่วโมง รายวัน และต่อโครงการรายชั่วโมงทั้งหมด

concurrentRequests

object (QuotaStatus)

พร็อพเพอร์ตี้ Analytics มาตรฐานสามารถส่งคำขอพร้อมกันได้สูงสุด 10 รายการ พร็อพเพอร์ตี้ Analytics 360 ใช้คำขอพร้อมกันได้สูงสุด 50 รายการ

serverErrorsPerProjectPerHour

object (QuotaStatus)

การจับคู่พร็อพเพอร์ตี้ Analytics มาตรฐานและโปรเจ็กต์ระบบคลาวด์อาจมีข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ได้สูงสุด 10 รายการต่อชั่วโมง การจับคู่พร็อพเพอร์ตี้ Analytics 360 และโปรเจ็กต์ที่อยู่ในระบบคลาวด์อาจมีข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ได้สูงสุด 50 รายการต่อชั่วโมง

potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

พร็อพเพอร์ตี้ Analytics ส่งคำขอได้สูงสุด 120 รายการโดยมีมิติข้อมูลที่อาจถึงเกณฑ์ต่อชั่วโมง ในคำขอแบบกลุ่ม คำขอรายงานแต่ละรายการจะนับแยกกันสำหรับโควต้านี้ หากคำขอดังกล่าวมีมิติข้อมูลที่อาจถึงเกณฑ์แล้ว

tokensPerProjectPerHour

object (QuotaStatus)

พร็อพเพอร์ตี้ Analytics ใช้โทเค็นได้สูงสุด 35% ต่อโปรเจ็กต์ต่อชั่วโมง จำนวนนี้หมายถึงพร็อพเพอร์ตี้ Analytics มาตรฐานสามารถใช้โทเค็นได้สูงสุด 14,000 รายการต่อโปรเจ็กต์ต่อชั่วโมง และพร็อพเพอร์ตี้ Analytics 360 ใช้โทเค็นได้ 140,000 โทเค็นต่อโปรเจ็กต์ต่อชั่วโมง คำขอ API จะใช้โทเค็นจำนวนเดียว และจะมีการหักเงินจำนวนดังกล่าวจากโควต้ารายชั่วโมง รายวัน และต่อโครงการรายชั่วโมงทั้งหมด

QuotaStatus

สถานะปัจจุบันสำหรับกลุ่มโควต้าหนึ่งๆ

การแสดง JSON
{
  "consumed": integer,
  "remaining": integer
}
ช่อง
consumed

integer

โควต้าที่คำขอนี้ใช้ไป

remaining

integer

โควต้าที่เหลือหลังจากคำขอนี้