Tài nguyên: Phân khúc dữ liệu
Xác định giá trị nhận dạng cho một phân khúc khoảng không quảng cáo mà người tuyển chọn hoặc chuyên viên kế hoạch truyền thông có thể nhắm đến trong giao diện người dùng của gói đấu giá hoặc giao dịch. Việc tuyển chọn khoảng không quảng cáo do người tuyển chọn thực hiện trên các nền tảng bên ngoài. -- Next ID: 9 --
| Biểu diễn dưới dạng JSON |
|---|
{ "name": string, "createTime": string, "updateTime": string, "state": enum ( |
| Trường | |
|---|---|
name |
Không thể thay đổi. Giá trị nhận dạng. Giá trị nhận dạng riêng biệt của phân khúc dữ liệu. Mã tài khoản tương ứng với mã tài khoản đã tạo phân khúc. Định dạng |
createTime |
Chỉ có đầu ra. Thời điểm tạo phân khúc dữ liệu. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
updateTime |
Chỉ có đầu ra. Thời điểm phân khúc dữ liệu được cập nhật gần đây nhất. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
state |
Chỉ có đầu ra. Trạng thái của phân khúc dựa trên dữ liệu. |
| Phí sẽ được tính khi các tài khoản khác sử dụng phân khúc dữ liệu này. Ví dụ: khi các tài khoản khác thêm phân khúc dữ liệu này vào một giao dịch hoặc gói đấu giá. Bạn không thể thay đổi loại phí của phân khúc dựa trên dữ liệu sau khi đặt. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi: | |
cpmFee |
Không bắt buộc. Phí cố định được tính cho mỗi nghìn lượt hiển thị. Sau khi đặt, bạn không thể thay đổi mã tiền tệ. |
millipercentOfMediaFee |
Không bắt buộc. Phí sẽ được tính theo tỷ lệ phần trăm của chi phí cho mỗi lượt hiển thị, được biểu thị bằng phần nghìn phần trăm. Ví dụ: 1% được biểu thị là 1000. |
| Kết thúc các trường loại trừ lẫn nhau. | |
userListId |
Không bắt buộc. Không thể thay đổi. Mã nhận dạng của Danh sách người dùng được gói trong Phân khúc dữ liệu này. Người quản lý có tài khoản Đối tác dữ liệu được liên kết có thể tạo một phân khúc dữ liệu bao gồm danh sách người dùng thuộc sở hữu của tài khoản Đối tác dữ liệu được liên kết. Bạn có thể tải danh sách người dùng lên và quản lý danh sách đó bằng Data Manager API. Việc liên kết danh sách người dùng với một phân khúc dữ liệu cho phép bạn xác định một phân khúc khoảng không quảng cáo dựa trên đối tượng mà bạn tạo. |
Tiểu bang
Chỉ có đầu ra. Sử dụng phương thức kích hoạt và huỷ kích hoạt để thay đổi trạng thái.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Giá trị mặc định. |
ACTIVE |
Phân khúc dữ liệu đang hoạt động. |
INACTIVE |
Phân khúc dữ liệu không hoạt động. |
SUSPENDED |
Phân khúc dữ liệu bị tạm ngưng và không thể kích hoạt. |
Phương thức |
|
|---|---|
|
Kích hoạt một phân khúc dựa trên dữ liệu. |
|
Tạo một phân khúc dữ liệu thuộc sở hữu của người tuyển chọn trong danh sách. |
|
Huỷ kích hoạt một phân khúc dựa trên dữ liệu. |
|
Lấy một phân khúc dữ liệu theo tên của phân khúc đó. |
|
Liệt kê các phân khúc dữ liệu do một người tuyển chọn sở hữu. |
|
Cập nhật phân khúc dựa trên dữ liệu. |