Method: properties.runFunnelReport

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

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

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

คำขอ HTTP

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

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

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

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

string

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

ตัวอย่าง: property/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 ฉบับ รายงานย่อยสองรายงานเป็นชุดค่าผสมของมิติข้อมูลและเมตริกที่แตกต่างกัน

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

การแสดง 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

DateRange

ชุดวันที่ต่อเนื่องกัน: startDate, startDate + 1, ..., endDate อนุญาตให้มีช่วงวันที่ได้ไม่เกิน 4 ช่วง

การแสดง JSON 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
ช่อง
startDate

string

วันที่เริ่มต้นที่ครอบคลุมสำหรับการค้นหาในรูปแบบ YYYY-MM-DD ต้องอยู่หลังวันที่ endDate ไม่ได้ ระบบยอมรับรูปแบบ NdaysAgo, yesterday หรือ today ด้วย และในกรณีดังกล่าว ระบบจะอนุมานวันที่ตามเขตเวลาการรายงานของที่พัก
endDate

string

วันที่สิ้นสุดการรวมสำหรับการค้นหาในรูปแบบ YYYY-MM-DD ต้องไม่เกินวันที่ startDate ระบบยอมรับรูปแบบ NdaysAgo, yesterday หรือ today ด้วย และในกรณีดังกล่าว ระบบจะอนุมานวันที่ตามเขตเวลาการรายงานของที่พัก
name

string

กำหนดชื่อให้กับช่วงวันที่นี้ มิติข้อมูล dateRange จะได้รับการตั้งค่าเป็นชื่อนี้ในการตอบกลับรายงาน หากตั้งค่าไว้แล้ว จะขึ้นต้นด้วย date_range_ หรือ RESERVED_ ไม่ได้ หากไม่ได้ตั้งค่า ช่วงวันที่จะตั้งชื่อตามดัชนีที่อิงตาม 0 ในคำขอ เช่น date_range_0, date_range_1 เป็นต้น

Funnel

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

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

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

boolean

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

object (FunnelStep)

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

FunnelStep

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

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

string

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

boolean

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

object (FunnelFilterExpression)

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

string (Duration format)

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

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

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

FunnelFilterExpression

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

การแสดง JSON 
{

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

object (FunnelFilterExpressionList)

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

object (FunnelFilterExpressionList)

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

object (FunnelFilterExpression)

FunnelFilterExpression ไม่ได้เป็น notExpression
funnelFieldFilter

object (FunnelFieldFilter)

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

object (FunnelEventFilter)

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

FunnelFilterExpressionList

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

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

object (FunnelFilterExpression)

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

FunnelFieldFilter

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

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

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

string

ชื่อมิติข้อมูลหรือชื่อเมตริก
ฟิลด์สหภาพ one_filter ระบุตัวกรอง 1 ประเภท one_filter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
stringFilter

object (StringFilter)

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

object (InListFilter)

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

object (NumericFilter)

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

object (BetweenFilter)

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

StringFilter

ตัวกรองสำหรับสตริง

การแสดง JSON 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
ช่อง
matchType

enum (MatchType)

ประเภทการทำงานของคีย์เวิร์ดสำหรับตัวกรองนี้
value

string

ค่าสตริงที่ใช้สำหรับการจับคู่
caseSensitive

boolean

หากเป็น "จริง" ค่าสตริงจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

MatchType

ประเภทการทำงานของตัวกรองสตริง

Enum
MATCH_TYPE_UNSPECIFIED ไม่ระบุ
EXACT ค่าสตริงตรงกันทั้งหมด
BEGINS_WITH เริ่มต้นด้วยค่าสตริง
ENDS_WITH ลงท้ายด้วยค่าสตริง
CONTAINS มีค่าสตริง
FULL_REGEXP จับคู่นิพจน์ทั่วไปกับค่าสตริงโดยสมบูรณ์
PARTIAL_REGEXP การจับคู่บางส่วนสำหรับนิพจน์ทั่วไปกับค่าสตริง

InListFilter

ผลลัพธ์ต้องอยู่ในรายการค่าสตริง

การแสดง JSON 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
ช่อง
values[]

string

รายการค่าสตริง ต้องระบุ
caseSensitive

boolean

หากเป็น "จริง" ค่าสตริงจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

NumericFilter

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

การแสดง JSON 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
ช่อง
operation

enum (Operation)

ประเภทการดำเนินการสำหรับตัวกรองนี้
value

object (NumericValue)

ค่าตัวเลขหรือค่าวันที่

การดำเนินการ

การดำเนินการที่ใช้กับตัวกรองตัวเลข

Enum
OPERATION_UNSPECIFIED ไม่ระบุ
EQUAL เท่ากับ
LESS_THAN น้อยกว่า
LESS_THAN_OR_EQUAL น้อยกว่าหรือเท่ากับ
GREATER_THAN มากกว่า
GREATER_THAN_OR_EQUAL มากกว่าหรือเท่ากับ

NumericValue

เพื่อแสดงตัวเลข

การแสดง JSON 
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
ช่อง
ฟิลด์สหภาพ one_value ค่าตัวเลข one_value ค่าใดค่าหนึ่งต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
int64Value

string (int64 format)

ค่าจำนวนเต็ม
doubleValue

number

ค่า Double

BetweenFilter

เพื่อแสดงให้เห็นว่าผลลัพธ์ต้องอยู่ระหว่าง 2 จำนวน (นับรวมด้วย)

การแสดง JSON 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
ช่อง
fromValue

object (NumericValue)

ขึ้นต้นด้วยหมายเลขนี้
toValue

object (NumericValue)

ลงท้ายด้วยหมายเลขนี้

FunnelEventFilter

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

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

string

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

object (FunnelParameterFilterExpression)

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

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

FunnelParameterFilterExpression

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

การแสดง JSON 
{

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

object (FunnelParameterFilterExpressionList)

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

object (FunnelParameterFilterExpressionList)

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

object (FunnelParameterFilterExpression)

FunnelParametersFilterExpression ไม่ได้เป็นของ notExpression
funnelParameterFilter

object (FunnelParameterFilter)

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

FunnelParameterFilterExpressionList

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

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

object (FunnelParameterFilterExpression)

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

FunnelParameterFilter

นิพจน์เพื่อกรองค่าพารามิเตอร์ใน Funnel

การแสดง JSON 
{

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

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

string

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

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

string

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

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

พารามิเตอร์สินค้าใช้ได้เฉพาะในเหตุการณ์อีคอมเมิร์ซเท่านั้น ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์อีคอมเมิร์ซได้จากคําแนะนําในการวัดอีคอมเมิร์ซ
ฟิลด์สหภาพ one_filter ระบุตัวกรอง 1 ประเภท one_filter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
stringFilter

object (StringFilter)

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

object (InListFilter)

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

object (NumericFilter)

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

object (BetweenFilter)

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

FunnelBreakdown

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

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

object (Dimension)

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

string (int64 format)

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

มิติข้อมูล

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

การแสดง JSON 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
ช่อง
name

string

ชื่อของมิติข้อมูล โปรดดูมิติข้อมูล API สำหรับรายการชื่อมิติข้อมูลที่วิธีการรายงานหลักรองรับ เช่น runReport และ batchRunReports โปรดดูมิติข้อมูลแบบเรียลไทม์สำหรับรายการชื่อมิติข้อมูลที่เมธอด runRealtimeReport รองรับ โปรดดูมิติข้อมูล Funnel สำหรับรายการชื่อมิติข้อมูลที่เมธอด runFunnelReport รองรับ

หากระบุ dimensionExpression แล้ว name อาจเป็นสตริงใดก็ได้ที่คุณต้องการภายในชุดอักขระที่อนุญาต ตัวอย่างเช่น หาก dimensionExpression เชื่อม country กับ city คุณสามารถเรียกมิติข้อมูลนั้นว่า countryAndCity ชื่อมิติข้อมูลที่เลือกต้องตรงกับนิพจน์ทั่วไป ^[a-zA-Z0-9_]$

name อ้างอิงมิติข้อมูลใน dimensionFilter, orderBys, dimensionExpression และ pivots
dimensionExpression

object (DimensionExpression)

มิติข้อมูลหนึ่งอาจเป็นผลลัพธ์ของนิพจน์ของมิติข้อมูลหลายมิติ เช่น มิติข้อมูล "country, city": Concatenate(country, ", ", city)

DimensionExpression

ใช้เพื่อแสดงมิติข้อมูลที่เป็นผลมาจากสูตรของมิติข้อมูลหลายส่วน ตัวอย่างการใช้งาน 1) ตัวพิมพ์เล็ก(ส่วนข้อมูล) 2) เชื่อมต่อ(มิติข้อมูล 1, สัญลักษณ์, มิติข้อมูล2)

การแสดง JSON 
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
ช่อง
ฟิลด์สหภาพ one_expression ระบุนิพจน์มิติข้อมูล 1 ประเภทสำหรับ DimensionExpression one_expression ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
lowerCase

object (CaseExpression)

ใช้เพื่อแปลงค่ามิติข้อมูลเป็นตัวพิมพ์เล็ก
upperCase

object (CaseExpression)

ใช้เพื่อแปลงค่ามิติข้อมูลเป็นอักษรตัวพิมพ์ใหญ่
concatenate

object (ConcatenateExpression)

ใช้เพื่อรวมค่ามิติข้อมูลเป็นมิติข้อมูลเดียว เช่น มิติข้อมูล "country, city": Concatenate(country, ", ", city)

CaseExpression

ใช้เพื่อแปลงค่ามิติข้อมูลเป็นกรณีเดียว

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

string

ชื่อของมิติข้อมูล ชื่อต้องอ้างอิงกลับไปที่ชื่อในช่องมิติข้อมูลของคำขอ

ConcatenateExpression

ใช้เพื่อรวมค่ามิติข้อมูลเป็นมิติข้อมูลเดียว

การแสดง JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
ช่อง
dimensionNames[]

string

ชื่อของมิติข้อมูล ชื่อต้องอ้างอิงกลับไปที่ชื่อในช่องมิติข้อมูลของคำขอ
delimiter

string

ตัวคั่นที่วางไว้ระหว่างชื่อมิติข้อมูล

ตัวคั่นมักเป็นอักขระตัวเดียว เช่น "|" หรือ "," แต่สามารถเป็นสตริงที่ยาวกว่าได้ หากค่ามิติข้อมูลมีตัวคั่น ค่าทั้ง 2 รายการจะแสดงในการตอบสนองโดยไม่มีความแตกต่าง เช่น หากค่ามิติข้อมูล 1 = "US,FR", ค่ามิติข้อมูล 2 = "JP" และตัวคั่น = "," คำตอบจะมี "US,FR,JP"

FunnelNextAction

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

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

object (Dimension)

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

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

string (int64 format)

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

FunnelVisualizationType

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

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

กลุ่ม

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

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

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

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

string

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

object (UserSegment)

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

object (SessionSegment)

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

object (EventSegment)

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

UserSegment

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

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

object (UserSegmentCriteria)

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

object (UserSegmentExclusion)

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

UserSegmentCriteria

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

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

object (UserSegmentConditionGroup)

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

object (UserSegmentSequenceGroup)

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

UserSegmentConditionGroup

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

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

enum (UserCriteriaScoping)

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

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

object (SegmentFilterExpression)

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

UserCriteriaScoping

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

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

SegmentFilterExpression

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

การแสดง JSON 
{

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

object (SegmentFilterExpressionList)

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

object (SegmentFilterExpressionList)

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

object (SegmentFilterExpression)

SegmentFilterExpression ไม่ได้เป็นของ notExpression
segmentFilter

object (SegmentFilter)

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

object (SegmentEventFilter)

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

SegmentFilterExpressionList

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

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

object (SegmentFilterExpression)

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

SegmentFilter

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

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

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

string

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

object (SegmentFilterScoping)

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

object (StringFilter)

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

object (InListFilter)

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

object (NumericFilter)

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

object (BetweenFilter)

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

SegmentFilterScoping

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

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

boolean

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

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

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

หากขอบเขตของเกณฑ์คือ ACROSS_ALL_SESSIONS ระบบจะใช้ atAnyPointInTime = 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)

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

object (SegmentParameterFilterExpression)

SegmentParametersFilterExpression ไม่ได้เป็นของ notExpression
segmentParameterFilter

object (SegmentParameterFilter)

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

SegmentParameterFilterExpressionList

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

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

object (SegmentParameterFilterExpression)

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

SegmentParameterFilter

นิพจน์เพื่อกรองค่าพารามิเตอร์ในกลุ่ม

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

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

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

object (SegmentParameterFilterScoping)

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

string

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

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

string

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

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

พารามิเตอร์สินค้าใช้ได้เฉพาะในเหตุการณ์อีคอมเมิร์ซเท่านั้น ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์อีคอมเมิร์ซได้จากคําแนะนําในการวัดอีคอมเมิร์ซ
ฟิลด์สหภาพ one_filter ระบุตัวกรอง 1 ประเภท one_filter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
stringFilter

object (StringFilter)

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

object (InListFilter)

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

object (NumericFilter)

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

object (BetweenFilter)

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

SegmentParameterFilterScoping

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

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

string (int64 format)

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

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

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

คุณจะระบุ inAnyNDayPeriod หรือไม่ก็ได้ หากไม่ระบุ ระบบจะใช้ segmentParameterFilter กับแต่ละกิจกรรมทีละรายการ

UserSegmentSequenceGroup

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

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

enum (UserCriteriaScoping)

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

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

string (Duration format)

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

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

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

object (UserSequenceStep)

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

UserSequenceStep

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

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

boolean

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

enum (UserCriteriaScoping)

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

ไม่บังคับ หากไม่ระบุ stepScoping จะใช้ UserCriteriaScoping เดียวกับ sequenceScoping
segmentFilterExpression

object (SegmentFilterExpression)

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

UserSegmentExclusion

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

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

enum (UserExclusionDuration)

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

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

object (UserSegmentCriteria)

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

UserExclusionDuration

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

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

SessionSegment

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

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

object (SessionSegmentCriteria)

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

object (SessionSegmentExclusion)

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

SessionSegmentCriteria

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

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

object (SessionSegmentConditionGroup)

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

SessionSegmentConditionGroup

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

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

enum (SessionCriteriaScoping)

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

ไม่บังคับ หากไม่ระบุ ระบบจะใช้ conditionScoping จาก WITHIN_SAME_SESSION
segmentFilterExpression

object (SegmentFilterExpression)

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

SessionCriteriaScoping

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

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

SessionSegmentExclusion

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

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

enum (SessionExclusionDuration)

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

ไม่บังคับ หากไม่ระบุ ระบบจะใช้ sessionExclusionDuration จาก SESSION_EXCLUSION_TEMPORARY
sessionExclusionCriteria

object (SessionSegmentCriteria)

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

SessionExclusionDuration

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

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

EventSegment

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

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

object (EventSegmentCriteria)

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

object (EventSegmentExclusion)

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

EventSegmentCriteria

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

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

object (EventSegmentConditionGroup)

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

EventSegmentConditionGroup

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

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

enum (EventCriteriaScoping)

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

ไม่บังคับ หากไม่ระบุ ระบบจะใช้ conditionScoping จาก EVENT_CRITERIA_WITHIN_SAME_EVENT
segmentFilterExpression

object (SegmentFilterExpression)

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

EventCriteriaScoping

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

Enum
EVENT_CRITERIA_SCOPING_UNSPECIFIED ขอบเขตของเกณฑ์ที่ไม่ได้ระบุ ไม่ระบุ
EVENT_CRITERIA_WITHIN_SAME_EVENT เมื่อมีคุณสมบัติตรงตามเกณฑ์ภายในเหตุการณ์เดียว เหตุการณ์นั้นก็จะตรงกับเกณฑ์

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

FilterExpression

เพื่อแสดงตัวกรองมิติข้อมูลหรือเมตริก ช่องในFilterExpression เดียวกันต้องเป็นมิติข้อมูลทั้งหมดหรือเมตริกทั้งหมด

การแสดง JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
ช่อง
ฟิลด์สหภาพ expr ระบุนิพจน์ตัวกรอง 1 ประเภทสำหรับ FilterExpression expr ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
andGroup

object (FilterExpressionList)

นิพจน์ตัวกรองใน andGroup มีความสัมพันธ์ AND
orGroup

object (FilterExpressionList)

นิพจน์ตัวกรองใน orGroup มีความสัมพันธ์ OR
notExpression

object (FilterExpression)

filterExpression ไม่ใช่ของ notExpression
filter

object (Filter)

ตัวกรองพื้นฐาน ในFilterExpression เดียวกัน ชื่อช่องทั้งหมดของตัวกรองจะต้องเป็นมิติข้อมูลทั้งหมดหรือเมตริกทั้งหมด

FilterExpressionList

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

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

object (FilterExpression)

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

กรอง

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

การแสดง 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 ประเภทสำหรับFilter one_filter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
stringFilter

object (StringFilter)

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

object (InListFilter)

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

object (NumericFilter)

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

object (BetweenFilter)

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

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

DimensionHeader

อธิบายคอลัมน์มิติข้อมูลในรายงาน มิติข้อมูลที่ขอในรายงานจะสร้างรายการคอลัมน์ภายในแถวและ DimensionHeaders อย่างไรก็ตาม มิติข้อมูลที่ใช้ภายในตัวกรองหรือนิพจน์โดยเฉพาะจะไม่สร้างคอลัมน์ในรายงาน กล่าวคือ มิติข้อมูลเหล่านั้นจะไม่สร้างส่วนหัว

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

string

ชื่อมิติข้อมูล

MetricHeader

อธิบายคอลัมน์เมตริกในรายงาน คำขอเมตริกที่มองเห็นได้ในรายงานจะสร้างรายการคอลัมน์ภายในแถวและ MetricHeaders อย่างไรก็ตาม เมตริกที่ใช้ภายในตัวกรองหรือนิพจน์โดยเฉพาะจะไม่สร้างคอลัมน์ในรายงาน ด้วยเหตุนี้ เมตริกเหล่านั้นจึงไม่สร้างส่วนหัว

การแสดง JSON 
{
  "name": string,
  "type": enum (MetricType)
}
ช่อง
name

string

ชื่อเมตริก
type

enum (MetricType)

ประเภทข้อมูลของเมตริก

MetricType

ประเภทค่าของเมตริก

Enum
METRIC_TYPE_UNSPECIFIED ไม่ระบุประเภท
TYPE_INTEGER ประเภทจำนวนเต็ม
TYPE_FLOAT ประเภทจุดลอยตัว
TYPE_SECONDS ระยะเวลาเป็นวินาที ประเภทจุดลอยตัวพิเศษ
TYPE_MILLISECONDS ระยะเวลาเป็นมิลลิวินาที ประเภทจุดทศนิยมพิเศษ
TYPE_MINUTES ระยะเวลาเป็นนาที ประเภทจุดทศนิยมพิเศษ
TYPE_HOURS ระยะเวลาเป็นชั่วโมง ประเภทจุดทศนิยมพิเศษ
TYPE_STANDARD เมตริกที่กำหนดเองของประเภทมาตรฐาน ประเภทจุดลอยตัวพิเศษ
TYPE_CURRENCY จำนวนเงิน ประเภทจุดทศนิยมพิเศษ
TYPE_FEET ความยาวเป็นฟุต เป็นประเภทจุดลอยตัวพิเศษ
TYPE_MILES ความยาวเป็นไมล์ ประเภทจุดลอยตัวพิเศษ
TYPE_METERS ความยาวเป็นเมตร เป็นประเภทจุดลอยตัวพิเศษ
TYPE_KILOMETERS ความยาวเป็นกิโลเมตร เป็นประเภทจุดลอยตัวพิเศษ

แถว

ข้อมูลรายงานสำหรับแต่ละแถว ตัวอย่างเช่น หาก RunReportRequest มี

"dimensions": [
  {
    "name": "eventName"
  },
  {
    "name": "countryId"
  }
],
"metrics": [
  {
    "name": "eventCount"
  }
]

แถว 1 แถวที่มี "in_app_purchase" เป็น eventName, "JP" เป็น countryId และ 15 เป็น eventCount มีลักษณะดังนี้

"dimensionValues": [
  {
    "value": "in_app_purchase"
  },
  {
    "value": "JP"
  }
],
"metricValues": [
  {
    "value": "15"
  }
]
การแสดง JSON 
{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
ช่อง
dimensionValues[]

object (DimensionValue)

รายการค่ามิติข้อมูลที่ขอ ใน PivotReport ค่าของขนาดจะแสดงสำหรับมิติข้อมูลที่รวมอยู่ใน Pivot เท่านั้น
metricValues[]

object (MetricValue)

รายการค่าเมตริกที่มองเห็นได้ที่ขอ

DimensionValue

ค่าของมิติข้อมูล

การแสดง JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
ช่อง
ฟิลด์สหภาพ one_value ค่ามิติข้อมูล one_value ประเภทหนึ่ง ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
value

string

ค่าเป็นสตริง หากประเภทมิติข้อมูลเป็นสตริง

MetricValue

ค่าของเมตริก

การแสดง JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
ช่อง
ฟิลด์สหภาพ one_value ค่าเมตริก one_value ค่าใดค่าหนึ่งอาจเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
value

string

ค่าการวัด ดู MetricHeader สำหรับประเภท

FunnelResponseMetadata

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

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

object (SamplingMetadata)

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

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

SamplingMetadata

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

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

string (int64 format)

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

string (int64 format)

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

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

PropertyQuota

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

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

QuotaStatus

สถานะปัจจุบันของกลุ่มโควต้าที่เฉพาะเจาะจง

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

integer

โควต้าที่ใช้โดยคำขอนี้
remaining

integer

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