Protected Audience API (पहले इसे FLEDGE कहा जाता था)

Privacy Sandbox के हिस्से के तौर पर, Chrome ने सुरक्षित ऑडियंस एपीआई—ब्राउज़र में मौजूद एपीआई इसकी मदद से, विज्ञापन देने वाले लोग या कंपनियां और विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनियां, इंटरेस्ट ग्रुप के आधार पर टारगेट किए गए विज्ञापन दिखा सकती हैं उपयोगकर्ताओं को तीसरे पक्ष की कुकी पर निर्भर रहने और दूसरी साइटों से सुरक्षित रखने के लिए ट्रैकिंग.

Chrome एक ऑरिजिन चला रहा है मुफ़्त में आज़माना Protected Audience API के लिए. Authorized Buyers कार्यक्रम में हिस्सा ले सकते हैं Ad Manager की पब्लिशर इन्वेंट्री पर Protected Audience API की टेस्टिंग. बिडिंग करने वाले लोग, Protected Audience API की जांच करके, ये काम कर सकते हैं:

  • Protected Audience API फ़्लो के असर के बारे में जानकारी मिलती है और उसे बार-बार दोहराया जाता है.
  • सार्वजनिक फ़ोरम पर, एपीआई से जुड़े संभावित सुधारों पर सुझाव/राय देना या शिकायत करना—इन कामों के लिए उदाहरण के लिए, GitHub.
  • एपीआई की मदद से, लोगों के हिसाब से विज्ञापन दिखाने की सुविधा को बढ़ावा देने की तैयारी करना तीसरे पक्ष की कुकी पर निर्भर रहना.

जांच करने में दिलचस्पी रखने वाले Authorized Buyers को, इसके लिए ऑप्ट इन करना होगा सेक्शन में दी गई जानकारी देखें.

विज्ञापन दिखाने के फ़्लो की खास जानकारी

यहां Authorized Buyers के लिए, Protected Audience से विज्ञापन दिखाने के फ़्लो की खास जानकारी दी गई है पार्टनर:

फ़्लो डायग्राम

  1. बिड करने वाला व्यक्ति, विज्ञापन देने वाले लोगों या कंपनियों के साथ मिलकर, हर एक के लिए इंटरेस्ट ग्रुप बनाए रखता है विज्ञापनदाता. अक्सर, विज्ञापन देने वाले, बिड करने वाले का टैग दिलचस्पी वाले ग्रुप में ब्राउज़र जोड़ने के लिए, विज्ञापन देने वाले व्यक्ति या कंपनी के पेज पर जाएं.
  2. असली उपयोगकर्ता किसी विज्ञापन देने वाले के पेज पर जाता है. पेज में बिड करने वाले की जानकारी हो सकती है टैग के साथ जोड़ा जा सकता है.
  3. बिड करने वाले का टैग, Protected Audience API joinAdInterestGroup() को शुरू करता है. इस कॉल में, ब्राउज़र से उपयोगकर्ता को एक इंटरेस्ट ग्रुप में जोड़ने का अनुरोध किया जाता है.
  4. असली उपयोगकर्ता किसी पब्लिशर के वेबपेज पर जाता है. उपयोगकर्ता के ब्राउज़र अनुरोध Google के पब्लिशर विज्ञापन टैग में.
  5. Google का पब्लिशर विज्ञापन टैग, Google सर्वर से कॉन्टेक्स्ट के हिसाब से विज्ञापन दिखाने के लिए अनुरोध करता है.
  6. Google, बिडिंग में हिस्सा लेने वाले लोगों को काम के बिड रिक्वेस्ट भेजता है. ज़्यादा जानकारी के लिए, ज़्यादा जानकारी के लिए, बिड रिक्वेस्ट में बदलाव वाला सेक्शन.
  7. बिड करने वाला व्यक्ति, interest_group_bidding फ़ील्ड के साथ BidResponse दिखाता है. अगर बिड करने वाला व्यक्ति interest_group_bidding की जानकारी नहीं देता है, तो Google यह नहीं बताता है नीलामी में, interestGroupBuyers में बिड करने वाले की मूल वैल्यू शामिल करें कॉन्फ़िगरेशन है. बिड रिस्पॉन्स मेंinterest_group_bidding.per_buyer_signals भी शामिल हो सकता है. के दौरान per_buyer_signals को बिड करने वाले के बिडिंग फ़ंक्शन में पास कर दिया जाएगा इन-ब्राउज़र नीलामी. बिड रिस्पॉन्स में हुए बदलाव देखें सेक्शन में ज़्यादा जानकारी देखें.
  8. Google, सर्वर-साइड नीलामी करता है और ब्राउज़र खोलें. सर्वर साइड नीलामी में, पारंपरिक और सर्वर साइड बिड शामिल की जाती हैं. बोली प्रतिसाद में एक प्रासंगिक बोली लगाने वाली बोली के बारे में जानकारी हो सकती है (अगर कोई भी).
  9. बिड रिस्पॉन्स में, इन-ब्राउज़र के लिए नीलामी कॉन्फ़िगरेशन शामिल होता है नीलामी. इसमें हिस्सा लेने वाले हर खरीदार के काम के सिग्नल शामिल हो सकते हैं (जो interest_group_bidding.per_buyer_signals के ज़रिए भेजे गए थे), प्रासंगिक विजेता जानकारी और बोली योग्यता की सेटिंग देखें.
  10. Google का पब्लिशर टैग, Protected Audience API runAdAuction() को शुरू करता है ऑन-डिवाइस इंटरेस्ट ग्रुप नीलामी शुरू करने के लिए. Google में सिर्फ़ यह शामिल है वे खरीदार जो पहले ही interest_group_bidding को इसके तौर पर वापस कर चुके हैं नीलामी के कॉन्फ़िगरेशन में interestGroupBuyers.
  11. Google, शर्तें पूरी करने वाले हर बिडर के per_buyer_signals को सुरक्षित ऑडियंस नीलामी कॉन्फ़िगरेशन.
  12. अगर बिड करने वाले के इंटरेस्ट ग्रुप ने trustedBiddingSignalsUrl, ब्राउज़र हर ग्रुप की हर ग्रुप के रीयल-टाइम सिग्नल फ़ेच करने के लिए, trustedBiddingSignalsUrl. यहां जाएं: Protected Audience API खास जानकारी.
  13. ब्राउज़र हर एक इंटरेस्ट ग्रुप के लिए, बिड करने वाले के generateBid() को शुरू करता है जिसने ऑप्ट-इन किया है और जो इन-ब्राउज़र नीलामी में हिस्सा ले सकता है. यह चरण बोली की गणना करता है और एक क्रिएटिव को चुनता है. generateBid() के पास इसका ऐक्सेस है बिड करने वाले और भरोसेमंद बिडिंग से मिला per_buyer_signals दिए गए इंटरेस्ट ग्रुप के लिए सिग्नल.
  14. ब्राउज़र, विक्रेता के (इस मामले में, Google के) scoreAd() का अनुरोध करता है इंटरेस्ट ग्रुप के आधार पर होने वाली विज्ञापन नीलामी में, हर बिड के लिए रैंक तय कर सकता है. बिड को रैंक किया जाता है और इन्हें पब्लिशर की सुरक्षा, विज्ञापन नीतियों वगैरह के हिसाब से फ़िल्टर किया जा सकता है करना है.
  15. ब्राउज़र, ज़रूरी शर्तें पूरी करने वाले इंटरेस्ट ग्रुप की बिड के साथ नीलामी करता है. कॉन्टेंट बनाने टॉप-रैंक वाली प्रासंगिक बोली, इन-ब्राउज़र नीलामी में हिस्सा लेती है.
  16. नीलामी के बाद, यदि कोई रुचि समूह विजेता होता है, तो ब्राउज़र विक्रेता की reportResult() और बोली लगाने वाले के reportWin() को सूचित करने के लिए इन-ब्राउज़र नीलामी के विजेता पक्ष की जानकारी दें.
  17. अगर एक इंटरेस्ट ग्रुप का विज्ञापन जीतता है, तो Google का पब्लिशर टैग विज्ञापन को iframe.

विज्ञापन दिखाने के फ़्लो की जानकारी

विज्ञापन दिखाने से पहले

क्रिएटिव समीक्षा

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

renderUrls के लिए ज़रूरी शर्तें:

  • एपीआई की मदद से सबमिट किया गया renderUrl, इस्तेमाल किए गए renderUrl से मेल खाना चाहिए जो इंटरेस्ट ग्रुप वाली विज्ञापन नीलामी में दिखते हैं.
  • हो सकता है कि हर renderUrl, विज्ञापन देने वाले किसी एक व्यक्ति या कंपनी से ही जुड़ा हो कैंपेन बनाएं. दिए गए renderUrl का इस्तेमाल इनकी ओर से विज्ञापन रेंडर करने के लिए नहीं किया जा सकता एक से ज़्यादा विज्ञापन देने वाले लोग या कंपनियां. हर renderUrl किसी एक क्रिएटिव से मैप होना चाहिए.
  • renderUrl को Google के ऑफ़लाइन ऐक्सेस और फ़ेच करने लायक होना चाहिए विज्ञापन के लिए आखिरी बार बिड लगाने के बाद सात दिनों तक क्रिएटिव समीक्षा सिस्टम का इस्तेमाल किया जा सकता है.
Real-time Bidding API

बिडिंग करने वाले लोग, रीयल-टाइम बिडिंग का इस्तेमाल कर सकते हैं क्रिएटिव अपलोड करने के लिए, एपीआई एक जैसी दिलचस्पी वाले ग्रुप के लिए बिडिंग.

अपने-आप क्रिएटिव स्कैन करने की सुविधा

बिडिंग करने वाले लोग, उन क्रिएटिव के लिए अपने-आप क्रिएटिव स्कैन होने की सुविधा सेट अप कर सकते हैं जो रीयल-टाइम बिडिंग एपीआई की मदद से अपलोड किया जाता है.

अगर क्रिएटिव को अपने-आप स्कैन करने की सुविधा सेट अप की जाती है, तो Google इन-ब्राउज़र नीलामी को स्कैन करता है और उन्हें अपने-आप स्कैन करता है, ताकि वे आगे की नीलामियां.

अपने-आप क्रिएटिव स्कैन होने की सुविधा चालू करने का तरीका यहां बताया गया है:

  • इंटरेस्ट ग्रुप क्रिएटिव के सभी renderUrl ऑरिजिन इसमें जोड़ें Authorized Buyers खाता.

  • क्रिएटिव के एचटीटीपी रिस्पॉन्स में ये कस्टम एचटीटीपी हेडर जोड़ें:

    Authorized-Buyers-Creative-ID

    स्ट्रिंग

    खरीदार के हिसाब से क्रिएटिव आईडी. क्रिएटिव आईडी की अधिकतम लंबाई है 128 बाइट.
    Authorized-Buyers-Click-Through-URLs

    स्ट्रिंग

    के अनुसार एन्कोड किए गए क्रिएटिव के लिए घोषित गंतव्य URL का सेट RFC2396 पर जाएगा.

उदाहरण:

HTTP/1.1 200 OK
Date: Mon, 8 Jan 2022 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Last-Modified: Mon, 8 Jan 2022 12:01:53 GMT
Content-Length: 88
Content-Type: text/html
Connection: Closed
Authorized-Buyers-Creative-ID:123456
Authorized-Buyers-Click-Through-URLs:https://www.advertiser.com/clickUrl1,https://www.advertiser.com/clickUrl12

<html>
<body>
<h1>Hello, World!</h1>
</body>
</html>
क्रिएटिव का समाप्ति

क्रिएटिव 15 दिनों के लिए स्वीकार किए जाते हैं. अगर रीयल-टाइम रिपोर्ट की मदद से क्रिएटिव सबमिट किए जाते हैं, तो बिडिंग एपीआई के लिए, आपको 15 दिनों के बाद क्रिएटिव को फिर से सबमिट करना होगा. अगर आपको इन बातों पर भरोसा है अपने-आप क्रिएटिव स्कैनिंग की सुविधा है. स्कैनिंग की प्रोसेस में, उन्हें अपने-आप दोबारा स्कैन किया जाता है.

खरीदार रिपोर्टिंग आईडी

डाइमेंशन का इस्तेमाल करके, रिपोर्टिंग मेट्रिक (जैसे, इंप्रेशन) को अलग-अलग कैटगरी में बांटा जा सकता है खरीदार से मिला है (उदाहरण के लिए, कैंपेन आईडी या विज्ञापन देने वाले का आईडी). किसी कीवर्ड को इंटरेस्ट ग्रुप के खर्च के लिए डाइमेंशन. इसके लिए buyerAndSellerReportingId तय करें अपने विज्ञापन को उस समय लागू करें जब आप उपयोगकर्ता के डिवाइस को इंटरेस्ट ग्रुप में जोड़ते हैं. ज़्यादा जानकारी देखें Protected Audience से जुड़ी जानकारी दस्तावेज़ में दिया गया है.

buyerAndSellerReportingId को जोड़ने के तरीके का उदाहरण नीचे दिया गया है इंटरेस्ट ग्रुप का कॉन्फ़िगरेशन:

const myGroup = {
  ...
  'ads': [
    {
      ...
      'buyerAndSellerReportingId':
        '{"google_signals": {"buyer_reporting_id": "12345"}}',
      ...
    }
  ]
}
joinAdInterestGroup(myGroup);

buyer_reporting_id, 'अनुमति दी गई' बॉक्स में नए डाइमेंशन के तौर पर दिखेगा खरीदार रिपोर्टिंग आईडी डाइमेंशन के तौर पर खरीदार का रिपोर्टिंग टूल.

सर्वर साइड नीलामी

बिड रिक्वेस्ट में बदलाव

में इस्तेमाल किए जाने के लिए, नीचे दिए गए प्रोटोकॉल के शुरुआती वर्शन हैं प्रयोग:

इंटरेस्ट ग्रुप के आधार पर, नीलामी से जुड़ी सहायता पाने के बारे में बताएं

बिड रिक्वेस्ट के लिए auction_environment नाम का एक नया फ़ील्ड जोड़ा गया है.

  • Google आरटीबी प्रोटोकॉल: BidRequest.adslot.auction_environment
  • OpenRTB: BidRequest.imp.ext.auction_environment

आप इस फ़ील्ड का उपयोग करके उन इंप्रेशन अवसरों के बीच अंतर कर सकते हैं, Protected Audience in-ब्राउज़र इंटरेस्ट ग्रुप नीलामी के साथ-साथ सिर्फ़ पारंपरिक सर्वर-साइड एक्सचेंज नीलामी के साथ काम करते हों. कॉन्टेंट बनाने auction_environment enum के ये मान हो सकते हैं:

  • SERVER_SIDE_AUCTION (OpenRTB JSON: 0): सर्वर-साइड की पारंपरिक नीलामियां
  • ON_DEVICE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 1): इनके साथ अनुरोध Protected Audience Support, जिसमें कॉन्टेक्स्ट के हिसाब से नीलामी Exchange के सर्वर, इंटरेस्ट ग्रुप के आधार पर बिडिंग, और आखिरी नीलामी ब्राउज़र में
सुरक्षित ऑडियंस वाले विज्ञापन स्लॉट का साइज़ दिखाएं

बिड रिक्वेस्ट में, नीचे दिए गए फ़ील्ड शामिल होते हैं. इनकी मदद से हम आपको सुरक्षित ऑडियंस विज्ञापन स्लॉट का आकार:

  • Google आरटीबी प्रोटोकॉल:
    • BidRequest.adslot.interest_group_auction.width
    • BidRequest.adslot.interest_group_auction.height
  • OpenRTB:
    • BidRequest.imp.ext.interest_group_auction.width
    • BidRequest.imp.ext.interest_group_auction.height

ये फ़ील्ड, Protected Audience API से जुड़ी नीलामी के लिए, विज्ञापन स्लॉट का साइज़ दिखाते हैं पिक्सल में.

यह साइज़, कॉन्टेक्स्ट के हिसाब से किए गए अनुरोध के साइज़ से अलग हो सकता है (Adslot.widthऔरAdslot.height या OpenRTB में: BidRequest.imp.banner.format).

काम के अनुरोध के कई साइज़ हो सकते हैं. उपयोगकर्ता के डिवाइस पर नीलामी जीतना विज्ञापन में केवल एक तय स्लॉट आकार को भरे जाने की उम्मीद की जाती है.

सुरक्षित ऑडियंस के विज्ञापन को रेंडर करने की क्षमता के बारे में बताएं

सुरक्षित ऑडियंस विज्ञापन मौजूदा समय के हिसाब से रेंडर हो भी सकते हैं और नहीं भी इंटिग्रेशन का चरण (रेंडर नहीं करना देखें प्रयोग). render_interest_group_ads बिड रिक्वेस्ट के फ़ील्ड से पता चलता है कि जीतने वाला Protected Audience विज्ञापन रेंडर किया जाएगा.

  • Google आरटीबी प्रोटोकॉल: BidRequest.adslot.interest_group_auction.render_interest_group_ads अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  • OpenRTB: BidRequest.imp.ext.interest_group_auction.render_interest_group_ads अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
उपयोगकर्ता आइडेंटिफ़ायर पर भरोसा कम करें

Protected Audience API टेस्टिंग के दायरे में आने वाले कॉन्टेक्स्ट के हिसाब से बिड रिक्वेस्ट ये काम कर सकती हैं कुकी-आधारित आइडेंटिफ़ायर को बनाए रखना ब्राउज़र, जैसे कि google_user_id (OpenRTB में BidRequest.user.id) और hosted_match_data (OpenRTB में BidRequest.user.buyerid) फ़ील्ड. मौजूदगी बिड रिक्वेस्ट में ऐसे आइडेंटिफ़ायर मौजूद रहेंगे जो निजता नीतियों को पढ़ें. हमारा सुझाव है कि आप टेस्टिंग के दौरान टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) और बिडिंग के मकसद से, तीसरे पक्ष की कुकी उपलब्ध न होने पर खरीदारी करना.

Google छोटे-छोटे प्रयोग भी चला सकता है, जिसमें कुकी-आधारित आइडेंटिफ़ायर Protected Audience API टेस्टिंग के लिए, बिड रिक्वेस्ट से जुड़ी जानकारी छिपाने के लिए उसमें बदलाव किया गया. यह तीसरे पक्ष की कुकी का इस्तेमाल बंद होने से पड़ने वाले संभावित असर का आकलन करना है.

तैयारी करने के लिए तीसरे पक्ष की कुकी का इस्तेमाल बंद होना (3PCD) साल 2024 में, Chrome अब आपको Chrome की मदद से जांच करने की सुविधा.

साइटें और वेंडर 3PCD शामिल है. जांच में, Chrome ब्राउज़र को 3PCD प्रयोग समूह को असाइन किया जाता है, मोड A या मोड B. हर ब्राउज़र के लिए एक अलग लेबल असाइन किया जाता है 3PCD प्रयोग समूह के मुताबिक, जिसे आप ऐक्सेस कर सकते हैं ब्राउज़र में मौजूद Chrome API.

Google, आरटीबी बिड पर Chrome API से, बिना बदलाव वाला लेबल पास करता है अनुरोध. किसी लेबल के छोटे ट्रैफ़िक हिस्से होने की वजह से, Google ज़रूरी नहीं है कि निजता को सीमित करने वाले कॉन्टेक्स्ट में लेबल को हमेशा शामिल किया जाए.

यहां वे फ़ील्ड दिए गए हैं जहां आप लेबल देख सकते हैं:

  • Google आरटीबी प्रोटोकॉल: BidRequest.device.cookie_deprecation_label अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  • OpenRTB: BidRequest.device.ext.cdep अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

बिड रिस्पॉन्स में बदलाव

इंटरेस्ट ग्रुप के आधार पर होने वाली नीलामी में हिस्सा लेने के बारे में बताना

यह आपकी ज़िम्मेदारी है कि आपको इस कार्यक्रम में हिस्सा लेने के अपने इंटेंट के बारे में साफ़ तौर पर बताना पड़े ब्राउज़र के अंदर होने वाली नीलामी में InterestGroupBidding ऑब्जेक्ट को संदर्भ के हिसाब से बिड रिस्पॉन्स:

  • Google आरटीबी प्रोटोकॉल: BidResponse.interest_group_bidding
  • OpenRTB: BidResponse.ext.igbid

आपको प्रासंगिक बोली प्रतिक्रिया देनी होगी. जवाब देने की ज़रूरत नहीं है प्रासंगिक बोली शामिल करें. InterestGroupBidding ऑब्जेक्ट में एक जैसी दिलचस्पी वाले ग्रुप के मालिक का origin, जो किसी एक ऑरिजिन से मेल खाना चाहिए बिड करने वाले व्यक्ति ने अपने खाते के लिए कॉन्फ़िगर किया है. origin को नीलामी में जोड़ा गया Google पब्लिशर टैग के कॉल करने पर, कॉन्फ़िगरेशन की interestGroupBuyers runAdAuction().

खरीदार के काम के सिग्नल लागू करना (हर खरीदार का सिग्नल)

कॉन्टेक्स्ट के हिसाब से बिड रिस्पॉन्स में, खरीदार से जुड़े सिग्नल शामिल किए जा सकते हैं. ये सिग्नल Google JSON ऑब्जेक्ट के रूप में, उसके ऑन-डिवाइस बिडिंग फ़ंक्शन में लागू होता है. इसके लिए perBuyerSignals आर्ग्युमेंट. इसे बिड रिस्पॉन्स में, प्रोटोकॉल के हिसाब से ये फ़ील्ड शामिल करें:

  • Google आरटीबी: BidResponse.interest_group_bidding.per_buyer_signals
  • OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata
खरीदार के हिसाब से रेंडरिंग सिग्नल लागू करना

एक जैसी दिलचस्पी वाले ग्रुप के क्रिएटिव, रेंडर होने के दौरान, काम के सीमित सिग्नल का इस्तेमाल कर सकते हैं प्रासंगिक बोली प्रतिक्रिया के माध्यम से उन सिग्नल को भेजना और उन्हें प्राप्त करना यूआरएल अनुरोध पर उन्हें शामिल कर सकते हैं. उदाहरण के लिए, रेंडरिंग क्रिएटिव के लुक और स्टाइल को बेहतर बनाने के लिए, इन सिग्नल का इस्तेमाल किया जा सकता है दिए गए विज्ञापन स्लॉट या प्रकाशक पेज के संदर्भ में प्रदर्शन को बेहतर बनाना चाहते हैं.

यूआरएल की मदद से सुरक्षित की गई स्ट्रिंग के तौर पर क्रम से लगाए गए, खरीदार के रेंडरिंग सिग्नल को इसमें शामिल किया जा सकता है संदर्भ के हिसाब से बिड रिस्पॉन्स, जिसे Google, लोकप्रिय हित में बदल देगा यूआरएल को ग्रुप में रेंडर करके उसे ${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]} मैक्रो.

रेंडरिंग सिग्नल को बिड रिस्पॉन्स में, इनके साथ तय किया जा सकता है इन फ़ील्ड में, प्रोटोकॉल का इस्तेमाल किया जा सकता है:

  • Google आरटीबी: BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals
  • OpenRTB: BidResponse.ext.igbid.igbuyer.rsig

अलग-अलग मैक्रो सफ़िक्स के साथ, रेंडरिंग सिग्नल के ज़्यादा से ज़्यादा तीन सेट शामिल किए जा सकते हैं का इस्तेमाल करें. उदाहरण के लिए, सफ़िक्स का उपयोग केवल क्रिएटिव पर लागू होने वाले सिग्नल के किसी खास सेट से मिलान करने के लिए किया जा सकता है उनसे जुड़े मैक्रो को अपने रेंडर यूआरएल में इस्तेमाल करती है. इससे डेटा ट्रांसफ़र कम हो जाता है साइज़.

इंटरेस्ट ग्रुप के खरीदार को Protected प्रोग्राम में हिस्सा लेने से मना कर दिया जाएगा ऑडियंस नीलामी, अगर सिग्नल यूआरएल-सुरक्षित नहीं हैं, मैक्रो सफ़िक्स यूनीक नहीं हैं, या सिग्नल के तीन से ज़्यादा सेट दिए जाते हैं.

ब्राउज़र में बोली की ज़्यादा से ज़्यादा कीमत बताएं

Protected Audience से खाता प्रस्ताव, बिड कंप्यूटेशन और आखिरी नीलामी, उपयोगकर्ता के डिवाइस पर स्थानीय तौर पर चलने की उम्मीद है. इससे यह बन सकता है: ऐसा कॉन्टेंट जिसके गलत इस्तेमाल की वजह से, आखिरी नीलामी की विश्वसनीयता पर असर पड़ सकता है परिणाम, जैसे जीतने वाली बोली की कीमत.

Google की Protected Audience API टेस्टिंग के दौरान, जोखिम को कम करने की सुविधा के तौर पर साथ ही, अपने आरटीबी पार्टनर के लिए, आप हर कॉन्टेक्स्ट के हिसाब से बिड रिस्पॉन्स. अपेक्षित अधिकतम बोली वह अधिकतम बोली मूल्य है जो आपके बिडिंग फ़ंक्शन के वापस आने की उम्मीद है. यदि जीतने वाली बोली की रिपोर्ट यहां दी गई है इन-ब्राउज़र नीलामी में यह रकम से ज़्यादा हो जाती है, तो जीतने वाली बिड की गिनती नहीं की जाती इवेंट के तौर पर शामिल होना चाहिए. इस तरीके में बदलाव हो सकता है.

बिड रिस्पॉन्स में, अनुमानित बिड की ज़्यादा से ज़्यादा वैल्यू तय की जा सकती है ये फ़ील्ड शामिल होते हैं:

  • Google आरटीबी प्रोटोकॉल: BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है (माइक्रोसीपीएम में दिखाया जाता है)
  • OpenRTB: BidResponse.igbid.igbuyer.maxbid(सीपीएम मुद्रा की यूनिट में दिखाया जाता है)
कई खातों को इंप्रेशन एट्रिब्यूट करना

बिडिंग करने वाले को अपनी दिलचस्पी दिखाने के लिए, एक बिलिंग आईडी चुनना होगा समूह बोली के इंप्रेशन देखने के लिए नीचे दिए गए फ़ील्ड का इस्तेमाल करें:

  • Google आरटीबी प्रोटोकॉल: BidResponse.interest_group_bidding.interest_group_buyers.billing_id अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  • OpenRTB: BidResponse.igbid.igbuyer.billing_id

चुना गया बिलिंग आईडी, बिड रिक्वेस्ट में सेट किया गया बिलिंग आईडी होना चाहिए:

  • Google आरटीबी प्रोटोकॉल: BidRequest.adslot.matching_ad_data.billing_id अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  • OpenRTB: BidRequest.imp.ext.billing_id

अगर इंटरेस्ट ग्रुप के लिए बिड लगाने के इंप्रेशन को एट्रिब्यूट करने के लिए बिलिंग आईडी का इस्तेमाल नहीं किया जा रहा है, तो अगर बिड करने वाला व्यक्ति, Protected Audience नीलामी में हिस्सा नहीं लेता है.

चाइल्ड खातों में ज़्यादा से ज़्यादा दो बिलिंग आईडी हो सकते हैं. खरीदार एक ही पते का इस्तेमाल कर सकता है मौजूदा बिलिंग आईडी और दूसरा बिलिंग आईडी, दिलचस्पी के हिसाब से किए गए खर्च के लिए हो. अगर आपको दो बिलिंग आईडी कॉन्फ़िगर करने हैं, तो अपने खाता मैनेजर से संपर्क करें चाइल्ड खाते के लिए.

हर बिलिंग आईडी के लिए, रोज़ का बजट तय किया जा सकता है. अपने खाता मैनेजर को चाइल्ड खातों की बिलिंग आईडी के लिए रोज़ का बजट सेट करना होगा.

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

ब्राउज़र में नीलामी के दौरान

ब्राउज़र में बिड जनरेट करें

इन-ब्राउज़र बोलियां जनरेट करने के लिए generateBid() का उपयोग करें.

Google ये पैरामीटर उपलब्ध कराता है:

  • auctionSignals: खाली है
  • perBuyerSignals: इसी सिग्नल का एक JavaScript ऑब्जेक्ट कॉन्टेक्स्ट के हिसाब से जवाब में बिड करने वाला

ये पैरामीटर दिखाए जाते हैं:

  • ad: Google इस फ़ील्ड को अनदेखा कर देता है.
  • bid: अंकों वाली वह बिड जो नीलामी में शामिल होती है. सीपीएम इकाइयों में होना चाहिए (माइक्रो नहीं).
  • render: बिड जीतने पर क्रिएटिव को दिखाने के लिए रेंडर किया जाने वाला यूआरएल नीलामी. Google को इस यूआरएल की समीक्षा करके, इसे अनुमति देनी होगी. ऐसा न करने पर, इसे फ़िल्टर कर दिया जाएगा नीलामी से बाहर रखा जा सकता है.
  • allowComponentAuction: true होना चाहिए. फ़िलहाल, Google में टेस्टिंग की सुविधा उपलब्ध है कई सेलर वाली नीलामियों के डेटा का इस्तेमाल करें.

यहां एक उदाहरण दिया गया है:

function generateBid(...) {
  ...
  return {'ad': 'example',
          'bid': ad.metadata.bid,
          'render': ad.renderUrl,
          'allowComponentAuction': true};
}

डिवाइस के ऑन-डिवाइस पर, Protected Audience से जुड़ी ज़रूरी जानकारी देखें बिडिंग सेक्शन में जाकर, generateBid() फ़ंक्शन की जानकारी पाएं.

बोली की मुद्रा

ब्राउज़र के अंदर होने वाली नीलामी की बोलियां, चुनी गई बोली की मुद्रा के सीपीएम की यूनिट में रखी जाती हैं.

बोली की मुद्रा, संदर्भ के हिसाब से बिड के जवाब में और generateBid की रिटर्न वैल्यू डालें और यह एक मान्य ISO 4217 ऐल्फ़ा कोड होना चाहिए, जैसे का नाम "USD", "EUR" या "JPY" के तौर पर डालें.

OpenRTB में, InterestGroupBuyer ऑब्जेक्ट में नए cur फ़ील्ड का इस्तेमाल Google का बिड रिस्पॉन्स एक्सटेंशन.

यहां एक उदाहरण दिया गया है:

ext {
  igbid {
    impid: "1"
    igbuyer {
      origin: "https://examplebuyerorigin.com"
      cur: "EUR"
    }
  }
}

Google आरटीबी प्रोटोकॉल में, नए currency फ़ील्ड का इस्तेमाल बिड रिस्पॉन्स में InterestGroupBuyer मैसेज मिला.

यहां एक उदाहरण दिया गया है:

interest_group_bidding {
  adslot_id: 1
  interest_group_buyer {
    origin: "https://examplebuyerorigin.com"
    currency: "EUR"
  }
}

बिड करने वालों का generateBid फ़ंक्शन को उसी मुद्रा में बोलियां दिखानी होंगी यह जानकारी, कॉन्टेक्स्ट के हिसाब से बिड के रिस्पॉन्स में दी गई है. नई bidCurrency प्रॉपर्टी को भरें generateBid की रिटर्न वैल्यू:

function generateBid(...) {
  ...
  return {'ad': ad,
          'bid': bid,
          'bidCurrency': 'EUR',
          ...};
}

अगर संदर्भ के हिसाब से बिड रिस्पॉन्स की मुद्रा, उस मुद्रा से अलग हो generateBid से या अगर दोनों में से कोई एक अमान्य मुद्रा दिखाता है, तो नीलामी से पहले बिड को फ़िल्टर कर दिया जाएगा.

विज्ञापन की क्वालिटी की जांच

क्रिएटिव नीति और पब्लिशर के कंट्रोल को नीति उल्लंघन ठीक करने के तरीके (एनफ़ोर्समेंट) को लागू करने पर, RTB के लिए Protected Audience API टेस्टिंग के दौरान, ब्राउज़र में उपयोगकर्ताओं की दिलचस्पी वाले ग्रुप की बिड पार्टनर.

डिजिटल सर्विसेज़ ऐक्ट से जुड़ी सहायता

डिजिटल सर्विसेज़ ऐक्ट के अनुच्छेद 26 की वजह से, पब्लिशर के लिए यह ज़रूरी हो सकता है कि खरीदार पारदर्शिता के मकसद से विज्ञापन में उससे जुड़ी जानकारी ज़ाहिर करना. जब "खरीदारों को सिर्फ़ डीएसए के साथ विज्ञापन दिखाने के लिए कहें ईईए में, मेरी साइट या ऐप्लिकेशन पर पारदर्शिता के बारे में जानकारी" कंट्रोल को प्रकाशक, इंटरेस्ट ग्रुप के खरीदार यह तय कर सकते हैं कि उन्हें इस पर निम्न फ़ील्ड को ध्यान में रखते हुए खरीदार पारदर्शिता रेंडर करना आवश्यक है मिले बोली अनुरोध: BidRequest.dsa.dsa_support और BidRequest.dsa.publisher_rendering_support Google Authorized Buyers प्रोटोकॉल और BidRequest.regs.dsa.required के लिए और OpenRTB प्रोटोकॉल के लिए BidRequest.dsa.pubrender.

जब बिड करने वाला कोई व्यक्ति, Protected Audience API से जुड़ी नीलामियों में हिस्सा लेना चाहता है बिड रिक्वेस्ट में यह सिग्नल मिलता है कि डीएसए के तहत पारदर्शिता रिपोर्ट दिखाना ज़रूरी है Protected Audience API की मदद से डिलीवर किए जाने वाले विज्ञापनों के लिए, वे ज़रूरी जानकारी सही तरीके से दिखा सकते हैं. साथ ही, BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है Google Authorized Buyers प्रोटोकॉल के लिए या BidResponse.ext.igbid.igbuyer.dsaadrenderOpenRTB प्रोटोकॉल के लिए. या फिर, इस खरीदार को Protected Audience API नीलामी में शामिल नहीं किया जाएगा.

डिजिटल सर्विसेज़ ऐक्ट में शामिल विज्ञापन पारदर्शिता के बारे में ज़्यादा जानने के लिए, सहायता केंद्र लेख: डिजिटल सर्विसेज़ ऐक्ट से जुड़ी शर्तों को पूरा करना.

बोली फ़िल्टर करना

Google, publisher को लागू करता है नियंत्रण और विज्ञापन नीतियां नीलामी के दौरान.

ब्राउज़र में नीलामी के बाद

खरीदार को नीलामी के नतीजे की रिपोर्ट करें: reportWin()

Google इन आर्ग्युमेंट को इकट्ठा नहीं करता:

  • auctionSignals
  • sellerSignals

खरीदार को नीलामी के नतीजे की रिपोर्ट करने के लिए reportWin() का इस्तेमाल करें.

रेंडर और विज्ञापन पर खरीदार की रिपोर्टिंग देखें इवेंट ज़्यादा जानकारी के लिए, Protected Audience API की जानकारी वाला सेक्शन.

मैक्रो

Protected Audience API से जुड़े क्रिएटिव का रेफ़रंस देने वाले renderUrl में, ये चीज़ें शामिल हो सकती हैं एक या ज़्यादा प्लेसहोल्डर होते हैं, जिन्हें मैक्रो कहा जाता है. इंटरेस्ट ग्रुप की नीलामी के बाद समाप्त होता है, लेकिन रेंडरिंग से पहले, मैक्रो को संबंधित वैल्यू. उपयोगकर्ता के डिवाइस पर नीलामी में इस्तेमाल किए जाने वाले renderUrl में, ये चीज़ें शामिल हो सकती हैं मैक्रो:

${GDPR} अगर जीडीपीआर लागू नहीं होता है, तो यह 0 तक बड़ा होता है या जीडीपीआर लागू होने पर 1 होता है. दस्तावेज़ देखें.
${GDPR_CONSENT_XXXX} पारदर्शिता” में विस्तृत होता है और अनुरोध से जुड़ी सहमति (टीसी) स्ट्रिंग. अगर पारदर्शिता और सहमति (टीसी) स्ट्रिंग खाली या अमान्य है. यह मैक्रो नहीं है.

इस मैक्रो का इस्तेमाल करके, टीसी स्ट्रिंग को किसी यूआरएल में IAB के जीवीएल में रजिस्टर किए गए वेंडर को भेजें. XXXX की जगह IAB के जीवीएल में रजिस्टर किए गए जीवीएल आईडी डालें वेंडर. अगर टीसी स्ट्रिंग खाली या अमान्य है, तो यह मैक्रो नहीं खुलता.

${GDPR_CONSENT_XXXX} मैक्रो वाले क्रिएटिव बन सकते हैं अगर IAB जीवीएल में रजिस्टर किया गया वेंडर आपके जीवीएल आईडी से जुड़ा है, तो उस पर रोक लगा दी जाएगी सम्मिलित करने के लिए उपयोगकर्ता की सहमति नहीं है.

${GDPR_CONSENT_XXXX} मैक्रो सिर्फ़ एक बार renderUrl.
${ADDL_CONSENT} अन्य अनुरोध से जुड़ी सहमति (एसी) स्ट्रिंग.
${AD_WIDTH}, ${AD_HEIGHT) ये मैक्रो, विज्ञापन स्लॉट की चौड़ाई और ऊंचाई डालते हैं.
${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}

रेंडर-टाइम खरीदार के सिग्नल वाला मैक्रो तय करें.

buyer.origin.example प्लेसहोल्डर को मूल स्थान से बदलें जो कि इंटरेस्ट ग्रुप के खरीदार के हों बिड रिस्पॉन्स में interest_group_buyers.origin. आप एक _OPTIONAL_SUFFIX शामिल करके ज़्यादा से ज़्यादा तीन अलग-अलग सिग्नल वैल्यू को रेंडर कर सकें.

इंप्रेशन की गिनती

आरटीबी पार्टनर के साथ Protected Audience API टेस्टिंग के दौरान, Google इंप्रेशन जब ब्राउज़र अपने reportResult() फ़ंक्शन को कॉल करता है और sendReportTo() पर किए गए कॉल में Google का रिपोर्टिंग यूआरएल फ़ेच करता है.

Google ने इस इवेंट का इस्तेमाल, Protected Audience में इंप्रेशन की गिनती करने के लिए किया गया है इन-ब्राउज़र नीलामियां, गिनती के लिए इस्तेमाल होने वाले इवेंट से अलग हो सकती हैं आरटीबी खरीदार पार्टनर के हिसाब से इंप्रेशन की संख्या, इंप्रेशन की संख्या में अंतर हो सकता है.

Protected Audience API की टेस्टिंग के लिए, Google का एक मकसद यह पता लगाना है कि को कम करने में मदद मिलती है.

बिल करने लायक इंप्रेशन का एट्रिब्यूशन

Protected Audience in-ब्राउज़र नीलामियों में बिड करने वाले किसी व्यक्ति का पूरा खर्च रुचि की मैपिंग के आधार पर, किसी एक बिडर खाते को एट्रिब्यूट किया गया है ग्रुप के मालिक के ऑरिजिन, बिडर के लिए कॉन्फ़िगर किए गए हैं. अलग-अलग बिड करने वाले के चाइल्ड सीट खाते का इस्तेमाल नहीं किया जा सकता.

रोज़ के बजट की सीमा

Protected Audience API की टेस्टिंग के दौरान, हर खाते का एक खाता लेवल होता है सुरक्षित ऑडियंस के खर्च की रोज़ की सीमा. रोज़ के बजट की सीमा से जोखिम कम हो सकता है में विज्ञापन की ज़रूरत होती है. दैनिक बजट की तय सीमा पार होने पर, खाते को अब Protected Audience से जुड़ी ज़रूरी शर्तें पूरी करने वाले बिड रिक्वेस्ट नहीं मिलेंगे.

खाता, Protected Audience से जुड़ी सीमा तक पहुंचना. उदाहरण के लिए, बोली लगाने वाला ऐसा खाता जो Protected Audience की सीमा को auction_environment = SERVER_SIDE_AUCTION (OpenRTB: 0) के साथ बिड रिक्वेस्ट मिल सकती है. भले ही, बिड रिक्वेस्ट Protected Audience API से जुड़ी नीलामी.

रीयल-टाइम फ़ीडबैक और जीतने के लिए कम से कम बोली

बिड करने वाले वे लोग जिन्होंने पेमेंट पाने के लिए ऑप्ट इन किया है रीयल-टाइम में सुझाव, शिकायत या राय को रुचि समूह के उन खरीदारों के लिए फ़ीडबैक प्राप्त होगा जिनका अनुरोध इसमें शामिल किए जाने के लिए किया गया है उपयोगकर्ता के डिवाइस पर, Protected Audience से जुड़ी नीलामी का इस्तेमाल करें. हर एक इंटरेस्ट ग्रुप खरीदार जो बिड करने वाले से मेल खाता है बिड रिस्पॉन्स पर सेट के बाद एक फ़ीडबैक ऑब्जेक्ट मिलेगा, चाहे वह कैसे भी हो कई बिड, Protected Audience नीलामी में इंटरेस्ट ग्रुप के खरीदार के तौर पर शामिल होती हैं. कॉन्टेंट बनाने यह जानकारी, इंटरेस्ट ग्रुप के खरीदार के सुझाव पर उपलब्ध होगी ऑब्जेक्ट:

  • फ़ीडबैक ऑब्जेक्ट का सुझाव यह होगा INTEREST_GROUP_BUYER_FEEDBACK.
  • इंटरेस्ट ग्रुप के खरीदार का ऑरिजिन.
  • इंटरेस्ट ग्रुप के खरीदार को जीतने के लिए, कम से कम बिड कुल नीलामी.
  • रुचि समूह के खरीदार को हासिल करने के लिए ज़रूरी कम से कम बोली पूरी नीलामी के सर्वर साइड कॉम्पोनेंट की सबसे ऊंची रैंक वाली बिड.
  • एक जैसी दिलचस्पी वाले ग्रुप के खरीदार का स्थिति कोड. संभावित स्थिति कोड ये हैं इसमें परिभाषित किया गया है interest-group-buyer-status-codes.txt.

इसके लिए प्रोटोकॉल दस्तावेज़ देखें Authorized Buyers आरटीबी और OpenRTB एक्सटेंशन का इस्तेमाल करें.

बिड के बारे में सुझाव की सूचना

Chrome, कुछ समय के लिए डीबग करने की सुविधा देता है एपीआई के लिए, Protected Audience API, Ad Manager को रीयल-टाइम में रिपोर्ट भेजने की सुविधा देता है सर्वर-टू-सर्वर डीबग नोटिफ़िकेशन जिनमें किसी Protected ऑडियंस बोली. इस सूचना में बिड लगाने की वजहें शामिल होंगी Protected Audience in-ब्राउज़र नीलामी के साथ-साथ बोली के बारे में नीचे दी गई जानकारी देखें.

बिडिंग करने वाले लोग, अपने खाता मैनेजर से संपर्क करके, स्टैटिक यूआरएल कॉन्फ़िगर कर सकते हैं. इसका इस्तेमाल, सुरक्षित ऑडियंस को डीबग करने के लिए बिड से जुड़े सुझाव/शिकायत/राय की सूचनाएं देने के लिए किया जाता है. यह चुने गए मैक्रो को बदलकर, Google के सर्वर से स्टैटिक यूआरएल फ़ेच किया जाएगा Protected Audience API से जुड़ी नीलामी पूरी होने के बाद. निम्नलिखित मैक्रो हैं समर्थित:

  • %%GOOGLE_QUERY_ID%%: इस मैक्रो की जगह Google क्वेरी आईडी ले ली गई है (Authorized Buyer प्रोटोकॉल में BidRequest.google_query_id, और OpenRTB प्रोटोकॉल में BidRequest.ext.google_query_id) जो Protected Audience-चालू किया गया संदर्भ के हिसाब से बिड रिक्वेस्ट.
  • %%INTEREST_GROUP_OWNER%%: इंटरेस्ट ग्रुप के मालिक का ऑरिजिन.
  • %%BID_CPM%%: CPM में वह बोली मूल्य जिसे generateBid() फ़ंक्शन.
  • %%RENDER_URL%%: क्रिएटिव का रेंडर यूआरएल.
  • %%STATUS%%: scoreAd() में बिड अस्वीकार किए जाने पर, स्टेटस कोड दिखता है. मान क्रिएटिव की स्थिति हैं कोड.

यहां स्टैटिक यूआरएल का सैंपल दिया गया है, जिसे बिडिंग करने वाला व्यक्ति अपना खाता मैनेजर दे सकता है:

https://dsp.example/debug?google_query_id=%%GOOGLE_QUERY_ID%%&ig_owner=%%INTEREST_GROUP_OWNER%%&render_url=%%RENDER_URL%%&bid=%%BID_CPM%%&status=%%STATUS%%

बोली फ़ीडबैक नोटिफ़िकेशन एक अस्थायी सुविधा है, जो Chrome की अस्थायी ForDebuggingOnly एपीआई.

प्रॉडक्ट-लेवल TURTLEDOVE

कई हिस्सों से बने विज्ञापन या प्रॉडक्ट-लेवल TURTLEDOVE Protected Audience API के दौरान, Google आरटीबी पार्टनर (पीएलटीडी) का इस्तेमाल किया जा सकता है टेस्टिंग हो रही है. अगर आपको टेस्ट करना है, तो इंटिग्रेशन के दौरान अपने खाता मैनेजर को इसके बारे में बताएं PLTD, क्योंकि अतिरिक्त संसाधनों और कॉन्फ़िगरेशन की ज़रूरत होती है.

शामिल होने पर की जाने वाली गतिविधि

Protected Audience API की जांच करने का तरीका यहां बताया गया है:

चरण

  1. अनुरोध करने का फ़ॉर्म भरें Protected Audience API के एक्सपेरिमेंट में शामिल होने के लिए.
  2. अनुरोध फ़ॉर्म सबमिट करने के बाद, अपने खाता मैनेजर या फ़ाइल Authorized Buyer सहायता केंद्र Center.
  3. खाता कॉन्फ़िगर होने के बाद, Google और पार्टनर, दोनों इंटिग्रेशन के लिए, टेस्ट के स्टेज में दिए गए चरणों को पूरा करें.

क्रिएटिव समीक्षा

उत्पाद-स्तरीय विज्ञापनों के साथ बोली लगाने के लिए (कई हिस्सों से मिलकर बने विज्ञापन) Protected Audience API से जुड़ी नीलामियों में, ये ज़रूरी शर्तें पूरी करें:

  • इस पैरामीटर के लिए, renderUrl में &pltd=True क्वेरी पैरामीटर शामिल करें: कॉम्पोनेंट विज्ञापन का कंटेनर (जिसे टॉप-लेवल renderUrl भी कहा जाता है) क्रिएटिव समीक्षा के दौरान टॉप-लेवल renderUrls में अंतर करें.
  • जब कॉम्पोनेंट विज्ञापन का कंटेनर Google से क्रिएटिव समीक्षा के लिए फ़ेच किया गया. यह समझने के लिए कि प्रतिनिधि विज्ञापन रेंडरिंग को दिखाया जाना चाहिए, आप validation=True क्वेरी पैरामीटर, जिसे Google के क्रिएटिव समीक्षा सिस्टम ने सेट किया है.

इंटिग्रेशन चेकलिस्ट

  • बिड रिक्वेस्ट का ऐसा एंडपॉइंट सेट अप करें जो Protected Audience API से अपने-आप जानकारी भरे कीवर्ड के हिसाब से बिड के रिस्पॉन्स से मिलते-जुलते फ़ील्ड—उदाहरण के लिए, interest_group_bidding.
  • उपयोगकर्ता के ब्राउज़र से जुड़ने के लिए, विज्ञापन देने वाले के पेजों पर टैग लागू करें एक जैसी चीज़ें चुनें.
  • generateBid() और reportWin() लागू करें.
  • इंटरेस्ट ग्रुप के मालिक का ऑरिजिन चुनें और उन्हें Authorized Buyer में जोड़ें जोड़ें.
  • Protected Audience API से जुड़ी इन्वेंट्री के लिए, प्री-टारगेटिंग सेट अप करना टेस्टिंग हो रही है.
  • क्रिएटिव के ज़रिए समीक्षा और मंज़ूरी के लिए क्रिएटिव सबमिट करें एपीआई.
  • (ज़रूरी नहीं) भरोसेमंद बिडिंग सिग्नल के एंडपॉइंट सेट अप करें.
  • (ज़रूरी नहीं) टेस्ट ऐडवर्टाइज़र पेज सेट अप करें, ताकि Google के इंजीनियर आपके इंटरेस्ट ग्रुप के खरीदार के मालिकाना हक वाले इंटरेस्ट ग्रुप में उसका ब्राउज़र शामिल होता है ऑरिजिन. इसकी मदद से, हम Protected Audience से जुड़ी नीलामियों को मैन्युअल तौर पर ट्रिगर कर पाते हैं.
  • (ज़रूरी नहीं) सुझाव/शिकायत/राय पाने के लिए, अपने खाते पर रीयल-टाइम में सुझाव पाने की सुविधा चालू करें एक जैसी दिलचस्पी वाले ग्रुप के खरीदारों ने, Protected Audience में शामिल होने का अनुरोध किया नीलामी.
  • (ज़रूरी नहीं) स्टैटिक यूआरएल कॉन्फ़िगर करने के लिए, अपने खाता मैनेजर से संपर्क करें आपको सर्वर-टू-सर्वर सूचना मिलती है, जो Protected Audience बिड की सुविधा देती है डिवाइस पर मौजूद Protected Audience से बिड की स्थिति के बारे में सुझाव/राय या शिकायत नीलामी की मदद लें. बोली फ़ीडबैक देखें नोटिफ़िकेशन देखें.

टेस्ट के चरण

पहला चरण: मैन्युअल तरीके से जांच करना

Protected Audience API से जुड़ी नीलामी को मैन्युअल तरीके से ट्रिगर करने का तरीका यहां बताया गया है, पक्का करें कि विज्ञापन और इंप्रेशन रिकॉर्ड करें:

  1. Chrome 101 या इसके बाद के वर्शन का इस्तेमाल करें.
  2. इसका इस्तेमाल करके, Privacy Sandbox API और Fenced Frame को चालू करें chrome://flags/#privacy-sandbox-ads-apis और chrome://flags/#enable-fenced-frames. ज़्यादा जानकारी के लिए, निजता की जांच करें सैंडबॉक्स के तौर पर दिखता है.
  3. रीयल-टाइम बिडिंग का इस्तेमाल करके क्रिएटिव को मंज़ूरी के लिए सबमिट करें एपीआई.
  4. बिड करने वाले के मालिकाना हक वाले पेज में कोई ब्राउज़र जोड़ने के लिए, बिड करने वाले के दिए गए, विज्ञापन देने वाले के पेज का इस्तेमाल करें एक जैसी दिलचस्पी वाला ग्रुप.

  5. एक सुरक्षित ऑडियंस नीलामी:

    https://fledge-testing.uc.r.appspot.com/?nid=allow_all

    नीलामी में जीतने के लिए, इन-ब्राउज़र इंटरेस्ट ग्रुप को ऊंची बोली लगानी होगी, क्योंकि परंपरागत सर्वर-साइड बिड के साथ मुकाबला कर सकते हैं. Google, हर पार्टनर के लिए खास तौर पर बनाया गया टेस्ट पब्लिशर पेज, जहां सिर्फ़ दिया गया पार्टनर नीलामी में हिस्सा ले सकता है. भरोसे के साथ जीत हासिल करना आसान हो सकता है पार्टनर के पेज पर इन-ब्राउज़र नीलामियां.

  6. इनकी पुष्टि करें:

    1. अपेक्षित विजेता विज्ञापन रेंडर किया जाता है.
    2. नीलामी के नतीजे सर्वर-साइड पर भेजे जाते हैं—यानी कि नीलामी में जीतने वाली बिडर reportWin() से एक पिंग वापस मिलता है.
    3. परीक्षण प्रकाशक पेज कंसोल, इसके साथ प्रत्येक बोली के लिए एक डीबग संदेश लॉग करता है यहां दी गई जानकारी:
      • renderUrl: बिड का रेंडर यूआरएल.
      • interestGroupOwner: बोली के इंटरेस्ट ग्रुप का मालिक.
      • accepted: अगर बिड स्वीकार कर ली गई थी, तो यह फ़ील्ड true है और false अगर scoreAd() ने बिड अस्वीकार की हो.
      • externalBidStatus: स्थिति कोड यदि बोली को scoreAd(). मान क्रिएटिव की स्थिति हैं कोड.

दूसरा चरण: (ज़रूरी नहीं) रेंडर न करने की प्रक्रिया का प्रयोग

जब Google और पार्टनर मैन्युअल तरीके से पुष्टि कर लें कि पार्टनर ये काम कर सकता है Protected Audience नीलामी में हिस्सा लेने के लिए, Google, पार्टनर को यह टेस्टिंग का अगला चरण है.

Protected Audience को चलाने के लिए, Google लाइव ट्रैफ़िक का एक छोटा हिस्सा बांटता है नीलामी. इसके बाद, Google और पार्टनर को मैन्युअल तरीके से Protected Audience API से जुड़ी नीलामी. Protected Audience API से जुड़ी नीलामी का नतीजा यह नहीं होता कि रेंडर किया गया. इससे हमें इंटिग्रेशन की जांच बड़े पैमाने पर करने में मदद मिलती है.

अपने खाता मैनेजर से संपर्क करें या Authorized Buyer के ज़रिए टिकट फ़ाइल करें सहायता केंद्र पर जाएं. Google इस चरण के लिए, खाते को चालू कर देगा.

तीसरा चरण: रेंडरिंग का प्रयोग

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

अपने खाता मैनेजर से संपर्क करें या Authorized Buyer के ज़रिए टिकट फ़ाइल करें सहायता केंद्र पर जाएं. Google इस चरण के लिए, खाते को चालू कर देगा.

अतिरिक्त सुविधाएं

यहां दी गई सुविधाएं, मुख्य प्रोटोकॉल के एक्सटेंशन हैं.

साथ-साथ लोड होना

पैरललाइज़ेशन एक ऐसा ऑप्टिमाइज़ेशन है जिससे शुरू से आखिर तक नीलामी में लगने वाले समय को इसके साथ-साथ प्रासंगिक विज्ञापन अनुरोध भी शुरू करना खरीदार भरोसेमंद सर्वर trustedBiddingSignalsUrl में बताया गया है.

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

विज्ञापन दिखाने के फ़्लो की खास जानकारी

यहां समानांतर नीलामी के फ़्लो की खास जानकारी दी गई है: फ़्लो डायग्राम अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

उपयोगकर्ता के डिवाइस पर, इंटरेस्ट ग्रुप के आधार पर खरीदारी करने की ज़रूरी शर्तें

साथ-साथ होने वाली नीलामियों के लिए, navigator.runAdAuction का कॉल इससे पहले होता है काम के विज्ञापन का रिस्पॉन्स दिखाया जाता है. खरीदार को भरोसेमंद ऑर्डर देने के लिए सर्वर कॉल के लिए अनुरोध करता है, तो navigator.runAdAuction के लिए आवश्यक है कि interestGroupBuyers पैरामीटर ऐसा होना चाहिए को मान के रूप में पास किया जाता है, जबकि बाकी नीलामी पैरामीटर JavaScript को स्वीकार करते हैं ऐसे वादे जिन्हें कॉन्टेक्स्ट के हिसाब से विज्ञापन के जवाब के बाद पूरा किया जा सकता है. से interestGroupBuyers को संदर्भ के हिसाब से विज्ञापन का जवाब मिलने से पहले पास किया जाता है, काम के विज्ञापन से मिला रिस्पॉन्स (इसमें बिड रिस्पॉन्स भी शामिल हैं) इसका इस्तेमाल यह चुनने के लिए नहीं किया जा सकता कि किन खरीदारों को साथ-साथ नीलामी में शामिल किया जाएगा दिए गए अनुरोध पर. Google के पब्लिशर टैग कैश के बजाय, उपयोगकर्ता के ब्राउज़र में, पिछलेinterestGroupBuyers एक ही डोमेन पर navigator.runAdAuction निष्पादन.

साथ-साथ लोड होने की प्रोसेस कई अहम बातों पर निर्भर करती है:

  1. ऐसे नीलामी सिग्नल जो खरीदार के भरोसेमंद सर्वर पर होने वाले अनुरोधों के लिए ज़रूरी नहीं हैं, जैसे, perBuyerSignals, को आरटीबी बिड रिस्पॉन्स में दिखाया जाना जारी रखा जा सकता है उसी तरह से करें जैसे वे नीलामियां करते हैं. इन सिग्नल के लिए प्रॉमिस पूरी हो जाने के बाद, ऑन-डिवाइस नीलामी उसी तरह से पूरी होगी जैसे कि अन्य प्लैटफ़ॉर्म पर होती है नीलामी के फ़्लो के बारे में बताएं.

  2. साथ-साथ लोड होने की प्रोसेस, इंटरेस्ट ग्रुप के खरीदारों की सूची को कैश मेमोरी में सेव करने पर निर्भर करती है, Google, हमेशा पैरललाइज़ेशन कैश के तौर पर पैरलल नीलामी नहीं करता खाली हो सकती है या उसकी समयसीमा खत्म हो चुकी है. अगर कैश मेमोरी खाली है या उसकी समयसीमा खत्म हो गई है, तो Google यह स्टैंडर्ड नॉन-पैरलल Protected Audience API नीलामी के लिए, खरीदार के इंटेंट का इस्तेमाल इन कामों के लिए करता है इंटरेस्ट ग्रुप के खरीदारों की कैश मेमोरी बनाने के लिए, नॉन-पैरलल नीलामी में हिस्सा नहीं ले सकते.

  3. अगर किसी भी बिडर के लिए कम से कम एक खरीदार को मौजूदा पब्लिशर के लिए कैश मेमोरी में सेव किया जाता है डोमेन है, तो Google नीलामी, जिसे बिड रिक्वेस्ट पर दिखाया जाएगा:

    • Google आरटीबी प्रोटोकॉल: BidRequest.adslot.interest_group_auction.parallelized
    • OpenRTB: BidRequest.imp.ext.interest_group_auction.parallelized

  4. किसी बिडर के लिए, रजिस्टर किए गए इंटरेस्ट ग्रुप के खरीदार की शुरुआत समानांतर नीलामी में शामिल ParallelAuctionBuyer एंट्री:

    • Google आरटीबी प्रोटोकॉल: BidRequest.adslot.interest_group_auction.parallel_auction_buyer
    • OpenRTB: BidRequest.imp.ext.interest_group_auction.pbuyer

  5. अगर समानांतर नीलामी चलती है, लेकिन खास खरीदार का ऑरिजिन मौजूद नहीं है कैश मेमोरी का इस्तेमाल करता है, तो उस खरीदार को मौजूदा डिवाइस में नहीं जोड़ा जा सकता नीलामी. यह parallelized=True के साथ किए गए उस अनुरोध से पता चलता है जिसमें एक दिए गए इंटरेस्ट ग्रुप के खरीदार की शुरुआत के लिए, ParallelAuctionBuyer की एंट्री. हालांकि, बिड करने वाले ऐसे लोग जो मान्य और ज़रूरी शर्तें पूरी करके, दिलचस्पी दिखाते हैं InterestGroupBuyer के बिड रिस्पॉन्स से मिले नतीजों में एक इंटरेस्ट ग्रुप से जुड़ा, संबंधित खरीदार होगा ऑरिजिन, कैश मेमोरी में जोड़े गए हैं और उन ऑरिजिन को कैश मेमोरी में सेव किया जा सकता है साथ ही, आने वाले समय में एक ही ब्राउज़र और डोमेन से किए जाने वाले अनुरोध शामिल करें. इंटरेस्ट ग्रुप की नीलामियों में हिस्सा लेने की इच्छा को नीचे दिए गए फ़ील्ड में दिखाया जा सकता है:

    • Google आरटीबी प्रोटोकॉल: BidResponse.adslot.interest_group_bidding.interest_group_buyers
    • OpenRTB: BidResponse.ext.igbid.igbuyer

  6. कैश मेमोरी में सेव किए गए खरीदार ऐसे ऑरिजिन (जो समानांतर नीलामी में शामिल हैं interestGroupBuyers पैरामीटर) जिसके लिए बिड करने वाला, इंटेंट नहीं दिखाता है बिड रिस्पॉन्स में हिस्सा लेने के लिए, खरीदार के भरोसेमंद सर्वर पर कॉल मिल सकती है साथ-साथ होने वाली नीलामी में हिस्सा नहीं लेगा.