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, กลุ่ม, วันที่, มิติข้อมูลการกระทําถัดไป และผู้ใช้ที่ใช้งานอยู่

มิติข้อมูลกลุ่มจะอยู่ในคำตอบนี้ก็ต่อเมื่อมีการขอกลุ่ม มิติข้อมูลวันที่จะอยู่ในคำตอบนี้ก็ต่อเมื่อมีการขอผ่าน 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 ในขั้นตอนของ 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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of mutually exclusive fields.
}
ช่อง
ระบุตัวกรองประเภทใดประเภทหนึ่งสำหรับ FunnelFilterExpression ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
ช่อง
fieldName

string

ชื่อมิติข้อมูลหรือชื่อเมตริก
ระบุตัวกรองประเภทใดประเภทหนึ่ง ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of mutually exclusive fields.
}
ช่อง
ระบุตัวกรองประเภทใดประเภทหนึ่งสำหรับ FunnelParameterFilterExpression ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "eventParameterName": string,
  "itemParameterName": string
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
ช่อง
ฟิลด์ที่กำลังกรอง ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
eventParameterName

string

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

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

string

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

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of mutually exclusive fields.
}
ช่อง
name

string

ชื่อของกลุ่มนี้ หากไม่ได้ระบุ ระบบจะตั้งชื่อกลุ่มว่า "กลุ่ม" ชื่อนี้กำหนดค่าสตริงที่แสดงผลโดยsegmentมิติข้อมูล segment คำนำหน้ามิติข้อมูลจะนำหน้าชื่อกลุ่มด้วยหมายเลขดัชนีที่อิงตาม 1 ของกลุ่มในคำขอ (เช่น "1. Segment", "2. กลุ่ม" ฯลฯ)
โดยจะระบุกลุ่มในขอบเขตเดียว ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of mutually exclusive fields.
}
ช่อง
ระบุตัวกรองประเภทใดประเภทหนึ่งสำหรับ SegmentFilterExpression ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
ช่อง
fieldName

string

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

object (SegmentFilterScoping)

ระบุขอบเขตของตัวกรอง
ระบุตัวกรองประเภทใดประเภทหนึ่งสำหรับ 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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of mutually exclusive fields.
}
ช่อง
ระบุตัวกรองประเภทใดประเภทหนึ่งสำหรับ SegmentParameterFilterExpression ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "eventParameterName": string,
  "itemParameterName": string
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
ช่อง
filterScoping

object (SegmentParameterFilterScoping)

ระบุขอบเขตของตัวกรอง
ฟิลด์ที่กำลังกรอง ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
eventParameterName

string

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

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

string

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

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

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

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

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