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 kiB से ज़्यादा नहीं होना चाहिए. ऐसा न होने पर, कॉल कनेक्ट नहीं हो पाएगा. दूसरा पैरामीटर एक इंटरेस्ट ग्रुप की अवधि के बारे में बताता है. इसे ज़्यादा से ज़्यादा 30 दिन के लिए सेट किया जा सकता है. क्रम के मुताबिक किए गए कॉल, पहले से सेव की गई वैल्यू को ओवरराइट कर देते हैं.
ज़रूरी प्रॉपर्टी
इंटरेस्ट ग्रुप के लिए, सिर्फ़ owner
और name
प्रॉपर्टी ज़रूरी हैं:
प्रॉपर्टी | उदाहरण | भूमिका |
---|---|---|
owner |
https://dsp.example |
इंटरेस्ट ग्रुप के मालिक का ऑरिजिन. |
name |
custom-bikes |
इंटरेस्ट ग्रुप का नाम. |
वैकल्पिक प्रॉपर्टी
बाकी प्रॉपर्टी ज़रूरी नहीं हैं:
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
2- उदाहरण:
https://dsp.example/bid/custom-bikes/update
- भूमिका: वह यूआरएल जो एक जैसी दिलचस्पी वाले ग्रुप के एट्रिब्यूट को अपडेट करने के लिए JSON दिखाता है. (ऑडियंस डेटा अपडेट करें और विज्ञापन रीफ़्रेश करें देखें.)
trustedBiddingSignalsUrl
2- उदाहरण:
https://dsp.example/trusted/bidding-signals
- भूमिका: बिड करने वाले की भरोसेमंद कुंजी/वैल्यू सेवा के की-वैल्यू अनुरोधों के लिए बेस यूआरएल.
trustedBiddingSignalsKeys
- उदाहरण:
['key1', 'key2' ...]
- भूमिका: की-वैल्यू वाली भरोसेमंद कुंजी/वैल्यू सेवा के अनुरोधों के लिए कुंजियां.
userBiddingSignals
- उदाहरण:
{...}
- भूमिका: अतिरिक्त मेटाडेटा, जिसका इस्तेमाल मालिक बिडिंग के दौरान कर सकता है.
ads
1- उदाहरण:
[bikeAd1, bikeAd2, bikeAd3]
- भूमिका: इस इंटरेस्ट ग्रुप के लिए बनाए जाने वाले विज्ञापन.
adComponents
- उदाहरण:
[customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2]
- भूमिका: कई हिस्सों से बने विज्ञापनों के लिए कॉम्पोनेंट.
1 biddingLogicUrl
और ads
प्रॉपर्टी ज़रूरी नहीं हैं, लेकिन नीलामी में हिस्सा लेने के लिए ये ज़रूरी हैं. इन प्रॉपर्टी के बिना कोई इंटरेस्ट ग्रुप बनाने के लिए इस्तेमाल के उदाहरण हो सकते हैं: उदाहरण के लिए, हो सकता है कि कोई इंटरेस्ट ग्रुप का मालिक किसी ऐसे कैंपेन के लिए इंटरेस्ट ग्रुप में ब्राउज़र जोड़ना चाहे जो अभी नहीं चल रहा है या आने वाले समय में उसका इस्तेमाल किया जा रहा है. ऐसा भी हो सकता है कि कुछ समय के लिए उसका विज्ञापन बजट खत्म हो गया हो.
2 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 मालिक जोड़े जा सकते हैं. ये सीमाएं गार्ड रेल की तरह हैं, किसी भी नियमित कार्रवाई में लागू नहीं होनी चाहिए.
मैं k-anon थ्रेशोल्ड को पूरा करने वाले इंटरेस्ट ग्रुप के विज्ञापनों को ज़्यादा से ज़्यादा कैसे बढ़ाऊं?
सार्वजनिक जानकारी के मुताबिक, एक ही इंटरेस्ट ग्रुप में, ऐसे कई विज्ञापन हो सकते हैं जिन्हें वह दिखाया जा सकता है. इसलिए, उस ग्रुप को अपने सबसे पसंदीदा विज्ञापन ग्रुप के लिए तय की गई सीमा से नीचे होने पर, अपने किसी अन्य विज्ञापन के लिए "फ़ॉलबैक विज्ञापन" के तौर पर बिडिंग करने का मौका मिलेगा. इसका मतलब है कि अगर कोई छोटा और खास विज्ञापन, जो k-ऐनिमिटी के थ्रेशोल्ड से कम है अब भी नीलामी में हिस्सा ले सकता है. इसके इंटरेस्ट ग्रुप के पास तब तक सामान्य विज्ञापन दिखाने का विकल्प होता है, जब तक कि उस विज्ञापन ग्रुप के लिए, ऑडियंस की संख्या ज़रूरत के मुताबिक नहीं हो जाती.
तकनीकी नज़रिए से, इन बातों पर ध्यान दिया जा सकता है:
- नया विज्ञापन दिखाना शुरू करने के लिए, उन मामलों में बस इसके साथ बिडिंग शुरू करें जहां आपको इसे दिखाना है. आपको कुछ और करने की ज़रूरत नहीं है.
- आपके पास फ़ॉलबैक विज्ञापन इस्तेमाल करने का विकल्प है, जिसका इस्तेमाल नए विज्ञापनों के लोकप्रिय न होने की स्थिति में किया जाता है. आपके फ़ॉलबैक विज्ञापन के 'k-anon' न होने का कुछ जोखिम होता है. इसलिए, आपको कभी-कभी सिर्फ़ फ़ॉलबैक विज्ञापन के लिए बिडिंग करने के बारे में सोचना चाहिए. उदाहरण के लिए, कई बार ऐसा 1% बार किया जा सकता है. उदाहरण के लिए, ऐसा तब करें, जब यह पक्का करने के लिए एक अच्छा लेवल है कि आपको फ़ॉलबैक के थ्रेशोल्ड से ज़्यादा रहने की उम्मीद है.
हाल में ही इस बात पर चर्चा हुई है कि अन्य तरीकों से क्या किया जा सकता है. इसलिए, अगर आपके पास इस्तेमाल का कोई ऐसा उदाहरण है जिसमें इस तरीके से समस्या पैदा हो सकती है, तो एपीआई को बेहतर बनाने के तरीकों के बारे में सार्वजनिक बातचीत में शामिल हों.
Protected Audience API के सभी रेफ़रंस
एपीआई रेफ़रंस गाइड उपलब्ध हैं:
- Protected Audience API के लिए डेवलपर गाइड.
- सुरक्षित ऑडियंस इंटरेस्ट ग्रुप और बिड जनरेट करने के बारे में विज्ञापन खरीदार के लिए गाइड.
- सुरक्षित ऑडियंस के बारे में विज्ञापन सेलर गाइड विज्ञापन नीलामी.
- नीलामी के नतीजों की रिपोर्ट करने के लिए गाइड
- सुरक्षित ऑडियंस के लिए सबसे सही तरीके विज्ञापन नीलामी में लगने वाले समय
- सुरक्षित ऑडियंस से जुड़ी समस्या हल करना
Protected Audience API के बारे में जानकारी देने वाला टूल , सुविधाओं के इस्तेमाल और पाबंदियों के बारे में भी जानकारी देता है.