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 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),
  "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 khẳng đị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 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 ở phạm vi ASSET_GROUP để một assetGroup duy nhất sử dụng độc quyền. Phạm vi có thể thay đổi từ ASSET_GROUP thành CUSTOMER nhưng không 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 đặt khi và chỉ khi phạm vi là ASSET_GROUP. Bất biến 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. Giá trị này phải là duy nhất cho tất cả các đối tượng trong tài khoản. Phải có độ dài tối thiểu là 1 và chiều 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ề. Biểu thị 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 đã xoá – đối tượng đã bị xoá và không thể dùng để nhắm mục tiêu.

AudienceDimension

Phương diện tích cực 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 kết 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 đâ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 của họ.
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
}
Trường
ageRanges[]

object (AgeSegment)

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

boolean

Bao gồm những người dùng không được xác định 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 được phép đưa vào. Phải chỉ định độ tuổi tối thiểu và ít nhất phải 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 được đưa vào. 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)

Đã thê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 không được 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 của họ.

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

enum (IncomeRangeType)

Đã thêm các phân khúc nhân khẩu học theo thu nhập hộ gia đình.
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)

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

boolean

Bao gồm 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 được thêm vào. Người dùng được bao gồm nếu họ thuộc ít nhất 1 phân khúc.

AudienceSegment

Phân khúc đối tượng tích cực.

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 kết 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 đâ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 có ý định mua hàng.
lifeEvent

object (LifeEventSegment)

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

object (DetailedDemographicSegment)

Phân khúc Thông tin chi tiết về nhân khẩu học.
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.

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 về sự kiện trong đời.

DetailedDemographicSegment

Phân khúc Thông tin chi tiết về nhân khẩu học.

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 về đối tượng tuỳ chỉnh.

AudienceExclusionDimension

Phương diện phủ định chỉ định những 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)
    }
  ]
}
Trường
exclusions[]

object (ExclusionSegment)

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

ExclusionSegment

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 kết hợp 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ừ.

AudienceScope

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

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