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)
    }
  ]
}
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 của đố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à mã riêng biệt cho tất 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 INTEREST" hoặc "PURCHASE_INTENT" cho đối tượng tuỳ chỉnh mới tạo nhưng vẫn giữ nguyên cho các đối tượng hiện tại)
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 bao gồm đối tượng tuỳ chỉnh này. Bạn có thể thêm thành viên trong quá trình tạo CustomAudience. Nếu các thành phần xuất hiện 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 của đối tượng tuỳ chỉnh 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 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 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.
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 So khớp người dùng theo mối quan tâm.
PURCHASE_INTENT Khớp với người dùng theo chủ đề họ đang nghiên cứu hoặc sản phẩm họ đang cân nhắc mua.
SEARCH So khớp 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ừ khóa, URL, địa điểm

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.
}
Trường
memberType

enum (CustomAudienceMemberType)

Loại thành viên của đối tượng tùy chỉnh, Từ khóa, URL, DANH_DANH_ hoặc ỨNG DỤNG.
Trường hợp value. Giá trị CustomAudienceComponent. Một trường được điền sẵn tuỳ thuộc vào loại thành viên. value chỉ có thể là một trong những trạng thái sau:
keyword

string

Một từ khoá hoặc cụm từ khoá – tối đa 10 từ và 80 ký tự. Hệ thống cho phép 40 ký tự đối với những ngôn ngữ có ký tự 2 byte (như tiếng Trung, tiếng Nhật hoặc tiếng Hàn) nhằm 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 danh mục địa điểm mà người dùng ghé thăm.
app

string

Tên gói của các ứ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ó của đối tượng tuỳ chỉnh.

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.
KEYWORD Người dùng có mối quan tâm hoặc hành động được mô tả bằng một từ khoá.
URL Người dùng có mối quan tâm 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.