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 đố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 đối tượng tuỳ chỉnh đã được bật hay 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ả đối tượng tuỳ chỉnh do một khách hàng tạo. Đây là trường bắt buộc để tạo thao tác.
type

enum (CustomAudienceType)

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

string

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

object (CustomAudienceMember)

Danh sách thành phần đối tượng tuỳ chỉnh tạo nên đố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 viên được trình bày trong thao tác UPDATE, thì các thành viên hiện có sẽ bị ghi đè.

CustomAudienceStatus

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

CustomAudienceMember

Một thành viên của đối tượng tuỳ chỉnh. Thành phần có thể là TỪKHOÁ, URL, DANH_MUC_DIA_DIEM hoặc ỨNG_DỤNG. Bạn chỉ có thể tạo hoặc xoá thành phần chứ không thể thay đổi.

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 đối tượng tuỳ chỉnh, TỪKHOÁ, URL, PLACE_CATEGORY hoặc APP.
Trường hợp hợp nhất value. Giá trị CustomAudienceMember. Một trường sẽ được điền tuỳ thuộc vào loại thành viên. value chỉ có thể là một trong những giá trị sau:
keyword

string

Từ khoá hoặc cụm từ khoá — tối đa 10 từ và 80 ký tự. Đối với các ngôn ngữ có ký tự 2 byte như tiếng Trung, tiếng Nhật hoặc tiếng Hàn, bạ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

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

string (int64 format)

Loại địa điểm được mô tả bằng danh mục địa điểm mà người dùng truy cập.
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 đối tượng tuỳ chỉnh 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.
KEYWORD Những 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 Những 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ả bằng một danh mục địa điểm.
APP Người dùng đã cài đặt ứng dụng di động.