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 những 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),
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  },
  "scope": enum (AudienceScope),
  "assetGroup": string,
  "name": string
}
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 đối tượng được bật hay bị xoá.
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 phủ định chỉ định thành phần đối tượng.
scope

enum (AudienceScope)

Xác định phạm vi có thể sử dụng đối tượng này. Theo mặc định, phạm vi là CUSTOMER. Bạn có thể tạo đối tượng với phạm vi ASSET_GROUP để một AssetGroup sử dụng độc quyền. Phạm vi có thể thay đổi từ ASSET_GROUP thành CUSTOMER, nhưng không thể thay đổi từ CUSTOMER thành ASSET_GROUP.
assetGroup

string

Không thể thay đổi. Nhóm thành phần chứa đối tượng này. Phải được đặt khi và chỉ khi phạm vi là ASSET_GROUP. Không thể thay đổi sau khi tạo. Nếu một đối tượng có phạm vi ASSET_GROUP được nâng cấp lên phạm vi CUSTOMER, thì trường này sẽ tự động bị xóa.
name

string

Tên của đối tượng. Mã này phải là duy nhất cho tất cả các đối tượng trong tài khoản. Ảnh phải có độ dài tối thiểu là 1 và độ dài tối đa là 255. Bắt buộc khi phạm vi không được đặt hoặc được đặt thành CUSTOMER. Không thể đặt hoặc cập nhật khi phạm vi là ASSET_GROUP.

AudienceStatus

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

Enum
UNSPECIFIED Chưa chỉ đị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 đang bật – đối tượng đang bật và có thể được nhắm mục tiêu.
REMOVED Trạng thái đã 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.
}
Trường
Trường hợp 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:
age

object (AgeDimension)

Phương diện chỉ định người dùng theo độ tuổi của họ.
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 của họ.

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

object (AgeSegment)

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

boolean

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

AgeSegment

Độ tuổi liền nhau.

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

integer

Độ tuổi tối thiểu để đưa vào. Phải chỉ định độ tuổi tối thiểu và ít nhất phải từ 18 tuổi. 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
}
Trường
genders[]

enum (GenderType)

Đã bao gồm phân khúc nhân khẩu học theo giới tính.
includeUndetermined

boolean

Bao gồm những người dùng chưa xác định giới tí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
}
Trường
incomeRanges[]

enum (IncomeRangeType)

Phân khúc nhân khẩu học có thu nhập hộ gia đình đã 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
}
Trường
parentalStatuses[]

enum (ParentalStatusType)

Đã bao gồm các phân khúc theo thông tin 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)
    }
  ]
}
Trường
segments[]

object (AudienceSegment)

Phân khúc đối tượng đã bao gồm. 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.
}
Trường
Trường hợp segment. Phân đoạn khẳng định. segment chỉ có thể là một trong những trạng thái sau:
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 có ý định 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 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
}
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
}
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
}
Trường
lifeEvent

string

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

DetailedDemographicSegment

Phân khúc nhân khẩu học chi tiết.

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

string

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

CustomAudienceSegment

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

Biểu diễn dưới dạng JSON 
{
  "customAudience": string
}
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 để loại trừ khỏi đối tượng.

Biểu diễn dưới dạng JSON 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
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 đố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.
}
Trường
Trường hợp segment. Phân khúc cần loại trừ. segment chỉ có thể là một trong những trạng thái sau:
userList

object (UserListSegment)

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

AudienceScope

Enum chứa các giá trị có thể có trong phạm vi đối tượng.

Enum
UNSPECIFIED Phạm vi chưa được chỉ định.
UNKNOWN Phiên bản này không xác định giá trị đã nhận.
CUSTOMER Đối tượng thuộc phạm vi ở cấp khách hàng.
ASSET_GROUP Đối tượng nằm trong phạm vi một AssetGroup cụ thể.