تجربة مواضيع Chrome لعرض الأسعار في الوقت الفعلي (RTB)

كجزء من مبادرة حماية الخصوصية، اقترح Chrome Topics API التجريبية. تزوِّد Topics API المتصلين التابعين لجهات خارجية على صفحة الويب (بما في ذلك مزوّدو تقنية الإعلان) بمواضيع إعلانية دقيقة قد يهتم بها زائر الصفحة حاليًا. ويمكن للمواضيع أن تكمل المعلومات السياقية حول الصفحة الحالية، ويمكن أن تكون مفيدة في دعم الإعلانات التي تستهدف الاهتمامات.

تتوفّر تجربة Topics API للشركاء الذين يقدّمون عروض الأسعار في الوقت الفعلي (RTB) في طلبات عروض الأسعار. املأ نموذج الطلب للانضمام إلى تجربة Topics API. يمكنك التواصل مع مدير حسابك للحصول على مزيد من المعلومات.

تمثيل طلب عرض السعر

بروتوكول "الشراة المعتمَدون" من Google

يتم تمثيل المواضيع في الحقل topics في رسالة BidRequest. ويتوفر هذا الحقل في الإصدار التجريبي المفتوح من البروتوكول.

هَا هُوَ التَّعْرِيفْ:

  // 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;

بروتوكول OpenRTB

يتم تمثيل المواضيع كأقسام في رسالة BidRequest.user.data OpenRTB.

الحقل	Type	الوصف
Data.ext.segtax	عدد صحيح	تمثّل هذه السمة معرّف تصنيف يتم تسجيله مركزيًا. وبالنسبة إلى المواضيع، هذا هو إصدار تصنيف الإعلانات الذي يحدّد المعنى الدلالي لكل معرّف موضوع. 600 يُستخدم للتصنيف الأولي لـ Topics في Chrome.
Data.ext.segclass	سلسلة	هذا الرمز مكافئ للرمز classifier_version.
Data.segment.id	سلسلة	هذا الرمز مكافئ للرمز id الذي تم تحويله إلى سلسلة.

Data.ext هو إضافة لرسالة BidRequest.user.data. وتتوفّر هذه الإضافة في الإصدار التجريبي المفتوح من البروتوكول.

هَا هُوَ التَّعْرِيفْ:

// 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;
}

أمثلة

في ما يلي مثال على كيفية تمثيل بروتوكولات "الشراة المعتمَدون من Google" وبروتوكولات OpenRTB للمواضيع التي تعرضها واجهة برمجة التطبيقات Chrome Topics API.

رد Chrome Topics API، المعروض من خلال document.browsingTopics():

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

طلب عرض السعر لبروتوكول "الشراة المعتمَدون من 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"
}

طلب عرض أسعار OpenRTB:

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

في المثال السابق، يشير taxonomy_version إلى أنه تم استخدام تعيين تصنيف_تصنيف_v1. بناءً على التصنيف، تتوافق معرفات الموضوعات هذه مع الموضوعات التالية:

رقم تعريف الموضوع	قيمة الموضوع
3	/فنون وترفيه/كتب هزلية
44	/فنون وترفيه/أوبرا
59	/سيارات ومركبات/مركبات كلاسيكية

مدى التوفّر

يخضع توفُّر المواضيع في طلب عرض السعر إلى عناصر التحكّم وحماية الخصوصية الحالية. على سبيل المثال، لا تكون المواضيع متاحة إذا أوقف المستخدم ميزة الإعلانات المخصّصة أو أوقفها في مستودع الإعلانات غير المخصّصة.