Protected Audience: इंटिग्रेशन गाइड

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

Protected Audience को बड़े पैमाने पर प्रोडक्शन में डिप्लॉय करने की तैयारी के लिए, पार्टनर अन्य पार्टियों के साथ इंटिग्रेशन पॉइंट का मज़ाक बनाकर टेस्टिंग शुरू कर सकते हैं. इंटिग्रेशन की योजना बनाने में आपकी मदद करने के लिए, इस गाइड में यह बताया गया है कि Android ऐप्लिकेशन के साथ Protected Audience को कैसे इंटिग्रेट किया जाए. इसमें ऐसी सुविधाएं शामिल हो सकती हैं जिन्हें Android डेवलपर प्रीव्यू पर Privacy Sandbox के मौजूदा चरण में अब तक लागू नहीं किया गया है. ऐसे मामलों में, समयसीमा के बारे में जानकारी दी जाती है.

Protected Audience इंटिग्रेशन के वर्कफ़्लो में चार मुख्य चरण होते हैं. ये चरण, विज्ञापन टेक्नोलॉजी की सेवा देने वाली अलग-अलग कंपनियों के ज़रिए पूरे किए जाते हैं:

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

इस डायग्राम में इन चरणों को दिखाया गया है:

Protected Audience की कस्टम ऑडियंस को मैनेज करने और विज्ञापन चुनने का वर्कफ़्लो.
Protected Audience की कस्टम ऑडियंस को मैनेज करने और विज्ञापन चुनने का वर्कफ़्लो.

शब्दावली

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

ज़रूरी शर्तें, इंटिग्रेशन पार्टनर के साथ जुड़ना, और सेटअप करना

इस सेक्शन में, कुछ शुरुआती गतिविधियों के बारे में बताया गया है. इससे आपको यह समझने में मदद मिलेगी कि Protected Audience कैसे काम करता है, Protected Audience इंटिग्रेशन का इस्तेमाल कैसे शुरू करें, और Protected Audience को लागू करने के लिए अपने इंटिग्रेशन पार्टनर के साथ कैसे जुड़ें. ये गतिविधियां एक साथ हो सकती हैं.

Protected Audience की सुविधाओं को रोल आउट करने से जुड़ी गाइड दिखाने वाला डायग्राम.
Protected Audience की सुविधाओं को रोल आउट करने के लिए गाइड.

Protected Audience के बारे में जानकारी

पहला चरण यह है कि आप Protected Audience API और सेवाओं के बारे में जानें.

  1. Protected Audience API और इसकी क्षमताओं के बारे में जानने के लिए, सबसे पहले डिज़ाइन प्रपोज़ल पढ़ें.
  2. डेवलपर गाइड पढ़ें. इसमें, अपने इस्तेमाल के उदाहरणों के लिए ज़रूरी कोड और एपीआई कॉल को शामिल करने का तरीका बताया गया है. साथ ही, Protected Audience के साथ इंटिग्रेट करने के लिए ज़रूरी सेवाओं के बारे में भी बताया गया है.
  3. Protected Audience API, सेवाओं, और दस्तावेज़ों के डिज़ाइन और उन्हें लागू करने के बारे में सुझाव/राय दें या शिकायत करें.
  4. Privacy Sandbox की नई सुविधाओं के बारे में अप-टू-डेट रहने के लिए, अपडेट पाने के लिए साइन अप करें.

सैंपल ऐप्लिकेशन सेट अप करना और उन्हें टेस्ट करना

Protected Audience के बारे में बुनियादी जानकारी पाने के बाद, आपको सैंपल ऐप्लिकेशन सेट अप करके उनकी जांच करनी चाहिए.

  1. जब आप इंटिग्रेशन शुरू करने के लिए तैयार हों, तब Privacy Sandbox Developer Preview के नए वर्शन के साथ अपना डेवलपमेंट एनवायरमेंट सेट अप करें.
  2. ज़रूरी सर्वर एंडपॉइंट सेट अप करें. इस प्रोसेस को बूटस्ट्रैप करने के लिए, एपीआई टेस्टिंग के अपने पसंदीदा सलूशन के साथ सैंपल मॉक का इस्तेमाल करें.
  3. कस्टम ऑडियंस मैनेजमेंट, विज्ञापन चुनने के वर्कफ़्लो, और इंप्रेशन रिपोर्टिंग के बारे में जानने के लिए, हमारे सैंपल ऐप्लिकेशन में कोड को फ़ोर्क करें और चलाएं.

इंटिग्रेशन पार्टनर से जुड़ाव

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

बीटा वर्शन का सेटअप (चौथी तिमाही में उपलब्ध होगा)

Android पर Privacy Sandbox के लिए, अपने संगठन को रजिस्टर करें. रजिस्ट्रेशन करना ज़रूरी है, ताकि विज्ञापन टेक्नोलॉजी डेवलपर, Privacy Sandbox की नीतियों के मुताबिक काम कर सकें. इससे विज्ञापन टेक्नोलॉजी डेवलपर को, कई एसडीके और डोमेन पर अपनी पहचान तय करने की अनुमति मिलती है.

आर्किटेक्चर से जुड़ी बातें

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

ऑडियंस और रीमार्केटिंग विज्ञापनों से जुड़ी जानकारी डिवाइस पर सेव की जाती है

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

बिडिंग और नीलामी की प्रोसेस, डिवाइस पर होती है

सर्वर पर नीलामी करने के साथ-साथ, विज्ञापन टेक्नोलॉजी प्लैटफ़ॉर्म के पास अब डिवाइस पर सेव की गई विज्ञापन की मांग को रैंक करने और उसकी कीमत तय करने का विकल्प भी है.

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

डेटा से जुड़ी रणनीति

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

अपना समाधान तैयार करना

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

खरीदार: ऑडियंस बनाना

आम तौर पर, खरीदार कस्टम ऑडियंस को मैनेज करते हैं. कस्टम ऑडियंस को डिवाइस पर मैनेज किया जाता है. इसलिए, कस्टम ऑडियंस को मैनेज करने वाले एपीआई को डिवाइस पर इस्तेमाल करने के लिए डिज़ाइन किया गया है.

अगर विज्ञापन देने वाले व्यक्ति या कंपनी के ऐप्लिकेशन में आपका एसडीके मौजूद है, तो joinCustomAudience() का इस्तेमाल करके इस कोड को सीधे तौर पर लागू किया जा सकता है.

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

  • खरीदार के तौर पर, विज्ञापन देने वाले व्यक्ति या कंपनी से ऑडियंस तय करने के लिए कहें. डिवाइस पर मौजूद इंटिग्रेशन पार्टनर का SDK टूल, खरीदार को ऐप्लिकेशन इवेंट भेज सकता है. पहले से तय की गई शर्तों को पूरा करने पर, खरीदार एसडीके को मैसेज भेजता है. इससे एसडीके, खरीदार की ओर से क्लाइंट पर कस्टम ऑडियंस में शामिल हो जाता है.
  • एसडीके, सीधे तौर पर ऑडियंस का मालिकाना हक रख सकता है. विज्ञापन देने वाले लोग या कंपनियां, ऑडियंस तय करने के लिए एसडीके की सेवा देने वाली कंपनी के साथ काम करती हैं. SDK, ऐप्लिकेशन के इवेंट को मॉनिटर करता है और सही समय पर ऑडियंस में शामिल होता है. साथ ही, खरीदार को सूचना देता है कि किसी उपयोगकर्ता को ऑडियंस में शामिल कर लिया गया है.

रीमार्केटिंग कैंपेन का प्रोटोटाइप: कस्टम ऑडियंस डिज़ाइन करना

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

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

सेटअप और प्रोटोटाइप

  • कस्टम ऑडियंस एपीआई का इस्तेमाल करके, डिवाइस पर ऑडियंस बनाएं और सेव करें. इसका इस्तेमाल बाद में नीलामी में किया जा सकता है.
  • लागू करने और एपीआई के इस्तेमाल के बारे में ज़्यादा जानकारी के लिए, डेवलपर गाइड देखें.

डिज़ाइन से जुड़ी बातें

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

बिडिंग लॉजिक का यूआरएल

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

उपयोगकर्ता के बिडिंग सिग्नल

खरीदार, UserBiddingSignals का इस्तेमाल करके, विज्ञापन देने वाले व्यक्ति या कंपनी या खरीदार के पास मौजूद उपयोगकर्ता की जानकारी को डिवाइस पर होने वाली आने वाली नीलामियों में पास कर सकते हैं. इसमें यह जानकारी शामिल हो सकती है:

  • वे अन्य ऑडियंस जिनमें उपयोगकर्ता को जोड़ा गया है.
  • विज्ञापन देने वाले व्यक्ति या कंपनी के पास मौजूद, उपयोगकर्ता से जुड़ी पहले पक्ष की अहम जानकारी.

ये सिग्नल नीलामी के दौरान उपलब्ध होते हैं. इसलिए, खरीदार नीलामी के दौरान कस्टम बिडिंग की कार्रवाइयां कर सकते हैं. इनमें ये कार्रवाइयां शामिल हैं:

  • बिडिंग सिग्नल के आधार पर बिड को बढ़ाना या घटाना.
  • नीलामी से कुछ विज्ञापनों को फ़िल्टर करें.

भरोसेमंद बिडिंग डेटा

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

TrustedBiddingData फ़ील्ड में एक यूआरएल और कुंजियों का सेट होता है. किस तरह के मुख्य स्ट्रक्चर का इस्तेमाल करना है, यह तय करते समय इन बातों का ध्यान रखें:

  • एक तरीका यह है कि बनाई जा रही ऑडियंस के लिए, एक ऐसी कुंजी शामिल की जाए जो ऑडियंस से 1:1 मैप करती हो. इसके बाद, की-वैल्यू सेवा में ऑडियंस से जुड़ी सभी ज़रूरी जानकारी शामिल हो सकती है.
  • रीयल-टाइम में बजट और विज्ञापन की स्थिति पर ध्यान देना ज़रूरी है.
  • बिडिंग के लिए तय की गई ज़्यादा से ज़्यादा रकम या अन्य सिग्नल, जिनका इस्तेमाल नीलामी में विज्ञापन की कीमत तय करने के लिए किया जा सकता है. इस जानकारी को विज्ञापन के साथ AdData सूची में शामिल किया जा सकता है. हालांकि, इसे की-वैल्यू सेवा में सेव करने से, ज़रूरत के हिसाब से अपडेट किया जा सकता है.

AdData सूची

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

विज्ञापन देने वाले लोग या कंपनियां तय करती हैं कि उन्हें हर विज्ञापन में कितनी जानकारी शामिल करनी है. इन बातों का ध्यान रखें:

  • AdData सूची को दो तरीकों से अपडेट किया जा सकता है:
    • जब ऐप्लिकेशन में फ़ोरग्राउंड में कोई गतिविधि दिख रही हो, तब वह किसी उपयोगकर्ता को कस्टम ऑडियंस में शामिल करते समय सूची शुरू कर सकता है.
    • हर दिन अपडेट होने के दौरान, फ़ेच करने की प्रोसेस बैकग्राउंड में शुरू होती है. डिवाइस, joinCustomAudience कॉल में शामिल daily_update_url को अनुरोध भेजता है. साथ ही, उसे अपडेट की गई AdData सूची के साथ जवाब मिलने की उम्मीद होती है.
  • नीलामी के दौरान, विज्ञापनों के बारे में ज़्यादा जानकारी मांगी जा सकती है. नीलामी से पहले, डिवाइस खरीदारों की उस कुंजी-वैल्यू सेवा को अनुरोध भेजता है जो joinCustomAudience के trustedBiddingData फ़ील्ड में दी गई थी. की-वैल्यू सेवा एक नई सेवा है. यह Protected Audience API को लागू करने वाले खरीदारों के लिए उपलब्ध है. इस सेवा के बारे में ज़्यादा जानकारी इस दस्तावेज़ में आगे दी गई है.
  • अपने विज्ञापन के लिए क्रिएटिव आईडी शामिल करने से, आपको कुछ क्रिएटिव पर कुछ कार्रवाइयां करने में मदद मिल सकती है. उदाहरण के लिए, विज्ञापन देने वाले लोग या कंपनियां कुछ क्रिएटिव को रोक सकती हैं. ऐसे में, आपको रीयल-टाइम कुंजी-वैल्यू सेवा से उन क्रिएटिव आईडी को पुल करना होगा. इसके बाद, उन्हें AdData सूची में मौजूद विज्ञापनों से मैच करना होगा.

AdData में render_url शामिल होना चाहिए. विजेता रीमार्केटिंग विज्ञापन के रेंडर यूआरएल का इस्तेमाल, विज्ञापन रेंडर करने के लिए किया जाता है. इन बातों का ध्यान रखें:

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

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

चालू होने और खत्म होने का समय

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

  • पुराना उपयोगकर्ता (उदाहरण के लिए, ऐसा उपयोगकर्ता जिसने पिछले सात दिनों में, विज्ञापन देने वाले व्यक्ति या कंपनी के ऐप्लिकेशन का इस्तेमाल नहीं किया है)
    • जब भी उपयोगकर्ता ऐप्लिकेशन खोलता है, तब खरीदार कॉल कर सकता है joinCustomAudience और टाइमस्टैंप के तौर पर activation_time को कॉन्फ़िगर कर सकता है. यह टाइमस्टैंप, सात दिन बाद का होगा.
    • अगर उपयोगकर्ता ने सात दिन पहले आखिरी बार ऐप्लिकेशन खोला था, तो ऑडियंस बिडिंग के लिए ज़रूरी शर्तें पूरी करती है.
  • सीज़नल ऑडियंस (ऐसी ऑडियंस जो आने वाले समय में किसी खास समयावधि के दौरान ही मान्य होती है)
    • खरीदार, कस्टम ऑडियंस को पहले से तय कर सकता है. ये ऑडियंस, आने वाले समय में पहले से तय की गई समयावधि के दौरान ही बिडिंग के लिए उपलब्ध होंगी.
    • उदाहरण के लिए, अगर विज्ञापन देने वाले किसी व्यक्ति या कंपनी को अमेरिका में 2022 में गर्मियों के आखिर में कोई कैंपेन चलाना है, तो खरीदार joinCustomAudience को कॉल कर सकता है और activation_time को 20 अगस्त, 2022 को शनिवार के लिए कॉन्फ़िगर कर सकता है. अगर कैंपेन सिर्फ़ एक हफ़्ते तक चलता है, तो खरीदार कस्टम ऑडियंस के खत्म होने की तारीख 27 अगस्त, 2022 के तौर पर सेट कर सकता है. इसके बाद, विज्ञापन चुनते समय प्लैटफ़ॉर्म कस्टम ऑडियंस को फ़िल्टर कर देता है. आखिर में, इसे ट्रैश में डाल दिया जाता है.

खरीदार और विक्रेता: विज्ञापन चुनना

विज्ञापन चुनने के लिए, खरीदारों और सेलर के बीच सहयोग ज़रूरी होता है. इसे चार चरणों वाली प्रोसेस के तौर पर देखा जा सकता है:

  1. सेलर, मीडिएशन की रणनीति तय करते हैं.
  2. सेलर, नीलामी को कॉन्फ़िगर करते हैं और विज्ञापन चुनने की प्रोसेस शुरू करते हैं.
  3. खरीदारों को, सेलर के तय किए गए कॉन्फ़िगरेशन का इस्तेमाल करके नीलामी में हिस्सा लेने का न्योता दिया जाता है. खरीदार के बिडिंग लॉजिक को लागू करके, विज्ञापन और बिड को चुना जाता है.
  4. विज्ञापन देने वाले लोगों या कंपनियों के फ़ैसले लेने के लॉजिक को लागू किया जाता है, ताकि उम्मीदवारों को स्कोर किया जा सके और सबसे अच्छा विज्ञापन चुना जा सके.

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

सेलर: मीडिएशन की रणनीति तय करना

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

सेलर: नीलामी को कॉन्फ़िगर करें

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

सेटअप और प्रोटोटाइप

  • सेलर, AdSelectionConfig ऑब्जेक्ट सेट अप करके और AdSelection एपीआई का इस्तेमाल करके, नीलामी को कॉन्फ़िगर और शुरू कर सकता है. selectAds() को लागू करके, नीलामी को ट्रिगर करें.
  • लागू करने और एपीआई के इस्तेमाल के बारे में ज़्यादा जानकारी के लिए, डेवलपर गाइड देखें.

डिज़ाइन से जुड़ी बातें

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

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

  • विज्ञापन चुनने का वर्कफ़्लो शुरू करने से पहले, विज्ञापन का अनुरोध करें. इससे खरीदारों से जुड़ी जानकारी इकट्ठा की जा सकेगी. इसके बाद, इस जानकारी का इस्तेमाल करके विज्ञापन चुनने की सुविधा को कॉन्फ़िगर करें.

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

    • खरीदारों की एक ऐसी स्टैटिक सूची जिसे सेलर हमेशा प्रोसेस में शामिल करना चाहता है.
    • खरीदारों की ऐसी सूची जो विज्ञापन के जवाब में हिस्सा लेना चाहते हैं. अगर सेलर, विज्ञापन एक्सचेंज के साथ काम करता है और उसे सभी खरीदारों के बारे में पूरी जानकारी नहीं है, तो यह विकल्प उसके लिए काम का है.

  • सेलर, कई तरीकों से इस प्रोसेस में जानकारी दे सकता है:

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

खरीदार: विज्ञापन स्लॉट के लिए बिडिंग

सेटअप और प्रोटोटाइप

  • खरीदार, generateBid() JavaScript फ़ंक्शन में बिडिंग लॉजिक जोड़ सकता है. यह फ़ंक्शन, biddingLogicUrl पैरामीटर से मिलता है. यह पैरामीटर, CustomAudience बनाते समय सेट किया जाता है. दिए गए स्पेसिफ़िकेशन का इस्तेमाल करके, मॉक सेवा सेट अप की जा सकती है. इसके अलावा, इस एंडपॉइंट को किसी असली सर्वर पर भी लागू किया जा सकता है.
  • लागू करने और एपीआई के इस्तेमाल के बारे में ज़्यादा जानकारी के लिए, डेवलपर गाइड देखें.

डिज़ाइन से जुड़ी बातें

  • बिडिंग लॉजिक को डिवाइस पर लागू किया जाता है. साथ ही, नीलामी में इस्तेमाल किए गए कुछ सिग्नल को रीयल टाइम में क्वेरी किया जाता है. सीमाओं के बारे में जानने के लिए, सीमाओं की सूची देखें.
  • विज्ञापन के इस्तेमाल से जुड़े कुछ मामलों में, सेलर के साथ मिलकर काम करना ज़रूरी होता है. इससे यह पुष्टि की जा सकती है कि आपके पास विज्ञापन के कई विकल्प और उनकी बोलियां हैं, जिन्हें डिवाइस पर दिखाया जा सकता है.

बिडिंग लॉजिक डिज़ाइन करना

खरीदारों के बिडिंग लॉजिक को JavaScript का इस्तेमाल करके लागू किया जाना चाहिए. साथ ही, इसे डिवाइस पर लागू किया जाता है. डेवलपर गाइड में, ज़रूरी हस्ताक्षर और नीलामी के दौरान पास किए गए अलग-अलग पैरामीटर के बारे में जानकारी दी गई है. डिवाइस पर मौजूद बिडिंग लॉजिक के पास अतिरिक्त जानकारी का ऐक्सेस होता है. यह जानकारी, आपके generateBid() फ़ंक्शन को पैरामीटर के तौर पर भेजी जाती है.

बिडिंग का डेटा उपलब्ध कराना

कुंजी-वैल्यू सेवाओं के साथ रीयल-टाइम बिडिंग सिग्नल

खरीदार के तौर पर, आपके पास नीलामी के दौरान रीयल टाइम सिग्नल फ़ेच करने का विकल्प होता है. इसके लिए, आपको अपनी मालिकाना हक वाली कुंजी-वैल्यू सेवा का इस्तेमाल करना होगा. आपको इस सेवा का शुरुआती वर्शन, सार्वजनिक Privacy Sandbox रिपॉज़िटरी में मिल सकता है. इसके अलावा, आपके पास अपनी सेवा बनाने का विकल्प भी है. इस सेवा के यूआरएल को कस्टम ऑडियंस में trustedBiddingUrl के तौर पर तय किया जाता है. साथ ही, प्लैटफ़ॉर्म डेटा को फ़ेच करने की कोशिश करता है और trusted_bidding_signals parameter की मदद से, उसे आपके generateBid फ़ंक्शन के लिए उपलब्ध कराता है. आपको अपना की-स्ट्रक्चर बनाना होगा.

कॉन्टेक्स्ट और उपयोगकर्ता के सिग्नल

आपके generateBid फ़ंक्शन के पास, डिवाइस पर नीलामी चलाते समय उपयोगकर्ता के अतिरिक्त सिग्नल का ऐक्सेस होता है. ये सिग्नल, contextual_signals और per_buyer_signals फ़ील्ड के साथ पास किए जाते हैं. ये सभी फ़ील्ड JSON ऑब्जेक्ट हैं. इनका फ़ॉर्मैट खरीदारों और सेलर को तय करना होता है.

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

per_buyer_signals फ़ील्ड को आपके बिडिंग लॉजिक के लिए उपलब्ध कराया जाता है. नीलामी का कॉन्फ़िगरेशन बनाते समय, सेलर इन वैल्यू को सेट करता है. खरीदारों और सेलर को मिलकर काम करना होगा, ताकि यह पुष्टि की जा सके कि यह डेटा डिवाइस पर मौजूद है और इसे बिडिंग के लॉजिक में शामिल किया गया है. इस फ़ील्ड के इस्तेमाल के कुछ उदाहरण यहां दिए गए हैं:

  • ब्रैंड की सुरक्षा के लिए फ़िल्टर करना. सेलर, खरीदारों को उस ऐप्लिकेशन के बारे में कुछ जानकारी दे सकता है जो विज्ञापन का अनुरोध कर रहा है. खरीदार इस जानकारी का इस्तेमाल करके, कुछ विज्ञापनों को फ़िल्टर कर सकता है.
  • किसी एमएल मॉडल के लिए एंबेडिंग भेजना. यह मॉडल, कॉन्टेक्स्ट के हिसाब से जानकारी को ध्यान में रखता है.

सेलर्स: स्कोर करना और सबसे अच्छा परफ़ॉर्म करने वाला विज्ञापन चुनना

सेटअप और प्रोटोटाइप

  • सेलर, scoreAd() JavaScript फ़ंक्शन में स्कोरिंग लॉजिक जोड़ सकता है. यह फ़ंक्शन, scoringLogicUrl पैरामीटर से मिलता है. यह पैरामीटर, AdSelectionConfig बनाते समय सेट किया जाता है. दिए गए स्पेसिफ़िकेशन का इस्तेमाल करके, मॉक सेवा सेट अप की जा सकती है. इसके अलावा, इस एंडपॉइंट को किसी असली सर्वर पर भी लागू किया जा सकता है.
  • लागू करने और एपीआई के इस्तेमाल के बारे में ज़्यादा जानकारी के लिए, डेवलपर गाइड देखें.

स्कोरिंग लॉजिक डिज़ाइन करना

सेलर, JavaScript में स्कोरिंग लॉजिक लागू करते हैं. यह लॉजिक, डिवाइस पर लागू होता है. डेवलपर गाइड में, ज़रूरी हस्ताक्षर और नीलामी के दौरान पास किए गए अलग-अलग पैरामीटर के बारे में जानकारी दी गई है. इसके अलावा, डिवाइस पर मौजूद स्कोरिंग लॉजिक के पास, scoreAd फ़ंक्शन को पैरामीटर के तौर पर पास की गई अतिरिक्त जानकारी को ऐक्सेस करने की अनुमति होती है.

स्कोरिंग का डेटा उपलब्ध कराना

कुंजी-वैल्यू सेवाओं के साथ रीयल-टाइम स्कोरिंग सिग्नल

सेलर के तौर पर, आपके पास नीलामी के दौरान रीयल टाइम सिग्नल फ़ेच करने का विकल्प होता है. इसके लिए, आपको अपनी मालिकाना हक वाली कुंजी-वैल्यू सेवा का इस्तेमाल करना होगा. आपको इस सेवा का शुरुआती वर्शन, Privacy Sandbox की सार्वजनिक रिपॉज़िटरी में मिल सकता है. इस सेवा के यूआरएल को ऑक्शन कॉन्फ़िगरेशन में trustedScoringUri के तौर पर तय किया जाता है. साथ ही, प्लैटफ़ॉर्म trusted_scoring_signals पैरामीटर का इस्तेमाल करके, डेटा को फ़ेच करने और उसे आपके scoreAd फ़ंक्शन के लिए उपलब्ध कराने की कोशिश करता है. आपको अपना की-स्ट्रक्चर बनाना चाहिए.

कॉन्टेक्स्ट और उपयोगकर्ता के सिग्नल

आपके scoreAd फ़ंक्शन के पास, डिवाइस पर नीलामी करते समय उपयोगकर्ता के अतिरिक्त सिग्नल का ऐक्सेस होता है. इन सिग्नल को contextual_signal फ़ील्ड का इस्तेमाल करके, आपके स्कोरिंग फ़ंक्शन को भेजा जाता है. इस फ़ील्ड में एक JSON ऑब्जेक्ट होता है. इसका फ़ॉर्मैट, खरीदार और सेलर तय करते हैं.

contextual_signal फ़ील्ड में, कॉन्टेक्स्ट के हिसाब से जानकारी शामिल होती है. यह जानकारी उपयोगकर्ता के लिए काम की हो सकती है. इन सिग्नल को सेव करने वाला ऑब्जेक्ट, Protected Audience खुद बनाता है. साथ ही, इसे आपके स्कोरिंग लॉजिक में पास करता है. इसे एक खाली ऑब्जेक्ट के तौर पर पास किया जाता है. अगर आपको लगता है कि उपयोगकर्ता के बारे में कोई सिग्नल, आपके इस्तेमाल के उदाहरण के लिए काम का हो सकता है, तो सुझाव/राय दें या शिकायत करें.

सेलर: विज्ञापन रेंडर करना

सेलर को नीलामी जीतने वाला विज्ञापन दिखाना होगा. सबसे अच्छा परफ़ॉर्म करने वाले विज्ञापनों को कैसे रेंडर किया जाता है, इस बारे में ज़्यादा जानने के लिए डिज़ाइन प्रपोज़ल देखें. इस इलाके को अब भी डिज़ाइन किया जा रहा है.

इंप्रेशन के नतीजों की रिपोर्ट करना

सेटअप और प्रोटोटाइप

  • खरीदार और विक्रेता, reportWin() या scoringLogicUrl पैरामीटर से दिखाए जाने वाले reportWin() JavaScript फ़ंक्शन में रिपोर्टिंग लॉजिक जोड़ सकते हैं.biddingLogicUrl दिए गए स्पेसिफ़िकेशन का इस्तेमाल करके, मॉक सेवा सेट अप की जा सकती है. इसके अलावा, इस एंडपॉइंट को किसी असली सर्वर पर भी लागू किया जा सकता है.
  • लागू करने और एपीआई के इस्तेमाल के बारे में ज़्यादा जानकारी के लिए, डेवलपर गाइड देखें.

डिज़ाइन से जुड़ी बातें

खरीदारों और सेलर को अपने कॉन्फ़िगर किए गए एंडपॉइंट से मिले JavaScript कोड में, reportWin फ़ंक्शन लागू करना होगा. इस तरीके से, अपने सर्वर पर डेटा वापस भेजा जा सकता है.

Privacy Sandbox, इवेंट लेवल और एग्रीगेट रिपोर्ट मैनेज करने के लिए Attribution Reporting API भी उपलब्ध कराता है. ज़्यादा जानकारी के लिए, इंटिग्रेशन गाइड पढ़ें.