CustomInterest

Mối quan tâm 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,
  "status": enum (CustomInterestStatus),
  "type": enum (CustomInterestType),
  "members": [
    {
      object (CustomInterestMember)
    }
  ],
  "id": string,
  "name": string,
  "description": string
}
Các trường
resourceName

string

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

customers/{customerId}/customInterests/{custom_interest_id}

status

enum (CustomInterestStatus)

Trạng thái của mối quan tâm tuỳ chỉnh này. Cho biết liệu mối quan tâm tuỳ chỉnh đang bật hay bị xoá.

type

enum (CustomInterestType)

Loại sở thích tùy chỉnh, custom_AFFINITY hoặc custom_INTENT. Theo mặc định, loại này được đặt thành CUSTOM_AFFINITY.

members[]

object (CustomInterestMember)

Danh sách các thành viên có mối quan tâm tuỳ chỉnh có chứa mối quan tâm tuỳ chỉnh này. Bạn có thể thêm thành viên trong quá trình tạo Custominterest. 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 đè.

id

string (int64 format)

Chỉ có đầu ra. Mã của mối quan tâm tuỳ chỉnh.

name

string

Tên của mối quan tâm tuỳ chỉnh. Giá trị này phải là duy nhất trên cùng một đối tượng chung sở thích tuỳ chỉnh. Đây là trường bắt buộc để tạo hoạt động.

description

string

Nội dung mô tả về đối tượng có mối quan tâm tuỳ chỉnh này.

CustomInterestStatus

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

CustomInterestType

Enum chứa các loại mối quan tâm 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.
CUSTOM_AFFINITY Cho phép nhà quảng cáo thương hiệu xác định danh sách đối tượng chung sở thích tùy chỉnh.
CUSTOM_INTENT Cho phép nhà quảng cáo xác định danh sách đối tượng có mục đích tùy chỉnh.

CustomInterestMember

Là thành viên của đối tượng có mối quan tâm tuỳ chỉnh. Thành viên có thể là một từ khoá hoặc URL. Đó là bất biến, tức là chỉ có thể tạo hoặc xoá chứ không thể thay đổi.

Biểu diễn dưới dạng JSON
{
  "memberType": enum (CustomInterestMemberType),
  "parameter": string
}
Các trường
memberType

enum (CustomInterestMemberType)

Loại thành viên có sở thích tuỳ chỉnh, từ khoá hoặc URL.

parameter

string

Văn bản từ khoá khi memberType là TỪ KHOÁ hoặc chuỗi URL khi thành viênType là URL.

CustomInterestMemberType

Enum chứa các loại thành phần có thể có theo mối quan tâm 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 Loại thành viên có mối quan tâm tùy chỉnh KEY.
URL URL loại thành viên có mối quan tâm tuỳ chỉnh.