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

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

खास जानकारी

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

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

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

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

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

  1. नीलामी शुरू होने से पहले, खरीदार इंटरेस्ट ग्रुप कॉन्फ़िगरेशन में डील और सीट आईडी रजिस्टर करता है
    • डील और सीट के आईडी, चुने जा सकने वाले रिपोर्टिंग आईडी फ़ील्ड (selectableBuyerAndSellerReportingIds) में सेट किए जा सकते हैं.
    • अगर सभी डील के लिए सीट आईडी एक ही है, तो सीट आईडी को buyerAndSellerReportingId में सेट किया जा सकता है. साथ ही, डील आईडी को चुने जा सकने वाले रिपोर्टिंग आईडी फ़ील्ड (selectableBuyerAndSellerReportingIds) में सेट किया जा सकता है.
  2. बिड जनरेट करने के दौरान, डील और सीट आईडी उपलब्ध हो जाते हैं. खरीदार, selectableBuyerAndSellerReportingIds से कोई डील आईडी चुनता है. खरीदार, selectedBuyerAndSellerReportingId लौटाकर एक ऐसी बिड जनरेट करता है जिसमें उस बिड से जुड़ा डील आईडी शामिल हो. कोई बिड सिर्फ़ तब नीलामी जीत सकती है, जब दिखाया गया डील आईडी, अन्य रिपोर्टिंग आईडी और दिलचस्पी के ग्रुप की चुनिंदा प्रॉपर्टी के साथ-साथ, k-anonymous हो.
  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
      buyerAndReportingId: '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(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectableBuyerAndSellerReportingIds // ['deal123', 'deal456', 'deal789']
    buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;

  // ...

  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-पहचान की पुष्टि में पास हो गई हो, तो selectableBuyerAndSellerReportingIds के-पहचान समूह की जांच में पास न होने वाले विज्ञापन, फिर से चलाने पर इंटरेस्ट ग्रुप में मौजूद नहीं होंगे.

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

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

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

  // ...
}

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

याद रखें कि कोई बिड सिर्फ़ तब नीलामी जीत सकती है, जब selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (अगर मौजूद है), और buyerReportingId (अगर मौजूद है) को इंटरेस्ट ग्रुप के मालिक, बिडिंग स्क्रिप्ट के यूआरएल, रेंडर यूआरएल, और विज्ञापन के साइज़ के साथ k-anonymous किया गया हो. कम से कम 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'
    buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;
}

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