ऑडियंस डेटा तय करना

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

क्या आप डेवलपर नहीं हैं? Protected Audience API की खास जानकारी देखें.

Protected Audience API के इंटरेस्ट ग्रुप

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

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

एपीआई फ़ंक्शन

joinAdInterestGroup()

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

joinAdInterestGroup() के लिए कॉलिंग कॉन्टेक्स्ट का ऑरिजिन, इंटरेस्ट ग्रुप के मालिक के ऑरिजिन से मेल खाना चाहिए. इसलिए, joinAdInterestGroup() को किसी iframe से कॉल करना होगा. उदाहरण के लिए, डीएसपी से. ऐसा तब तक करना होगा, जब तक इंटरेस्ट ग्रुप के मालिक का ऑरिजिन, मौजूदा दस्तावेज़ के ऑरिजिन से मेल नहीं खाता. उदाहरण के लिए, अपनी वेबसाइट के इंटरेस्ट ग्रुप वाली कोई वेबसाइट.

joinAdInterestGroup() को इनकी अनुमति चाहिए:

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

इसका मतलब है कि dsp.example.com की अनुमति के बिना, malicious.example, dsp.example.com के मालिकाना हक वाले किसी दिलचस्पी वाले ग्रुप के लिए joinAdInterestGroup() को कॉल नहीं कर सकता.

विज़िट की गई साइट से अनुमति

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

इस्तेमाल से जुड़ा उदाहरण

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

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  updateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

फ़ंक्शन को पास किया गया interestGroup ऑब्जेक्ट, 50 केआईबी से ज़्यादा का नहीं होना चाहिए. ऐसा न होने पर, कॉल पूरा नहीं होगा. दूसरे पैरामीटर से, दिलचस्पी वाले ग्रुप की अवधि तय की जाती है. यह अवधि ज़्यादा से ज़्यादा 30 दिन हो सकती है. बाद के कॉल, पहले से सेव की गई वैल्यू को बदल देते हैं.

ज़रूरी प्रॉपर्टी

दिलचस्पी के हिसाब से बनाए गए ग्रुप के लिए, सिर्फ़ owner और name प्रॉपर्टी ज़रूरी हैं:

ज़रूरी नहीं है कि ये प्रॉपर्टी मौजूद हों

बची हुई प्रॉपर्टी की वैल्यू देना ज़रूरी नहीं है:

biddingLogicUrl^{1, 2}

उदाहरण: https://dsp.example/bid/custom-bikes/bid.js

भूमिका: बिडिंग के लिए यूआरएल, जो वर्कलेट में JavaScript चलाता है.

biddingWasmHelperUrl^{1, 2}

उदाहरण: https://dsp.example/bid/custom-bikes/bid.wasm

भूमिका: biddingLogicUrl से ड्राइव किए गए WebAssembly कोड के लिए यूआरएल.

updateUrl²

उदाहरण: https://dsp.example/bid/custom-bikes/update

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

trustedBiddingSignalsUrl²

उदाहरण: https://dsp.example/trusted/bidding-signals

भूमिका: यह बिडर की भरोसेमंद Key/Value सेवा के लिए, की-वैल्यू के अनुरोधों का बेस यूआरएल है.

trustedBiddingSignalsKeys

उदाहरण: ['key1', 'key2' ...]

भूमिका: की-वैल्यू ट्रस्टेड की/वैल्यू सेवा के अनुरोधों के लिए कुंजियां.

userBiddingSignals

उदाहरण: {...}

भूमिका: मालिक के पास ऐसा अतिरिक्त मेटाडेटा होता है जिसका इस्तेमाल वह बिडिंग के दौरान कर सकता है.

ads¹

उदाहरण: [bikeAd1, bikeAd2, bikeAd3]

भूमिका: ऐसे विज्ञापन जो इस दिलचस्पी वाले ग्रुप के लिए रेंडर किए जा सकते हैं.

adComponents

उदाहरण: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2]

भूमिका: कई हिस्सों से बने विज्ञापनों के लिए कॉम्पोनेंट.

¹ biddingLogicUrl और ads प्रॉपर्टी की वैल्यू देना ज़रूरी नहीं है. हालांकि, नीलामी में हिस्सा लेने के लिए इनकी वैल्यू देना ज़रूरी है. इन प्रॉपर्टी के बिना भी, इंटरेस्ट ग्रुप बनाया जा सकता है. उदाहरण के लिए, इंटरेस्ट ग्रुप का मालिक किसी ऐसे कैंपेन के लिए ब्राउज़र को इंटरेस्ट ग्रुप में जोड़ना चाहे जो अभी नहीं चल रहा है या आने वाले समय में किसी अन्य काम के लिए जोड़ना चाहे. इसके अलावा, ऐसा भी हो सकता है कि उसके पास विज्ञापन दिखाने के लिए कुछ समय के लिए बजट न हो.

² Protected Audience API के मौजूदा वर्शन में, biddingLogicUrl, biddingWasmHelperUrl, updateUrl, और trustedBiddingSignalsUrl का ऑरिजिन, ओनर के ऑरिजिन के जैसा होना चाहिए. ऐसा हो सकता है कि यह पाबंदी लंबे समय तक न रहे. साथ ही, ads और adComponents यूआरएल पर इस तरह की कोई पाबंदी नहीं है.

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

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

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

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

leaveAdInterestGroup()

दिलचस्पी के हिसाब से बनाए गए ग्रुप का मालिक, ब्राउज़र से किसी ग्रुप को हटाने का अनुरोध कर सकता है. ब्राउज़र, दिलचस्पी वाले ग्रुप को सदस्यता सूची से हटा देता है.

navigator.leaveAdInterestGroup({
  owner: 'https://dsp.example',
  name: 'custom-bikes'
});

अगर कोई उपयोगकर्ता उस साइट पर वापस आता है जिसने ब्राउज़र से किसी इंटरेस्ट ग्रुप को जोड़ने के लिए कहा था, तो इंटरेस्ट ग्रुप का मालिक navigator.leaveAdInterestGroup() फ़ंक्शन को कॉल कर सकता है. इससे वह ब्राउज़र से इंटरेस्ट ग्रुप को हटाने का अनुरोध कर सकता है.

विज्ञापन का कोड भी, दिलचस्पी वाले ग्रुप के लिए इस फ़ंक्शन को कॉल कर सकता है.

अक्सर पूछे जाने वाले सवाल

किसी एक उपयोगकर्ता के लिए, ग्रुप के हर मालिक के हिसाब से ज़्यादा से ज़्यादा कितने दिलचस्पी वाले ग्रुप बनाए जा सकते हैं?

Chrome, हर मालिक के लिए ज़्यादा से ज़्यादा 1,000 दिलचस्पी वाले ग्रुप और दिलचस्पी वाले ग्रुप के ज़्यादा से ज़्यादा 1,000 मालिकों की अनुमति देता है. इन सीमाओं को सुरक्षा के लिए बनाया गया है. इनका इस्तेमाल सामान्य तौर पर नहीं किया जाना चाहिए.

मैं 𝑘-anon थ्रेशोल्ड को पूरा करने वाले दिलचस्पी वाले ग्रुप के विज्ञापनों को कैसे ज़्यादा से ज़्यादा लोगों तक पहुंचाऊं?

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

रणनीतिक तौर पर, इन बातों पर ध्यान दिया जा सकता है:

• किसी नए विज्ञापन को दिखाना शुरू करने के लिए, उन मामलों में उसके लिए बिडिंग शुरू करें जहां आपको उसे दिखाना है. आपको कुछ और करने की ज़रूरत नहीं है.
• आपके पास फ़ॉलबैक विज्ञापन दिखाने का विकल्प होता है. इसका इस्तेमाल तब किया जाता है, जब नए विज्ञापन 𝑘-एनॉन नहीं होते हैं. इस बात का जोखिम है कि आपका फ़ॉलबैक विज्ञापन, 𝑘-एनॉन न हो. इसलिए, कभी-कभी सिर्फ़ फ़ॉलबैक विज्ञापन के साथ बिडिंग करने पर विचार किया जा सकता है. उदाहरण के लिए, ऐसा 1% समय के लिए करें. इससे यह पक्का किया जा सकेगा कि फ़ॉलबैक, थ्रेशोल्ड से ऊपर बना रहे.

हाल ही में, इस बारे में चर्चा हुई है कि इस सुविधा को कैसे बेहतर बनाया जा सकता है. इसलिए, अगर आपको किसी ऐसे मामले में इस सुविधा का इस्तेमाल करना है जिसमें यह समस्या पैदा कर सकती है, तो एपीआई को बेहतर बनाने के तरीकों के बारे में सार्वजनिक बातचीत में हिस्सा लें.

Protected Audience API के सभी रेफ़रंस

API reference guides are available:

• Developer guide for the Protected Audience API.
• Ad buyer guide to Protected Audience interest groups and bid generation.
• Ad seller guide to Protected Audience ad auctions.
• Guide to reporting auction results
• Best practices for Protected Audience ad auction latency
• Troubleshoot Protected Audience

The Protected Audience API explainer also provides detail about feature support and constraints.