Audience

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

การแสดง JSON
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  },
  "scope": enum (AudienceScope),
  "assetGroup": string,
  "name": string
}
ช่อง
resourceName

string

เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของกลุ่มเป้าหมาย ชื่อกลุ่มเป้าหมายมีรูปแบบดังนี้

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

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

status

enum (AudienceStatus)

เอาต์พุตเท่านั้น สถานะของกลุ่มเป้าหมายนี้ ระบุว่าเปิดใช้หรือนำกลุ่มเป้าหมายออก

description

string

คำอธิบายของกลุ่มเป้าหมายนี้

dimensions[]

object (AudienceDimension)

มิติข้อมูลบวกที่ระบุองค์ประกอบกลุ่มเป้าหมาย

exclusionDimension

object (AudienceExclusionDimension)

มิติข้อมูลเชิงลบที่ระบุองค์ประกอบกลุ่มเป้าหมาย

scope

enum (AudienceScope)

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

assetGroup

string

เปลี่ยนแปลงไม่ได้ กลุ่มชิ้นงานที่กําหนดขอบเขตกลุ่มเป้าหมายนี้ ต้องตั้งค่าหากและเฉพาะในกรณีที่เป็นขอบเขตเป็น ASSET_GROUP เปลี่ยนแปลงไม่ได้หลังจากสร้าง หากกลุ่มเป้าหมายที่มีขอบเขต ASSET_GROUP อัปเกรดเป็นขอบเขต CUSTOMER ระบบจะล้างช่องนี้โดยอัตโนมัติ

name

string

ชื่อกลุ่มเป้าหมาย ซึ่งต้องไม่ซ้ำกันในกลุ่มเป้าหมายทั้งหมดในบัญชี โดยต้องมีความยาวขั้นต่ำ 1 และความยาวสูงสุด 255 ต้องระบุเมื่อไม่ได้ตั้งขอบเขตไว้หรือตั้งค่าเป็น CUSTOMER ไม่สามารถตั้งค่าหรืออัปเดตได้เมื่อขอบเขตเป็น ASSET_GROUP

AudienceStatus

แจกแจงที่มีประเภทสถานะกลุ่มเป้าหมายที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับผลลัพธ์เท่านั้น แสดงถึงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED สถานะเปิดใช้ - กลุ่มเป้าหมายเปิดใช้และสามารถกำหนดเป้าหมายได้
REMOVED สถานะถูกนำออก - กลุ่มเป้าหมายถูกนำออกแล้วและไม่สามารถใช้ในการกำหนดเป้าหมายได้

AudienceDimension

มิติข้อมูลเชิงบวกที่ระบุกลุ่มเป้าหมายของผู้ใช้

การแสดง JSON
{

  // Union field dimension can be only one of the following:
  "age": {
    object (AgeDimension)
  },
  "gender": {
    object (GenderDimension)
  },
  "householdIncome": {
    object (HouseholdIncomeDimension)
  },
  "parentalStatus": {
    object (ParentalStatusDimension)
  },
  "audienceSegments": {
    object (AudienceSegmentDimension)
  }
  // End of list of possible types for union field dimension.
}
ช่อง
ฟิลด์การรวม dimension มิติข้อมูลที่ระบุผู้ใช้ที่อยู่ในกลุ่มเป้าหมาย dimension ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
age

object (AgeDimension)

มิติข้อมูลที่ระบุผู้ใช้ตามอายุ

gender

object (GenderDimension)

มิติข้อมูลที่ระบุผู้ใช้ตามเพศ

householdIncome

object (HouseholdIncomeDimension)

มิติข้อมูลที่ระบุผู้ใช้ตามรายได้ครัวเรือน

parentalStatus

object (ParentalStatusDimension)

มิติข้อมูลที่ระบุผู้ใช้ตามสถานะความเป็นบิดามารดา

audienceSegments

object (AudienceSegmentDimension)

มิติข้อมูลที่ระบุผู้ใช้ตามการเป็นสมาชิกในกลุ่มเป้าหมายอื่นๆ

AgeDimension

มิติข้อมูลที่ระบุผู้ใช้ตามอายุ

การแสดง JSON
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
ช่อง
ageRanges[]

object (AgeSegment)

ช่วงอายุต่อเนื่องที่จะรวมอยู่ในมิติข้อมูล

includeUndetermined

boolean

รวมผู้ใช้ที่ไม่ได้ระบุอายุ

AgeSegment

ช่วงอายุต่อเนื่อง

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

integer

อายุขั้นต่ำที่จะรวม ต้องระบุอายุขั้นต่ำและต้องมีอายุ 18 ปีขึ้นไป ค่าที่อนุญาตคือ 18, 25, 35, 45, 55 และ 65

maxAge

integer

อายุสูงสุดที่จะรวม ไม่จำเป็นต้องระบุอายุสูงสุด หากระบุ maxAge ต้องมากกว่า minAge และค่าที่อนุญาตคือ 24, 34, 44, 54 และ 64

GenderDimension

มิติข้อมูลที่ระบุผู้ใช้ตามเพศ

การแสดง JSON
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
ช่อง
genders[]

enum (GenderType)

กลุ่มเป้าหมายตามข้อมูลประชากรตามเพศซึ่งรวมไว้

includeUndetermined

boolean

รวมผู้ใช้ที่ไม่ได้ระบุเพศ

HouseholdIncomeDimension

มิติข้อมูลที่ระบุผู้ใช้ตามรายได้ครัวเรือน

การแสดง JSON
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
ช่อง
incomeRanges[]

enum (IncomeRangeType)

รวมกลุ่มข้อมูลประชากรตามรายได้ครัวเรือนแล้ว

includeUndetermined

boolean

รวมผู้ใช้ที่ไม่ได้กำหนดรายได้ครัวเรือน

ParentalStatusDimension

มิติข้อมูลที่ระบุผู้ใช้ตามสถานะความเป็นบิดามารดา

การแสดง JSON
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
ช่อง
parentalStatuses[]

enum (ParentalStatusType)

รวมกลุ่มเป้าหมายตามข้อมูลประชากรตามสถานะความเป็นบิดามารดา

includeUndetermined

boolean

รวมถึงผู้ใช้ที่ไม่ได้กำหนดสถานะความเป็นบิดามารดา

AudienceSegmentDimension

มิติข้อมูลที่ระบุผู้ใช้ตามการเป็นสมาชิกในกลุ่มเป้าหมายอื่นๆ

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

object (AudienceSegment)

กลุ่มเป้าหมายที่รวมไว้ ระบบจะรวมผู้ใช้หากผู้ใช้อยู่ในกลุ่มอย่างน้อย 1 กลุ่ม

AudienceSegment

กลุ่มเป้าหมายเชิงบวก

การแสดง JSON
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  },
  "userInterest": {
    object (UserInterestSegment)
  },
  "lifeEvent": {
    object (LifeEventSegment)
  },
  "detailedDemographic": {
    object (DetailedDemographicSegment)
  },
  "customAudience": {
    object (CustomAudienceSegment)
  }
  // End of list of possible types for union field segment.
}
ช่อง
ฟิลด์การรวม segment กลุ่มเชิงบวก segment ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
userList

object (UserListSegment)

กลุ่มรายชื่อผู้ใช้

userInterest

object (UserInterestSegment)

ผู้สนใจหรือกลุ่มที่มีแผนจะซื้อ

lifeEvent

object (LifeEventSegment)

กลุ่มเป้าหมายของเหตุการณ์สด

detailedDemographic

object (DetailedDemographicSegment)

กลุ่มเป้าหมายตามข้อมูลประชากรโดยละเอียด

customAudience

object (CustomAudienceSegment)

กลุ่มเป้าหมายที่กำหนดเอง

UserListSegment

กลุ่มรายชื่อผู้ใช้ การหยุดให้บริการกลุ่มเป้าหมายที่คล้ายกันจะเริ่มในเดือนพฤษภาคม 2023 โปรดดูตัวเลือกอื่นๆ ที่ https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html

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

string

ทรัพยากรรายชื่อผู้ใช้

UserInterestSegment

กลุ่มเป้าหมายตามความสนใจของผู้ใช้

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

string

แหล่งข้อมูลความสนใจของผู้ใช้

LifeEventSegment

กลุ่มเหตุการณ์สด

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

string

ทรัพยากรสำหรับเหตุการณ์สำคัญในชีวิต

DetailedDemographicSegment

กลุ่มเป้าหมายตามข้อมูลประชากรโดยละเอียด

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

string

แหล่งข้อมูลข้อมูลประชากรโดยละเอียด

CustomAudienceSegment

กลุ่มเป้าหมายที่กำหนดเอง

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

string

ทรัพยากรกลุ่มเป้าหมายที่กำหนดเอง

AudienceExclusionDimension

มิติข้อมูลเชิงลบที่ระบุผู้ใช้ที่จะยกเว้นจากกลุ่มเป้าหมาย

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

object (ExclusionSegment)

กลุ่มเป้าหมายที่จะยกเว้น

ExclusionSegment

กลุ่มเป้าหมายที่จะยกเว้นจากกลุ่มเป้าหมาย

การแสดง JSON
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
ช่อง
ฟิลด์การรวม segment กลุ่มที่จะยกเว้น segment ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
userList

object (UserListSegment)

กลุ่มรายชื่อผู้ใช้ที่จะยกเว้น

AudienceScope

แจกแจงค่าขอบเขตของกลุ่มเป้าหมายที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุขอบเขต
UNKNOWN ไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้
CUSTOMER และมีการกำหนดกลุ่มเป้าหมายที่ระดับลูกค้า
ASSET_GROUP กลุ่มเป้าหมายจะได้รับการกําหนดขอบเขตภายใต้ AssetGroup ที่เฉพาะเจาะจง