Audience

Đối tượng là một lựa chọn nhắm mục tiêu hiệu quả, cho phép bạn phân tách các thuộc tính của phân khúc (chẳng hạn như thông tin chi tiết về nhân khẩu học và đối tượng chung sở thích) để tạo đối tượng đại diện cho các phần trong phân khúc mục tiêu của bạn.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "name": string,
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  }
}
Các trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của đối tượng. Tên đối tượng có dạng:

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng của đối tượng.
status

enum (AudienceStatus)

Chỉ có đầu ra. Trạng thái của đối tượng này. Cho biết liệu đối tượng được bật hay bị xoá.
name

string

Bắt buộc. Tên của đối tượng. Tên này phải là duy nhất đối với mọi đối tượng. Mã này phải có độ dài tối thiểu là 1 và độ dài tối đa là 255.
description

string

Nội dung mô tả về đối tượng này.
dimensions[]

object (AudienceDimension)

Phương diện dương xác định thành phần đối tượng.
exclusionDimension

object (AudienceExclusionDimension)

Phương diện âm chỉ định thành phần đối tượng.

AudienceStatus

Enum chứa các loại trạng thái đối tượng có thể có.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ENABLED Trạng thái đã bật – đối tượng đang bật và có thể nhắm mục tiêu.
REMOVED Trạng thái đã bị xoá – đối tượng bị xoá và không thể dùng để nhắm mục tiêu.

AudienceDimension

Phương diện khẳng định chỉ định đối tượng của người dùng.

Biểu diễn dưới dạng 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.
}
Các trường
Trường nhóm dimension. Phương diện chỉ định người dùng thuộc đối tượng. dimension chỉ có thể là một trong những trạng thái sau đây:
age

object (AgeDimension)

Phương diện chỉ định người dùng theo độ tuổi.
gender

object (GenderDimension)

Phương diện chỉ định người dùng theo giới tính.
householdIncome

object (HouseholdIncomeDimension)

Phương diện chỉ định người dùng theo thu nhập hộ gia đình.
parentalStatus

object (ParentalStatusDimension)

Phương diện chỉ định người dùng theo tình trạng con cái.
audienceSegments

object (AudienceSegmentDimension)

Phương diện chỉ định người dùng theo tư cách thành viên của họ trong các phân khúc đối tượng khác.

AgeDimension

Phương diện chỉ định người dùng theo độ tuổi.

Biểu diễn dưới dạng JSON 
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
Các trường
ageRanges[]

object (AgeSegment)

Các độ tuổi liền nhau cần được đưa vào phương diện này.
includeUndetermined

boolean

Bao gồm những người dùng có độ tuổi không được xác định.

AgeSegment

Độ tuổi liền nhau.

Biểu diễn dưới dạng JSON 
{
  "minAge": integer,
  "maxAge": integer
}
Các trường
minAge

integer

Độ tuổi tối thiểu để đưa vào. Bạn phải chỉ định độ tuổi tối thiểu và từ 18 tuổi trở lên. Các giá trị được phép là 18, 25, 35, 45, 55 và 65.
maxAge

integer

Độ tuổi tối đa để đưa vào. Bạn không cần chỉ định độ tuổi tối đa. Nếu được chỉ định, maxAge phải lớn hơn minAge và các giá trị được phép là 24, 34, 44, 54 và 64.

GenderDimension

Phương diện chỉ định người dùng theo giới tính.

Biểu diễn dưới dạng JSON 
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
Các trường
genders[]

enum (GenderType)

Phân khúc nhân khẩu học theo giới tính đã được thêm vào.
includeUndetermined

boolean

Bao gồm những người dùng có giới tính chưa được xác định.

HouseholdIncomeDimension

Phương diện chỉ định người dùng theo thu nhập hộ gia đình.

Biểu diễn dưới dạng JSON 
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
Các trường
incomeRanges[]

enum (IncomeRangeType)

Phân khúc nhân khẩu học có thu nhập hộ gia đình được bao gồm.
includeUndetermined

boolean

Bao gồm những người dùng có thu nhập hộ gia đình không được xác định.

ParentalStatusDimension

Phương diện chỉ định người dùng theo tình trạng con cái.

Biểu diễn dưới dạng JSON 
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
Các trường
parentalStatuses[]

enum (ParentalStatusType)

Đã bao gồm phân khúc nhân khẩu học về tình trạng con cái.
includeUndetermined

boolean

Bao gồm những người dùng có tình trạng con cái chưa được xác định.

AudienceSegmentDimension

Phương diện chỉ định người dùng theo tư cách thành viên của họ trong các phân khúc đối tượng khác.

Biểu diễn dưới dạng JSON 
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
Các trường
segments[]

object (AudienceSegment)

Phân khúc đối tượng được đưa vào. Người dùng sẽ được đưa vào nếu họ thuộc ít nhất một phân khúc.

AudienceSegment

Phân khúc đối tượng khẳng định.

Biểu diễn dưới dạng 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.
}
Các trường
Trường nhóm segment. Phân đoạn khẳng định. segment chỉ có thể là một trong những trạng thái sau đây:
userList

object (UserListSegment)

Phân đoạn danh sách người dùng.
userInterest

object (UserInterestSegment)

Phân khúc chung sở thích hoặc Phân khúc đang cân nhắc mua hàng.
lifeEvent

object (LifeEventSegment)

Phân khúc đối tượng của sự kiện trực tiếp.
detailedDemographic

object (DetailedDemographicSegment)

Phân khúc đối tượng nhân khẩu học chi tiết.
customAudience

object (CustomAudienceSegment)

Phân khúc đối tượng tuỳ chỉnh.

UserListSegment

Phân đoạn danh sách người dùng. Tính năng Đối tượng tương tự sẽ ngừng hoạt động từ tháng 5 năm 2023. Hãy tham khảo https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html để biết các lựa chọn khác.

Biểu diễn dưới dạng JSON 
{
  "userList": string
}
Các trường
userList

string

Tài nguyên danh sách người dùng.

UserInterestSegment

Phân khúc mối quan tâm của người dùng.

Biểu diễn dưới dạng JSON 
{
  "userInterestCategory": string
}
Các trường
userInterestCategory

string

Tài nguyên về mối quan tâm của người dùng.

LifeEventSegment

Phân đoạn sự kiện trực tiếp.

Biểu diễn dưới dạng JSON 
{
  "lifeEvent": string
}
Các trường
lifeEvent

string

Tài nguyên sự kiện trong đời.

DetailedDemographicSegment

Phân khúc đối tượng nhân khẩu học chi tiết.

Biểu diễn dưới dạng JSON 
{
  "detailedDemographic": string
}
Các trường
detailedDemographic

string

Tài nguyên chi tiết về nhân khẩu học.

CustomAudienceSegment

Phân khúc đối tượng tuỳ chỉnh.

Biểu diễn dưới dạng JSON 
{
  "customAudience": string
}
Các trường
customAudience

string

Tài nguyên đối tượng tuỳ chỉnh.

AudienceExclusionDimension

Phương diện phủ định chỉ định người dùng cần loại trừ khỏi đối tượng.

Biểu diễn dưới dạng JSON 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
Các trường
exclusions[]

object (ExclusionSegment)

Phân khúc đối tượng cần loại trừ.

ExclusionSegment

Một phân khúc đối tượng cần loại trừ khỏi một đối tượng.

Biểu diễn dưới dạng JSON 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
Các trường
Trường nhóm segment. Phân đoạn cần loại trừ. segment chỉ có thể là một trong những trạng thái sau đây:
userList

object (UserListSegment)

Phân khúc danh sách người dùng cần loại trừ.