REST Resource: properties.audiences

{
  "name": string,
  "displayName": string,
  "description": string,
  "membershipDurationDays": integer,
  "adsPersonalizationEnabled": boolean,
  "eventTrigger": {
    object (AudienceEventTrigger)
  },
  "exclusionDurationMode": enum (AudienceExclusionDurationMode),
  "filterClauses": [
    {
      object (AudienceFilterClause)
    }
  ],
  "createTime": string
}

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรสำหรับทรัพยากรกลุ่มเป้าหมายนี้ รูปแบบ: พร็อพเพอร์ตี้/{propertyId}/audiences/{audienceId}

string

ต้องระบุ ชื่อที่แสดงของกลุ่มเป้าหมาย

string

ต้องระบุ คำอธิบายกลุ่มเป้าหมาย

integer

ต้องระบุ เปลี่ยนแปลงไม่ได้ ระยะเวลาที่ผู้ใช้ควรอยู่ในกลุ่มเป้าหมาย และจะตั้งค่าเป็นมากกว่า 540 วันไม่ได้

boolean

เอาต์พุตเท่านั้น GA จะตั้งค่าเป็น "เท็จ" โดยอัตโนมัติหากเป็นกลุ่มเป้าหมาย NPA และไม่รวมอยู่ในการปรับโฆษณาตามโปรไฟล์ของผู้ใช้

object (AudienceEventTrigger)

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

enum (AudienceExclusionDurationMode)

เปลี่ยนแปลงไม่ได้ ระบุระยะเวลาการยกเว้นสําหรับผู้ใช้ที่ตรงตามตัวกรองการยกเว้น ซึ่งจะใช้กับวลีตัวกรอง "ยกเว้น" ทั้งหมด และละเว้นเมื่อไม่มีวลีตัวกรอง "ยกเว้น" ในกลุ่มเป้าหมาย

object (AudienceFilterClause)

ต้องระบุ เปลี่ยนแปลงไม่ได้ รายการที่ไม่เรียงลำดับ วลีของตัวกรองที่กำหนดกลุ่มเป้าหมาย วลีทั้งหมดจะใช้ AND ด้วยกัน

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่สร้างกลุ่มเป้าหมาย

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

{
  "eventName": string,
  "logCondition": enum (LogCondition)
}

string

ต้องระบุ ชื่อเหตุการณ์ที่จะบันทึก

enum (LogCondition)

ต้องระบุ ควรบันทึกเหตุการณ์เมื่อใด

{
  "clauseType": enum (AudienceClauseType),

  // Union field filter can be only one of the following:
  "simpleFilter": {
    object (AudienceSimpleFilter)
  },
  "sequenceFilter": {
    object (AudienceSequenceFilter)
  }
  // End of list of possible types for union field filter.
}

enum (AudienceClauseType)

ต้องระบุ ระบุว่านี่เป็นเงื่อนไขตัวกรอง "รวม" หรือ "ยกเว้น"

object (AudienceSimpleFilter)

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

object (AudienceSequenceFilter)

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

{
  "scope": enum (AudienceFilterScope),
  "filterExpression": {
    object (AudienceFilterExpression)
  }
}

enum (AudienceFilterScope)

ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุขอบเขตของตัวกรองนี้

object (AudienceFilterExpression)

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

{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (AudienceFilterExpressionList)
  },
  "orGroup": {
    object (AudienceFilterExpressionList)
  },
  "notExpression": {
    object (AudienceFilterExpression)
  },
  "dimensionOrMetricFilter": {
    object (AudienceDimensionOrMetricFilter)
  },
  "eventFilter": {
    object (AudienceEventFilter)
  }
  // End of list of possible types for union field expr.
}

object (AudienceFilterExpressionList)

รายการนิพจน์ที่จะใช้ร่วมกัน โดยจะมีได้เฉพาะ AudienceFilterExpressions กับ orGroup เท่านั้น คุณต้องตั้งค่าสำหรับ AudienceFilterExpression ระดับบนสุด

object (AudienceFilterExpressionList)

รายการนิพจน์ที่ใช้ OR ร่วมกัน ต้องไม่มี AudienceFilterExpressions กับ andGroup หรือ orGroup

object (AudienceFilterExpression)

นิพจน์ตัวกรองที่จะเป็น "ไม่" (เช่น กลับสี และแบบเสริม) จะรวมได้เฉพาะdimensionOrMetricFilter โดยจะตั้งค่าใน AudienceFilterExpression ระดับบนสุดไม่ได้

object (AudienceDimensionOrMetricFilter)

ตัวกรองในมิติข้อมูลหรือเมตริกรายการเดียว โดยจะตั้งค่าใน AudienceFilterExpression ระดับบนสุดไม่ได้

object (AudienceEventFilter)

สร้างตัวกรองที่ตรงกับเหตุการณ์ที่เฉพาะเจาะจง โดยจะตั้งค่าใน AudienceFilterExpression ระดับบนสุดไม่ได้

{
  "filterExpressions": [
    {
      object (AudienceFilterExpression)
    }
  ]
}

object (AudienceFilterExpression)

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

{
  "fieldName": string,
  "atAnyPointInTime": boolean,
  "inAnyNDayPeriod": integer,

  // 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.
}

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ชื่อมิติข้อมูลหรือชื่อเมตริกที่จะกรอง หากชื่อช่องหมายถึงมิติข้อมูลหรือเมตริกที่กำหนดเอง ระบบจะเพิ่มคำนำหน้าขอบเขตหน้ามิติข้อมูลหรือชื่อเมตริกที่กำหนดเอง สำหรับข้อมูลเพิ่มเติมเกี่ยวกับคำนำหน้าขอบเขตหรือมิติข้อมูล/เมตริกที่กำหนดเอง โปรดดูเอกสารเกี่ยวกับ Google Analytics Data API

boolean

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

คุณจะตั้งค่านี้ได้เมื่อขอบเขตผู้ชมเป็น ACROSS_ALL_SESSIONS เท่านั้น

integer

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

เช่น หากตั้งค่าเป็น 1 วัน ระบบจะประเมินเฉพาะข้อมูลของวันปัจจุบัน จุดอ้างอิงคือวันที่ปัจจุบันที่ไม่ได้ตั้งค่า atAnyPointInTime หรือ false

คุณจะตั้งค่าได้ก็ต่อเมื่อขอบเขตกลุ่มเป้าหมายคือ ACROSS_ALL_SESSIONS และต้องไม่เกิน 60 วัน

object (StringFilter)

ตัวกรองสำหรับมิติข้อมูลประเภทสตริงที่ตรงกับรูปแบบเฉพาะ

object (InListFilter)

ตัวกรองสำหรับมิติข้อมูลสตริงที่ตรงกับรายการตัวเลือกที่เฉพาะเจาะจง

object (NumericFilter)

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

object (BetweenFilter)

ตัวกรองสำหรับค่าตัวเลขหรือวันที่ระหว่างค่าบางค่าในมิติข้อมูลหรือเมตริก

{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}

enum (MatchType)

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

string

ต้องระบุ ค่าสตริงที่จะจับคู่

boolean

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

{
  "values": [
    string
  ],
  "caseSensitive": boolean
}

string

ต้องระบุ รายการค่าสตริงที่เป็นไปได้ซึ่งจะใช้จับคู่กัน ต้องระบุ

boolean

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

{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}

enum (Operation)

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

object (NumericValue)

ต้องระบุ ค่าตัวเลขหรือวันที่ที่จะจับคู่กับ

{

  // 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.
}

string (int64 format)

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

number

ค่า Double

{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}

object (NumericValue)

ต้องระบุ ขึ้นต้นด้วยตัวเลขนี้ (รวมค่านี้ด้วย)

object (NumericValue)

ต้องระบุ ลงท้ายด้วยหมายเลขนี้ (รวมหมายเลขนี้)

{
  "eventName": string,
  "eventParameterFilterExpression": {
    object (AudienceFilterExpression)
  }
}

string

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

object (AudienceFilterExpression)

ไม่บังคับ หากระบุ ตัวกรองนี้จะจับคู่เหตุการณ์ที่ตรงกับทั้งชื่อเหตุการณ์เดียวและนิพจน์ตัวกรองพารามิเตอร์ ไม่สามารถตั้งค่า AudienceEventFilter ภายในนิพจน์ตัวกรองพารามิเตอร์ (เช่น ระบบไม่รองรับตัวกรองเหตุการณ์ที่ซ้อนกัน) ค่านี้ควรเป็นกลุ่มเดียวและGroup ofdimensionOrMetricFilter หรือ notExpression ไม่รองรับ AND ของ OR นอกจากนี้ หากมีตัวกรองสำหรับ "eventCount" ระบบจะพิจารณาเฉพาะตัวกรองนั้น ระบบจะไม่สนใจตัวกรองอื่นๆ ทั้งหมด

{
  "scope": enum (AudienceFilterScope),
  "sequenceMaximumDuration": string,
  "sequenceSteps": [
    {
      object (AudienceSequenceStep)
    }
  ]
}

enum (AudienceFilterScope)

ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุขอบเขตของตัวกรองนี้

string (Duration format)

ไม่บังคับ กำหนดระยะเวลาที่ลำดับทั้งหมดต้องเกิดขึ้น

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

object (AudienceSequenceStep)

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

{
  "scope": enum (AudienceFilterScope),
  "immediatelyFollows": boolean,
  "constraintDuration": string,
  "filterExpression": {
    object (AudienceFilterExpression)
  }
}

enum (AudienceFilterScope)

ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุขอบเขตของขั้นตอนนี้

boolean

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

string (Duration format)

ไม่บังคับ เมื่อตั้งค่าแล้ว ขั้นตอนนี้ต้องเป็นไปตามการจำกัดระยะเวลาของขั้นตอนก่อนหน้า (เช่น t[i] - t[i-1] <=restrictDuration) หากไม่ได้ตั้งค่าไว้ ก็ไม่จำเป็นต้องระบุระยะเวลา (ไม่จำกัดระยะเวลาได้) ระบบจะไม่สนใจสำหรับขั้นตอนแรก

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

object (AudienceFilterExpression)

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