Thử nghiệm Chủ đề trên Chrome cho RTB

Trong Hộp cát về quyền riêng tư, Chrome đã đề xuất API Chủ đề thử nghiệm. API Chủ đề cung cấp cho phương thức gọi của bên thứ ba trên trang web (bao gồm cả nhà cung cấp công nghệ quảng cáo) các chủ đề quảng cáo chi tiết mà khách truy cập trang hiện có thể quan tâm. Các chủ đề này có thể bổ sung thông tin theo ngữ cảnh về trang hiện tại và có thể hữu ích khi hỗ trợ quảng cáo dựa trên mối quan tâm.

Thử nghiệm Topics API dành cho các đối tác đặt giá thầu theo thời gian thực (RTB) trong yêu cầu giá thầu. Hãy điền vào biểu mẫu yêu cầu để tham gia thử nghiệm API Chủ đề. Hãy liên hệ với người quản lý tài khoản của bạn để biết thêm thông tin.

Trình bày yêu cầu giá thầu

Giao thức Authorized Buyers của Google

Các chủ đề được thể hiện trong trường topics trong thông báo BidRequest. Trường này có trong phiên bản beta mở của giao thức.

Dưới đây là định nghĩa:

  // Experimental field; subject to change.
  // A coarse-grained topic that a website visitor might currently be interested
  // in based on recent browsing activity. See
  // https://developer.chrome.com/docs/privacy-sandbox/topics/ and/or
  // https://privacysandbox.com/intl/en_us/proposals/topics/ for more
  // information about the Topics API. Reach out to your account manager to
  // participate in the Topics API experiment.
  message Topic {
    // The value of a topic ID. A numerical identifier corresponding to a
    // coarse-grained advertising topic. See
    // https://github.com/patcg-individual-drafts/topics/blob/main/taxonomy_v1.md
    // for a list of topics in the initial taxonomy.
    optional int32 id = 1;
    // The version of the advertising taxonomy which defines the semantic
    // meaning of each topic ID for the topics, for example "v1".
    optional string taxonomy_version = 2;
    // The version of the classifier used by the browser to map hostnames to
    // topic IDs in the taxonomy.
    optional string classifier_version = 3;
  }

  // The list of topics that a website visitor might currently be interested in
  // inferred by the browser based on recent browsing activity. See
  // https://developer.chrome.com/docs/privacy-sandbox/topics/ and/or
  // https://privacysandbox.com/intl/en_us/proposals/topics/ for more
  // information about Topics API.
  repeated Topic topics = 74;

Giao thức OpenRTB

Các chủ đề được biểu thị dưới dạng phân khúc trong thông báo OpenRTB BidRequest.user.data.

Trường	Loại	Nội dung mô tả
Data.ext.segtax	Số nguyên	Mã nhận dạng của một hệ thống phân loại được đăng ký tập trung. Đối với Chủ đề, đây là phiên bản của hệ thống phân loại quảng cáo, xác định ý nghĩa ngữ nghĩa của từng mã chủ đề. 600 được dùng cho cách phân loại ban đầu Chủ đề của Chrome.
Data.ext.segclass	Chuỗi	Tương đương với classifier_version.
Data.segment.id	Chuỗi	Tương đương với id được truyền thành một chuỗi.

Data.ext là phần mở rộng cho tin nhắn BidRequest.user.data. Tiện ích này có sẵn trong phiên bản beta mở của giao thức.

Dưới đây là định nghĩa:

// Ad Exchange extensions for the Data object.
message DataExt {
  // The ID for a taxonomy that is registered centrally. Used to define the
  // namespace and semantic meaning of the segment IDs. See
  // https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/extensions/community_extensions/segtax.md#enumeration-of-taxonomies
  // for the enumeration of the taxonomies that this value can take. Currently
  // only Chrome Topics API taxonomy (segtax=600) is supported.
  optional int32 segtax = 1;

  // The version of the classifier which produced the segment IDs within the
  // taxonomy. For example, in the case of Chrome Topics API (segtax=600), this
  // is the version of the classifier used by the browser to map hostnames to
  // topics in the taxonomy.
  optional string segclass = 2;
}

Ví dụ

Sau đây là ví dụ về cách giao thức Authorized Buyers và OpenRTB của Google thể hiện các chủ đề do API Chủ đề của Chrome trả về.

Phản hồi của API Chủ đề Chrome, do document.browsingTopics() trả về:

[
  {
    "modelVersion": "classifier_v1",
    "taxonomyVersion": "taxonomy_v1",
    "topic": 3
  },
  {
    "modelVersion": "classifier_v1",
    "taxonomyVersion": "taxonomy_v1",
    "topic": 44
  },
  {
    "modelVersion": "classifier_v1",
    "taxonomyVersion": "taxonomy_v1",
    "topic": 59
  }
]

Giá thầu yêu cầu giao thức Authorized Buyers của Google:

topics {
  id: 3
  taxonomy_version: "taxonomy_v1"
  classifier_version: "classifier_v1"
}
topics {
  id: 44
  taxonomy_version: "taxonomy_v1"
  classifier_version: "classifier_v1"
}
topics {
  id: 59
  taxonomy_version: "taxonomy_v1"
  classifier_version: "classifier_v1"
}

Yêu cầu giá thầu OpenRTB:

{
  "user": {
    "data": [
      {
        "ext": {
          "segtax": 600,
          "segclass": "classifier_v1"
        },
        "segment": [
          { "id": "3" },
          { "id": "44" },
          { "id": "59" }
        ]
      }
    ]
  }
}

Trong ví dụ trước, taxonomy_version ngụ ý rằng mối liên kết logcat_v1 được sử dụng. Dựa trên cách phân loại, những mã chủ đề này tương ứng với các chủ đề sau:

Mã chủ đề	Giá trị chủ đề
3	/Nghệ thuật & giải trí/Truyện tranh
44	/Nghệ thuật & giải trí/Opera
59	/Ô tô và xe cộ/Phương tiện cổ điển

Phạm vi áp dụng

Sự hiện diện của chủ đề trong yêu cầu giá thầu phải tuân theo các biện pháp kiểm soát và bảo vệ quyền riêng tư hiện có. Ví dụ: sẽ không có chủ đề nếu người dùng chọn không nhận quảng cáo được cá nhân hoá hoặc khoảng không quảng cáo quảng cáo không được cá nhân hoá.