เอกสารนี้อธิบายไวยากรณ์และข้อควรพิจารณาสำหรับการใช้กลุ่มใน Core Reporting API
เกริ่นนำ
เมื่อใช้ฟีเจอร์การแบ่งกลุ่มของ API การรายงานหลัก คุณจะขอกลุ่มใน API การรายงานหลักได้ 2 วิธี ดังนี้
- กลุ่มตามรหัส: ค้นหาโดยใช้รหัสตัวเลขของกลุ่มในตัวหรือกลุ่มที่กำหนดเอง
- กลุ่มแบบไดนามิก: ระบุกลุ่มแบบไดนามิกในเวลาที่มีการขอ
กลุ่มตามรหัส
คุณขอกลุ่มใน API การรายงานหลักได้โดยใช้รหัสของกลุ่มในตัวหรือกลุ่มที่กำหนดเอง ดึงข้อมูลกลุ่มที่มีอยู่ทั้งหมดสำหรับผู้ใช้ได้โดยใช้เมธอด list ของ
การเก็บรวบรวมกลุ่มใน Google Analytics Management API รหัสของแต่ละกลุ่มจะอยู่ในพร็อพเพอร์ตี้ id ของ
ทรัพยากรกลุ่ม
ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้รหัสกลุ่มในคำขอ API ได้ที่เอกสารอ้างอิงสำหรับ Core Reporting API
กลุ่มแบบไดนามิก
นอกจากนี้ คุณยังสร้างและใช้กลุ่มแบบไดนามิกเมื่อส่งคำขอ API ได้ด้วย โดยปกติแล้ว เมื่อสร้างกลุ่มแบบไดนามิก คุณควรพิจารณาสิ่งต่อไปนี้
การพิจารณาแต่ละรายการสำหรับการสร้างกลุ่มเป้าหมายแบบไดนามิกจะอธิบายไว้ด้านล่างในระดับสูง หากต้องการตรวจสอบไวยากรณ์ที่สมบูรณ์ของกลุ่มแบบไดนามิก โปรดดูการอ้างอิงไวยากรณ์ของกลุ่มแบบไดนามิก
อนุญาตให้ใช้มิติข้อมูลและเมตริกในกลุ่ม
มิติข้อมูลและเมตริกบางรายการไม่สามารถใช้ในกลุ่มได้ หากต้องการดูว่ามิติข้อมูลและเมตริกใดบ้างที่ได้รับอนุญาตในกลุ่ม ให้ไปที่
เครื่องมือสำรวจมิติข้อมูลและเมตริก
1. การเลือกผู้ใช้เทียบกับเซสชัน
ระบุว่าคุณกำลังพยายามเลือกผู้ใช้หรือเซสชัน (หรือทั้ง 2 อย่าง)
- ใช้
users::เพื่อเลือกผู้ใช้ - ใช้
sessions::เพื่อเลือกเซสชัน - หากระบุเงื่อนไขสำหรับทั้ง
users::และsessions::ให้ทำดังนี้- ระบบจะใช้เงื่อนไขผู้ใช้ก่อนเพื่อแสดงผลเซสชันสำหรับผู้ใช้ที่ตรงกัน
- เงื่อนไขเซสชันจะมีผลกับเซสชันจาก #1 เท่านั้น
เช่น
- เลือกผู้ใช้ที่ใช้เบราว์เซอร์ Chrome ในเซสชันของตนอย่างน้อย 1 เซสชัน
users::condition::ga:browser==Chrome
- เลือกเซสชันที่ใช้เบราว์เซอร์ Chrome
sessions::condition::ga:browser==Chrome
- เลือกเซสชันจากตัวเมืองลอนดอนจากผู้ใช้ที่เคยใช้เบราว์เซอร์ Chrome อย่างน้อย 1 เซสชัน
users::condition::ga:browser==Chrome;sessions::condition::ga:city==London
ดูส่วน conditionScope ของข้อมูลอ้างอิงไวยากรณ์เพื่อดูรายละเอียดเกี่ยวกับการเลือกผู้ใช้และเซสชัน
2. การใช้เงื่อนไขเทียบกับลำดับ
เมื่อระบุได้ว่าต้องการแบ่งกลุ่มผู้ใช้หรือเซสชัน ให้ระบุเงื่อนไขและ/หรือลำดับอย่างน้อย 1 รายการ
เงื่อนไข
เงื่อนไขจะใช้คำนำหน้า condition:: เช่น
- เลือกผู้ใช้จากลอนดอนที่เข้าชมโดยใช้เบราว์เซอร์ Chrome
users::condition::ga:city==London;ga:browser==Chrome
ลำดับ
เงื่อนไขลำดับประกอบด้วยขั้นตอนอย่างน้อย 1 ขั้นตอน โดยที่แต่ละขั้นตอนจะกำหนดโดยเงื่อนไขมิติข้อมูล/เมตริกอย่างน้อย 1 รายการ
ระบุเงื่อนไขแบบเรียงลำดับโดยใช้คำนำหน้า sequence:: และโอเปอเรเตอร์ตามด้วย (;–>>) หรือตามด้วย (;–>) ทันที เช่น
- เลือกผู้ใช้ที่ใช้เดสก์ท็อปก่อน แล้วจึงใช้อุปกรณ์เคลื่อนที่ เนื่องจากเรากำลังแบ่งกลุ่มผู้ใช้ การดําเนินการนี้จะค้นหาเซสชันทั้งหมดของผู้ใช้และตรวจสอบว่าผู้ใช้ใช้เดสก์ท็อปในเซสชันหนึ่ง ตามด้วยอุปกรณ์เคลื่อนที่ในเซสชันต่อๆ ไปหรือไม่
-
users::sequence::ga:deviceCategory==desktop;->>ga:deviceCategory==mobile
-
- คุณสามารถใช้เงื่อนไขหลายรายการสำหรับแต่ละขั้นตอนได้ด้วย
-
users::sequence::ga:deviceCategory==desktop;ga:operatingSystem==Windows->>ga:deviceCategory==mobile;ga:operatingSystem==Android
-
- นอกจากนี้ คุณยังรวมเงื่อนไขและลำดับในกลุ่มโดยใช้เครื่องหมาย "และ" (เช่น ";")
-
users::condition::ga:totalEvents>10;sequence::ga:deviceCategory==desktop->>ga:deviceCategory==mobile
-
ดูรายละเอียดเกี่ยวกับเงื่อนไขพื้นฐานและเงื่อนไขตามลำดับได้ที่ส่วน conditionType ของการอ้างอิงไวยากรณ์ ดูตัวอย่างเพิ่มเติมได้ที่ส่วน เงื่อนไขและ ลำดับของ การอ้างอิงฟีเจอร์กลุ่ม
3. การใช้ขอบเขตเมตริก
ขอบเขตสำหรับเมตริกจะกำหนดระดับที่มีการกำหนดเมตริกนั้น ได้แก่ HIT, SESSION หรือ USER เช่น ga:pageviews และ ga:transactions เป็นเมตริกระดับ HIT เนื่องจากเกิดขึ้นใน Hit ขณะที่ ga:sessionDuration และ ga:bounces เป็นเมตริกระดับ SESSION เพราะมีค่าเพียงค่าเดียวต่อเซสชัน
โดยหลักการแล้ว USER คือขอบเขตระดับสูงสุด และ HIT คือขอบเขตระดับต่ำสุด
นอกจากนี้ ยังสามารถรายงานค่าเมตริกในขอบเขตที่มากกว่าขอบเขตหลักได้ด้วย
เช่น คุณสามารถรายงาน ga:pageviews และ ga:transactions ที่ระดับเซสชันและผู้ใช้ได้ โดยเพียงแต่เพิ่มแต่ละรายการสำหรับแต่ละ Hit ที่เกิดขึ้นในเซสชันเหล่านั้นหรือสำหรับผู้ใช้เหล่านั้น
คุณระบุขอบเขตสำหรับเงื่อนไขเมตริกแต่ละรายการได้ ซึ่งจะกำหนดระดับที่จะใช้เงื่อนไขนั้นๆ ขอบเขตเมตริกระบุโดยใช้คำนำหน้า perUser::, perSession:: หรือ perHit::
เช่น
- เลือกผู้ใช้ที่ใช้จ่ายอย่างน้อย 300 บาทบนเว็บไซต์ (เช่น
มูลค่าตลอดอายุการใช้งานของผู้ใช้เท่ากับ 300 บาทเป็นอย่างน้อย)
users::condition::perUser::ga:transactionRevenue>=10
- เลือกผู้ใช้ที่ใช้จ่ายอย่างน้อย $10 ในเซสชัน
users::condition::perSession::ga:transactionRevenue>=10
การจำกัดขอบเขต
Core Reporting API จะตรวจสอบขอบเขตเมตริกเพื่อให้มั่นใจว่าคำค้นหาที่ระบุเป็นคำค้นหาที่ถูกต้อง กฎสำหรับการตรวจสอบขอบเขตมีดังนี้
- ขอบเขตเมตริกที่ระบุต้องเท่ากับหรือต่ำกว่าขอบเขตเงื่อนไขระดับบนสุดเสมอ (ตามที่ระบุไว้โดย
users::หรือคำนำหน้าsessions::) - ขอบเขตเมตริกที่ระบุต้องเท่ากับหรือมากกว่าขอบเขตหลักตามที่ระบุไว้ในโมเดลข้อมูล โปรดดูเมตริก: การอ้างอิงขอบเขตหลักสำหรับรายการเมตริกและขอบเขตหลักทั้งหมด
ตัวอย่างเช่น ขอบเขตเมตริกที่ถูกต้องมีดังนี้
- ทั้งขอบเขตเงื่อนไขและเมตริกเท่ากัน (เช่น ระดับผู้ใช้)
users::condition::perUser::ga:transactionRevenue>10
- ขอบเขตของเงื่อนไขสูงกว่าขอบเขตของเมตริก (เช่น USER > เซสชัน)
users::condition::perSession::ga:transactionRevenue>10
ga:totalEventsเป็นเมตริกระดับ HIT ดังนั้นขอบเขตที่เป็นไปได้ของเงื่อนไขในเงื่อนไขคือperHit::,perSession::หรือperUser::(เนื่องจากทั้งหมดมีค่ามากกว่าหรือเท่ากับขอบเขตระดับ HIT)users::condition::perHit::ga:totalEvents>5users::condition::perSession::ga:totalEvents>5
ตัวอย่างเช่น ขอบเขตเมตริกที่ไม่ถูกต้องมีดังนี้
- กลุ่มต่อไปนี้ไม่ถูกต้องเนื่องจากขอบเขตเงื่อนไขระดับบนสุดต่ำกว่าขอบเขตเมตริก (เช่น เซสชัน < ผู้ใช้)
sessions::condition::perUser::ga:transactionRevenue>10
- การใช้ขอบเขตระดับ HIT สำหรับเมตริกระดับ SESSION และระดับ HIT <
ระดับ SESSION
users::condition::perHit::ga:sessionDuration>60
ขอบเขตเริ่มต้น
เมื่อไม่ได้ระบุขอบเขตสำหรับเงื่อนไขเมตริกไว้อย่างชัดแจ้ง ขอบเขตจะมีค่าเริ่มต้นเป็นขอบเขตของเงื่อนไข เช่น กลุ่มต่อไปนี้จะใช้ขอบเขตระดับผู้ใช้สำหรับเงื่อนไขเมตริกทั้งหมด
users::condition::ga:transactionRevenue>=10;ga:sessionDuration>60
การอ้างอิงไวยากรณ์กลุ่มแบบไดนามิก
ไวยากรณ์ฐาน
ไวยากรณ์ในการกำหนดกลุ่มจะอยู่ในรูปแบบ segment=<segmentCondition>+ กล่าวคือ กลุ่มประกอบด้วยคำสั่ง segmentCondition อย่างน้อย 1 รายการ
<segmentCondition> มีความหมายว่า <conditionScope><conditionType><dimensionOrMetricConditions>
ตำแหน่ง:
conditionScope ระบุขอบเขตระดับบนสุดของเงื่อนไข
conditionType ระบุประเภทของเงื่อนไข
dimensionOrMetricConditions ระบุเงื่อนไขมิติข้อมูล/เมตริกหรือขั้นตอนของลำดับ
conditionScope
ระบุขอบเขตระดับบนสุดของเงื่อนไข ค่าที่เป็นไปได้มีดังนี้
users::สำหรับการเลือกผู้ใช้sessions::เพื่อเลือกเซสชัน
ข้อจำกัดและข้อควรพิจารณาสำหรับ conditionScope
- หากระบุเงื่อนไข "ผู้ใช้" และ "เซสชัน" หลายรายการในกลุ่มเดียว จะต้องรวมเงื่อนไขดังกล่าวด้วยโอเปอเรเตอร์ AND
- เงื่อนไขที่เลือกทั้งผู้ใช้และเซสชันต้องรวมกับโอเปอเรเตอร์ AND ด้วย เมื่อระบุเงื่อนไขสำหรับทั้งผู้ใช้และเซสชันแล้ว ระบบจะใช้เงื่อนไขผู้ใช้ทั้งหมดก่อนเพื่อหาผู้ใช้ที่ตรงกัน ตามด้วยเงื่อนไขเซสชันทั้งหมดในเซสชันที่เป็นของผู้ใช้ที่ตรงกันเหล่านั้น
- หากใช้เงื่อนไขระดับผู้ใช้ ช่วงวันที่ต้องไม่เกิน 90 วัน
- ขอบเขตของเงื่อนไขยังกําหนดระดับขอบเขตเริ่มต้นสำหรับเงื่อนไขเมตริกทั้งหมดที่อยู่ภายใต้ขอบเขตนั้นด้วย (ดูรายละเอียดเพิ่มเติมเกี่ยวกับระดับขอบเขตได้ที่ เมตริก: การอ้างอิงขอบเขตหลัก)
conditionType
ระบุประเภทของเงื่อนไข ค่าที่เป็นไปได้มีดังนี้
condition::สำหรับการระบุเงื่อนไขอย่างง่าย (กล่าวคือ ไม่เรียงตามลำดับ)sequence::สำหรับการระบุเงื่อนไขตามลำดับ
ข้อจำกัดและข้อควรพิจารณาสำหรับ conditionType
- หากมีการระบุ "เงื่อนไขแบบง่าย" และ "ลำดับ" หลายรายการ เงื่อนไขเหล่านั้นจะต้องรวมกับโอเปอเรเตอร์ AND เสมอ
- อนุญาตให้มีขั้นตอนสูงสุด 10 ขั้นตอนสำหรับเงื่อนไขตามลำดับต่อกลุ่ม
เงื่อนไข
เงื่อนไขทั่วไปประกอบด้วยเงื่อนไขมิติข้อมูล/เมตริกอย่างน้อย 1 ข้อที่รวมกันได้
โอเปอเรเตอร์เงื่อนไขที่ถูกต้องสำหรับเงื่อนไขพื้นฐานมีดังนี้
- การรวมเงื่อนไขด้วยโอเปอเรเตอร์ AND หรือ OR
- โอเปอเรเตอร์มิติข้อมูลและเมตริก
ไวยากรณ์สำหรับเงื่อนไขทั่วไปมีดังนี้
condition::<dimensionOrMetricConditions>
ตัวอย่างเงื่อนไขทั่วไป
users::condition::ga:transactionRevenue>10;ga:sessionDuration>60- คุณระบุโอเปอเรเตอร์นิเสธระดับบนสุดเพื่อหาส่วนเสริมของเงื่อนไขง่ายๆ ที่ระบุได้ ซึ่งอาจมีเงื่อนไขมิติข้อมูล/เมตริกหลายรายการอยู่ภายใน เช่น
users::condition::!ga:transactionRevenue>10;ga:sessionDuration>60
การยกเว้นเงื่อนไข
เงื่อนไขการยกเว้นใช้เพื่อสร้างกลุ่มที่ไม่เป็นไปตามเงื่อนไขที่กําหนด
ไวยากรณ์จะใช้โอเปอเรเตอร์ NOT (อักขระ !) เพื่อลบล้างเงื่อนไขและยกเว้นเซสชันที่ตรงกับเงื่อนไขนั้น
ยกเว้นเซสชันที่หน้าที่ออกตรงทุกประการกับ
เส้นทางของหน้าหลัก:
sessions::condition::!ga:exitPagePath==/
หลายเงื่อนไข
คุณจะจัดกลุ่มเงื่อนไขระดับผู้ใช้ทั้งหมดภายใต้คำนำหน้า users:: รายการเดียว หรือจะใช้คำนำหน้า users:: แยกต่างหากสำหรับแต่ละเงื่อนไขก็ได้ เงื่อนไขระดับเซสชันก็เช่นเดียวกัน
ตัวอย่างเช่น กลุ่มต่อไปนี้เทียบเท่ากัน ในทั้ง 2 กรณี
condition1 และ condition2
ได้รับการANDแสดงแก่ผู้ใช้บางรายดังนี้
users::<condition1>;<condition2>
users::<condition1>users::<condition2>
เงื่อนไขของลำดับ
เงื่อนไขลำดับประกอบด้วยขั้นตอนอย่างน้อย 1 ขั้นตอน โดยแต่ละขั้นตอนจะได้รับการกำหนดโดยเงื่อนไขมิติข้อมูล/เมตริกอย่างน้อย 1 รายการ คุณใช้หลายขั้นตอนร่วมกับโอเปอเรเตอร์ลำดับพิเศษได้
โอเปอเรเตอร์ลำดับที่ถูกต้องสำหรับเงื่อนไขลำดับมีดังนี้
- โอเปอเรเตอร์
–>>บ่งบอกว่าขั้นตอนก่อนหน้าอยู่ก่อนขั้นตอนถัดไป - โอเปอเรเตอร์
–>บ่งบอกว่าขั้นตอนก่อนหน้าอยู่ก่อนขั้นตอนถัดไปทันที
ไวยากรณ์สำหรับเงื่อนไขลำดับคือ
sequence:: NOT? FIRST_HIT_MATCHES_FIRST_STEP?
ที่ไหน:
NOT แทนด้วย: !FIRST_HIT_MATCHES_FIRST_STEP แทนด้วย: ^PRECEDES แทนด้วย: ;–>>IMMEDIATELY_PRECEDES แทนด้วย: ;–>step แทนด้วย: <dimensionOrMetricConditions>
ตัวอย่างเงื่อนไขของลำดับ
-
users::sequence::ga:deviceCategory==desktop;->ga:deviceCategory==tablet - หรือจะระบุโอเปอเรเตอร์นิเสธระดับบนสุดเพื่อหาส่วนเสริมของลำดับหนึ่งๆ ได้ด้วย ซึ่งอาจมีหลายขั้นตอนและ/หรือเงื่อนไขมิติข้อมูล/เมตริกอยู่ภายใน เช่น
users::sequence::!ga:deviceCategory==desktop;->ga:deviceCategory==tablet - คุณใช้โอเปอเรเตอร์
^ได้เพื่อระบุว่าขั้นตอนแรกตรงกับ Hit แรกของเซสชันแรกในช่วงวันที่ที่ระบุ เช่นusers::sequence::^ga:deviceCategory==desktop;->ga:deviceCategory==tablet
วันที่เกิดเงื่อนไขเซสชัน
กลุ่มรองรับการวิเคราะห์ประเภทที่ใช้ไวยากรณ์ dateOfSession เมื่อใช้ร่วมกับโอเปอเรเตอร์ระหว่าง <> คุณจะจำกัดกลุ่มไว้เฉพาะกลุ่มผู้ใช้ที่เริ่มเซสชันภายในช่วงวันที่ที่ต้องการได้ ช่วงวันที่สูงสุดสำหรับ dateOfSession คือ 31 วัน โปรดดูรายละเอียดเกี่ยวกับการใช้งานในตัวอย่างวันที่ของเซสชันด้านล่าง
เงื่อนไขของมิติข้อมูลและเมตริก
การรวมเงื่อนไข
คุณรวมเงื่อนไขมิติข้อมูลอย่างน้อย 1 รายการกับ AND ได้ (เช่น ";") และ OR (เช่น ",") ที่มีโอเปอเรเตอร์ OR มีลำดับความสำคัญสูงกว่า
ไวยากรณ์จะเหมือนกับสิ่งที่ใช้รวมตัวกรอง ดูรายละเอียดได้ที่การรวมตัวกรองในข้อมูลอ้างอิง API การรายงานหลัก
โอเปอเรเตอร์
ตารางด้านล่างอธิบายโอเปอเรเตอร์ที่ใช้ได้ทั้งหมดซึ่งใช้ในกลุ่มได้ และระบุว่าโอเปอเรเตอร์เหล่านั้นรองรับมิติข้อมูลและ/หรือเมตริกหรือไม่
| ผู้ประกอบธุรกิจ | คำอธิบาย | เงื่อนไขมิติข้อมูลรองรับไหม | รองรับในเงื่อนไขเมตริกไหม |
|---|---|---|---|
== |
การทำงานแบบตรงทั้งหมดหรือเท่ากับ | ได้ เช่น ga:city==London |
ได้ เช่น ga:adCost==10 |
!= |
ไม่เท่ากับหรือไม่ใช่รายการที่ตรงกันทั้งหมด | ได้ เช่น ga:city!=London |
ได้ เช่น ga:adCost!=10 |
< |
น้อยกว่า | ใช่ (สำหรับค่าตัวเลขเท่านั้น) เช่น ga:hour<12 |
ได้ เช่น ga:adCost<10 |
<= |
น้อยกว่าหรือเท่ากับ | ใช่ (สำหรับค่าตัวเลขเท่านั้น) เช่น ga:hour<=12 |
ได้ เช่น ga:adCost<=10 |
> |
มากกว่า | ใช่ (สำหรับค่าตัวเลขเท่านั้น) เช่น ga:hour>12 |
ได้ เช่น ga:adCost>10 |
>= |
มากกว่าหรือเท่ากับ | ใช่ (สำหรับค่าตัวเลขเท่านั้น) เช่น ga:hour>=12 |
ได้ เช่น ga:adCost>=10 |
<> |
ระหว่าง (ค่าอยู่ระหว่างช่วงที่ระบุ)1 | ใช่ (สำหรับค่าตัวเลขเท่านั้น) เช่น ga:hour<>1_12 |
ได้ เช่น ga:adCost<>10_20 |
[] |
ในรายการ (ค่าเป็นหนึ่งในค่าที่ระบุ)2 | ได้ เช่น ga:browser[]Chrome|Firefox|Opera |
ไม่ได้ |
=@ |
มีสตริงย่อย | ได้ เช่น ga:keyword=@shoes |
ไม่ได้ |
!@ |
ไม่มีสตริงย่อย | ได้ เช่น ga:keyword!@shoes |
ไม่ได้ |
=~ |
มีการจับคู่สำหรับนิพจน์ทั่วไป | ได้ เช่น ga:keyword=~shoes |
ไม่ได้ |
!~ |
ไม่มีรายการที่ตรงกันสำหรับนิพจน์ทั่วไป | ได้ เช่น ga:keyword!~shoes |
ไม่ได้ |
1ระหว่างโอเปอเรเตอร์ <>
อนุญาตให้คุณค้นหาค่าภายในช่วงหนึ่งๆ ค่าของช่วงจะรวมไว้ และใช้ได้กับทั้งเมตริกและมิติข้อมูลที่มีค่าตัวเลข (เช่น ga:hour) ค่าต่ำสุดและสูงสุดในช่วงต้องคั่นด้วยขีดล่าง
ไวยากรณ์:{dimensionOrMetricName}<>{minValue}_{maxValue}
ตัวอย่าง:
เลือกเซสชันที่เกิดขึ้นระหว่างวันที่ 12 ถึง 23
sessions::condition::ga:hour<>12_23
2ในโอเปอเรเตอร์รายการ []
ช่วยให้คุณค้นหาค่าจากรายการที่ระบุได้ ใช้ได้กับมิติข้อมูลเท่านั้น รายการค่าต้องคั่นด้วยอักขระ "|" หากมี "|" อยู่ในค่า ค่านั้นต้องกำหนดเป็นอักขระหลีก
ไวยากรณ์:{dimensionName}[]{value1}|{value2}|...
ข้อจำกัด:
อนุญาตให้มีค่าได้สูงสุด 10 ค่าต่อเงื่อนไขมิติข้อมูลแบบในรายการ (เช่น ga:city[]city1|city2|...|city10)
ตัวอย่าง:
เลือกเซสชันที่มาจากเบราว์เซอร์ Chrome, Firefox หรือ Operasessions::condition::ga:browser[]Chrome|Firefox|Opera
การกำหนดสัญลักษณ์พิเศษเป็นอักขระหลีก
ต้อง Escape สัญลักษณ์พิเศษ "," และ ";" หากอยู่ภายในนิพจน์ค่า เช่น
ga:keyword==nike\,shoes
ดูรายละเอียดเพิ่มเติมเกี่ยวกับเงื่อนไขมิติข้อมูลและเมตริกได้ที่ เอกสารอ้างอิงสำหรับ API การรายงานหลัก
ข้อจำกัด
ข้อจำกัดที่เกี่ยวข้องกับเงื่อนไขมิติข้อมูลและเมตริกมีดังนี้
- มีเงื่อนไขมิติข้อมูลหรือเมตริกได้สูงสุด 10 รายการต่อกลุ่ม
- ความยาวนิพจน์สูงสุดสำหรับเงื่อนไขมิติข้อมูลคือ 1,024 อักขระ
การย้ายข้อมูลกลุ่มแบบไดนามิกเดิม
กลุ่มแบบไดนามิกเดิมที่ใช้คํานําหน้า dynamic:: เทียบเท่ากับกลุ่มระดับเซสชันที่มีเงื่อนไขมิติข้อมูลและเมตริกในไวยากรณ์ปัจจุบัน หากใช้กลุ่มแบบไดนามิกเดิม คุณควรย้ายข้อมูลไปยังไวยากรณ์ใหม่โดยแทนที่คำนำหน้า dynamic:: ด้วยคำนำหน้า sessions::condition:: ตัวอย่างเช่น กลุ่ม 2 กลุ่มด้านล่างนี้เทียบเท่ากัน
dynamic::ga:browser==Chrome
เท่ากับ:
sessions::condition::ga:browser==Chrome
ตัวอย่างกลุ่ม
1. ข้อมูลประชากร: ภาษาเพศชายเป็นอังกฤษ (EN-US) สนใจเกม และมาจากอเมริกา
ใช้กลุ่มตามผู้ใช้ก่อน ดังนั้น เงื่อนไขที่อิงตามผู้ใช้จึงแสดงผลเป็นผู้ใช้ที่เป็นผู้ชายและสนใจเกม จากนั้นเซสชันของผู้ใช้เหล่านี้จะอยู่ภายใต้เงื่อนไขตามเซสชันเพื่อให้ได้เซสชันที่มาจากอเมริกาและใช้ภาษา EN-US
users::condition::ga:userGender==Male;users::condition::ga:interestAffinityCategory==Games
;
sessions::condition::ga:region==Americas;sessions::condition::ga:language==en-u
2. พฤติกรรม: ผู้ใช้ที่มีเซสชันมากกว่า 100 เซสชัน ไม่ได้เข้าชมในช่วง 7 วันที่ผ่านมา ทำธุรกรรมมากกว่า 2 รายการต่อเซสชัน และใช้เวลาในเว็บไซต์นานกว่า 100 วินาทีต่อเซสชัน
users::condition::ga:sessions>100;ga:daysSinceLastSession>=7;
perSession::ga:transactions>2;perSession::ga:sessionDuration>100
3. เซสชัน: เลือกเซสชันที่มีเบราว์เซอร์เป็น Chrome, ประเทศเป็นสหรัฐอเมริกา และข้อยกเว้นต่อ Hit > 1 และเลือกผู้ใช้ที่ออกต่อเซสชัน < 2
sessions::condition::ga:browser==Chrome;ga:country==US;perHit::ga:exceptions>1;
users::condition::perSession::ga:exits<2
4. เซสชันที่มีลำดับ: เลือกเซสชันที่มีขั้นตอน: Chrome และเหตุการณ์ทั้งหมดต่อ Hit > 5 และเลือกผู้ใช้ด้วยขั้นตอน: บนเดสก์ท็อป ตามขั้นตอน: ในอุปกรณ์เคลื่อนที่
sessions::sequence::ga:browser==Chrome;condition::perHit::ga:totalEvents>5;users::sequence::ga:deviceCategory==desktop->>ga:deviceCategory=mobile
5. วันที่เกิดเซสชัน: เลือกผู้ใช้ที่มีเซสชันแรกระหว่างวันที่ 20 พฤษภาคม 2014 ถึง 30 พฤษภาคม 2014 และใช้เวลาบนเว็บไซต์มากกว่า 600 วินาที
users::sequence::^ga:sessionCount==1;dateOfSession<>2014-05-20_2014-05-30;->>ga:sessionDurationBucket>600
เมตริก: การอ้างอิงขอบเขตหลัก
| เมตริก | ขอบเขตหลัก |
|---|---|
ga:adClicks | จั่วไพ่ |
ga:adCost | จั่วไพ่ |
ga:adsenseAdsClicks | จั่วไพ่ |
ga:adsenseAdsViewed | จั่วไพ่ |
ga:adsenseAdUnitsViewed | จั่วไพ่ |
ga:adsenseCTR | จั่วไพ่ |
ga:adsenseECPM | จั่วไพ่ |
ga:adsensePageImpressions | จั่วไพ่ |
ga:adsenseRevenue | จั่วไพ่ |
ga:avgDomainLookupTime | จั่วไพ่ |
ga:avgDomContentLoadedTime | จั่วไพ่ |
ga:avgDomInteractiveTime | จั่วไพ่ |
ga:avgEventValue | จั่วไพ่ |
ga:avgPageDownloadTime | จั่วไพ่ |
ga:avgPageLoadTime | จั่วไพ่ |
ga:avgRedirectionTime | จั่วไพ่ |
ga:avgScreenviewDuration | จั่วไพ่ |
ga:avgSearchDepth | จั่วไพ่ |
ga:avgSearchDuration | จั่วไพ่ |
ga:avgSearchResultViews | จั่วไพ่ |
ga:avgServerConnectionTime | จั่วไพ่ |
ga:avgServerResponseTime | จั่วไพ่ |
ga:avgUserTimingValue | จั่วไพ่ |
ga:costPerConversion | จั่วไพ่ |
ga:costPerGoalConversion | จั่วไพ่ |
ga:costPerTransaction | จั่วไพ่ |
ga:CPC | จั่วไพ่ |
ga:CPM | จั่วไพ่ |
ga:CTR | จั่วไพ่ |
ga:domainLookupTime | จั่วไพ่ |
ga:domContentLoadedTime | จั่วไพ่ |
ga:domInteractiveTime | จั่วไพ่ |
ga:domLatencyMetricsSample | จั่วไพ่ |
ga:eventValue | จั่วไพ่ |
ga:exceptions | จั่วไพ่ |
ga:exceptionsPerScreenview | จั่วไพ่ |
ga:fatalExceptions | จั่วไพ่ |
ga:fatalExceptionsPerScreenview | จั่วไพ่ |
ga:goalAbandonRateAll | จั่วไพ่ |
ga:goalAbandonsAll | จั่วไพ่ |
ga:goalCompletionsAll | จั่วไพ่ |
ga:goalStartsAll | จั่วไพ่ |
ga:goalValueAll | จั่วไพ่ |
ga:goalValueAllPerSearch | จั่วไพ่ |
ga:goalXXAbandonRate | จั่วไพ่ |
ga:goalXXAbandons | จั่วไพ่ |
ga:goalXXCompletions | จั่วไพ่ |
ga:goalXXStarts | จั่วไพ่ |
ga:goalXXValue | จั่วไพ่ |
ga:impressions | จั่วไพ่ |
ga:itemQuantity | จั่วไพ่ |
ga:itemRevenue | จั่วไพ่ |
ga:itemsPerPurchase | จั่วไพ่ |
ga:localItemRevenue | จั่วไพ่ |
ga:localTransactionRevenue | จั่วไพ่ |
ga:localTransactionShipping | จั่วไพ่ |
ga:localTransactionTax | จั่วไพ่ |
ga:margin | จั่วไพ่ |
ga:metricXX | จั่วไพ่ |
ga:pageDownloadTime | จั่วไพ่ |
ga:pageLoadSample | จั่วไพ่ |
ga:pageLoadTime | จั่วไพ่ |
ga:pageValue | จั่วไพ่ |
ga:pageviews | จั่วไพ่ |
ga:percentSearchRefinements | จั่วไพ่ |
ga:redirectionTime | จั่วไพ่ |
ga:revenuePerItem | จั่วไพ่ |
ga:revenuePerTransaction | จั่วไพ่ |
ga:ROI | จั่วไพ่ |
ga:RPC | จั่วไพ่ |
ga:screenviews | จั่วไพ่ |
ga:searchDepth | จั่วไพ่ |
ga:searchDuration | จั่วไพ่ |
ga:searchGoalConversionRateAll | จั่วไพ่ |
ga:searchGoalXXConversionRate | จั่วไพ่ |
ga:searchRefinements | จั่วไพ่ |
ga:searchResultViews | จั่วไพ่ |
ga:searchUniques | จั่วไพ่ |
ga:serverConnectionTime | จั่วไพ่ |
ga:serverResponseTime | จั่วไพ่ |
ga:socialActivities | จั่วไพ่ |
ga:socialInteractions | จั่วไพ่ |
ga:socialInteractionsPerSession | จั่วไพ่ |
ga:speedMetricsSample | จั่วไพ่ |
ga:timeOnScreen | จั่วไพ่ |
ga:totalEvents | จั่วไพ่ |
ga:totalValue | จั่วไพ่ |
ga:transactionRevenue | จั่วไพ่ |
ga:transactions | จั่วไพ่ |
ga:transactionShipping | จั่วไพ่ |
ga:transactionTax | จั่วไพ่ |
ga:uniqueAppviews | จั่วไพ่ |
ga:uniqueEvents | จั่วไพ่ |
ga:uniquePageviews | จั่วไพ่ |
ga:uniquePurchases | จั่วไพ่ |
ga:uniqueScreenviews | จั่วไพ่ |
ga:uniqueSocialInteractions | จั่วไพ่ |
ga:userTimingSample | จั่วไพ่ |
ga:userTimingValue | จั่วไพ่ |
ga:adsenseExits | เซสชัน |
ga:avgTimeOnPage | เซสชัน |
ga:avgSessionDuration | เซสชัน |
ga:bounces | เซสชัน |
ga:entranceBounceRate | เซสชัน |
ga:entranceRate | เซสชัน |
ga:entrances | เซสชัน |
ga:eventsPerSessionWithEvent | เซสชัน |
ga:exitRate | เซสชัน |
ga:exits | เซสชัน |
ga:goalConversionRateAll | เซสชัน |
ga:goalValuePerSession | เซสชัน |
ga:goalXXConversionRate | เซสชัน |
ga:organicSearches | เซสชัน |
ga:pageviewsPerSession | เซสชัน |
ga:percentSessionsWithSearch | เซสชัน |
ga:screenviewsPerSession | เซสชัน |
ga:searchExitRate | เซสชัน |
ga:searchExits | เซสชัน |
ga:searchSessions | เซสชัน |
ga:sessionDuration | เซสชัน |
ga:transactionRevenuePerSession | เซสชัน |
ga:transactionsPerSession | เซสชัน |
ga:bounceRate | เซสชัน |
ga:sessions | เซสชัน |
ga:sessionsWithEvent | เซสชัน |
ga:newSessions | ผู้ใช้ |
ga:percentNewSessions | ผู้ใช้ |
ga:users | ผู้ใช้ |