- แหล่งข้อมูล: กลุ่มเป้าหมาย
- AudienceEventTrigger
- LogCondition
- AudienceExclusionDurationMode
- AudienceFilterClause
- AudienceSimpleFilter
- AudienceFilterScope
- AudienceFilterExpression
- AudienceFilterExpressionList
- AudienceDimensionOrMetricFilter
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- การดำเนินการ
- NumericValue
- BetweenFilter
- AudienceEventFilter
- AudienceSequenceFilter
- AudienceSequenceStep
- AudienceClauseType
- เมธอด
แหล่งข้อมูล: กลุ่มเป้าหมาย
ข้อความแหล่งข้อมูลที่แสดงถึงกลุ่มเป้าหมาย GA4
การแสดง JSON |
---|
{ "name": string, "displayName": string, "description": string, "membershipDurationDays": integer, "adsPersonalizationEnabled": boolean, "eventTrigger": { object ( |
ช่อง | |
---|---|
name |
เอาต์พุตเท่านั้น ชื่อทรัพยากรสำหรับทรัพยากรกลุ่มเป้าหมายนี้ รูปแบบ: พร็อพเพอร์ตี้/{propertyId}/audiences/{audienceId} |
displayName |
ต้องระบุ ชื่อที่แสดงของกลุ่มเป้าหมาย |
description |
ต้องระบุ คำอธิบายกลุ่มเป้าหมาย |
membershipDurationDays |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ระยะเวลาที่ผู้ใช้ควรอยู่ในกลุ่มเป้าหมาย ไม่สามารถตั้งค่าเกิน 540 วัน |
adsPersonalizationEnabled |
เอาต์พุตเท่านั้น GA จะตั้งค่าเป็น "เท็จ" โดยอัตโนมัติหากเป็นกลุ่มเป้าหมาย NPA และยกเว้นจากการปรับโฆษณาตามโปรไฟล์ของผู้ใช้ |
eventTrigger |
ไม่บังคับ ระบุเหตุการณ์ที่จะบันทึกเมื่อผู้ใช้เข้าร่วมกลุ่มเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะไม่บันทึกเหตุการณ์เมื่อผู้ใช้เข้าร่วมกลุ่มเป้าหมาย |
exclusionDurationMode |
เปลี่ยนแปลงไม่ได้ ระบุระยะเวลาการยกเว้นสำหรับผู้ใช้ที่ตรงกับตัวกรองการยกเว้น โดยจะมีผลกับวลีของตัวกรอง "ยกเว้น" ทั้งหมด และจะไม่มีผลหากไม่มีเงื่อนไขตัวกรอง "ยกเว้น" ในกลุ่มเป้าหมาย |
filterClauses[] |
ต้องระบุ เปลี่ยนแปลงไม่ได้ รายการที่ไม่เรียงลำดับ ข้อความตัวกรองที่กำหนดกลุ่มเป้าหมาย อนุประโยคทั้งหมดจะรวมกันเป็น AND |
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 |
ต้องระบุ ระบุว่าเป็นวลีตัวกรองรวมหรือยกเว้น |
ฟิลด์สหภาพ
|
|
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 |
ผู้ใช้จะเข้าร่วมกลุ่มเป้าหมายหากตรงตามเงื่อนไขตัวกรองภายใน 1 เซสชัน |
AUDIENCE_FILTER_SCOPE_ACROSS_ALL_SESSIONS |
ผู้ใช้จะเข้าร่วมกลุ่มเป้าหมายหากเหตุการณ์ใดก็ตามตรงกับเงื่อนไขตัวกรองในเซสชันใดก็ตาม |
AudienceFilterExpression
นิพจน์เชิงตรรกะของตัวกรองมิติข้อมูล เมตริก หรือเหตุการณ์กลุ่มเป้าหมาย
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์สหภาพ expr นิพจน์ที่ใช้กับตัวกรอง expr ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
andGroup |
รายการนิพจน์ที่จะรวมกันเป็น AND ซึ่งมีได้เฉพาะ AudienceFilterexpressions ที่มี orGroup เท่านั้น ต้องตั้งค่าสำหรับ AudienceFilterExpression ระดับบนสุด |
orGroup |
รายการนิพจน์ที่จะ OR รวมเข้าด้วยกัน โดยต้องไม่มี AudienceFilterExpressions ด้วย andGroup หรือ orGroup |
notExpression |
นิพจน์ตัวกรองที่ไม่ใช่ "ไม่ใช่" (เช่น กลับสี เติมเต็ม) ซึ่งมีได้เฉพาะมิติข้อมูลOrMetricFilter ตั้งค่านี้ใน 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 หรือ false ซึ่งจะตั้งค่าได้ต่อเมื่อขอบเขตระดับกลุ่มเป้าหมายคือ ACROSS_ALL_SESSIONS และต้องไม่เกิน 60 วัน |
ฟิลด์สหภาพ 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 |
ช่อง | |
---|---|
ฟิลด์สหภาพ one_value ค่าตัวเลขค่าหนึ่ง one_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
int64Value |
ค่าจำนวนเต็ม |
doubleValue |
ค่า Double |
BetweenFilter
ตัวกรองสำหรับค่าตัวเลขหรือวันที่ระหว่างค่าหนึ่งๆ ในมิติข้อมูลหรือเมตริก
การแสดง JSON |
---|
{ "fromValue": { object ( |
ช่อง | |
---|---|
fromValue |
ต้องระบุ ขึ้นต้นด้วยจำนวนนี้ โดยนับรวมด้วย |
toValue |
ต้องระบุ ลงท้ายด้วยหมายเลขนี้ (รวมเลขตัวแรกและตัวสุดท้าย) |
AudienceEventFilter
ตัวกรองที่ตรงกับเหตุการณ์ที่มีชื่อเหตุการณ์เดียว หากระบุพารามิเตอร์เหตุการณ์ เฉพาะชุดย่อยของเหตุการณ์ที่ตรงกับทั้งชื่อเหตุการณ์เดียวและนิพจน์ตัวกรองพารามิเตอร์ที่ตรงกับตัวกรองเหตุการณ์นี้
การแสดง JSON |
---|
{
"eventName": string,
"eventParameterFilterExpression": {
object ( |
ช่อง | |
---|---|
eventName |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ชื่อเหตุการณ์ที่ต้องการจับคู่ |
eventParameterFilterExpression |
ไม่บังคับ หากระบุไว้ ตัวกรองนี้จะจับคู่เหตุการณ์ที่ตรงกับทั้งชื่อเหตุการณ์เดียวและนิพจน์ตัวกรองพารามิเตอร์ ไม่สามารถตั้งค่า AudienceEventFilter ภายในนิพจน์ตัวกรองพารามิเตอร์ได้ (ตัวอย่างเช่น ระบบไม่รองรับตัวกรองเหตุการณ์ที่ซ้อนกัน) ซึ่งควรเป็นกลุ่มของมิติข้อมูลOrMetricFilter หรือ notExpression กลุ่มเดียว แต่ไม่รองรับ AND ของ OR นอกจากนี้ หากมีตัวกรองสำหรับ "eventCount" จะพิจารณาเฉพาะตัวกรองนั้น และละเว้นตัวกรองอื่นๆ ทั้งหมด |
AudienceSequenceFilter
กำหนดตัวกรองที่จะต้องเกิดขึ้นในลำดับที่เฉพาะเจาะจงเพื่อให้ผู้ใช้เป็นสมาชิกของกลุ่มเป้าหมาย
การแสดง JSON |
---|
{ "scope": enum ( |
ช่อง | |
---|---|
scope |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุขอบเขตสำหรับตัวกรองนี้ |
sequenceMaximumDuration |
ไม่บังคับ กำหนดระยะเวลาที่ลำดับทั้งหมดต้องเกิดขึ้น ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
sequenceSteps[] |
ต้องระบุ ลำดับขั้นตอน ผู้ใช้ต้องทำแต่ละขั้นตอนให้เสร็จสมบูรณ์เพื่อเข้าร่วมตัวกรองลำดับ |
AudienceSequenceStep
เงื่อนไขที่จำเป็นต้องเกิดขึ้นตามลำดับขั้นตอนที่ระบุเพื่อให้ผู้ใช้รายนี้จับคู่ได้กับลำดับ
การแสดง JSON |
---|
{ "scope": enum ( |
ช่อง | |
---|---|
scope |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุขอบเขตสำหรับขั้นตอนนี้ |
immediatelyFollows |
ไม่บังคับ หากจริง เหตุการณ์ที่ดำเนินการตามขั้นตอนนี้ต้องเป็นเหตุการณ์ถัดไปหลังจากที่เหตุการณ์ดำเนินการตามขั้นตอนสุดท้ายแล้ว หากไม่ได้ตั้งค่าหรือ "เท็จ" ขั้นตอนนี้จะทำตามขั้นตอนก่อนหน้าโดยอ้อม เช่น อาจมีเหตุการณ์ระหว่างขั้นตอนก่อนหน้ากับขั้นตอนนี้ โดยจะละเว้นในขั้นตอนแรก |
constraintDuration |
ไม่บังคับ เมื่อตั้งค่า ขั้นตอนนี้จะต้องมีลักษณะภายใน personalDuration ของขั้นตอนก่อนหน้า (เช่น t[i] - t[i-1] <= restrictionDuration) หากไม่ได้ตั้งค่า จะไม่มีข้อกำหนดระยะเวลา (ระยะเวลาเป็นแบบไม่จำกัด) โดยจะละเว้นในขั้นตอนแรก ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
filterExpression |
ต้องระบุ เปลี่ยนแปลงไม่ได้ นิพจน์เชิงตรรกะของตัวกรองมิติข้อมูล เมตริก หรือเหตุการณ์กลุ่มเป้าหมายในแต่ละขั้นตอน |
AudienceClauseType
ระบุว่าเป็นวลีตัวกรองรวมหรือยกเว้น
Enum | |
---|---|
AUDIENCE_CLAUSE_TYPE_UNSPECIFIED |
ประเภทข้อความที่ระบุไม่ได้ |
INCLUDE |
ผู้ใช้จะรวมอยู่ในกลุ่มเป้าหมายหากเป็นไปตามข้อกำหนดของตัวกรอง |
EXCLUDE |
ระบบจะยกเว้นผู้ใช้จากกลุ่มเป้าหมายหากเป็นไปตามข้อกำหนดของตัวกรอง |
วิธีการ |
|
---|---|
|
เก็บกลุ่มเป้าหมายในพร็อพเพอร์ตี้ |
|
สร้างกลุ่มเป้าหมาย |
|
ค้นหากลุ่มเป้าหมายกลุ่มเดียว |
|
แสดงรายการกลุ่มเป้าหมายในพร็อพเพอร์ตี้ |
|
อัปเดตกลุ่มเป้าหมายในพร็อพเพอร์ตี้ |