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 สำหรับการใช้งานเฉพาะตัวใน assetGroup เดียว ขอบเขตอาจเปลี่ยนจาก ASSET_GROUP เป็น CUSTOMER แต่ไม่เปลี่ยนจาก CUSTOMER เป็น ASSET_GROUP

assetGroup

string

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

name

string

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

AudienceStatus

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

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

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

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