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 (उदाहरण के लिए, DSP से) से कॉल करना होगा. ऐसा तब तक करना होगा, जब तक इंटरेस्ट ग्रुप के मालिक की ऑरिजिन, मौजूदा दस्तावेज़ की ऑरिजिन से मेल न खाती हो (उदाहरण के लिए, अपने इंटरेस्ट ग्रुप वाली कोई वेबसाइट).
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 नहीं होते हैं. इसका एक जोखिम यह है कि आपका फ़ॉलबैक विज्ञापन के-एनॉन न हो, इसलिए कभी-कभी सिर्फ़ फ़ॉलबैक विज्ञापन की मदद से बिडिंग की जा सकती है. उदाहरण के लिए, 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.