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

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

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

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

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

Protected Audience API क्या है?

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

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

Protected Audience API, Chromium में लागू किया जाने वाला पहला एक्सपेरिमेंट है TURTLEDOVE परिवार. कॉन्टेंट बनाने Protected Audience और 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'.
  • ब्राउज़र को ऐक्सेस करने की अनुमति देने के लिए, इंटरेस्ट ग्रुप के कॉन्फ़िगरेशन की जानकारी बिडिंग कोड, विज्ञापन कोड, और रीयल-टाइम डेटा को इकट्ठा कर सकते हैं, बशर्ते ग्रुप के मालिक को विज्ञापन नीलामी में बिड करते हैं.

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

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

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

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

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

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

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

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

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

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

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

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

मैं Protected Audience API का इस्तेमाल कैसे करूं?

  • Protected Audience API की डेवलपर गाइड में इनके बारे में बताया गया है एपीआई को इस्तेमाल करने का तरीका क्या है और इसे स्थानीय तौर पर कैसे टेस्ट किया जाए.

  • protected-audience-demo.web.app, विज्ञापन देने वाले लोगों या कंपनियों और पब्लिशर के लिए, Protected Audience से जुड़े बुनियादी डिप्लॉयमेंट के बारे में सिलसिलेवार तरीके से निर्देश साइटें. Protected Audience के डेमो वीडियो में बताया गया है कि यह कोड कैसे काम करता है और इसकी झलक कैसे देखी जा सकती है डीबग करने के लिए, Chrome DevTools का इस्तेमाल कैसे करें.

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

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

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

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

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

क्या मेरे पास Protected Audience API से ऑप्ट आउट करने का विकल्प है?

Protected Audience API का ऐक्सेस ब्लॉक करने का तरीका जानें, अलग-अलग विज्ञापन फ़ॉर्मैट का इस्तेमाल कर सकते हैं.

मुख्य सिद्धांत

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

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

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

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

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

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

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

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

Chrome, हर मालिक के लिए, 1,000 इंटरेस्ट ग्रुप और ज़्यादा से ज़्यादा 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 API में, विज्ञापन नीलामी, ऐसे छोटे JavaScript प्रोग्राम का कलेक्शन होती है जिन्हें ब्राउज़र, उपयोगकर्ता के ब्राउज़र पर चलाता है डिवाइस का इस्तेमाल करें. निजता बनाए रखने के लिए, विक्रेता और खरीदारों के सभी विज्ञापन नीलामी कोड दिखाए जाते हैं अलग-अलग JavaScript वर्कलेट में, जो बाहरी दुनिया से बात नहीं कर सकते.

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

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

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

खरीदारों को खोने से जुड़ी रिपोर्टिंग के तरीके पर बातचीत चल रही है.

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

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

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

को दबाकर रखें खरीदार या विक्रेता 'की' की सूची देता है का इस्तेमाल करें. कुंजी/वैल्यू सेवा, हर कुंजी के लिए एक वैल्यू के साथ जवाब देती है.

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

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

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

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

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

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

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

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

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

Protected Audience से जुड़ी नीलामी में, विज्ञापन देने वाला अपने पहले पक्ष (ग्राहक) के डेटा का इस्तेमाल करके, दिलचस्पी के हिसाब से बनाए गए ग्रुप की सदस्यता तय कर सकता है. साथ ही, वह इंटरेस्ट ग्रुप में 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 का इस्तेमाल कैसे किया जा सकता है.

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