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

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

अगर आपको 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, फ़ेन्स्ड फ़्रेम, और Attribution Reporting.

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

Protected Audience API क्या है?

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

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 Beta 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 से किया गया हो.

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

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

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

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

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

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

टाइमलाइन के अपडेट के लिए, 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. सेलर और नीलामी में हिस्सा लेने वाले खरीदार, Key/Value सेवा से रीयल-टाइम डेटा का अनुरोध करते हैं

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

खरीदार, अपनी Key/Value सेवा से रीयल-टाइम डेटा का अनुरोध कर सकता है. इसके लिए, उसे 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 की Key/Value सेवा को ओपन सोर्स करने के बारे में पढ़ें.

6. सबसे अच्छा परफ़ॉर्म करने वाला विज्ञापन दिखाया जाता है

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

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

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

7. नीलामी के नतीजे की रिपोर्ट की जाती है

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

इवेंट-लेवल की रिपोर्टिंग के लिए, कुछ समय के लिए उपलब्ध इस सुविधा का इस्तेमाल किया जा सकता है. इसके लिए, सेलर के लिए 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 और Magnite के PARRROT के प्रस्तावों में, डिवाइस पर होने वाली नीलामी में खरीदारों और सेलर की अलग-अलग भूमिकाओं के बारे में बताया गया है. Protected Audience API की विज्ञापन बिडिंग/स्कोरिंग का फ़्लो, इसी काम पर आधारित है.
• RTB House ने TURTLEDOVE में नतीजे पर आधारित और प्रॉडक्ट-लेवल बदलाव किए. इससे डिवाइस पर होने वाली नीलामी में, पहचान छिपाने वाले मॉडल और मनमुताबिक बनाने की सुविधाओं को बेहतर बनाया गया
• PARAKEET, Microsoft का एक प्रस्ताव है. यह TURTLEDOVE की तरह विज्ञापन दिखाने वाली सेवा है. यह ब्राउज़र और विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनियों के बीच टीईई में चलने वाले प्रॉक्सी सर्वर पर निर्भर करती है. इसका इस्तेमाल, विज्ञापन अनुरोधों को गुमनाम बनाने और निजता से जुड़ी सेटिंग लागू करने के लिए किया जाता है. Protected Audience API ने इस प्रॉक्सी मॉडल को नहीं अपनाया है. हम PARAKEET और Protected Audience API के JavaScript एपीआई को एक साथ ला रहे हैं. इससे, आने वाले समय में दोनों ऑफ़र की सबसे अच्छी सुविधाओं को एक साथ इस्तेमाल किया जा सकेगा.

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

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

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

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

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

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

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

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

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

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

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

सुझाव/राय देना या शिकायत करना

सहायता पाएं

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

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

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

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

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

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

अपडेट पाएं

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