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)

สถานะโควต้าของพร็อพเพอร์ตี้ 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 มีความสัมพันธ์แบบ "และ"
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)

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

object (FunnelParameterFilterExpressionList)

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

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

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

object (SegmentParameterFilterExpressionList)

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

object (SegmentParameterFilterExpressionList)

SegmentParameterFilterExpression ใน orGroup มีความสัมพันธ์แบบ "หรือ"
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)

ระบุขอบเขตสําหรับตัวกรอง
ฟิลด์สหภาพ 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 วันติดต่อกัน เช่น ระบบจะพิจารณาระยะเวลา 2021-11-01 ถึง 2021-11-03, 2021-11-02 ถึง 2021-11-04, 2021-11-03 ถึง 2021-11-05 และอื่นๆ

ระบบจะไม่ขยายช่วงวันที่เพื่อที่จะได้กรอบเวลา N วันเต็มๆ ในช่วงเริ่มต้นของช่วงวันที่ ตัวอย่างเช่น หากรายงานเป็นวันที่ 01-11-2021 ถึง 10-11-2021 และ 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 แต่ละรายการสอดคล้องกับช่วงวันที่ตามลำดับที่ระบุช่วงวันที่ในคำขอ

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