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

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

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

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

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

Protected Audience API क्या है?

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

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

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

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

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

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

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

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

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

सेलर, नीलामी के नतीजे (reportResult()) की शिकायत कर सकता है. साथ ही, खरीदार अपनी जीत (reportWin()) की शिकायत कर सकते हैं.

सुरक्षित ऑडियंस की नीलामी रिपोर्ट के बारे में जानें.

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

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

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

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

मैं Protected Audience API को कैसे आज़मा सकता/सकती हूं?

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

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

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

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

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

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

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

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

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

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

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

दिलचस्पी के हिसाब से ग्रुप क्या होता है?

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

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

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

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

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

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

Chrome पर, हर मालिक के पास पसंद के ज़्यादा से ज़्यादा 1,000 ग्रुप बनाने की अनुमति होती है. साथ ही, पसंद के ज़्यादा से ज़्यादा 1,000 ग्रुप के मालिक भी हो सकते हैं. इन सीमाओं का मकसद, सामान्य ऑपरेशन में इनका इस्तेमाल न करना है.

खरीदार कौन होता है?

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

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

खरीदारों के तीन काम होते हैं:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Protected Audience API की विज्ञापन नीलामी के छह चरण
Protected Audience API से जुड़ी विज्ञापन नीलामी के चरण.

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

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

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

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

खरीदारों को खोने की समस्या की रिपोर्टिंग के लिए, चर्चा की जा रही है.

Protected Audience API की कुंजी/वैल्यू सेवा क्या है?

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

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

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

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

एपीआई के बारे में जानकारी और भरोसे के मॉडल के बारे में जानकारी से, Protected Audience API की पासकोड/वैल्यू सेवा के बारे में ज़्यादा जानें.

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

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

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

शुरुआती जांच के लिए, "अपना सर्वर लाएं" मॉडल का इस्तेमाल किया जाता है. लंबे समय में, विज्ञापन टेक्नोलॉजी से जुड़ी सेवाओं को रीयल-टाइम डेटा पाने के लिए, भरोसेमंद एक्सीक्यूशन एनवायरमेंट में चल रही, ओपन-सोर्स 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 का इस्तेमाल करने का तरीका भी बताया गया है.

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