CustomAudience

Đối tượng tuỳ chỉnh. Đây là danh sách người dùng theo mối quan tâm.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
Các trường
resourceName

string

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

customers/{customerId}/customAudiences/{custom_audience_id}
id

string (int64 format)

Chỉ có đầu ra. Mã của đối tượng tuỳ chỉnh.
status

enum (CustomAudienceStatus)

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

string

Tên của đối tượng tuỳ chỉnh. Mã này phải là duy nhất cho tất cả các đối tượng tuỳ chỉnh do khách hàng tạo. Đây là trường bắt buộc để tạo hoạt động.
type

enum (CustomAudienceType)

Loại đối tượng tuỳ chỉnh. (Không được phép sử dụng QUAN TÂM" HOẶC "PURCHASE_INTENT" cho đối tượng tuỳ chỉnh mới tạo, nhưng giữ lại cho các đối tượng hiện có)
description

string

Nội dung mô tả về đối tượng tuỳ chỉnh này.
members[]

object (CustomAudienceMember)

Danh sách các thành viên của đối tượng tuỳ chỉnh trong đối tượng tuỳ chỉnh này. Bạn có thể thêm thành viên trong quá trình tạo Đối tượng tuỳ chỉnh. Nếu các thành phần được hiển thị trong thao tác CẬP NHẬT, thì các thành phần hiện có sẽ bị ghi đè.

CustomAudienceStatus

Enum chứa các trạng thái đối tượng tuỳ chỉnh 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 tuỳ chỉnh đang bật và có thể được nhắm mục tiêu.
REMOVED Trạng thái đã xoá – đối tượng tuỳ chỉnh đã bị xoá và không thể dùng để nhắm mục tiêu.

CustomAudienceType

Enum chứa các loại đối tượng tuỳ chỉnh 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.
AUTO Google Ads sẽ tự động chọn cách diễn giải phù hợp nhất tại thời điểm phân phát.
INTEREST Khớp người dùng theo mối quan tâm của họ.
PURCHASE_INTENT So khớp người dùng theo chủ đề họ đang tìm hiểu hoặc sản phẩm mà họ đang cân nhắc mua.
SEARCH Khớp với người dùng theo nội dung họ đã tìm kiếm trên Google Tìm kiếm.

CustomAudienceMember

Là thành viên của đối tượng tuỳ chỉnh. Thành viên có thể là từ khoá, URL, địa chỉ Place_CATEGORY hoặc ỨNG DỤNG. Bạn chỉ có thể tạo hoặc xoá thành viên này, chứ không thể thay đổi thành phần này.

Biểu diễn dưới dạng JSON 
{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}
Các trường
memberType

enum (CustomAudienceMemberType)

Loại thành viên đối tượng tùy chỉnh, từ khóa, URL, địa điểm bên thứ ba hoặc ứng dụng.
Trường nhóm value. Giá trị CustomAudienceAudience. Một trường được điền sẵn tuỳ theo loại thành viên. value chỉ có thể là một trong những trạng thái sau đây:
keyword

string

Từ khoá hoặc cụm từ khoá – tối đa 10 từ và 80 ký tự. Những ngôn ngữ có ký tự 2 byte (như tiếng Trung, tiếng Nhật hoặc tiếng Hàn) được phép sử dụng 40 ký tự, mô tả mối quan tâm hoặc hành động của người dùng.
url

string

Một URL loại HTTP có bao gồm giao thức, tối đa 2048 ký tự, bao gồm cả nội dung mà người dùng quan tâm.
placeCategory

string (int64 format)

Loại địa điểm được mô tả theo một danh mục địa điểm mà người dùng ghé thăm.
app

string

Tên gói của những ứng dụng Android mà người dùng đã cài đặt, chẳng hạn như com.google.example.

CustomAudienceMemberType

Enum chứa các loại thành viên có thể có đối tượng tuỳ chỉnh.

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.
KEYWORD Người dùng có sở thích hoặc hành động được mô tả bằng từ khóa.
URL Người dùng có sở thích liên quan đến nội dung của trang web.
PLACE_CATEGORY Những người dùng truy cập vào các loại địa điểm được mô tả theo một danh mục địa điểm.
APP Người dùng đã cài đặt ứng dụng di động.