इस पेज का अनुवाद Cloud Translation API से किया गया है.

Protected Audience API की खास जानकारी

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

यह लेख किसके लिए है?

इस लेख में, Protected Audience API की बुनियादी बातों और इसके कुछ सिद्धांतों के बारे में बताया गया है. हालांकि, ज़्यादा तकनीकी जानकारी नहीं दी गई है.

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

Protected Audience दस्तावेज़ में इस्तेमाल किए जाने वाले शब्दों के लिए, शब्दावली देखें. इस लेख के आखिर में, लोगों के साथ जुड़ने और सुझाव/राय देने या शिकायत करने का तरीका जानें.

Protected Audience API क्या है?

Protected Audience API, प्राइवसी सैंडबॉक्स टेक्नोलॉजी है. यह रीमार्केटिंग और कस्टम ऑडियंस के इस्तेमाल के उदाहरणों के लिए सेवा देता है. इसे इस तरह से डिज़ाइन किया गया है कि तीसरे पक्ष, सभी साइटों पर उपयोगकर्ता के ब्राउज़िंग व्यवहार को ट्रैक नहीं कर सकते.

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

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

एक मिनट में Protected Audience API

Protected Audience API के बारे में ज़्यादा जानकारी के लिए, Protected Audience API डेवलपर गाइड पढ़ें.

Protected Audience API की लाइफ़साइकल के हर चरण की खास जानकारी — Protected Audience API की लाइफ़साइकल.

Protected Audience API, इंटरेस्ट ग्रुप का इस्तेमाल करके, साइटों को उनके उपयोगकर्ताओं के हिसाब से काम के विज्ञापन दिखाने की सुविधा देता है.

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

इंटरेस्ट ग्रुप का नाम: उदाहरण के लिए, 'कस्टम-बाइक'.
इंटरेस्ट ग्रुप का मालिक: उदाहरण के लिए, 'https://dsp.example'.
अगर ग्रुप के मालिक को विज्ञापन नीलामी में बिड करने के लिए न्योता दिया जाता है, तो इंटरेस्ट ग्रुप के कॉन्फ़िगरेशन की जानकारी ब्राउज़र को बिडिंग कोड, विज्ञापन कोड, और रीयल-टाइम डेटा ऐक्सेस करने की अनुमति देगा.

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

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

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

बोली लगाने वाले हर इंटरेस्ट ग्रुप को खरीदार कहा जाता है.

जब ब्राउज़र, विज्ञापन नीलामी चलाने के लिए फ़ंक्शन को कॉल करता है, तो हर खरीदार का कोड, उसकी Protected Audience Key/Value सेवा से मिले रीयल-टाइम डेटा की मदद से बिड जनरेट करता है. इसके बाद, विक्रेता को इन बिड के साथ-साथ विक्रेता के मालिकाना हक वाला रीयल-टाइम डेटा मिलता है और उसे हर बिड के लिए स्कोर मिलता है. सबसे ज़्यादा स्कोर वाली बिड नीलामी जीत जाती है.

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

विक्रेता नीलामी के नतीजे (reportResult()) की रिपोर्ट कर सकता है और खरीदार अपनी जीत (reportWin()) की रिपोर्ट कर सकते हैं.

Protected Audience की नीलामी रिपोर्ट के बारे में जानें.

हमें Protected Audience API की ज़रूरत क्यों है?

उपयोगकर्ता की रुचियों को समझने से, आपको काम के विज्ञापन दिखाने के लिए, साइट के कॉन्टेंट के आधार पर विज्ञापन चुनने (संदर्भ के हिसाब से टारगेटिंग) या विज्ञापन दिखाने वाली साइट पर उपयोगकर्ता की दी गई जानकारी (पहले पक्ष के डेटा टारगेटिंग) के आधार पर विज्ञापन दिखाने की ज़रूरत नहीं पड़ती.

आम तौर पर, विज्ञापन प्लैटफ़ॉर्म को सभी साइटों पर उपयोगकर्ताओं के व्यवहार को ट्रैक करके उनकी दिलचस्पी के बारे में पता चलता है. ब्राउज़र को ऐसा तरीका चाहिए जिससे विज्ञापन प्लैटफ़ॉर्म, काम के विज्ञापन चुन सकें. इससे कॉन्टेंट पब्लिशर, क्रॉस-साइट ट्रैकिंग के बिना भी विज्ञापन से रेवेन्यू हासिल कर सकते हैं.

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

चेतावनी: Chrome में टेस्टिंग के लिए उपलब्ध सुविधाओं को समझने के लिए, डेवलपर की गाइड और सुरक्षित ऑडियंस की ऐसी सुविधाओं की स्थिति पढ़ें जिन्हें मंज़ूरी मिलना बाकी है. सुरक्षित ऑडियंस की सुविधाएं समय के साथ जोड़ी जाएंगी. साथ ही, हम समय-समय पर इस बात की सूची अपडेट करते रहेंगे कि कौनसी सुविधाएं पहले ही लागू कर दी गई हैं और कौनसी सुविधाएं अभी पूरी नहीं हुई हैं.

Protected Audience API को कैसे आज़माया जा सकता है?

Protected Audience API की डेवलपर गाइड में एपीआई का इस्तेमाल करने और उसकी स्थानीय तौर पर जांच करने के तरीके के बारे में बताया गया है.
सुरक्षित-ऑडियंस-demo.web.app की मदद से, विज्ञापन देने वाले और पब्लिशर साइटों पर बुनियादी Protected Audience के डिप्लॉयमेंट की जानकारी दी जाती है. Protected Audience डेमो वीडियो में, इस कोड के काम करने के तरीके के बारे में बताया गया है. साथ ही, डीबग करने के लिए Chrome DevTools को इस्तेमाल करने के तरीके की झलक देखी गई है.

कौनसा ब्राउज़र कॉन्फ़िगरेशन उपलब्ध है?

उपयोगकर्ता, Chrome में प्राइवसी सैंडबॉक्स के ट्रायल में अपनी भागीदारी बदल सकते हैं. इसके लिए, उन्हें chrome://settings/adPrivacy में टॉप लेवल सेटिंग को चालू या बंद करना होगा. शुरुआती टेस्टिंग के दौरान, उपयोगकर्ता प्राइवसी सैंडबॉक्स की सेटिंग का इस्तेमाल करके, Protected Audience API से ऑप्ट आउट कर सकते हैं.

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

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

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

क्या Protected Audience API से ऑप्ट आउट किया जा सकता है?

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

खास कॉन्सेप्ट

क्या आपको Protected Audience से जुड़े शब्दों के बारे में ज़्यादा जानकारी चाहिए? प्राइवसी सैंडबॉक्स की शब्दावली देखें.

इंटरेस्ट ग्रुप क्या होता है?

Protected Audience API इंटरेस्ट ग्रुप, एक जैसी दिलचस्पी रखने वाले लोगों के ग्रुप को दिखाता है. यह रीमार्केटिंग सूची से मिलता-जुलता है.

हर Protected Audience API इंटरेस्ट ग्रुप का एक मालिक होता है. अलग-अलग तरह के मालिक, अलग-अलग इस्तेमाल के हिसाब से अलग-अलग तरह के इंटरेस्ट ग्रुप बनाएंगे.

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

एक जैसी दिलचस्पी वाले ग्रुप के टाइप

इस टेबल में, Protected Audience API के अलग-अलग तरह के इंटरेस्ट ग्रुप और मालिकों के उदाहरण दिए गए हैं.

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

Chrome हर मालिक के लिए, एक हज़ार इंटरेस्ट ग्रुप और इंटरेस्ट ग्रुप के ज़्यादा से ज़्यादा 1,000 मालिकों को अनुमति देता है. ये सीमाएं गार्ड रेल की तरह हैं, किसी भी नियमित कार्रवाई में लागू नहीं होनी चाहिए.

खरीदार क्या है?

Protected Audience API में, खरीदार वह पक्ष होता है जो इंटरेस्ट ग्रुप का मालिक होता है और विज्ञापन नीलामी में बिड करता है.

उदाहरण के लिए:

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

खरीदारों के पास तीन जॉब होते हैं:

चुनें कि नीलामी में हिस्सा लेना है या नहीं.
विज्ञापन चुनें और बिड कैलकुलेट करें.
नीलामी के नतीजे की रिपोर्ट करें.

ये काम, Protected Audience API की विज्ञापन नीलामी के दौरान खरीदार के दिए गए कोड में, प्रोग्राम के ज़रिए पूरे किए जाते हैं.

जब कोई खरीदार किसी उपयोगकर्ता के ब्राउज़र से यह कहता है कि वह ग्रुप का सदस्य है (JavaScript फ़ंक्शन navigator.joinAdInterestGroup() पर कॉल करके), तो वह ब्राउज़र को यह जानकारी देता है:

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

नीलामी के नतीजे रिपोर्ट करने के लिए, खरीदार के कोड में reportWin() फ़ंक्शन भी शामिल हो सकता है.

विज्ञापन नीलामी कौन चलाता है?

ऐसे कई पक्ष हैं जो विज्ञापन स्पेस को बेचने के लिए नीलामी कर सकते हैं.

उदाहरण के लिए:

कॉन्टेंट पब्लिशर: अपनी वेबसाइट पर विज्ञापन का कॉन्टेंट होस्ट करने के लिए खुद की मदद करता है.
सप्लाई-साइड प्लैटफ़ॉर्म (SSP): पब्लिशर के साथ काम करना और दूसरी सेवाएं देना.
तीसरे पक्ष की स्क्रिप्ट: विज्ञापन नीलामी में हिस्सा लेने के लिए, पब्लिशर की मदद करना.

Protected Audience API की मदद से, विज्ञापन स्पेस सेलर में तीन काम किए जाते हैं:

पब्लिशर के नियमों को लागू करने के लिए: यह बताना कि कौनसे खरीदार और कौनसी बिड, ज़रूरी शर्तें पूरी करती हैं.
नीलामी के लॉजिक को चलाएं: हर बिड के लिए ज़रूरी स्कोर का हिसाब लगाने के लिए, JavaScript को वर्कलेट में चलाया जाता है.
नीलामी के नतीजे की रिपोर्ट करें.

ये काम, JavaScript फ़ंक्शन navigator.runAdAuction() को कॉल करके विज्ञापन नीलामी शुरू करने पर सेलर से मिले कोड में, प्रोग्राम के ज़रिए पूरे किए जाते हैं.

Protected Audience API की विज्ञापन नीलामी की सुविधा कैसे काम करती है?

नीचे दिए गए डायग्राम में, Protected Audience API विज्ञापन नीलामी के हर चरण के बारे में बताया गया है:

Protected Audience API की विज्ञापन नीलामी के छह स्टेज — Protected Audience की विज्ञापन नीलामी के स्टेज.

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

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

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

कोई उपयोगकर्ता किसी ऐसी साइट पर जाता है जो विज्ञापन दिखाती है.
विक्रेता का कोड नीलामी शुरू करता है. विक्रेता तय करता है कि कौनसा विज्ञापन स्पेस बिक्री के लिए है और कौन बिडिंग कर सकता है. साथ ही, विक्रेता यह भी बताता है कि उन बिड को स्कोर करने का एक तरीका क्या है.
न्योता पाने वाले खरीदार का कोड, बिड जनरेट करने, काम के विज्ञापन क्रिएटिव का यूआरएल, और अन्य डेटा जनरेट करता है. बिडिंग स्क्रिप्ट, खरीदार की कुंजी/वैल्यू वाली सेवा से रीयल-टाइम डेटा क्वेरी कर सकती है, जैसे कि विज्ञापन कैंपेन का बाकी बजट.
सेलर का कोड, हर बिड के लिए स्कोर तय करता है और विजेता चुनता है. यह लॉजिक, बिड की वैल्यू और दूसरे डेटा का इस्तेमाल करके, बिड की ज़रूरत के हिसाब से विज्ञापन दिखाता है. साथ ही, उस विज्ञापन को अस्वीकार कर देता है जो संदर्भ के हिसाब से विज्ञापन के विजेता को पीछे न छोड़ सके. रीयल-टाइम डेटा के लिए, सेलर अपनी कुंजी/वैल्यू वाली सेवा का इस्तेमाल कर सकता है. नीलामी शुरू होने से पहले, विक्रेता को उपलब्ध विज्ञापन स्लॉट के लिए, काम के हिसाब से सबसे अच्छे विज्ञापन मिल जाते हैं.
नीलामी कॉन्फ़िगरेशन में resolveToConfig फ़्लैग सेट होने पर, जीतने वाले विज्ञापन को फ़ेंस किए गए फ़्रेम कॉन्फ़िगरेशन ऑब्जेक्ट के तौर पर दिखाया जाता है. कॉन्फ़िगरेशन का इस्तेमाल, फ़ेंस किए गए फ़्रेम से विज्ञापन क्रिएटिव पर ले जाने के लिए किया जाता है. साथ ही, क्रिएटिव का यूआरएल सेलर और पब्लिशर, दोनों से छिपा रहता है. अगर resolveToConfig फ़्लैग को false पर सेट किया गया है या इसमें पास नहीं किया गया है, तो सबसे अच्छा परफ़ॉर्म करने वाला विज्ञापन एक ओपेक URN के तौर पर दिखाया जाता है. इसका इस्तेमाल, iframe में विज्ञापन को रेंडर करने के लिए किया जा सकता है. फ़ेंस्ड फ़्रेम कॉन्फ़िगरेशन ऑब्जेक्ट, M114 और उसके बाद के वर्शन में उपलब्ध है.
नीलामी की सूचना, विक्रेता और जीतने वाले खरीदारों को दी जाती है.
ध्यान दें: विक्रेता के reportResult() और खरीदार के reportWin() में sendReportTo() को कॉल किया जा सकता है. यह सुविधा कुछ समय के लिए उपलब्ध रहेगी. ऐसा तब तक होगा, जब तक प्राइवेट एग्रीगेशन में एग्रीगेट रिपोर्ट उपलब्ध नहीं हो जाती.

खरीदारों को खोने से बचने की शिकायत करने के तरीके पर चर्चा की जा रही है.

Protected Audience API Key/वैल्यू सेवा क्या है?

Protected Audience API कुंजी/वैल्यू सेवा, खरीदार के बिड करने पर विज्ञापन टेक्नोलॉजी को रीयल-टाइम डेटा के लिए क्वेरी करने की सुविधा देती है. साथ ही, निजता को बनाए रखते हुए, सेलर को विज्ञापन स्कोर करने की सुविधा देती है. Protected Audience API की/वैल्यू सेवा और अन्य सेवाओं के बारे में, Protected Audience API की सेवाओं के बारे में पढ़ें.

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

खरीदार या विक्रेता, 'कुंजी' की सूची उपलब्ध कराता है, ताकि यह बताया जा सके कि उसे Protected Audience API Key/Value सेवा से किस डेटा की ज़रूरत है. कुंजी/वैल्यू सेवा, हर कुंजी के लिए एक वैल्यू के साथ जवाब देती है.

Protected Audience API Key/Value सेवा कोड, अब Privacy Sandbox GitHub रिपॉज़िटरी में उपलब्ध है. Chrome और Android डेवलपर इस सेवा का इस्तेमाल कर सकते हैं.

Protected Audience API Key/Value सेवा के बारे में ज़्यादा जानने के लिए, एपीआई के बारे में जानकारी और ट्रस्ट मॉडल की जानकारी देखें.

रीयल-टाइम डेटा को नीलामियों में कैसे शामिल किया जाता है?

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

Protected Audience API की निजता से जुड़ी ज़रूरी शर्तों को पूरा करने के लिए, कुंजी/वैल्यू सेवा, विज्ञापन नीलामी के दौरान ज़रूरी रीयल-टाइम डेटा उपलब्ध कराती है. जब हर खरीदार navigator.joinAdInterestGroup() को कॉल करता है, तो खरीदार कुंजी/वैल्यू सेवा का यूआरएल और नीलामी के दौरान सेवा से पूछी जाने वाली कुंजियों की जानकारी देता है. इसी तरह, जब सेलर navigator.runAdAuction() को कॉल करके विज्ञापन नीलामी करता है, तो सेलर, कुंजी/वैल्यू से जुड़ी सेवा के लिए एक यूआरएल देता है. विक्रेता की कुंजी/वैल्यू सेवा से क्रिएटिव के रेंडर यूआरएल के बारे में क्वेरी की जाएगी.

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

यह पक्का करने के लिए कि नेटवर्क के पास टेस्ट करने के लिए ज़रूरी समय हो, हमें तीसरे पक्ष की कुकी के बंद होने के कुछ समय बाद तक, ओपन सोर्स कुंजी/वैल्यू सेवाओं या भरोसेमंद एक्ज़ीक्यूशन एनवायरमेंट के इस्तेमाल की ज़रूरत नहीं होती है. इस ट्रांज़िशन के लागू होने से पहले, हम डेवलपर को इसकी जांच करने और उन्हें इस्तेमाल करने के बारे में ज़रूरी सूचना देंगे.

सुरक्षित ऑडियंस की नीलामी में, पहले पक्ष (ग्राहक) के डेटा का इस्तेमाल कैसे किया जाता है?

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

सुरक्षित ऑडियंस की नीलामी में, विज्ञापन देने वाला दिलचस्पी के ग्रुप की सदस्यता तय करने के लिए, पहले पक्ष (ग्राहक) के डेटा का इस्तेमाल कर सकता है. साथ ही, वह डेटा को userBiddingSignals के तौर पर इंटरेस्ट ग्रुप में भी भेज सकता है. विज्ञापन देने वाले व्यक्ति या कंपनी का पहले पक्ष (ग्राहक) का डेटा, सिर्फ़ बिड जनरेट करने के दौरान खरीदार के लिए उपलब्ध होगा. यह डेटा सेलर के लिए उपलब्ध नहीं होगा.

उदाहरण के लिए, अगर विज्ञापन देने वाले को उपयोगकर्ता के पसंदीदा रंग के बारे में पता है, तो उपयोगकर्ता को किसी इंटरेस्ट ग्रुप में जोड़े जाने पर, उसकी वैल्यू को इंटरेस्ट ग्रुप कॉन्फ़िगरेशन में userBiddingSignals के तौर पर सेट किया जा सकता है:

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

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

इस उदाहरण में बताया गया है कि पब्लिशर, पहले पक्ष (ग्राहक) का डेटा, नीलामी में हिस्सा लेने वाले अलग-अलग लोगों को कैसे पास कर सकता है:

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);

ज़्यादा जानें

Protected Audience API के बारे में ज़्यादा जानकारी के लिए, Protected Audience API डेवलपर गाइड पढ़ें.

डेवलपर

अगर आप Protected Audience API का इस्तेमाल करने के लिए तैयार हैं, तो एक्सपेरिमेंट करना और इसमें हिस्सा लेना लेख पढ़ें.

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

दिलचस्पी दिखाएं और सुझाव/राय दें या शिकायत करें

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