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

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

ตัวอย่าง: properties/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 ช่วงทับซ้อนกัน ระบบจะรวมข้อมูลเหตุการณ์ของวันที่ทับซ้อนกันไว้ในแถวการตอบกลับของทั้ง 2 ช่วงวันที่
funnel

object (Funnel)

ไม่บังคับ การกําหนดค่า 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 ประเภท TRENDED_FUNNEL เท่านั้น มิติข้อมูลการดำเนินการถัดไปจะอยู่ในคำตอบก็ต่อเมื่อมีการขอเท่านั้น
propertyQuota

object (PropertyQuota)

สถานะโควต้าของพร็อพเพอร์ตี้ Google 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 ในขั้นตอนที่ 3 ของ Funnel ของคำขอจะสร้าง 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.
}
ช่อง
ฟิลด์ Union expr ระบุตัวกรองประเภทใดประเภทหนึ่งสำหรับ 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

ชื่อมิติข้อมูลหรือชื่อเมตริก
ฟิลด์ Union one_filter ระบุตัวกรองประเภทใดประเภทหนึ่ง 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.
}
ช่อง
ฟิลด์ Union expr ระบุตัวกรองประเภทใดประเภทหนึ่งสำหรับ FunnelParameterFilterExpression expr ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
andGroup

object (FunnelParameterFilterExpressionList)

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

object (FunnelParameterFilterExpressionList)

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

object (FunnelParameterFilterExpression)

FunnelParameterFilterExpression ไม่ใช่ 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.
}
ช่อง
ฟิลด์ Union one_parameter ฟิลด์ที่กรอง one_parameter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
eventParameterName

string

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

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

string

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

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

พารามิเตอร์สินค้าใช้ได้ในเหตุการณ์อีคอมเมิร์ซเท่านั้น ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์อีคอมเมิร์ซได้ที่คู่มือวัดอีคอมเมิร์ซ
ฟิลด์ Union one_filter ระบุตัวกรองประเภทใดประเภทหนึ่ง 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 ของคุณ ตัวอย่างเช่น จากกลุ่มผู้ใช้ทั้งหมดของคุณ กลุ่มหนึ่งอาจเป็นผู้ใช้จากประเทศหรือเมืองหนึ่งๆ อีกกลุ่มหนึ่งอาจเป็นผู้ใช้ที่ซื้อกลุ่มผลิตภัณฑ์หนึ่งๆ หรือเยี่ยมชมส่วนหนึ่งในเว็บไซต์ หรือเรียกเหตุการณ์หนึ่งๆ ให้แสดงในแอป

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

การแสดง 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. กลุ่ม" เป็นต้น)
ฟิลด์ Union one_segment_scope โดยจะระบุกลุ่มในขอบเขตเดียว 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 หากตรงตามเกณฑ์ภายในเซสชันเดียว ผู้ใช้จะตรงกับเกณฑ์
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.
}
ช่อง
ฟิลด์ Union expr ระบุตัวกรองประเภทใดประเภทหนึ่งสำหรับ SegmentFilterExpression expr ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
andGroup

object (SegmentFilterExpressionList)

SegmentFilterExpression ใน andGroup มีความสัมพันธ์แบบ AND
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)

ระบุขอบเขตของตัวกรอง
ฟิลด์ Union one_filter ระบุตัวกรองประเภทใดประเภทหนึ่งสำหรับ 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 = false หากไม่ได้ระบุ

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.
}
ช่อง
ฟิลด์ Union expr ระบุตัวกรองประเภทใดประเภทหนึ่งสำหรับ SegmentParameterFilterExpression expr ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
andGroup

object (SegmentParameterFilterExpressionList)

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

object (SegmentParameterFilterExpressionList)

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

object (SegmentParameterFilterExpression)

SegmentParameterFilterExpression ไม่ใช่ของ 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)

ระบุขอบเขตของตัวกรอง
ฟิลด์ Union one_parameter ฟิลด์ที่กรอง one_parameter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
eventParameterName

string

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

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

string

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

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

พารามิเตอร์สินค้าใช้ได้ในเหตุการณ์อีคอมเมิร์ซเท่านั้น ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์อีคอมเมิร์ซได้ที่คู่มือวัดอีคอมเมิร์ซ
ฟิลด์ Union one_filter ระบุตัวกรองประเภทใดประเภทหนึ่ง 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 วันติดต่อกัน เช่น ระบบจะพิจารณาระยะเวลา 2021-11-01 ถึง 2021-11-03, 2021-11-02 ถึง 2021-11-04, 2021-11-03 ถึง 2021-11-05 และอื่นๆ

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

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

UserSegmentSequenceGroup

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

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

enum (UserCriteriaScoping)

ต้องเป็นไปตามขั้นตอนทั้งหมดของลำดับในการกำหนดขอบเขตเพื่อให้ผู้ใช้ตรงกับลำดับ เช่น หากเป็น sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION ผู้ใช้จะต้องทำขั้นตอนทั้งหมดในลําดับให้เสร็จสิ้นภายในเซสชันเดียวจึงจะตรงกับลําดับ ไม่รองรับ 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 ขั้นตอนในลําดับนี้ต้องเสร็จสมบูรณ์ภายในเซสชันเดียวเพื่อให้ผู้ใช้ตรงกับลําดับ 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 หากตรงตามเกณฑ์ภายในเซสชันเดียว เซสชันนั้นจะตรงกับเกณฑ์

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 หากตรงตามเกณฑ์ภายในเหตุการณ์เดียว เหตุการณ์นั้นจะตรงกับเกณฑ์

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 สอดคล้องกับช่วงวันที่ตามลำดับที่ระบุช่วงวันที่ในคำขอ

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