Protected Audience के तहत आने वाले ऑफ़र

Protected Audience API से जुड़ी नीलामी में, डील लागू करना. इन्हें प्राइवेट मार्केटप्लेस (पीएमपी) भी कहा जाता है

खास जानकारी

डील को निजी मार्केटप्लेस (पीएमपी) भी कहा जाता है. इसमें, इन्वेंट्री के सबसेट पर खरीदारों को चुनिंदा ऐक्सेस या पसंदीदा कीमत की सुविधा मिलती है. प्रोग्रैम्ड तरीके से डील करने के लिए, सीट आईडी और डील आईडी इस्तेमाल किए जाते हैं:

  • सीट आईडी, खरीदार से मिलता है. यह एक आइडेंटिफ़ायर है, जो खरीदार के ग्राहक की पहचान करता है. सीट आईडी से बिलिंग पर असर पड़ सकता है. उदाहरण के लिए, अगर किसी सेलर ने सीट के लिए छूट दी है.
  • डील आईडी खरीदार या विक्रेता से मिलता है. यह एक आइडेंटिफ़ायर होता है, जो खरीदार और सेलर के बीच हुए कानूनी समझौते को दिखाता है. डील आईडी में कई प्रॉपर्टी हो सकती हैं. जैसे, कीमत/कीमत, वॉल्यूम कमिटी, ऑडियंस की जानकारी, विशिष्टता वगैरह.

सुरक्षित ऑडियंस, रिपोर्टिंग आईडी का इस्तेमाल करके डील की सुविधा देती है. इससे सीट और डील आईडी, ऑक्शन बिडिंग, स्कोरिंग, और रिपोर्टिंग के लिए उपलब्ध हो जाते हैं. रिपोर्टिंग आईडी की मदद से, विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनियों को डील और सीट आईडी मिलते हैं. ये आईडी, नीलामी के बाद Protected Audience से जुड़े डेटा के लेन-देन की रिपोर्ट में हासिल किए जा सकते हैं. इससे, उन्हें डील के लेन-देन और बिलिंग की कोशिशों को व्यवस्थित करने में मदद मिलती है. हम उम्मीद करते हैं कि खरीदारों, विक्रेताओं, एजेंसियों, और विज्ञापन देने वालों को, उन्हें मिलने वाली डील और सीट आईडी को समझने और समझने के लिए, अपने हिसाब से रणनीतियां तय की गई होंगी.

कदम-दर-कदम निर्देश

Protected Audience API से जुड़ी नीलामी में डील करने का तरीका यहां बताया गया है:

  1. नीलामी शुरू होने से पहले, खरीदार इंटरेस्ट ग्रुप कॉन्फ़िगरेशन में डील और सीट आईडी रजिस्टर करता है
    • डील और सीट के आईडी, चुने जा सकने वाले रिपोर्टिंग आईडी फ़ील्ड (selectableBuyerAndSellerReportingIds) में सेट किए जा सकते हैं.
    • अगर सभी डील के लिए सीट आईडी एक ही है, तो सीट आईडी को buyerAndSellerReportingId में सेट किया जा सकता है. साथ ही, डील आईडी को चुने जा सकने वाले रिपोर्टिंग आईडी फ़ील्ड (selectableBuyerAndSellerReportingIds) में सेट किया जा सकता है.
  2. बिड जनरेशन के दौरान, डील और सीट आईडी उपलब्ध हो जाते हैं. खरीदार, selectableBuyerAndSellerReportingIds से कोई डील आईडी चुनता है. खरीदार, selectedBuyerAndSellerReportingId दिखाकर उस बिड से जुड़ा डील आईडी शामिल करके बिड जनरेट करता है. कोई बोली सिर्फ़ तब जीत सकती है, जब रिटर्न किया गया डील आईडी, अन्य रिपोर्टिंग आईडी और इंटरेस्ट ग्रुप की चुनिंदा प्रॉपर्टी के साथ-साथ दिखता है.
  3. विज्ञापन स्कोर के दौरान, चुनी गई डील और सीट के आईडी, सेलर के लिए उपलब्ध हो जाते हैं.
  4. डील और सीट के आईडी, सेलर के रिपोर्टिंग फ़ंक्शन में उपलब्ध होते हैं.
  5. डील और सीट आईडी, खरीदार के रिपोर्टिंग फ़ंक्शन में उपलब्ध हो जाते हैं.

1. डील और सीट आईडी का रजिस्ट्रेशन

नीलामी शुरू होने से पहले, खरीदार इंटरेस्ट ग्रुप कॉन्फ़िगरेशन में डील और सीट आईडी रजिस्टर करता है. डील और सीट के आईडी, selectableBuyerAndSellerReportingIds में स्ट्रिंग के कलेक्शन के तौर पर सेट होते हैं. अगर सभी डील के लिए सीट आईडी एक ही है और उन्हें दोहराने की ज़रूरत नहीं है, तो सीट आईडी को buyerAndSellerReportingId फ़ील्ड में जोड़ा जा सकता है, जो स्ट्रिंग स्वीकार करता है:

const interestGroupConfig = {
  owner: 'https://buyer.example',
  name: 'example-ig',
  ad: [
    {
      renderURL: 'https://buyer.example/ad.html',
      selectableBuyerAndSellerReportingIds: ['deal123', 'deal456', 'deal789'], // Deal IDs
      buyerAndSellerReportingId: 'seat123', // Seat ID

      // Though it is not used to facilitate deals, the buyer
      // reporting ID can be defined with other reporting IDs
      buyerReportingId: 'brid123'
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

अगर डील के लिए सीट आईडी अलग है, तो यह सेट अप इस्तेमाल किया जा सकता है:

const interestGroupConfig = {
  owner: 'https://buyer.example',
  name: 'example-ig',
  ad: [
    {
      renderURL: 'https://buyer.example/ad.html',
      selectableBuyerAndSellerReportingIds: [
        'deal123seat123',
        'deal456seat456',
        'deal789seat456'
      ], // Deal and Seat IDs
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

2. बिड जनरेशन के दौरान, खरीदारों के लिए डील और सीट आईडी

बिड जनरेशन के दौरान, खरीदार यह तय करता है कि उसे डील आईडी पर बिड करनी है या नहीं. generateBid() में, खरीदार selectableBuyerAndSellerReportingIds से कोई डील आईडी चुन सकता है और वैल्यू को selectedBuyerAndSellerReportingId के तौर पर दिखा सकता है. अगर चुना गया डील आईडी selectableBuyerAndSellerReportingIds कलेक्शन में नहीं है, तो बिड अस्वीकार कर दी जाएगी.

function generateBid(interestGroup, ...) {
  const [{
    buyerAndSellerReportingId, // 'seat123'
    selectableBuyerAndSellerReportingIds // ['deal123', 'deal456', 'deal789']
    buyerReportingId // 'brid123' - Not used for deals, but the value is available
  }] = interestGroup.ads;

  // ...

  return {
    bid: 1,
    render: 'https://buyer.example/ad.html',
    selectedBuyerAndSellerReportingId: 'deal456', // Buyer selects a deal ID
  };
}

selectedbuyerAndSellerReportingId के लिए दिखाई गई वैल्यू वाली बिड, नीलामी में सिर्फ़ तब जीत सकती है, जब selectedbuyerAndSellerReportingId की वैल्यू, buyerAndSellerReportingId (अगर मौजूद है), buyerReportingId (अगर मौजूद है), इंटरेस्ट ग्रुप के मालिक, बिडिंग स्क्रिप्ट यूआरएल, रेंडर यूआरएल, और विज्ञापन साइज़ के साथ मिलकर, k-anonymous हो. कम से कम 2025 की पहली तिमाही तक, विज्ञापन साइज़ को इस जांच से बाहर रखा गया है.

भले ही, selectablebuyerAndSellerReportingIds को इंटरेस्ट ग्रुप कॉन्फ़िगरेशन में तय किया गया हो, लेकिन generateBid() के लिए ऐसी बिड दिखाना मान्य है जिसमें selectedbuyerAndSellerReportingId शामिल न हो. इस मामले में, अगर यह बिड जीतती है, तो रिपोर्टिंग फ़ंक्शन को दिए गए रिपोर्टिंग आईडी, चुने जा सकने वाले रिपोर्टिंग आईडी के व्यवहार का पालन करेंगे.

जिन मामलों में generateBid() को फिर से चलाया जाता है, क्योंकि शुरुआती अनुरोध से ऐसे विज्ञापनों के साथ कोई बिड नहीं मिली जो k-anonymity जांच पास कर चुके हैं, तो फिर से चलाए जाने पर, k-anonymity जांच पास न करने वाले selectableBuyerAndSellerReportingIds, इंटरेस्ट ग्रुप में मौजूद नहीं होंगे.

3. विज्ञापन स्कोरिंग के दौरान, सेलर के लिए डील और सीट आईडी

चुने गए डील आईडी और सीट आईडी (अगर मौजूद हो) को scoreAd() के लिए ऐक्सेस किया जा सकता है. सेलर, डील आईडी और किसी खास शर्त को ध्यान में रखते हुए, बिड जीतने वाली बिड के लिए ज़रूरी स्कोर उपलब्ध कराता है. अगर सेलर को लगता है कि खरीदार ने जो डील आईडी चुना है वह लागू नहीं होता, तो सेलर बिड को अस्वीकार कर देता है. इसके लिए, वह बिड को शून्य या पसंदीदा नहीं होने का स्कोर देता है.

function scoreAd(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingIds, // 'deal456'
  } = browserSignals;

  // ...
}

4. सेलर की रिपोर्टिंग के लिए डील और सीट के आईडी

ध्यान दें कि बिड सिर्फ़ तब जीत सकती है, जब selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (अगर मौजूद है), और buyerReportingId (अगर मौजूद है), इंटरेस्ट ग्रुप के मालिक, बिडिंग की स्क्रिप्ट का यूआरएल, रेंडर यूआरएल, और विज्ञापन का साइज़ से अनजान होती हैं. साल 2025 की पहली तिमाही तक विज्ञापन के साइज़ को इस जांच से बाहर रखा गया है. इसलिए, selectedBuyerAndSellerReportingId वाली रिपोर्टिंग आईडी की वैल्यू, reportResult() में हमेशा उपलब्ध रहेंगी. ध्यान दें कि भले ही buyerReportingId को k-अनामता के लिए चुना जाता है, लेकिन यह मान सिर्फ़ 'खरीदार की रिपोर्टिंग' फ़ंक्शन के लिए उपलब्ध होता है, विक्रेता रिपोर्टिंग फ़ंक्शन के लिए नहीं.

function reportResult(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingIds // 'deal456'
  } = browserSignals;

  // ...
}

5. खरीदार की रिपोर्टिंग के लिए डील और सीट के आईडी

विक्रेता रिपोर्टिंग की यही अवधारणा खरीदारों की रिपोर्टिंग पर भी लागू होती है. ध्यान दें कि बिड सिर्फ़ तब जीत सकती है, जब selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (अगर मौजूद है), और buyerReportingId (अगर मौजूद है), इंटरेस्ट ग्रुप के मालिक, बिडिंग की स्क्रिप्ट का यूआरएल, रेंडर यूआरएल, और विज्ञापन का साइज़ से अनजान होती हैं. साल 2025 की पहली तिमाही तक विज्ञापन के साइज़ को इस जांच से बाहर रखा गया है. इसलिए, selectedBuyerAndSellerReportingId वाली रिपोर्टिंग आईडी की वैल्यू, reportWin() में हमेशा उपलब्ध रहेंगी.

function reportWin(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingId // 'deal456'
    buyerReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;
}

दिलचस्पी बढ़ाएं और सुझाव दें