- Biểu diễn dưới dạng JSON
- AudienceStatus
- AudienceDimension
- AgeDimension (Kích thước độ tuổi)
- AgeSegment
- GenderDimension
- HouseholdIncomeDimension
- ParentalStatusDimension
- AudienceSegmentDimension
- AudienceSegment
- UserListSegment
- UserInterestSegment
- LifeEventSegment (Phân đoạn sự kiện trong đời)
- DetailedDemographicSegment
- CustomAudienceSegment
- AudienceExclusionDimension
- ExclusionSegment (Phân loại loại trừ)
- AudienceScope
Đố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 ( |
Các trường | |
---|---|
resourceName |
Không thể thay đổi. Tên tài nguyên của đối tượng. Tên đối tượng có dạng:
|
id |
Chỉ có đầu ra. Mã nhận dạng của đối tượng. |
status |
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á. |
description |
Nội dung mô tả về đối tượng này. |
dimensions[] |
Phương diện dương xác định thành phần đối tượng. |
exclusionDimension |
Phương diện âm chỉ định thành phần đối tượng. |
scope |
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 phải từ CUSTOMER sang ASSET_GROUP. |
assetGroup |
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. 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 |
Tên của đối tượng. Mã này phải là duy nhất cho tất cả đối tượng trong tài khoản. Mã này 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 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 |
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 |
Phương diện chỉ định người dùng theo độ tuổi. |
gender |
Phương diện chỉ định người dùng theo giới tính. |
householdIncome |
Phương diện chỉ định người dùng theo thu nhập hộ gia đình. |
parentalStatus |
Phương diện chỉ định người dùng theo tình trạng con cái. |
audienceSegments |
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 ( |
Các trường | |
---|---|
ageRanges[] |
Các độ tuổi liền nhau cần được đưa vào phương diện này. |
includeUndetermined |
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 |
Độ 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 |
Độ 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 ( |
Các trường | |
---|---|
genders[] |
Phân khúc nhân khẩu học theo giới tính đã được thêm vào. |
includeUndetermined |
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 ( |
Các trường | |
---|---|
incomeRanges[] |
Phân khúc nhân khẩu học có thu nhập hộ gia đình được bao gồm. |
includeUndetermined |
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 ( |
Các trường | |
---|---|
parentalStatuses[] |
Đã bao gồm phân khúc nhân khẩu học về tình trạng con cái. |
includeUndetermined |
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 ( |
Các trường | |
---|---|
segments[] |
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 |
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 |
Phân đoạn danh sách người dùng. |
userInterest |
Phân khúc chung sở thích hoặc Phân khúc đang cân nhắc mua hàng. |
lifeEvent |
Phân khúc đối tượng của sự kiện trực tiếp. |
detailedDemographic |
Phân khúc đối tượng nhân khẩu học chi tiết. |
customAudience |
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 |
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 |
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 |
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 |
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 |
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 ( |
Các trường | |
---|---|
exclusions[] |
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 |
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 |
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ể có 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 đặt trong phạm vi ở cấp khách hàng. |
ASSET_GROUP |
Đối tượng này nằm trong phạm vi một AssetGroup cụ thể. |