Android पर Protected Audience (पहले इसे FLEDGE के नाम से जाना जाता था) को लागू करने के लिए, आम तौर पर विज्ञापन देने वाले ऐप्लिकेशन, पब्लिशर ऐप्लिकेशन, सेलर, और खरीदारों के बीच इंटिग्रेशन की ज़रूरत होती है. यह गाइड उन पार्टनर के लिए है जो कस्टम ऑडियंस मैनेज करना चाहते हैं और नीलामियां चलाना चाहते हैं. इनमें विज्ञापन टेक्नोलॉजी नेटवर्क भी शामिल हैं, जो खरीदार और सेलर, दोनों के तौर पर काम करते हैं. अलग-अलग विज्ञापन कैंपेन के अलग-अलग लक्ष्य हो सकते हैं. साथ ही, सभी इस्तेमाल के उदाहरणों के लिए, सुरक्षित ऑडियंस की सभी सुविधाओं का इस्तेमाल नहीं किया जाता. इस गाइड में, जहां भी हो सके वहां ज़्यादा खास मामलों में मदद करने के लिए ज़रूरी चरणों के बारे में बताया गया है.
पार्टनर, सुरक्षित ऑडियंस को बड़े पैमाने पर प्रोडक्शन में डिप्लॉय करने की तैयारी के लिए, अन्य पक्षों के इंटिग्रेशन पॉइंट की नकल करके टेस्टिंग शुरू कर सकते हैं. इंटिग्रेशन की योजना बनाने में आपकी मदद करने के लिए, इस गाइड में इस बारे में पूरी जानकारी दी गई है कि आपके Android ऐप्लिकेशन में, सुरक्षित ऑडियंस को कैसे इंटिग्रेट किया जा सकता है. इसमें ऐसी सुविधाएं शामिल हो सकती हैं जिन्हें फ़िलहाल, Android डेवलपर प्रीव्यू पर निजता सैंडबॉक्स के मौजूदा चरण में लागू नहीं किया गया है. ऐसे मामलों में, टाइमलाइन से जुड़े दिशा-निर्देश दिए जाते हैं.
सुरक्षित ऑडियंस के इंटिग्रेशन वर्कफ़्लो में चार मुख्य चरण होते हैं. ये चरण, अलग-अलग तरह के विज्ञापन टेक्नोलॉजी पार्टनर के हिसाब से होते हैं:
- खरीदार, कस्टम ऑडियंस बनाता है.
- विज्ञापन चुनने की प्रोसेस, विज्ञापनों में से सबसे अच्छा विज्ञापन चुनती है.
- सेलर का ऐप्लिकेशन, विज्ञापन चुनने की प्रोसेस शुरू करता है.
- विज्ञापन सेवाएं, बाय-साइड फ़िल्टरिंग और बिडिंग कोड को लागू करती हैं.
- विज्ञापन सेवाएं, सेल-साइड डिसीज़न कोड को लागू करती हैं.
- नीलामी में जीतने वाला विज्ञापन, सेलर के ऐप्लिकेशन में रेंडर किया जाता है.
- विज्ञापन इंप्रेशन की रिपोर्ट, खरीदार और सेलर, दोनों के लिए उपलब्ध होती हैं.
इन चरणों को नीचे दिए गए डायग्राम में दिखाया गया है:
शब्दावली
- विज्ञापन देने वाला: ऐसी कंपनी जो विज्ञापन इन्वेंट्री खरीदकर, उपयोगकर्ताओं से जुड़ती है.
- पब्लिशर: ऐसी कंपनी जो अपने कॉन्टेंट के साथ विज्ञापन इन्वेंट्री बेचती है.
- खरीदार: विज्ञापन टेक्नोलॉजी से जुड़ी ऐसी कंपनी जो विज्ञापन देने वालों को विज्ञापन इन्वेंट्री खरीदने में मदद करती है.
- सेलर: विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी, जो पब्लिशर को विज्ञापन इन्वेंट्री बेचने में मदद करती है.
- नेटवर्क: विज्ञापन टेक्नोलॉजी कंपनी, जो खरीदार और सेलर, दोनों के तौर पर काम करती है.
- मालिकाना हक और ऑपरेशन: ऐसी कंपनी जो पब्लिशर, सेलर, और खरीदार के तौर पर काम करती है.
- इंटिग्रेशन पार्टनर: ऐसी कंपनियां जिनके साथ आपको Protected Audience के साथ इंटिग्रेट करने के लिए काम करना है.
ज़रूरी शर्तें, इंटिग्रेशन पार्टनर की भागीदारी, और सेटअप
इस सेक्शन में शुरुआती गतिविधियों के बारे में बताया गया है. इनसे आपको यह समझने में मदद मिलेगी कि सुरक्षित ऑडियंस कैसे काम करती है, सुरक्षित ऑडियंस के इंटिग्रेशन को कैसे शुरू किया जा सकता है, और सुरक्षित ऑडियंस को लागू करने के लिए, इंटिग्रेशन पार्टनर के साथ कैसे जुड़ा जा सकता है. ये गतिविधियां एक साथ हो सकती हैं.
Protected Audience के बारे में जानकारी
पहला कदम, Protected Audience API और सेवाओं के बारे में जानना है.
- Protected Audience API और इसकी सुविधाओं के बारे में जानने के लिए, डिज़ाइन का प्रस्ताव पढ़ें.
- इस्तेमाल के उदाहरणों के लिए ज़रूरी कोड और एपीआई कॉल को शामिल करने का तरीका जानने के लिए, डेवलपर गाइड पढ़ें. साथ ही, Protected Audience के साथ इंटिग्रेट करने के लिए ज़रूरी सेवाओं के बारे में जानें.
- Protected Audience API, सेवाओं, और दस्तावेज़ों के डिज़ाइन और लागू करने के बारे में सुझाव/राय दें या शिकायत करें.
- प्राइवसी सैंडबॉक्स की नई सुविधाओं के बारे में अप-टू-डेट रहने के लिए, अपडेट पाने के लिए साइन अप करें.
सैंपल ऐप्लिकेशन सेट अप करना और उन्हें टेस्ट करना
Protected Audience के बुनियादी सिद्धांतों के बारे में जानने के बाद, आपको सैंपल ऐप्लिकेशन सेट अप करने और उनकी जांच करने की ज़रूरत है.
- इंटिग्रेशन शुरू करने के लिए, Privacy Sandbox के डेवलपर के लिए उपलब्ध झलक के साथ अपना डेवलपमेंट एनवायरमेंट सेट अप करें.
- ज़रूरी सर्वर एंडपॉइंट सेट अप करें. इस प्रोसेस को शुरू करने के लिए, अपने पसंदीदा एपीआई टेस्टिंग सलूशन के साथ सैंपल मॉक का इस्तेमाल करें.
- कस्टम ऑडियंस मैनेजमेंट, विज्ञापन चुनने के वर्कफ़्लो, और इंप्रेशन रिपोर्टिंग के बारे में जानने के लिए, हमारे सैंपल ऐप्लिकेशन में कोड को फ़ॉर्क करें और चलाएं.
इंटिग्रेशन पार्टनर के साथ जुड़ाव
Android पर सुरक्षित ऑडियंस की सुविधा को टेस्ट करने और इस्तेमाल करने के बारे में चर्चा करने के लिए, अपने इंटिग्रेशन पार्टनर के साथ बातचीत शेड्यूल करें. इसमें, दोनों पक्षों के बीच भेजे गए सिग्नल के टाइप के बारे में भी चर्चा की जा सकती है. खरीदारों के लिए, बातचीत में कस्टम ऑडियंस बनाने और उनसे जुड़ने की रणनीतियां शामिल होनी चाहिए. इनमें ऑडियंस तय करने के तरीके के बारे में बातचीत भी शामिल हो सकती है. इंटिग्रेशन के लिए समयसीमा तय करने के लिए, अपने इंटिग्रेशन पार्टनर के साथ मिलकर काम करें. इसमें, शुरुआती टेस्टिंग से लेकर इसे अपनाने तक की समयसीमा तय करना शामिल है. साथ ही, यह भी तय करना कि डिज़ाइन में हर पक्ष की ज़िम्मेदारी किन चीज़ों की है.
बीटा वर्शन सेटअप करना (चौथी तिमाही में उपलब्ध)
अपने संगठन को Android पर Privacy Sandbox में रजिस्टर करें. रजिस्टर करना ज़रूरी है, ताकि यह पक्का किया जा सके कि विज्ञापन टेक्नोलॉजी डेवलपर, निजता सैंडबॉक्स की नीतियों के मुताबिक काम कर रहे हैं. साथ ही, इससे विज्ञापन टेक्नोलॉजी डेवलपर को कई SDK टूल और डोमेन में अपनी पहचान बताने में मदद मिलती है.
आर्किटेक्चर से जुड़ी बातें
Protected Audience की मदद से, खरीदार और सेलर, दोनों के लिए डिवाइस पर विज्ञापन नीलामियां चलाई जा सकती हैं. आपको और आपके इंटिग्रेशन पार्टनर को अपने डिज़ाइन में कई अहम बातों का ध्यान रखना चाहिए:
ऑडियंस और रीमार्केटिंग विज्ञापन, डिवाइस पर सेव किए जाते हैं
फ़िलहाल, विज्ञापनों को पूरी तरह से सर्वर पर सेव किया जाता है. हालांकि, ऑडियंस की जानकारी और रीमार्केटिंग विज्ञापनों को डिवाइस पर सेव किया जाता है. टारगेटिंग के लिए डिवाइस में मौजूद डेटा पर निर्भर न करने वाले कॉन्टेक्स्ट विज्ञापन, सर्वर पर ही रहेंगे. विज्ञापन टेक्नोलॉजी प्लैटफ़ॉर्म को विज्ञापन की मांग को ध्यान में रखते हुए, सर्वर और डिवाइसों के बीच फैलाना होगा.
बिडिंग और नीलामी की प्रोसेस, डिवाइस पर होती है
सर्वर पर नीलामियां चलाने के अलावा, विज्ञापन टेक्नोलॉजी प्लैटफ़ॉर्म के पास अब डिवाइस पर सेव की गई विज्ञापन की मांग की कीमत तय करने और उसे रैंक करने का मौका है.
आम तौर पर, विज्ञापन टेक्नोलॉजी कंपनियां, कॉन्टेक्स्ट के हिसाब से विज्ञापन दिखाने के लिए नीलामी करती हैं, जैसा कि वे आज करती हैं. नीलामी पूरी करने के बाद, सेलर डिवाइस पर नीलामी चलाने का विकल्प चुन सकता है. इससे, डिवाइस पर सेव की गई रीमार्केटिंग डिमांड का आकलन किया जा सकता है. अब ये प्रोसेस डिवाइस पर चलती हैं. इसलिए, मौजूदा सीमाओं को ध्यान में रखना ज़रूरी है. इससे यह पक्का किया जा सकता है कि नीलामी, रीमार्केटिंग के अलग-अलग इस्तेमाल के उदाहरणों में, अलग-अलग इंटिग्रेशन पार्टनर के डिज़ाइन के मुताबिक पूरी तरह से चले.
डेटा स्ट्रैटेजी
विज्ञापन टेक्नोलॉजी प्लैटफ़ॉर्म को नीलामियों में इस्तेमाल किए जाने वाले डेटा टाइप पर विचार करना चाहिए. फ़िलहाल, यह जानकारी अलग-अलग सोर्स से इकट्ठा की जाती है और फिर एक सर्वर पर सेव की जाती है. सुरक्षित ऑडियंस नीलामियों में, उस डेटा को पास करने के लिए कई अलग-अलग पाथ उपलब्ध होते हैं. उदाहरण के लिए: बचे हुए बजट जैसे रीयल-टाइम सिग्नल, भरोसेमंद सिग्नल के तौर पर किसी कीवर्ड-वैल्यू सेवा से मिलते हैं. वहीं, दिन के समय जैसे संदर्भ सिग्नल, नीलामी करते समय सेलर से भेजे जाते हैं. इन सिग्नल के बारे में इस गाइड के काम के सेक्शन में ज़्यादा जानकारी दी गई है.
अपना समाधान बनाएं
सुरक्षित ऑडियंस के साथ नीलामी चलाने के लिए, कई अहम चरण हैं. खरीदारों को ऑडियंस बनानी होगी, बिडिंग डेटा देना होगा, ऑडियंस के लिए विज्ञापन टारगेट करने होंगे, और बिडिंग सेट अप करनी होगी. सेलर को नीलामी को कॉन्फ़िगर और ट्रिगर करना होगा, संभावित विज्ञापनों को स्कोर करना होगा, और विजेता चुनना होगा. इनमें से कुछ चरणों के लिए, दोनों पक्षों के बीच मिलकर काम करना ज़रूरी होता है, ताकि यह पक्का किया जा सके कि नीलामी सही तरीके से पूरी हो. यहां दिए गए सेक्शन में, हर चरण के बारे में पूरी जानकारी दी गई है. साथ ही, यह भी बताया गया है कि नीति लागू करने की ज़िम्मेदारी किसकी है.
खरीदार: ऑडियंस बनाना
आम तौर पर, खरीदार कस्टम ऑडियंस मैनेज करते हैं. कस्टम ऑडियंस को डिवाइस पर मैनेज किया जाता है. इसलिए, कस्टम ऑडियंस को मैनेज करने वाले एपीआई को डिवाइस पर इस्तेमाल करने के लिए डिज़ाइन किया गया है.
अगर विज्ञापन देने वाले के ऐप्लिकेशन में आपका SDK टूल मौजूद है, तो इस कोड को सीधे joinCustomAudience() के ज़रिए लागू किया जा सकता है.
अगर आपके डिवाइसों पर आपका SDK टूल का कोड नहीं है, तो किसी ऐसे मौजूदा इंटिग्रेशन पार्टनर के साथ साझेदारी की जा सकती है जो SDK टूल की सेवा भी देता हो. कस्टम ऑडियंस तय करने और मैनेज करने के लिए, कॉन्ट्रैक्ट और फ़्लो तय करने के लिए, इस पार्टनर की पहचान करें और उसके साथ काम करें. इस गाइड में "खरीदार" शब्द का इस्तेमाल किया गया है. भले ही, किसी भी तरीके का इस्तेमाल किया गया हो. इसके कुछ उदाहरण यहां दिए गए हैं:
- खरीदार के तौर पर, विज्ञापन देने वाले व्यक्ति या कंपनी से ऑडियंस तय कराएं. डिवाइस पर मौजूद इंटिग्रेशन पार्टनर का SDK टूल, खरीदार को ऐप्लिकेशन इवेंट भेज सकता है. पहले से तय शर्तें पूरी होने पर, खरीदार SDK टूल को एक मैसेज भेजता है. इससे, खरीदार की ओर से क्लाइंट पर कस्टम ऑडियंस में शामिल होने की प्रोसेस शुरू होती है.
- SDK टूल के पास ऑडियंस का मालिकाना हक हो सकता है. विज्ञापन देने वाले लोग या कंपनियां, ऑडियंस तय करने के लिए, SDK टूल की सेवा देने वाली कंपनी के साथ काम करती हैं. SDK टूल, ऐप्लिकेशन इवेंट को मॉनिटर करता है और सही समय पर ऑडियंस में शामिल होता है. साथ ही, खरीदार को यह सूचना देता है कि किसी उपयोगकर्ता को ऑडियंस में शामिल किया गया है.
रीमार्केटिंग कैंपेन का प्रोटोटाइप: कस्टम ऑडियंस डिज़ाइन करना
कस्टम ऑडियंस, एक जैसी दिलचस्पी रखने वाले उपयोगकर्ताओं का ग्रुप होता है. इन उपयोगकर्ताओं को उनके काम के विज्ञापन दिखाए जा सकते हैं. उपयोगकर्ता की गतिविधि के आधार पर, विज्ञापन देने वाले लोगों या कंपनियों को अपने ऐप्लिकेशन में कस्टम ऑडियंस बनाने में, खरीदार मदद कर सकते हैं.
Protected Audience, कस्टम ऑडियंस के लिए एक कंटेनर बनाता है. यह कंटेनर, विज्ञापन देने वाले व्यक्ति या कंपनी के तय किए गए किसी खास कस्टम उपयोगकर्ता ऐक्टिविटी से मैप होता है. इसमें, संभावित विज्ञापनों का एक कलेक्शन शामिल होता है, जिन्हें उस ऑडियंस को दिखाया जा सकता है. साथ ही, इसमें कस्टम बिडिंग लॉजिक और डेटा का एक कलेक्शन भी शामिल होता है. इसका इस्तेमाल, नीलामी के दौरान विज्ञापनों को फ़िल्टर करने और उनकी कीमत तय करने के लिए किया जा सकता है.
सेटअप और प्रोटोटाइप
- डिवाइस पर ऑडियंस बनाने और सेव करने के लिए, कस्टम ऑडियंस एपीआई का इस्तेमाल करें. इस ऑडियंस का इस्तेमाल बाद में नीलामी में किया जा सकता है.
- लागू करने और एपीआई के इस्तेमाल से जुड़ी जानकारी के लिए, डेवलपर गाइड देखें.
डिज़ाइन से जुड़ी बातें
कस्टम ऑडियंस कॉन्फ़िगर करके, खरीदार कई तरह के इस्तेमाल के उदाहरणों का इस्तेमाल कर सकते हैं. इसमें, इस ऑडियंस को टारगेट करने वाले विज्ञापन या कैंपेन के टाइप के लिए बिडिंग लॉजिक तय करना, संभावित विज्ञापनों की सूची तय करना, और ऐसी ही अन्य बातें शामिल हैं. इस सेक्शन में, कस्टम ऑडियंस में कुछ मुख्य फ़ील्ड को पॉप्युलेट करने और इस्तेमाल करने के लिए, डिज़ाइन से जुड़ी बातों के बारे में बताया गया है.
बिडिंग लॉजिक का यूआरएल
ऑक्शन डिवाइस पर लागू होती हैं. इसलिए, खरीदारों को ऐसा एंडपॉइंट डिप्लॉय करना होगा जो बिडिंग लॉजिक को JavaScript के तौर पर दिखा सके. डेवलपर गाइड में, ज़रूरी तरीकों के हस्ताक्षरों के बारे में बताया गया है. बिडिंग लॉजिक के पास नीलामी के दौरान, उपयोगकर्ता के बारे में कुछ सिग्नल का ऐक्सेस होता है. इनके बारे में अगले कुछ सेक्शन में बताया गया है. बिडिंग लॉजिक और उपयोगकर्ता सिग्नल सेटअप के बारे में इस लेख में आगे बताया गया है.
उपयोगकर्ता के बिडिंग सिग्नल
खरीदार, UserBiddingSignals का इस्तेमाल करके, डिवाइस पर होने वाली आने वाली नीलामियों में, उपयोगकर्ता के बारे में विज्ञापन देने वाले व्यक्ति या कंपनी या खुद खरीदार के पास मौजूद जानकारी को पास कर सकते हैं. इसमें यह जानकारी शामिल हो सकती है:
- ऐसी अन्य ऑडियंस जिनमें उपयोगकर्ता को जोड़ा गया है.
- उपयोगकर्ता के बारे में विज्ञापन देने वाले के पास मौजूद, पहले पक्ष की अहम जानकारी.
ये सिग्नल ऑक्शन के दौरान उपलब्ध होते हैं. इसलिए, खरीदार ऑक्शन के दौरान कस्टम बिडिंग ऑपरेशन कर सकते हैं. इनमें ये शामिल हैं:
- बिडिंग सिग्नल के आधार पर बिड को बढ़ाया या घटाया जा सकता है.
- नीलामी से कुछ खास विज्ञापनों को फ़िल्टर करें.
भरोसेमंद बिडिंग डेटा
सुरक्षित ऑडियंस की सुविधा लागू करने के तहत, बिडिंग के दौरान खरीदार, कीवर्ड-वैल्यू सेवा से रीयल-टाइम जानकारी ऐक्सेस कर सकते हैं. कुछ समय के लिए, बिडिंग के इन सिग्नल को खरीदार और सेलर, किसी भी सेवा से फ़ेच कर सकते हैं. इनमें वह सेवा भी शामिल है जिसे वे खुद चलाते हैं. इसका सबसे सामान्य उदाहरण, विज्ञापनों के लिए बचे हुए बजट को देखना है. डेवलपमेंट के दौरान, इस सेवा का मॉक बनाया जा सकता है. साथ ही, इस मॉक एंडपॉइंट के हिसाब से डेवलप किया जा सकता है. सेटअप करने के निर्देशों के लिए, GitHub पर हमारे सैंपल ऐप्लिकेशन के डेटा स्टोर करने की जगह में FledgeServerSpec डायरेक्ट्री देखें.
TrustedBiddingData फ़ील्ड में एक यूआरएल और कुंजियों का एक सेट होता है.
किस तरह के कीवर्ड स्ट्रक्चर का इस्तेमाल करना है, यह तय करते समय इन बातों का ध्यान रखें:
- एक आसान तरीका यह है कि आप ऐसी कुंजी शामिल करें जो बनाई जा रही ऑडियंस के साथ 1:1 मैप हो. इसके बाद, की-वैल्यू सेवा में ऑडियंस से जुड़ी सभी काम की जानकारी हो सकती है.
- रीयल-टाइम में बजट और विज्ञापन की स्थिति पर ध्यान देना ज़रूरी है.
- बिड की ज़्यादा से ज़्यादा रकम या अन्य सिग्नल, जिनका इस्तेमाल नीलामी में विज्ञापन की कीमत तय करने के लिए किया जा सकता है. इस जानकारी को विज्ञापन के साथ
AdDataसूची में शामिल किया जा सकता है. हालांकि, इसे की-वैल्यू सेवा में सेव करने पर, ज़रूरत के हिसाब से इसे आसानी से अपडेट किया जा सकता है.
AdData सूची
रीमार्केटिंग कैंपेन बनाते समय, विज्ञापन देने वाले लोग या कंपनियां आम तौर पर ऑडियंस में किसी उपयोगकर्ता को दिखाने के लिए, कई तरह के विज्ञापनों पर विचार करती हैं. जैसे, उपयोगकर्ता के ऐप्लिकेशन के साथ पहले हुए जुड़ाव के आधार पर, अलग-अलग छूट का विज्ञापन दिखाना. कस्टम ऑडियंस में एक AdData सूची शामिल होती है, जिसमें संभावित विज्ञापन होते हैं.
हर विज्ञापन में कितनी जानकारी शामिल करनी है, यह तय करने का अधिकार खरीदारों के पास होता है. कुछ बातों का ध्यान रखें:
AdDataसूची को दो तरीकों से अपडेट किया जा सकता है:- जब ऐप्लिकेशन में फ़ोरग्राउंड में कोई गतिविधि दिख रही हो, तो उपयोगकर्ता को कस्टम ऑडियंस में जोड़ने पर, वह सूची शुरू कर सकता है.
- हर दिन के अपडेट के दौरान, फ़ेच करने की प्रोसेस बैकग्राउंड में शुरू होती है. डिवाइस,
joinCustomAudienceकॉल में शामिलdaily_update_urlको अनुरोध भेजता है. साथ ही, अपडेट की गईAdDataसूची के साथ जवाब मिलने की उम्मीद करता है.
- नीलामी के समय, विज्ञापनों के बारे में ज़्यादा जानकारी का अनुरोध किया जा सकता है. नीलामी से पहले, डिवाइस खरीदारों की उस मुख्य-वैल्यू वाली सेवा के लिए अनुरोध भेजता है जो
joinCustomAudienceकेtrustedBiddingDataफ़ील्ड में दी गई थी. की-वैल्यू सेवा एक नई सेवा है, जो खरीदारों के लिए सुरक्षित ऑडियंस को लागू करने का हिस्सा है. इस सेवा के बारे में ज़्यादा जानकारी, इस दस्तावेज़ में आगे दी गई है. - अपने विज्ञापन के लिए क्रिएटिव आईडी शामिल करने से, आपको कुछ खास क्रिएटिव पर कुछ कार्रवाइयां करने में मदद मिल सकती है. उदाहरण के लिए, विज्ञापन देने वाले कुछ क्रिएटिव को रोक सकते हैं और आपको रीयल-टाइम की-वैल्यू सेवा से उन क्रिएटिव आईडी को खींचकर,
AdDataसूची में मौजूद विज्ञापनों से मैच करना हो.
AdData में render_url शामिल होना चाहिए. विज्ञापन को रेंडर करने के लिए, सबसे अच्छा परफ़ॉर्म करने वाले रीमार्केटिंग विज्ञापन के रेंडर यूआरएल का इस्तेमाल किया जाता है. इन बातों का ध्यान रखें:
- रेंडर यूआरएल में, उपयोगकर्ता की पहचान छिपाने के लिए तय की गई सीमा होती है. इसलिए, इसमें सीमित पैरामीटर शामिल करने से बचें. इस थ्रेशोल्ड के बारे में ज़्यादा जानकारी, बाद में पब्लिश की जाएगी.
- इस यूआरएल में, विज्ञापन को रेंडर करने के लिए ज़रूरी सारी जानकारी होनी चाहिए. उदाहरण के लिए, अगर आपको कुछ खास प्रॉडक्ट दिखाने हैं, तो यूआरएल में प्रॉडक्ट आईडी को पैरामीटर के तौर पर जोड़ें.
प्रोटोटाइप बनाते समय, सिर्फ़ renderUri फ़ील्ड की ज़रूरत होती है. यह विज्ञापन की रेंडरिंग एसेट पर ले जाता है. समाधान बनाते समय, AdData में मौजूद मेटाडेटा फ़ील्ड को अनदेखा किया जा सकता है. अपने समाधान को प्रोडक्शन में ले जाते समय, आपको यह तय करना चाहिए कि आपके लिए कौनसा मेटाडेटा काम का है. इसका इस्तेमाल बिड जनरेशन के दौरान, बिड की कीमत में बदलाव करने के लिए किया जा सकता है.
चालू होने का समय और खत्म होने का समय
चालू होने और खत्म होने के समय वाले फ़ील्ड का इस्तेमाल, उन इस्तेमाल के उदाहरणों के लिए किया जा सकता है जहां किसी कस्टम ऑडियंस को सिर्फ़ तय समय के अंदर नीलामियों के लिए मंज़ूरी मिलनी चाहिए. ध्यान रखें कि ऐक्टिवेशन के समय में कितनी देरी की जा सकती है और ऐक्टिवेशन और खत्म होने के समय के बीच का अंतर कितना हो सकता है, इस पर कुछ सीमाएं हैं. इस्तेमाल के उदाहरणों में ये शामिल हैं:
- पुराना उपयोगकर्ता (उदाहरण के लिए, ऐसा उपयोगकर्ता जिसने पिछले सात दिनों में विज्ञापन देने वाले के ऐप्लिकेशन का इस्तेमाल नहीं किया है)
- जब भी उपयोगकर्ता ऐप्लिकेशन खोलता है, तो खरीदार
joinCustomAudienceको कॉल कर सकता है औरactivation_timeको, आने वाले सात दिनों के टाइमस्टैंप के तौर पर कॉन्फ़िगर कर सकता है. - अगर उपयोगकर्ता ने आखिरी बार ऐप्लिकेशन को खोलने के सात दिन बाद फिर से खोला है, तो ऑडियंस बिडिंग के लिए ज़रूरी शर्तें पूरी करती है.
- जब भी उपयोगकर्ता ऐप्लिकेशन खोलता है, तो खरीदार
- सीज़न के हिसाब से ऑडियंस (ऐसी ऑडियंस जो आने वाले समय में किसी तय समयसीमा के दौरान ही मान्य होती है)
- खरीदार, पहले से ही ऐसी कस्टम ऑडियंस तय कर सकता है जो आने वाले समय में तय किए गए समय के दौरान ही बिडिंग के लिए ज़रूरी शर्तें पूरी करती हों.
- उदाहरण के लिए, अगर विज्ञापन देने वाले का साल 2022 में अमेरिका में, गर्मी के आखिर में चलने वाला कैंपेन है, तो उसका खरीदार
joinCustomAudienceको कॉल करके,activation_timeको शनिवार, 20 अगस्त, 2022 के तौर पर कॉन्फ़िगर कर सकता है. अगर कैंपेन सिर्फ़ एक हफ़्ते के लिए चलता है, तो खरीदार खत्म होने की तारीख को 27 अगस्त, 2022 पर सेट कर सकता है. इसके बाद, विज्ञापन चुनने के दौरान प्लैटफ़ॉर्म, कस्टम ऑडियंस को फ़िल्टर कर देता है और आखिर में ग़ैर-ज़रूरी डेटा इकट्ठा कर लेता है.
खरीदार और सेलर: विज्ञापन चुनना
विज्ञापन चुनने के लिए, खरीदारों और सेलर के बीच सहयोग की ज़रूरत होती है. इसे चार चरणों में बांटा जा सकता है:
- सेलर, मीडिएशन की रणनीति तय करते हैं.
- सेलर, नीलामी को कॉन्फ़िगर करते हैं और विज्ञापन चुनने की प्रोसेस शुरू करते हैं.
- सेलर के तय किए गए कॉन्फ़िगरेशन के ज़रिए, खरीदारों को नीलामी में हिस्सा लेने का न्योता दिया जाता है. बिडिंग के लिए खरीदार का लॉजिक लागू किया जाता है, ताकि किसी संभावित विज्ञापन और बिड को चुना जा सके.
- विज्ञापनों को स्कोर देने और विजेता विज्ञापन चुनने के लिए, सेलर का फ़ैसला लेने का लॉजिक लागू किया जाता है.
डेवलपमेंट को आसान बनाने के लिए, खरीदारों और बिचौलियों के लिए सेवा के जवाबों को मॉक किया जा सकता है. इसमें बिडिंग और स्कोरिंग लॉजिक शामिल है. इससे आपको अपने इस्तेमाल के उदाहरण के हिसाब से, काम की चीज़ें डेवलप करने पर फ़ोकस करने में मदद मिलती है. मॉक एंडपॉइंट सेट अप करने के निर्देशों के लिए, GitHub पर FledgeServerSpec डायरेक्ट्री देखें. इसके अलावा, रिमोट JavaScript फ़ेचिंग की ज़रूरत को बदलने के तरीके के लिए, डेवलपर गाइड देखें.
सेलर: मीडिएशन की रणनीति तय करना
Protected Audience का मकसद, वॉटरफ़ॉल मीडिएशन की सुविधा को बेहतर बनाना है. इस सुविधा पर काम जारी है. उपलब्ध होने पर, इस बारे में ज़्यादा जानकारी दी जाएगी. फ़िलहाल, सुरक्षित ऑडियंस में वॉटरफ़ॉल मीडिएशन के लिए, डिज़ाइन का प्रस्ताव देखें.
सेलर: नीलामी को कॉन्फ़िगर करना
नीलामी को कॉन्फ़िगर करने और विज्ञापन चुनने की प्रोसेस के लिए जानकारी देने की ज़िम्मेदारी, सेलर की होती है. सेलर यह चुन सकते हैं कि जानकारी सभी या सिर्फ़ चुनिंदा पक्षों के लिए उपलब्ध कराई जाए. इसमें ऐसी जानकारी शामिल हो सकती है जो आपके पास है या खरीदारों की ओर से शामिल की गई जानकारी.
सेटअप और प्रोटोटाइप
- सेलर,
AdSelectionएपीआई का इस्तेमाल करके,AdSelectionConfigऑब्जेक्ट सेट अप करके नीलामी को कॉन्फ़िगर और शुरू कर सकता है.selectAds()को ट्रिगर करके नीलामी को ट्रिगर करें. - लागू करने और एपीआई के इस्तेमाल से जुड़ी जानकारी के लिए, डेवलपर गाइड देखें.
डिज़ाइन से जुड़ी बातें
इस सेक्शन में, विज्ञापन चुनने के कॉन्फ़िगरेशन में मुख्य फ़ील्ड को पॉप्युलेट करने और इस्तेमाल करने के लिए, डिज़ाइन से जुड़ी बातें शामिल हैं.
- निजी तौर पर विज्ञापन दिखाने के लिए, डिवाइस पर सिर्फ़ कस्टम ऑडियंस के विज्ञापन दिखाए जाते हैं. इसलिए, पहले से ही संदर्भ के हिसाब से विज्ञापन दिखाने का अनुरोध करने से, आपको अतिरिक्त मांग पर विचार करने में मदद मिलती है.
विज्ञापन चुनने का वर्कफ़्लो शुरू करने से पहले, खरीदारों से जानकारी इकट्ठा करने के लिए विज्ञापन अनुरोध चलाएं. इसके बाद, विज्ञापन चुनने की सुविधा को कॉन्फ़िगर करने के लिए, इस जानकारी का इस्तेमाल करें.
कई खरीदारों ने डिवाइस पर कस्टम ऑडियंस बनाई हो सकती है. इसलिए, सेलर को कस्टम ऑडियंस के खरीदार फ़ील्ड का इस्तेमाल करके, उन खरीदारों के बारे में बताना होगा जिन्हें इस प्रोसेस में शामिल करना है. इस सूची को कई तरीकों से बनाया जा सकता है. कुछ उदाहरण ये हैं:
- खरीदारों की ऐसी स्टैटिक सूची जिसे सेलर हमेशा प्रोसेस में शामिल करना चाहता है.
- उन खरीदारों की सूची जो विज्ञापन के जवाब में हिस्सा लेना चाहते हैं. यह विकल्प तब काम का होता है, जब सेलर विज्ञापन एक्सचेंज के साथ काम करता है और हो सकता है कि उसके पास सभी खरीदारों के बारे में पूरी जानकारी न हो.
सेलर, इस प्रोसेस में कई तरीकों से जानकारी दे सकता है:
- विज्ञापन चुनने के सिग्नल फ़ील्ड, निजी रनटाइम में नीलामी में हिस्सा लेने वाले सभी खरीदारों और सेलर के लिए उपलब्ध है. इसका इस्तेमाल, विज्ञापन के अवसर के बारे में जानकारी देने के लिए करें. जैसे, विज्ञापन का साइज़ और विज्ञापन का फ़ॉर्मैट.
- हर खरीदार के सिग्नल फ़ील्ड को किसी खास खरीदार को भेजा जाता है, ताकि बिडिंग की प्रोसेस में उसका इस्तेमाल किया जा सके. यह जानकारी खरीदार से मिलती है. विज्ञापन चुनने के दौरान इस्तेमाल करने के लिए, आपको सेलर के तौर पर यह तय करना होगा कि डिवाइस पर यह जानकारी कैसे हासिल की जाए.
- सेलर सिग्नल फ़ील्ड, सेलर के पास प्रोसेस में जानकारी देने का आखिरी तरीका है. विज्ञापनों को स्कोर करने और उन्हें फ़िल्टर करने के दौरान, सेलर के तौर पर इन सिग्नल का इस्तेमाल किया जाता है. जैसे, ब्रैंड सेफ़्टी जांच को चालू करना.
खरीदार: विज्ञापन स्लॉट के लिए बिडिंग करना
सेटअप और प्रोटोटाइप
- कोई खरीदार,
CustomAudienceबनाते समयbiddingLogicUrlपैरामीटर सेट से दिखाए गएgenerateBid()JavaScript फ़ंक्शन में अपना बिडिंग लॉजिक जोड़ सकता है. दी गई जानकारी का इस्तेमाल करके, मॉक सेवा सेट अप की जा सकती है या इस एंडपॉइंट को किसी असली सर्वर पर लागू किया जा सकता है. - लागू करने और एपीआई के इस्तेमाल से जुड़ी जानकारी के लिए, डेवलपर गाइड देखें.
डिज़ाइन से जुड़ी बातें
- बिडिंग लॉजिक, डिवाइस पर लागू होता है. साथ ही, नीलामी में इस्तेमाल किए गए कुछ सिग्नल के लिए रीयल टाइम में क्वेरी की जाती है. पाबंदियों के बारे में जानने के लिए, पाबंदियों की सूची देखें.
- विज्ञापन के कुछ इस्तेमाल के उदाहरणों के लिए, यह पक्का करने के लिए सेलर के साथ काम करना ज़रूरी है कि आपके पास डिवाइस पर दिखाए जाने के लिए, एक से ज़्यादा विज्ञापन और उनकी बिड हों.
बिडिंग लॉजिक डिज़ाइन करना
खरीदारों के बिडिंग लॉजिक को JavaScript के ज़रिए लागू करना होगा और इसे डिवाइस पर लागू किया जाएगा. डेवलपर गाइड में, ज़रूरी हस्ताक्षर के बारे में जानकारी दी गई है. साथ ही, नीलामी के दौरान इस्तेमाल किए गए अलग-अलग पैरामीटर के बारे में भी जानकारी दी गई है. डिवाइस पर बिडिंग लॉजिक के पास अतिरिक्त जानकारी का ऐक्सेस होता है. यह जानकारी, आपके generateBid() फ़ंक्शन में पैरामीटर के तौर पर भेजी जाती है.
बिडिंग डेटा की जानकारी देना
कुंजी-वैल्यू सेवाओं के साथ रीयल-टाइम बिडिंग सिग्नल
खरीदार के तौर पर, आपके पास नीलामी के दौरान अपनी मालिकाना हक वाली किसी कीवर्ड-वैल्यू सेवा से रीयल टाइम सिग्नल फ़ेच करने का विकल्प होता है. इस सेवा को लागू करने का शुरुआती तरीका, सार्वजनिक Privacy Sandbox रिपॉज़िटरी में देखा जा सकता है. इसके अलावा, अपनी सेवा भी बनाई जा सकती है. इस सेवा का यूआरएल, कस्टम ऑडियंस में trustedBiddingUrl के तौर पर तय किया गया है. साथ ही, प्लैटफ़ॉर्म डेटा को फ़ेच करने की कोशिश करता है और उसे trusted_bidding_signals
parameter की मदद से आपके generateBid फ़ंक्शन के लिए उपलब्ध कराता है. आपको अपना कुंजी स्ट्रक्चर सेट करना होगा.
कॉन्टेक्स्ट और उपयोगकर्ता सिग्नल
डिवाइस पर नीलामी चलाते समय, आपके generateBid फ़ंक्शन के पास उपयोगकर्ता के अन्य सिग्नल का ऐक्सेस होता है. ये सिग्नल, contextual_signals और per_buyer_signals फ़ील्ड के साथ पास किए जाते हैं. ये सभी फ़ील्ड JSON ऑब्जेक्ट हैं. खरीदारों और सेलर को इनका फ़ॉर्मैट तय करना होगा.
contextual_signals फ़ील्ड में ऐसी जानकारी शामिल होती है जो उपयोगकर्ता के लिए काम की हो सकती है. इन सिग्नल को होल्ड करने वाला ऑब्जेक्ट, Protected Audience खुद बनाता है और इसे आपकी बिडिंग लॉजिक को पास करता है. फ़िलहाल, इसे खाली ऑब्जेक्ट के तौर पर पास किया जाता है. अगर आपको लगता है कि उपयोगकर्ता के बारे में संदर्भ के हिसाब से मिलने वाला सिग्नल, आपके इस्तेमाल के उदाहरण के लिए काम का हो सकता है, तो इस बारे में सुझाव/राय दें या शिकायत करें.
per_buyer_signals फ़ील्ड को आपके बिडिंग लॉजिक के लिए उपलब्ध कराया जाता है. सेलर, नीलामी कॉन्फ़िगरेशन बनाते समय ये वैल्यू सेट करता है. खरीदारों और सेलर को मिलकर यह पक्का करना होगा कि यह डेटा डिवाइस पर मौजूद हो और बिडिंग लॉजिक को भेजा गया हो. इस फ़ील्ड के इस्तेमाल के कुछ उदाहरण यहां दिए गए हैं:
- ब्रैंड की सुरक्षा के लिए फ़िल्टर करना. सेलर, खरीदारों को विज्ञापन का अनुरोध करने वाले ऐप्लिकेशन के बारे में, कैटगरी से जुड़ी कुछ जानकारी दे सकता है. खरीदार इस जानकारी का इस्तेमाल करके, कुछ विज्ञापनों को फ़िल्टर कर सकता है.
- ऐसे एमएल मॉडल के लिए एम्बेड भेजना जो संदर्भ के हिसाब से जानकारी का इस्तेमाल करता है.
सेलर: विज्ञापन को स्कोर करना और सबसे अच्छा विज्ञापन चुनना
सेटअप और प्रोटोटाइप
- कोई सेलर,
AdSelectionConfigबनाते समयscoringLogicUrlपैरामीटर सेट से दिखाए गएscoreAd()JavaScript फ़ंक्शन में, स्कोरिंग लॉजिक जोड़ सकता है. दी गई जानकारी का इस्तेमाल करके, मॉक सेवा सेट अप की जा सकती है या इस एंडपॉइंट को किसी असली सर्वर पर लागू किया जा सकता है. - लागू करने और एपीआई के इस्तेमाल से जुड़ी जानकारी के लिए, डेवलपर गाइड देखें.
स्कोरिंग लॉजिक डिज़ाइन करना
सेलर, JavaScript में स्कोरिंग लॉजिक लागू करते हैं. इसे डिवाइस पर लागू किया जाता है. डेवलपर गाइड में, ज़रूरी हस्ताक्षर के बारे में जानकारी दी गई है. साथ ही, इसमें नीलामी के दौरान इस्तेमाल किए गए अलग-अलग पैरामीटर के बारे में भी जानकारी दी गई है. इसके अलावा, डिवाइस पर स्कोरिंग लॉजिक के पास, scoreAd फ़ंक्शन के पैरामीटर के तौर पर पास की गई अतिरिक्त जानकारी का ऐक्सेस होता है.
स्कोरिंग डेटा की सप्लाई करना
कुंजी-वैल्यू सेवाओं की मदद से, रीयल-टाइम स्कोरिंग सिग्नल
सेलर के तौर पर, आपके पास नीलामी के दौरान, अपनी मालिकाना हक वाली किसी कीवर्ड-वैल्यू सेवा से रीयल टाइम सिग्नल फ़ेच करने का विकल्प होता है. इस सेवा को शुरू में लागू करने के बारे में जानकारी, सार्वजनिक Privacy Sandbox रिपॉज़िटरी में देखी जा सकती है. इस सेवा का यूआरएल, नीलामी कॉन्फ़िगरेशन में trustedScoringUri के तौर पर तय किया गया है. साथ ही, प्लैटफ़ॉर्म डेटा को फ़ेच करने की कोशिश करता है और trusted_scoring_signals पैरामीटर की मदद से, उसे आपके scoreAd फ़ंक्शन के लिए उपलब्ध कराता है. आपको अपनी कुंजी का स्ट्रक्चर तय करना चाहिए.
कॉन्टेक्स्ट और उपयोगकर्ता सिग्नल
डिवाइस पर नीलामी चलाते समय, आपके scoreAd फ़ंक्शन के पास उपयोगकर्ता के अन्य सिग्नल का ऐक्सेस होता है. ये सिग्नल, contextual_signal फ़ील्ड के ज़रिए आपके स्कोरिंग फ़ंक्शन को भेजे जाते हैं. इस फ़ील्ड में JSON ऑब्जेक्ट होते हैं. इनका फ़ॉर्मैट, खरीदार और सेलर तय करते हैं.
contextual_signal फ़ील्ड में, संदर्भ के हिसाब से ऐसी जानकारी शामिल होती है जो उपयोगकर्ता के लिए काम की हो सकती है. इन सिग्नल को होल्ड करने वाला ऑब्जेक्ट, सुरक्षित ऑडियंस खुद बनाती है और इसे आपके स्कोरिंग लॉजिक में भेजती है. इसे खाली ऑब्जेक्ट के तौर पर पास किया जाता है. अगर आपको लगता है कि उपयोगकर्ता के बारे में कोई सिग्नल, आपके इस्तेमाल के उदाहरण के हिसाब से हो सकता है, तो इस पर विचार करने के लिए सुझाव, राय या शिकायत सबमिट करें.
सेलर: विज्ञापन रेंडर करना
सेलर को विज्ञापन दिखाने के लिए, विज्ञापन को रेंडर करना होगा. विजेता विज्ञापनों को रेंडर करने के तरीके के बारे में ज़्यादा जानकारी के लिए, डिज़ाइन के प्रस्ताव को देखें. इस सेक्शन को अभी डिज़ाइन किया जा रहा है.
इंप्रेशन के नतीजों की रिपोर्ट
सेटअप और प्रोटोटाइप
- खरीदार और सेलर,
reportWin()JavaScript फ़ंक्शन में रिपोर्टिंग लॉजिक जोड़ सकते हैं. यह फ़ंक्शन,biddingLogicUrlयाscoringLogicUrlपैरामीटर से दिखाया जाता है. दी गई जानकारी का इस्तेमाल करके, मॉक सेवा सेट अप की जा सकती है या इस एंडपॉइंट को किसी असली सर्वर पर लागू किया जा सकता है. - लागू करने और एपीआई के इस्तेमाल से जुड़ी जानकारी के लिए, डेवलपर गाइड देखें.
डिज़ाइन से जुड़ी बातें
खरीदारों और सेलर को अपने कॉन्फ़िगर किए गए एंडपॉइंट से मिले JavaScript कोड में reportWin फ़ंक्शन लागू करना होगा. इस तरीके से, डेटा को अपने सर्वर पर वापस भेजा जा सकता है.
Privacy Sandbox, इवेंट लेवल और एग्रीगेट रिपोर्ट को मैनेज करने के लिए, Attribution Reporting API भी उपलब्ध कराता है. ज़्यादा जानकारी के लिए, इंटिग्रेशन गाइड पढ़ें.
फ़िलहाल कोई सुझाव नहीं है.
अपने Google खाते में साइन इन करने की कोशिश करें.