Tạo và sửa đổi phân khúc dữ liệu

Tạo phân khúc dữ liệu mới

Bạn có thể tạo một phân khúc dựa trên dữ liệu mới bằng phương thức curators.dataSegments.create. Sau khi tạo, phân khúc dữ liệu của bạn sẽ ở trạng thái ACTIVE, cho phép các giao dịch hoặc gói phân phát trong phiên Đặt giá thầu theo thời gian thực nhắm đến phân khúc dữ liệu.

Để các nhà lập kế hoạch truyền thông có thể thấy phân khúc dữ liệu để nhắm mục tiêu giao dịch hoặc gói, bạn phải bật Khả năng hiển thị phân khúc trong thẻ Cài đặt phân khúc dữ liệu của Giao diện người dùng tuyển chọn.

Điểm chính: Khi tạo một phân khúc dữ liệu, nội dung yêu cầu phải có một trường name chứa đường dẫn tài nguyên có giá trị chuỗi curatorDataSegmentId duy nhất. curatorDataSegmentId là giá trị dùng để nhắm mục tiêu đến ưu đãi hoặc gói.

Ví dụ sau đây đưa ra yêu cầu HTTP POST với nội dung JSON chứa đối tượng DataSegment. Yêu cầu được gửi đến một điểm cuối API tạo một phân khúc dữ liệu có cấu hình được chỉ định.

Ví dụ về lệnh gọi API curl

Yêu cầu

curl --request POST \
'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"cpmFee":{"nanos":100,"units":0,"currencyCode":"USD"},"name":"curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2"}' \
--compressed
    

Phản hồi

{
  "name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2",
  "createTime": "2025-08-14T17:45:08.744379Z",
  "updateTime": "2025-08-14T17:45:08.744379Z",
  "cpmFee": {
    "currencyCode": "USD",
    "nanos": 100
  },
  "state": "ACTIVE"
}
    

Sửa đổi một phân khúc dữ liệu hiện có

Để sửa đổi một phân đoạn dữ liệu hiện có, bạn có thể sử dụng phương thức curators.dataSegments.patch. Ví dụ: sử dụng phương thức này để điều chỉnh trường cpmFee cho phân đoạn dữ liệu.

Ví dụ sau đây đưa ra yêu cầu HTTP PATCH với nội dung JSON chứa đối tượng DataSegment. Yêu cầu được gửi đến một điểm cuối API sửa đổi phân khúc dữ liệu đã chỉ định và chỉ sửa đổi trường DataSegment.cpmFee.nanos được chỉ định trong updateMask.

Ví dụ về lệnh gọi API curl

Yêu cầu

curl --request PATCH \
  'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2?updateMask=cpmFee.nanos&key=[YOUR_API_KEY]' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"cpmFee":{"nanos":50}}' \
  --compressed
    

Phản hồi

{
  "name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2",
  "createTime": "2025-08-14T17:45:08.744Z",
  "updateTime": "2025-08-14T17:56:02.200619Z",
  "cpmFee": {
    "currencyCode": "USD",
    "nanos": 50
  },
  "state": "ACTIVE"
}
    

Các bước tiếp theo

• Tìm hiểu cách kích hoạt và huỷ kích hoạt phân khúc dựa trên dữ liệu bằng Marketplace API.
• Tìm hiểu cách xem phân khúc dựa trên dữ liệu của bạn bằng Marketplace API.
• Tìm hiểu về quy cách tuyển chọn theo thời gian thực.
• Tìm hiểu cách phân tích cú pháp các yêu cầu phân đoạn đến trong tính năng Sắp xếp theo thời gian thực.