- แหล่งข้อมูล: กลุ่มเป้าหมาย
- AudienceEventTrigger
- LogCondition
- AudienceExclusionDurationMode
- AudienceFilterClause
- AudienceSimpleFilter
- AudienceFilterScope
- AudienceFilterExpression
- AudienceFilterExpressionList
- AudienceDimensionOrMetricFilter
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- การดำเนินการ
- NumericValue
- BetweenFilter
- AudienceEventFilter
- AudienceSequenceFilter
- AudienceSequenceStep
- AudienceClauseType
- เมธอด
แหล่งข้อมูล: กลุ่มเป้าหมาย
ข้อความทรัพยากรที่แสดงถึงกลุ่มเป้าหมาย
| การแสดง JSON |
|---|
{ "name": string, "displayName": string, "description": string, "membershipDurationDays": integer, "adsPersonalizationEnabled": boolean, "eventTrigger": { object ( |
| ช่อง | |
|---|---|
name |
เอาต์พุตเท่านั้น ชื่อทรัพยากรสำหรับทรัพยากรกลุ่มเป้าหมายนี้ รูปแบบ: properties/{propertyId}/audiences/{audienceId} |
displayName |
ต้องระบุ ชื่อที่แสดงของกลุ่มเป้าหมาย |
description |
ต้องระบุ คำอธิบายของกลุ่มเป้าหมาย |
membershipDurationDays |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ระยะเวลาที่ผู้ใช้ควรอยู่ในกลุ่มเป้าหมาย โดยจะตั้งค่าได้ไม่เกิน 540 วัน |
adsPersonalizationEnabled |
เอาต์พุตเท่านั้น GA จะตั้งค่าเป็น false โดยอัตโนมัติหากเป็นกลุ่มเป้าหมาย NPA และได้รับการยกเว้นจากการปรับโฆษณาตามโปรไฟล์ของผู้ใช้ |
eventTrigger |
ไม่บังคับ ระบุเหตุการณ์ที่จะบันทึกเมื่อผู้ใช้เข้าร่วมกลุ่มเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะไม่บันทึกเหตุการณ์เมื่อผู้ใช้เข้าร่วมกลุ่มเป้าหมาย |
exclusionDurationMode |
เปลี่ยนแปลงไม่ได้ ระบุระยะเวลาที่การยกเว้นจะมีผลสำหรับผู้ใช้ที่ตรงกับตัวกรองการยกเว้น โดยจะใช้กับทุกข้อความในตัวกรอง "ยกเว้น" และจะละเว้นเมื่อไม่มีข้อความในตัวกรอง "ยกเว้น" ในกลุ่มเป้าหมาย |
filterClauses[] |
ต้องระบุ เปลี่ยนแปลงไม่ได้ รายการที่ไม่เรียงลำดับ กลไกการกรองที่กำหนดกลุ่มเป้าหมาย ระบบจะรวมทุกข้อเข้าด้วยกัน |
createTime |
เอาต์พุตเท่านั้น เวลาที่สร้างกลุ่มเป้าหมาย ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
AudienceEventTrigger
ระบุเหตุการณ์ที่จะบันทึกเมื่อผู้ใช้เข้าร่วมกลุ่มเป้าหมาย
| การแสดง JSON |
|---|
{
"eventName": string,
"logCondition": enum ( |
| ช่อง | |
|---|---|
eventName |
ต้องระบุ ชื่อเหตุการณ์ที่จะบันทึก |
logCondition |
ต้องระบุ เมื่อใดที่ควรบันทึกเหตุการณ์ |
LogCondition
กำหนดเวลาที่จะบันทึกเหตุการณ์
| Enum | |
|---|---|
LOG_CONDITION_UNSPECIFIED |
ไม่ได้ระบุเงื่อนไขของบันทึก |
AUDIENCE_JOINED |
ควรบันทึกเหตุการณ์เมื่อผู้ใช้เข้าร่วมเท่านั้น |
AUDIENCE_MEMBERSHIP_RENEWED |
ระบบควรบันทึกเหตุการณ์ทุกครั้งที่มีการปฏิบัติตามเงื่อนไขกลุ่มเป้าหมาย แม้ว่าผู้ใช้จะเป็นสมาชิกของกลุ่มเป้าหมายอยู่แล้วก็ตาม |
AudienceExclusionDurationMode
ระบุระยะเวลาที่การยกเว้นจะมีผลสำหรับผู้ใช้ที่ตรงกับตัวกรองการยกเว้น
| Enum | |
|---|---|
AUDIENCE_EXCLUSION_DURATION_MODE_UNSPECIFIED |
ไม่ได้ระบุ |
EXCLUDE_TEMPORARILY |
ยกเว้นผู้ใช้จากกลุ่มเป้าหมายในช่วงเวลาที่ผู้ใช้มีคุณสมบัติตรงตามกลไกการกรอง |
EXCLUDE_PERMANENTLY |
ยกเว้นผู้ใช้จากกลุ่มเป้าหมายหากผู้ใช้เคยมีคุณสมบัติตรงตามกลไกการกรอง |
AudienceFilterClause
วลีสำหรับกำหนดตัวกรองแบบง่ายหรือตัวกรองลำดับ ตัวกรองอาจเป็นแบบรวม (เช่น ระบบจะรวมผู้ใช้ที่ตรงตามอนุประโยคตัวกรองไว้ในกลุ่มเป้าหมาย) หรือแบบยกเว้น (เช่น ระบบจะยกเว้นผู้ใช้ที่ตรงตามอนุประโยคตัวกรองออกจากกลุ่มเป้าหมาย)
| การแสดง JSON |
|---|
{ "clauseType": enum ( |
| ช่อง | |
|---|---|
clauseType |
ต้องระบุ ระบุว่านี่คือเงื่อนไขตัวกรองรวมหรือยกเว้น |
ฟิลด์ Union
|
|
simpleFilter |
ตัวกรองแบบง่ายที่ผู้ใช้ต้องมีคุณสมบัติตรงตามจึงจะเป็นสมาชิกของกลุ่มเป้าหมายได้ |
sequenceFilter |
ตัวกรองที่ต้องเกิดขึ้นตามลำดับที่เฉพาะเจาะจงเพื่อให้ผู้ใช้เป็นสมาชิกของกลุ่มเป้าหมาย |
AudienceSimpleFilter
กำหนดตัวกรองอย่างง่ายที่ผู้ใช้ต้องมีเพื่อให้เป็นสมาชิกของกลุ่มเป้าหมาย
| การแสดง JSON |
|---|
{ "scope": enum ( |
| ช่อง | |
|---|---|
scope |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุขอบเขตสําหรับตัวกรองนี้ |
filterExpression |
ต้องระบุ เปลี่ยนแปลงไม่ได้ นิพจน์เชิงตรรกะของตัวกรองมิติข้อมูล เมตริก หรือเหตุการณ์ของกลุ่มเป้าหมาย |
AudienceFilterScope
ระบุวิธีประเมินผู้ใช้เพื่อเข้าร่วมกลุ่มเป้าหมาย
| Enum | |
|---|---|
AUDIENCE_FILTER_SCOPE_UNSPECIFIED |
ไม่ได้ระบุขอบเขต |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_EVENT |
ผู้ใช้จะเข้าร่วมกลุ่มเป้าหมายหากตรงตามเงื่อนไขตัวกรองภายในเหตุการณ์เดียว |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_SESSION |
ผู้ใช้จะเข้าร่วมกลุ่มเป้าหมายหากตรงตามเงื่อนไขตัวกรองภายในเซสชันเดียว |
AUDIENCE_FILTER_SCOPE_ACROSS_ALL_SESSIONS |
ผู้ใช้จะเข้าร่วมกลุ่มเป้าหมายหากเหตุการณ์ใดก็ตามในเซสชันใดก็ตามเป็นไปตามเงื่อนไขตัวกรอง |
AudienceFilterExpression
นิพจน์เชิงตรรกะของตัวกรองมิติข้อมูล เมตริก หรือเหตุการณ์ของกลุ่มเป้าหมาย
| การแสดง JSON |
|---|
{ // Union field |
| ช่อง | |
|---|---|
ฟิลด์ Union expr นิพจน์ที่ใช้กับตัวกรอง expr ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
andGroup |
รายการนิพจน์ที่จะรวมกันด้วย AND โดยจะมีได้เฉพาะ AudienceFilterExpressions ที่มี orGroup ต้องตั้งค่านี้สําหรับ AudienceFilterExpression ระดับบนสุด |
orGroup |
รายการนิพจน์ที่จะรวมกันด้วย OR โดยต้องไม่มี AudienceFilterExpressions ที่มี andGroup หรือ orGroup |
notExpression |
นิพจน์ตัวกรองที่จะใช้ NOT (เช่น กลับด้าน เสริม) โดยจะรวมได้เฉพาะ DimensionOrMetricFilter เท่านั้น ตั้งค่านี้ใน AudienceFilterExpression ระดับบนสุดไม่ได้ |
dimensionOrMetricFilter |
ตัวกรองในมิติข้อมูลหรือเมตริกเดียว ตั้งค่านี้ใน AudienceFilterExpression ระดับบนสุดไม่ได้ |
eventFilter |
สร้างตัวกรองที่ตรงกับเหตุการณ์ที่เฉพาะเจาะจง ตั้งค่านี้ใน AudienceFilterExpression ระดับบนสุดไม่ได้ |
AudienceFilterExpressionList
รายการนิพจน์ตัวกรองกลุ่มเป้าหมาย
| การแสดง JSON |
|---|
{
"filterExpressions": [
{
object ( |
| ช่อง | |
|---|---|
filterExpressions[] |
รายการนิพจน์ตัวกรองกลุ่มเป้าหมาย |
AudienceDimensionOrMetricFilter
ตัวกรองที่เฉพาะเจาะจงสําหรับมิติข้อมูลหรือเมตริกรายการเดียว
| การแสดง JSON |
|---|
{ "fieldName": string, "atAnyPointInTime": boolean, "inAnyNDayPeriod": integer, // Union field |
| ช่อง | |
|---|---|
fieldName |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ชื่อมิติข้อมูลหรือชื่อเมตริกที่จะกรอง หากชื่อฟิลด์อ้างอิงถึงมิติข้อมูลที่กําหนดเองหรือเมตริกที่กําหนดเอง ระบบจะเพิ่มคํานําหน้าขอบเขตไว้ที่ด้านหน้าชื่อมิติข้อมูลที่กําหนดเองหรือเมตริกที่กําหนดเอง ดูข้อมูลเพิ่มเติมเกี่ยวกับคำนำหน้าขอบเขตหรือมิติข้อมูล/เมตริกที่กำหนดเองได้ในเอกสารประกอบ Data API ของ Google Analytics |
atAnyPointInTime |
ไม่บังคับ ระบุว่าตัวกรองนี้ต้องมีการประเมินแบบไดนามิกหรือไม่ หากตั้งค่าเป็นจริง ผู้ใช้จะเข้าร่วมกลุ่มเป้าหมายหากมีคุณสมบัติตรงตามเงื่อนไขไม่ว่าตอนไหนก็ตาม (การประเมินแบบคงที่) หากไม่ได้ตั้งค่าหรือตั้งค่าเป็น "เท็จ" การประเมินผู้ใช้สำหรับกลุ่มเป้าหมายจะเป็นแบบไดนามิก กล่าวคือระบบจะรวมเอาผู้ใช้ที่มีคุณสมบัติตรงกับเงื่อนไขเข้าไปด้วย และเมื่อใดก็ตามที่ผู้ใช้ดังกล่าวมีคุณสมบัติไม่เข้าเงื่อนไข ระบบก็จะนำออกจากกลุ่มเป้าหมาย คุณจะตั้งค่านี้ได้ก็ต่อเมื่อขอบเขตกลุ่มเป้าหมายเป็น ACROSS_ALL_SESSIONS เท่านั้น |
inAnyNDayPeriod |
ไม่บังคับ หากตั้งค่าไว้ จะระบุกรอบเวลาที่จะประเมินข้อมูลเป็นจำนวนวัน หากไม่ได้ตั้งค่า ระบบจะประเมินข้อมูลกลุ่มเป้าหมายเทียบกับข้อมูลตลอดอายุการใช้งาน (เช่น กรอบเวลาที่ไม่มีที่สิ้นสุด) เช่น หากตั้งค่าเป็น 1 วัน ระบบจะประเมินเฉพาะข้อมูลของวันปัจจุบัน จุดอ้างอิงคือวันที่ปัจจุบันเมื่อไม่ได้ตั้งค่าหรือเป็นเท็จสำหรับ atAnyPointInTime โดยจะตั้งค่าได้ก็ต่อเมื่อขอบเขตกลุ่มเป้าหมายเป็น ACROSS_ALL_SESSIONS และต้องไม่เกิน 60 วัน |
ฟิลด์ Union one_filter ตัวกรองใดตัวกรองหนึ่งข้างต้น one_filter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
stringFilter |
ตัวกรองสำหรับมิติข้อมูลประเภทสตริงที่ตรงกับรูปแบบที่เฉพาะเจาะจง |
inListFilter |
ตัวกรองสำหรับมิติข้อมูลสตริงที่ตรงกับรายการตัวเลือกที่เฉพาะเจาะจง |
numericFilter |
ตัวกรองสำหรับค่าตัวเลขหรือค่าวันที่ในมิติข้อมูลหรือเมตริก |
betweenFilter |
ตัวกรองสำหรับค่าตัวเลขหรือวันที่ระหว่างค่าที่แน่นอนในมิติข้อมูลหรือเมตริก |
StringFilter
ตัวกรองสำหรับมิติข้อมูลประเภทสตริงที่ตรงกับรูปแบบที่เฉพาะเจาะจง
| การแสดง JSON |
|---|
{
"matchType": enum ( |
| ช่อง | |
|---|---|
matchType |
ต้องระบุ ประเภทการทำงานของตัวกรองสตริง |
value |
ต้องระบุ ค่าสตริงที่จะจับคู่ |
caseSensitive |
ไม่บังคับ หากจริง การจับคู่จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ หากเป็น "เท็จ" การจับคู่จะไม่คำนึงถึงตัวพิมพ์เล็กหรือใหญ่ |
MatchType
ประเภทการทำงานของตัวกรองสตริง
| Enum | |
|---|---|
MATCH_TYPE_UNSPECIFIED |
ไม่ระบุ |
EXACT |
การทำงานแบบตรงทั้งหมดของค่าสตริง |
BEGINS_WITH |
ขึ้นต้นด้วยค่าสตริง |
ENDS_WITH |
ลงท้ายด้วยค่าสตริง |
CONTAINS |
มีค่าสตริง |
FULL_REGEXP |
นิพจน์ทั่วไปที่ตรงกันทั้งหมดกับค่าสตริง |
InListFilter
ตัวกรองสำหรับมิติข้อมูลสตริงที่ตรงกับรายการตัวเลือกที่เฉพาะเจาะจง
| การแสดง JSON |
|---|
{ "values": [ string ], "caseSensitive": boolean } |
| ช่อง | |
|---|---|
values[] |
ต้องระบุ รายการค่าสตริงที่เป็นไปได้ที่จะใช้จับคู่ ต้องระบุ |
caseSensitive |
ไม่บังคับ หากจริง การจับคู่จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ หากเป็น "เท็จ" การจับคู่จะไม่คำนึงถึงตัวพิมพ์เล็กหรือใหญ่ |
NumericFilter
ตัวกรองสำหรับค่าตัวเลขหรือค่าวันที่ในมิติข้อมูลหรือเมตริก
| การแสดง JSON |
|---|
{ "operation": enum ( |
| ช่อง | |
|---|---|
operation |
ต้องระบุ การดำเนินการที่ใช้กับตัวกรองตัวเลข |
value |
ต้องระบุ ค่าตัวเลขหรือวันที่ที่จะจับคู่ |
การดำเนินการ
การดำเนินการที่ใช้กับตัวกรองตัวเลข
| Enum | |
|---|---|
OPERATION_UNSPECIFIED |
ไม่ระบุ |
EQUAL |
เท่ากัน |
LESS_THAN |
น้อยกว่า |
GREATER_THAN |
มากกว่า |
NumericValue
เพื่อแสดงตัวเลข
| การแสดง JSON |
|---|
{ // Union field |
| ช่อง | |
|---|---|
ฟิลด์ Union one_value ค่าตัวเลข one_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
int64Value |
ค่าจำนวนเต็ม |
doubleValue |
ค่า Double |
BetweenFilter
ตัวกรองสำหรับค่าตัวเลขหรือวันที่ระหว่างค่าที่แน่นอนในมิติข้อมูลหรือเมตริก
| การแสดง JSON |
|---|
{ "fromValue": { object ( |
| ช่อง | |
|---|---|
fromValue |
ต้องระบุ ขึ้นต้นด้วยหมายเลขนี้ (รวมหมายเลขนี้ด้วย) |
toValue |
ต้องระบุ ลงท้ายด้วยหมายเลขนี้ (รวมหมายเลขนี้ด้วย) |
AudienceEventFilter
ตัวกรองที่ตรงกับเหตุการณ์ที่มีชื่อเหตุการณ์เดียว หากมีการระบุพารามิเตอร์เหตุการณ์ เฉพาะชุดย่อยของเหตุการณ์ที่ตรงกับทั้งชื่อเหตุการณ์เดียวและนิพจน์ตัวกรองพารามิเตอร์เท่านั้นที่จะตรงกับตัวกรองเหตุการณ์นี้
| การแสดง JSON |
|---|
{
"eventName": string,
"eventParameterFilterExpression": {
object ( |
| ช่อง | |
|---|---|
eventName |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ชื่อของเหตุการณ์ที่จะใช้จับคู่ |
eventParameterFilterExpression |
ไม่บังคับ หากระบุ ตัวกรองนี้จะตรงกับเหตุการณ์ที่ตรงกับทั้งชื่อเหตุการณ์เดียวและนิพจน์ตัวกรองพารามิเตอร์ ตั้งค่า AudienceEventFilter ภายในนิพจน์ตัวกรองพารามิเตอร์ไม่ได้ (เช่น ระบบไม่รองรับตัวกรองเหตุการณ์ที่ซ้อนกัน) ควรเป็น andGroup ของ dimensionOrMetricFilter หรือ notExpression รายการเดียว ระบบไม่รองรับ AND ของ OR นอกจากนี้ หากมีตัวกรองสำหรับ "eventCount" ระบบจะพิจารณาเฉพาะตัวกรองนั้นและไม่สนใจตัวกรองอื่นๆ ทั้งหมด |
AudienceSequenceFilter
กำหนดตัวกรองที่ต้องเกิดขึ้นในลำดับที่เฉพาะเจาะจงเพื่อให้ผู้ใช้เป็นสมาชิกของกลุ่มเป้าหมาย
| การแสดง JSON |
|---|
{ "scope": enum ( |
| ช่อง | |
|---|---|
scope |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุขอบเขตสําหรับตัวกรองนี้ |
sequenceMaximumDuration |
ไม่บังคับ กำหนดระยะเวลาที่ลำดับทั้งหมดต้องเกิดขึ้น ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย " |
sequenceSteps[] |
ต้องระบุ ลำดับขั้นตอนที่เรียงตามลำดับ ผู้ใช้ต้องทําแต่ละขั้นตอนให้เสร็จสมบูรณ์จึงจะเข้าร่วมตัวกรองลําดับได้ |
AudienceSequenceStep
เงื่อนไขที่ต้องเกิดขึ้นตามลำดับขั้นตอนที่ระบุเพื่อให้ผู้ใช้รายนี้ตรงกับลําดับ
| การแสดง JSON |
|---|
{ "scope": enum ( |
| ช่อง | |
|---|---|
scope |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุขอบเขตสำหรับขั้นตอนนี้ |
immediatelyFollows |
ไม่บังคับ หากเป็นจริง เหตุการณ์ที่ตรงกับขั้นตอนนี้ต้องเป็นเหตุการณ์ถัดจากเหตุการณ์ที่ตรงกับขั้นตอนสุดท้าย หากไม่ได้ตั้งค่าหรือเป็นเท็จ ขั้นตอนนี้จะไม่ได้เกิดขึ้นต่อทันทีจากขั้นตอนก่อนหน้า เช่น อาจมีเหตุการณ์ระหว่างขั้นตอนก่อนหน้ากับขั้นตอนนี้ ระบบจะข้ามการตรวจสอบนี้ในขั้นตอนแรก |
constraintDuration |
ไม่บังคับ เมื่อตั้งค่าแล้ว ขั้นตอนนี้ต้องดำเนินการให้เสร็จภายใน constraintDuration ของขั้นตอนก่อนหน้า (เช่น t[i] - t[i-1] <= constraintDuration) หากไม่ได้ตั้งค่าไว้ จะไม่มีข้อกำหนดระยะเวลา (ระยะเวลาจะไม่มีขีดจำกัด) ระบบจะข้ามการตรวจสอบนี้ในขั้นตอนแรก ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย " |
filterExpression |
ต้องระบุ เปลี่ยนแปลงไม่ได้ นิพจน์เชิงตรรกะของมิติข้อมูล กลุ่มเป้าหมาย เมตริก หรือตัวกรองเหตุการณ์ในแต่ละขั้นตอน |
AudienceClauseType
ระบุว่านี่คือเงื่อนไขตัวกรองรวมหรือยกเว้น
| Enum | |
|---|---|
AUDIENCE_CLAUSE_TYPE_UNSPECIFIED |
ประเภทข้อที่ไม่ระบุ |
INCLUDE |
ระบบจะรวมผู้ใช้ไว้ในกลุ่มเป้าหมายหากเป็นไปตามข้อกำหนดของตัวกรอง |
EXCLUDE |
ระบบจะยกเว้นผู้ใช้จากกลุ่มเป้าหมายหากตรงตามข้อความกรอง |
เมธอด |
|
|---|---|
|
เก็บกลุ่มเป้าหมายในพร็อพเพอร์ตี้ |
|
สร้างกลุ่มเป้าหมาย |
|
ค้นหากลุ่มเป้าหมายเดียว |
|
แสดงกลุ่มเป้าหมายในพร็อพเพอร์ตี้ |
|
อัปเดตกลุ่มเป้าหมายในพร็อพเพอร์ตี้ |