Protected Audience API: डेवलपर गाइड

bookmark_border संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

डिवाइस पर विज्ञापन नीलामियों के लिए डेवलपर गाइड. इसकी मदद से, तीसरे पक्ष की क्रॉस-साइट ट्रैकिंग के बिना, रीमार्केटिंग और कस्टम ऑडियंस को विज्ञापन दिखाए जा सकते हैं.

Protected Audience API के बारे में पहली बार जानने वाले लोग, एपीआई के बारे में ज़्यादा जानकारी के लिए Protected Audience API की खास जानकारी पढ़ें.

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

लागू करने की स्थिति

• Protected Audience API का प्रपोज़ल अब सामान्य तौर पर उपलब्ध होगा. सवाल पूछें और चर्चा को फ़ॉलो करें.
• Protected Audience API की मंज़ूरी बाकी है उसकी स्थिति Protected Audience API और सुविधाओं में हुए बदलावों और सुविधाओं को बेहतर बनाया गया है.
• ब्लिंक की स्थिति
• Protected Audience API Chrome प्लैटफ़ॉर्म की स्थिति: यह खास तौर पर Chrome पर Protected Audience API के लिए है.
• Ads API Chrome प्लैटफ़ॉर्म की स्थिति: विज्ञापन को आसान बनाने के लिए, कई एपीआई का कलेक्शन: Protected Audience API, Topics, फ़ेंस किए गए फ़्रेम, और एट्रिब्यूशन रिपोर्टिंग.

एपीआई में स्टेटस में हुए बदलावों की सूचना पाने के लिए, डेवलपर के लिए ईमेल भेजने की सूची में शामिल हों.

Protected Audience API क्या है?

Protected Audience API, Privacy Sandbox का एक एपीआई है. इसका इस्तेमाल, रीमार्केटिंग और कस्टम ऑडियंस के इस्तेमाल के उदाहरणों के लिए किया जाता है. इस एपीआई को इस तरह से डिज़ाइन किया गया है कि तीसरे पक्ष इसका इस्तेमाल, साइटों पर उपयोगकर्ता के ब्राउज़िंग व्यवहार को ट्रैक करने के लिए न कर सकें. यह एपीआई, ब्राउज़र की मदद से उपयोगकर्ता के डिवाइस पर होने वाली नीलामियों को चालू करता है. इससे, उपयोगकर्ता को उन वेबसाइटों के लिए काम के विज्ञापन दिखाए जा सकते हैं जिन पर वह पहले भी जा चुका है.

Protected Audience API, TURTLEDOVE फ़ैमिली के प्रस्तावों में से पहला ऐसा एक्सपेरिमेंट है जिसे Chromium में लागू किया गया है.

Protected Audience API आज़माना

उपलब्ध एपीआई का रेफ़रंस

इस दस्तावेज़ में, Protected Audience API के बारे में खास जानकारी दी गई है. अगर आपको एपीआई के खास तरीके और पैरामीटर चाहिए, तो:

• joinAdInterestGroup() और generateBid() के लिए खरीदारों की गाइड.
• Protected Audience API के लिए सेलर गाइड runAdAuction()
• reportWin() के लिए खरीदारों की गाइड और reportResult() के लिए सेलर की गाइड
• Protected Audience API से जुड़ी समस्या हल करना

Protected Audience API की मदद से विज्ञापन नीलामी में लगने वाले समय के लिए सबसे सही तरीके भी पढ़े जा सकते हैं.

Protected Audience API का डेमो

विज्ञापन देने वाले लोगों या कंपनियों और पब्लिशर की सभी साइटों पर, Protected Audience API को डिप्लॉय करने का बुनियादी तरीका जानने के लिए, protected-audience-demo.web.app/ पर जाएं.

इस एपीआई की जांच करना

डेस्कटॉप पर, Chrome के बीटा वर्शन 101.0.4951.26 और इसके बाद के वर्शन में, किसी एक उपयोगकर्ता के लिए Protected Audience API की जांच की जा सकती है:

• chrome://settings/adPrivacy में जाकर, विज्ञापन देखने वाले की निजता बनाए रखने से जुड़े सभी एपीआई चालू करें.
• कमांड लाइन से फ़्लैग सेट करना. Protected Audience API के फ़्लैग की पूरी सूची, Chromium Code Search में देखी जा सकती है.

iframe या फ़ेंस्ड फ़्रेम में विज्ञापन रेंडर करना

विज्ञापनों को <iframe> या <fencedframe> में रेंडर किया जा सकता है. यह इस बात पर निर्भर करता है कि कौनसे फ़्लैग सेट किए गए हैं.

विज्ञापनों को रेंडर करने के लिए <fencedframe> का इस्तेमाल करने के लिए:

--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,FencedFrames

विज्ञापनों को रेंडर करने के लिए <iframe> का इस्तेमाल करने के लिए:

--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,AllowURNsInIframes --disable-features=FencedFrames

डीबग के दौरान, कुछ समय के लिए गेम में होने वाली हार/जीत की रिपोर्टिंग के तरीके चालू करने के लिए, BiddingAndScoringDebugReportingAPI फ़्लैग शामिल करें.

इस्तेमाल की जा सकने वाली सुविधाएं

Chromium में सुविधा फ़्लैग के पीछे मौजूद Protected Audience API, Protected Audience API की इन सुविधाओं को टेस्ट करने के लिए किया गया पहला एक्सपेरिमेंट है:

• एक जैसी दिलचस्पी वाले ग्रुप: ब्राउज़र में सेव किए जाते हैं. साथ ही, विज्ञापन बिडिंग और रेंडरिंग को कॉन्फ़िगर करने के लिए, उनसे जुड़ा मेटाडेटा भी सेव किया जाता है.
• खरीदारों (डीएसपी या विज्ञापन देने वाले) की ओर से डिवाइस पर बिडिंग: यह सेव किए गए दिलचस्पी के ग्रुप और सेलर के सिग्नल पर आधारित होती है.
• सेलर (एसएसपी या पब्लिशर) के हिसाब से डिवाइस पर विज्ञापन चुनना: यह विकल्प, खरीदारों की नीलामी की बिड और मेटाडेटा के आधार पर तय होता है.
• फ़ेंस्ड फ़्रेम के कुछ समय के लिए बनाए गए आसान वर्शन में विज्ञापन रेंडर करना: इसमें विज्ञापन रेंडर करने के लिए, नेटवर्क ऐक्सेस और लॉगिंग की अनुमति होती है.

Protected Audience API के बारे में जानकारी में, इस सुविधा के साथ काम करने वाले प्लैटफ़ॉर्म और इसकी सीमाओं के बारे में ज़्यादा पढ़ें.

एक जैसी दिलचस्पी वाले ग्रुप की अनुमतियां

Protected Audience API को फ़िलहाल इस तरह से लागू किया गया है कि किसी पेज पर कहीं से भी joinAdInterestGroup() को कॉल किया जा सकता है. यहां तक कि क्रॉस-डोमेन iframe से भी joinAdInterestGroup() को कॉल किया जा सकता है.

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

कुंजी/वैल्यू सेवा

Protected Audience API की विज्ञापन नीलामी के साथ काम करने के लिए, ब्राउज़र कुंजी/वैल्यू सेवा को ऐक्सेस कर सकता है. इससे, रीयल-टाइम में ऐसी जानकारी हासिल की जा सकती है जो Protected Audience API की विज्ञापन नीलामी के साथ काम करती है. इस जानकारी का इस्तेमाल कई तरीकों से किया जा सकता है:

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

Protected Audience API की कुंजी/वैल्यू सेवा कोड अब उपलब्ध है. स्टेटस के बारे में अपडेट पाने के लिए, एलान वाली ब्लॉग पोस्ट देखें.

शुरुआती जांच के लिए, "अपना सर्वर लाएं" वाला मॉडल शुरू किया गया था. लंबे समय में, विज्ञापन टेक्नोलॉजी कंपनियों को, भरोसेमंद एक्सीक्यूशन एनवायरमेंट में चल रही, ओपन-सोर्स Protected Audience API की कुंजी/वैल्यू की सेवाओं का इस्तेमाल करना होगा.

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

सुविधा के इस्तेमाल के लिए सहायता का पता लगाना

एपीआई का इस्तेमाल करने से पहले, देख लें कि वह ब्राउज़र पर काम करता है या नहीं और दस्तावेज़ में उपलब्ध है या नहीं:

'joinAdInterestGroup' in navigator &&
  document.featurePolicy.allowsFeature('join-ad-interest-group') &&
  document.featurePolicy.allowsFeature('run-ad-auction') ?
  console.log('navigator.joinAdInterestGroup() is supported on this page') :
  console.log('navigator.joinAdInterestGroup() is not supported on this page');

Protected Audience API कैसे काम करता है?

इस उदाहरण में, कोई उपयोगकर्ता कस्टम साइकल बनाने वाली कंपनी की वेबसाइट ब्राउज़ करता है. इसके बाद, वह किसी समाचार वेबसाइट पर जाता है और उसे साइकल बनाने वाली कंपनी की नई साइकल का विज्ञापन दिखता है.

Protected Audience API की सुविधाएं, समय के साथ जोड़ी जाएंगी. ऐसा, इसे लागू करने के काम के आगे बढ़ने के साथ होगा.

1. कोई उपयोगकर्ता, विज्ञापन देने वाले व्यक्ति या कंपनी की साइट पर जाता है

मान लें कि कोई उपयोगकर्ता, कस्टम साइकल बनाने वाली किसी कंपनी (इस उदाहरण में विज्ञापन देने वाले) की वेबसाइट पर जाता है और हाथ से बनी स्टील साइकल के प्रॉडक्ट पेज पर कुछ समय बिताता है. इससे, साइकल बनाने वाली कंपनी को रीमार्केटिंग का मौका मिलता है.

2. उपयोगकर्ता के ब्राउज़र से इंटरेस्ट ग्रुप जोड़ने के लिए कहा जाता है

विज्ञापन देने वाले का डिमांड साइड प्लैटफ़ॉर्म (डीएसपी) या विज्ञापन देने वाला खुद, ब्राउज़र से कहता है कि वह इंटरेस्ट ग्रुप को उन ग्रुप की सूची में जोड़ दे जिनका सदस्य ब्राउज़र है. इसके लिए, वह navigator.joinAdInterestGroup() को कॉल करता है.

इस उदाहरण में, ग्रुप का नाम custom-bikes है और उसका मालिक dsp.example है. एक जैसी दिलचस्पी वाले ग्रुप का मालिक (इस मामले में, डीएसपी), Protected Audience API विज्ञापन नीलामी में खरीदार होगा. ब्राउज़र, उपयोगकर्ता के डिवाइस पर एक जैसी दिलचस्पी वाले ग्रुप की सदस्यता सेव करता है. इसे ब्राउज़र वेंडर या किसी अन्य व्यक्ति के साथ शेयर नहीं किया जाता.

• Protected Audience API के बारे में जानकारी देने वाली लेख पढ़ें: ब्राउज़र, इंटरेस्ट ग्रुप रिकॉर्ड करते हैं.
• एपीआई गाइड पढ़ें: खरीदार और डीएसपी, joinAdInterestGroup() और बिड जनरेट करने का तरीका जानें.

किसी इंटरेस्ट ग्रुप के लिए विज्ञापन तय करना

ads और adComponents ऑब्जेक्ट में, विज्ञापन क्रिएटिव का यूआरएल शामिल होता है. साथ ही, बिडिंग के समय इस्तेमाल किए जा सकने वाले मनमुताबिक मेटाडेटा को भी शामिल किया जा सकता है. उदाहरण के लिए:

{
  renderUrl: 'https://cdn.example/.../bikeAd1.html',
  metadata: bikeAd1metadata // optional
}

खरीदार बिड कैसे लगाते हैं?

generateBid() को हर उस इंटरेस्ट ग्रुप के लिए कॉल किया जाता है जिसका सदस्य ब्राउज़र है. ऐसा तब होता है, जब इंटरेस्ट ग्रुप के मालिक को बिड करने का न्योता मिलता है.

generatedBid() डेवलपर दस्तावेज़ पढ़ें.

3. उपयोगकर्ता, विज्ञापन स्पेस बेचने वाली किसी साइट पर जाता है

बाद में, उपयोगकर्ता किसी ऐसी साइट पर जाता है जो विज्ञापन स्पेस बेचती है. इस उदाहरण में, यह एक समाचार वेबसाइट है. साइट पर विज्ञापन इन्वेंट्री होती है, जिसे वह रीयल-टाइम बिडिंग की मदद से प्रोग्राम के हिसाब से बेचती है.

4. ब्राउज़र में विज्ञापन नीलामी की जाती है

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

• Protected Audience API के बारे में जानकारी देने वाली लेख पढ़ें: सेलर, उपयोगकर्ता के डिवाइस पर विज्ञापनों की नीलामी करते हैं
• एपीआई गाइड पढ़ें: सेलर, runAdAuction() और विज्ञापन नीलामी में लगने वाले समय के सबसे सही तरीकों के बारे में ज़्यादा जान सकते हैं.

5. सेलर और इस प्रोग्राम में हिस्सा लेने वाले खरीदार, कुंजी/वैल्यू सेवा से रीयल-टाइम डेटा का अनुरोध करते हैं

विज्ञापन नीलामी के दौरान, सेलर अपनी की/वैल्यू सेवा से अनुरोध करके, चुनिंदा विज्ञापन क्रिएटिव के बारे में रीयल-टाइम डेटा का अनुरोध कर सकता है. सेलर, runAdAuction() के दौरान trustedScoringSignalsUrl प्रॉपर्टी की मदद से इस जानकारी का अनुरोध कर सकता है. साथ ही, नीलामी में सभी इंटरेस्ट ग्रुप के ads और adComponents फ़ील्ड में मौजूद सभी एंट्री की renderUrl प्रॉपर्टी के पासकोड का भी इस्तेमाल किया जा सकता है.

खरीदार, navigator.joinAdInterestGroup() को पास किए गए इंटरेस्ट ग्रुप आर्ग्युमेंट की trustedBiddingSignalsUrl और trustedBiddingSignalsKeys प्रॉपर्टी का इस्तेमाल करके, अपनी कुंजी/वैल्यू सेवा से रीयल-टाइम डेटा का अनुरोध कर सकता है.

runAdAuction() को कॉल करने पर, ब्राउज़र हर विज्ञापन खरीदार के भरोसेमंद सर्वर से अनुरोध करता है. अनुरोध का यूआरएल कुछ ऐसा दिख सकता है:

https://kv-service.example/getvalues?hostname=publisher.example&keys=key1,key2

• बेस यूआरएल, trustedBiddingSignalsUrl से आता है.
• hostname, ब्राउज़र से मिलता है.
• keys की वैल्यू, trustedBiddingSignalsKeys से ली जाती है.

इस अनुरोध का जवाब, एक JSON ऑब्जेक्ट होता है, जिसमें हर बटन की वैल्यू दी जाती है.

• Protected Audience API के बारे में जानकारी देने वाली लेख पढ़ें: Protected Audience API की कुंजी/वैल्यू सेवा से रीयल-टाइम डेटा फ़ेच करना.
• Protected Audience API की कुंजी/वैल्यू सेवा को ओपन सोर्स करना लेख पढ़ें.

6. विज्ञापन दिखाने के लिए चुना गया विज्ञापन दिखाया जाता है

जब नीलामी कॉन्फ़िगरेशन में resolveToConfig फ़्लैग को true पर सेट किया जाता है, तो runAdAuction() से मिलने वाला प्रॉमिस, फ़ेंस किए गए फ़्रेम कॉन्फ़िगरेशन ऑब्जेक्ट (FencedFrameConfig) पर रिज़ॉल्व होता है. फ़्रेम कॉन्फ़िगरेशन का इस्तेमाल, फ़ेंस किए गए फ़्रेम में विज्ञापन दिखाने के लिए किया जाता है. हालांकि, फ़्रेम को जोड़ने वाले व्यक्ति को विज्ञापन का यूआरएल नहीं दिखता.

फ़ेंस किया गया फ़्रेम कॉन्फ़िगरेशन ऑब्जेक्ट, M114 से उपलब्ध है. FencedFrameConfig ऑब्जेक्ट के बारे में ज़्यादा जानने के लिए, Chrome ब्लॉग का लेख पढ़ें.

• Protected Audience API के बारे में जानकारी देने वाली लेख पढ़ें: ब्राउज़र, विज्ञापनों में से सबसे अच्छा विज्ञापन रेंडर करते हैं

7. नीलामी के नतीजे की शिकायत की जाती है

लंबे समय के प्लान के तहत, ब्राउज़र को Private Aggregation APIs का इस्तेमाल करके, बिक्री करने वाले और खरीदारों के लिए नीलामी के नतीजों की जानकारी देने की अनुमति दी जाएगी.

सेलर के लिए reportResult() और बिड जीतने वाले के लिए reportWin() को लागू करने वाला कोड, इवेंट-लेवल की रिपोर्टिंग के लिए, sendReportTo() फ़ंक्शन को कॉल कर सकता है. इसमें एक आर्ग्युमेंट होता है: नीलामी पूरी होने के बाद फ़ेच किए गए यूआरएल की जानकारी देने वाली स्ट्रिंग, जो रिपोर्ट किए जाने वाले इवेंट-लेवल की जानकारी को कोड में बदलती है.

• एपीआई गाइड पढ़ें: सेलर और खरीदार की रिपोर्टिंग के बारे में जानें

8. विज्ञापन पर क्लिक होने की रिपोर्ट की जाती है

फ़ेंस किए गए फ़्रेम में रेंडर किए गए विज्ञापन पर मिले क्लिक की रिपोर्ट की जाती है. इस सुविधा के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, फ़ेंस किए गए फ़्रेम वाले विज्ञापनों की रिपोर्टिंग देखें.

Protected Audience API और TURTLEDOVE के बीच क्या अंतर है?

Protected Audience API, TURTLEDOVE फ़ैमिली के प्रस्तावों में से पहला ऐसा एक्सपेरिमेंट है जिसे Chromium में लागू किया गया है.

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

TURTLEDOVE का मकसद, इस इस्तेमाल के उदाहरण को हल करने के लिए एक नया एपीआई उपलब्ध कराना है. साथ ही, निजता से जुड़ी कुछ अहम सुविधाएं भी देना है:

• विज्ञापन देने वाले के हिसाब से, किसी व्यक्ति की दिलचस्पी किस चीज़ में है, इस बारे में जानकारी ब्राउज़र के पास होती है, न कि विज्ञापन देने वाले के पास.
• विज्ञापन देने वाले लोग या कंपनियां, किसी व्यक्ति की दिलचस्पी के आधार पर विज्ञापन दिखा सकती हैं. हालांकि, वे उस दिलचस्पी को किसी व्यक्ति की अन्य जानकारी के साथ नहीं जोड़ सकतीं. जैसे, वह व्यक्ति कौन है या वह किस पेज पर जा रहा है.

Protected Audience API, TURTLEDOVE और उससे जुड़े बदलावों के प्रपोज़ल से बना है. इन बदलावों को एपीआई का इस्तेमाल करने वाले डेवलपर को बेहतर सेवा देने के लिए किया गया है:

• SPARROW में: Criteo ने ट्रस्टेड एक्ज़ीक्यूशन एनवायरमेंट (टीईई) में चलने वाले ("गेटकीपर") सेवा मॉडल को जोड़ने का सुझाव दिया है. Protected Audience API में, रीयल-टाइम डेटा लुकअप और एग्रीगेट की गई रिपोर्टिंग के लिए, टीईई का ज़्यादा सीमित इस्तेमाल किया जाता है.
• NextRoll के TERN और Magntinte के PARRROT के प्रस्तावों में, डिवाइस पर होने वाली नीलामी में खरीदारों और सेलर की अलग-अलग भूमिकाओं के बारे में बताया गया है. Protected Audience API की विज्ञापन बिडिंग/स्कोरिंग प्रोसेस, इस काम पर आधारित है.
• RTB House के नतीजे के आधार पर और प्रॉडक्ट-लेवल पर किए गए TURTLEDOVE के बदलावों से, डिवाइस पर होने वाली नीलामी के लिए, उपयोगकर्ता की पहचान छिपाने वाले मॉडल और उपयोगकर्ता के हिसाब से बनाने की सुविधाओं को बेहतर बनाया गया
• PARAKEET, Microsoft का ऐसा प्रस्ताव है जो TURTLEDOVE जैसी विज्ञापन सेवा के लिए है. यह ब्राउज़र और विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनियों के बीच, टीईई में चलने वाले प्रॉक्सी सर्वर पर निर्भर करता है. इससे विज्ञापन अनुरोधों को गुप्त रखने और निजता से जुड़ी प्रॉपर्टी लागू करने में मदद मिलती है. Protected Audience API ने इस प्रॉक्सी मॉडल को अपनाया नहीं है. हम PARAKEET के लिए JavaScript एपीआई और Protected Audience API को अलाइन कर रहे हैं. इससे, आने वाले समय में दोनों प्रस्तावों की बेहतर सुविधाओं को जोड़ने में मदद मिलेगी.

Protected Audience API, फ़िलहाल किसी वेबसाइट के विज्ञापन नेटवर्क को यह जानने से नहीं रोकता कि कोई व्यक्ति कौनसे विज्ञापन देखता है. हमें उम्मीद है कि समय के साथ, एपीआई को ज़्यादा निजी बनाने के लिए उसमें बदलाव किए जाएंगे.

क्या Topics API का इस्तेमाल, Protected Audience API के साथ किया जा सकता है?

हां. Topics API की मदद से, मौजूदा उपयोगकर्ता के लिए निगरानी में रखे गए विषय का इस्तेमाल, सेलर या बिड लगाने वाले व्यक्ति या कंपनी के तौर पर, संदर्भ के हिसाब से जानकारी के तौर पर किया जा सकता है. किसी विषय को इन प्रॉपर्टी में शामिल किया जा सकता है:

• auctionSignals, navigator.runAdAuction() को पास की गई नीलामी कॉन्फ़िगरेशन ऑब्जेक्ट की प्रॉपर्टी
• userBiddingSignals, navigator.joinAdInterestGroup() को पास किए गए इंटरेस्ट ग्रुप कॉन्फ़िगरेशन ऑब्जेक्ट की प्रॉपर्टी

ब्राउज़र का उपलब्ध कॉन्फ़िगरेशन

उपयोगकर्ता, Chrome में Privacy Sandbox के ट्रायल में अपनी भागीदारी में बदलाव कर सकते हैं. इसके लिए, उन्हें chrome://settings/adPrivacy में टॉप-लेवल की सेटिंग को चालू या बंद करना होगा.

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

हम टेस्ट और सुझाव/राय के आधार पर, Chrome में उपलब्ध सेटिंग को अपडेट करते रहेंगे. आने वाले समय में, हम Protected Audience API और उससे जुड़े डेटा को मैनेज करने के लिए, ज़्यादा बेहतर सेटिंग उपलब्ध कराएंगे.

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

क्या ब्राउज़र, Protected Audience के वर्कलेट को कैश मेमोरी में सेव करता है?

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

दर्शकों से जुड़ना और सुझाव/राय देना या शिकायत करना

सहायता पाएं

सवाल पूछने और लागू करने, डेमो या दस्तावेज़ से जुड़ी मदद पाने के लिए:

• GitHub: एक्सप्लेनर पढ़ें, सवाल पूछें, और चर्चा को फ़ॉलो करें.
• डेमो: डेमो कोड रिपॉज़िटरी पर समस्या दर्ज करें.
• डेवलपर सहायता: Privacy Sandbox डेवलपर सहायता रीपो पर सवाल पूछें और चर्चाओं में शामिल हों. Protected Audience API के लिए, समस्या का टेंप्लेट चुनें.
• Chrome में लागू करना: Protected Audience API को Chrome में लागू करने से जुड़ी गड़बड़ियों या समस्याओं के लिए, मौजूदा समस्याएं देखें या नई समस्या बताएं.

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

सार्वजनिक फ़ोरम के बाहर, Chrome की टीम के साथ निजी तौर पर सुझाव, राय या शिकायत शेयर करने के लिए, Privacy Sandbox के सुझाव, राय या शिकायत वाले फ़ॉर्म का इस्तेमाल करें.

ट्रांसकोड करने से ऑप्ट-आउट करना

क्या आपको Protected Audience API से ऑप्ट-आउट करना है? साइट के मालिक या उपयोगकर्ता के तौर पर, Protected Audience API का ऐक्सेस ब्लॉक करने का तरीका जानें.

अपडेट पाएं

• एपीआई की स्थिति में होने वाले बदलावों की सूचनाएं पाने के लिए, डेवलपर के लिए मेलिंग सूची में शामिल हों.
• एपीआई के बारे में चल रही सभी चर्चाओं को बारीकी से देखने के लिए, GitHub पर एपीआई पेज पर देखें बटन पर क्लिक करें. इसके लिए, आपके पास GitHub खाता होना चाहिए या नया खाता बनाना होगा.
• Privacy Sandbox के बारे में पूरी जानकारी पाने के लिए, आरएसएस फ़ीड [Privacy Sandbox में हुई प्रोग्रेस] की सदस्यता लें.
• Protected Audience API के लिए शेड्यूल किए गए कॉल में शामिल हों (हर दूसरे हफ़्ते). इसमें सभी लोग हिस्सा ले सकते हैं. हिस्सा लेने के लिए, पहले WICG में शामिल हों. इसमें आपके पास सक्रिय रूप से हिस्सा लेने या सिर्फ़ सुनने का विकल्प होता है!