इस पेज का अनुवाद Cloud Translation API से किया गया है.

Protected Audience API की मदद से, कस्टम ऑडियंस टारगेटिंग की सुविधा पाएं

हाल ही के अपडेट

कस्टम ऑडियंस अपडेट शेड्यूल करने के बारे में जानकारी जोड़ी गई
सुरक्षित ऑडियंस के साथ एट्रिब्यूशन रिपोर्टिंग इंटिग्रेशन जोड़ा गया
Protected Audience से जुड़ी सुविधाओं की टाइमलाइन पब्लिश की गई.
FLEDGE का नाम बदलकर Protected Audience API कर दिया गया है.
कस्टम ऑडियंस डेलिगेशन के लिए प्रस्ताव जोड़ा गया.
हर दिन के अपडेट के लिए, के-पहचान की पुष्टि करने की ज़रूरत हटाई गई यूआरएल.

Protected Audience बीटा वर्शन में है और सार्वजनिक डिवाइसों पर टेस्ट करने के लिए उपलब्ध है!

Protected Audience की मदद से, ये काम किए जा सकते हैं:

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

शुरू करने के लिए, Protected Audience डेवलपर गाइड पढ़ें. आपका सुझाव, शिकायत या राय की हम काफ़ी सराहना करते हैं, क्योंकि हम Protected Audience को लगातार बेहतर बनाते रहते हैं.

टाइमलाइन

आने वाले महीनों में हम नई सुविधाएं रिलीज़ करेंगे. रिलीज़ की सटीक तारीखें सुविधा के आधार पर अलग-अलग हो सकती है और इस तालिका को इसके लिंक के साथ अपडेट किया जाएगा दस्तावेज़ के उपलब्ध होने पर.

सुविधा	'डेवलपर के लिए झलक' में उपलब्ध है	बीटा वर्शन में उपलब्ध है
इवेंट-लेवल की रिपोर्टिंग	साल 2023 की पहली तिमाही	साल 2023 की तीसरी तिमाही
वॉटरफ़ॉल मीडिएशन	साल 2023 की पहली तिमाही	साल 2023 की चौथी तिमाही
ऐप्लिकेशन इंस्टॉल विज्ञापन फ़िल्टर करना	साल 2023 की दूसरी तिमाही	साल 2023 की तीसरी तिमाही
फ़्रीक्वेंसी कैप फ़िल्टर करना	साल 2023 की दूसरी तिमाही	साल 2023 की तीसरी तिमाही
फ़िल्टर करने के लिए, काम के विज्ञापनों को विज्ञापन चुनने के वर्कफ़्लो पर पास करना	साल 2023 की दूसरी तिमाही	साल 2023 की तीसरी तिमाही
इंटरैक्शन रिपोर्टिंग	साल 2023 की दूसरी तिमाही	साल 2023 की तीसरी तिमाही
कस्टम ऑडियंस डेलिगेशन में शामिल होना	साल 2023 की तीसरी तिमाही	साल 2023 की चौथी तिमाही
गैर-सीपीएम बिलिंग	साल 2023 की तीसरी तिमाही	साल 2023 की चौथी तिमाही
बिडिंग और नीलामी की सेवाओं को इंटिग्रेट करना	साल 2023 की तीसरी तिमाही	साल 2023 की चौथी तिमाही
डीबग रिपोर्टिंग	साल 2023 की तीसरी तिमाही	साल 2023 की चौथी तिमाही
एट्रिब्यूशन रिपोर्टिंग इंटिग्रेशन	लागू नहीं	साल 2023 की चौथी तिमाही
ओपन बिडिंग मीडिएशन	साल 2023 की चौथी तिमाही	साल 2023 की चौथी तिमाही
करंसी मैनेजमेंट	साल 2024 की पहली तिमाही	साल 2024 की दूसरी तिमाही
K-anon इंटिग्रेशन	लागू नहीं	साल 2024 की दूसरी तिमाही
एग्रीगेट रिपोर्टिंग इंटिग्रेशन	साल 2024 की तीसरी तिमाही	चौथी तिमाही '24

खास जानकारी

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

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

Android पर Protected Audience API (पहले इसे FLEDGE के नाम से जाना जाता था) में विज्ञापन टेक्नोलॉजी से जुड़े प्लैटफ़ॉर्म और विज्ञापन देने वाले लोगों या कंपनियों के लिए, नीचे दिए गए एपीआई इंटरैक्शन के आधार पर इस्तेमाल के ऐसे उदाहरण जो दोनों आइडेंटिफ़ायर को शेयर करने की सीमा तय करते हों और तीसरे पक्षों के साथ उपयोगकर्ता के ऐप्लिकेशन इंटरैक्शन की जानकारी:

कस्टम ऑडियंस एपीआई: यह "कस्टम ऑडियंस" ऐब्स्ट्रक्शन, जो विज्ञापन देने वाले की ओर से तय किए गए को दिखाता है एक जैसी सोच रखने वाले दर्शकों से. ऑडियंस की जानकारी डिवाइस पर सेव की जाती है. साथ ही, इसे ऑडियंस के लिए काम के विज्ञापनों और बिडिंग सिग्नल जैसे मनमुताबिक मेटाडेटा से जोड़ा जा सकता है. जानकारी का इस्तेमाल, आपको सूचना देने के लिए किया जा सकता है विज्ञापन फ़िल्टर करने की सुविधा, और रेंडरिंग के बारे में खास जानकारी.
Ad Select API: यह ऐसा फ़्रेमवर्क उपलब्ध कराता है जो ऑर्केस्ट्रेट ऐड टेक प्लैटफ़ॉर्म' उपयोगकर्ता के डिवाइस पर मौजूद सिग्नल का इस्तेमाल करने वाले वर्कफ़्लो "विनिंग" तय करते हैं स्थानीय तौर पर सेव किए गए उम्मीदवार के विज्ञापनों को ध्यान में रखकर विज्ञापन बनाना और कैंडिडेट के विज्ञापनों को बेहतर तरीके से प्रोसेस करना, जैसे कि AdTech प्लैटफ़ॉर्म डिवाइस पर वापस चला जाता है.

Android पर Privacy Sandbox में कस्टम ऑडियंस मैनेजमेंट और विज्ञापन चुनने के वर्कफ़्लो को दिखाने वाला फ़्लो चार्ट.

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

हाई लेवल पर इंटिग्रेशन इस तरह काम करता है:

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

Android के एपीआई पर Protected Audience का ऐक्सेस पाना

Protected Audience API को ऐक्सेस करने के लिए, AdTech प्लैटफ़ॉर्म को रजिस्टर करना होगा. यहां जाएं: ज़्यादा जानकारी के लिए, Privacy Sandbox खाते के लिए रजिस्टर करें.

कस्टम ऑडियंस मैनेजमेंट

कस्टम ऑडियंस

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

विज्ञापन देने वाला कोई ऐप्लिकेशन या इंटिग्रेट किया गया SDK टूल, शामिल हो सकता है या कस्टम ऑडियंस छोड़ना. उदाहरण के लिए, उपयोगकर्ता ऐप में यूज़र ऐक्टिविटी होती है.

कस्टम ऑडियंस मेटाडेटा

हर कस्टम ऑडियंस में यह मेटाडेटा शामिल होता है:

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

पसंद के मुताबिक ऑडियंस का ऐक्सेस देना

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

कस्टम ऑडियंस में शामिल हों

कस्टम ऑडियंस में शामिल होने के दो तरीके हैं:

joinCustomAudience()

कोई ऐप्लिकेशन या SDK टूल, कॉल करके कस्टम ऑडियंस में शामिल होने का अनुरोध कर सकता है CustomAudience ऑब्जेक्ट कोjoinCustomAudience() अनुमानित पैरामीटर. यहां उदाहरण के तौर पर कोड स्निपेट दिया गया है:

CustomAudience audience = new CustomAudience(
    Buyer = "example-dsp.com",
    Name = "running-shoes",
    ActivationTime = now(),
    ExpirationTime = ActivationTime.plus(30 days),
    DailyUpdateURL = Uri.parse("https://..."),
    UserBiddingSignals = new JSONObject("{...}"),
    TrustedBiddingURL = Uri.parse("https://..."),
    TrustedBiddingKeys = {'key1","key2", ...,"key n"},
    BiddingLogicURL =  Uri.parse("https://..."),
    Ads = [new AdData(renderUrl = Uri.parse("https://..."),
           metadata = new JSONObject("{...}"), ...];

// Invoke ad services API to join a custom audience.
joinCustomAudience(audience);

fetchAndJoinCustomAudience()

कोई ऐप्लिकेशन या SDK टूल, कस्टम ऑडियंस में शामिल होने का अनुरोध उन विज्ञापन टेक्नोलॉजी की ओर से कर सकता है जो fetchAndJoinCustomAudience() को कॉल करने का मतलब यह नहीं है कि वह उपयोगकर्ता के डिवाइस पर मौजूद है जैसा कि इस उदाहरण में दिखाया गया है:

FetchAndJoinCustomAudienceRequest fetchRequest = new FetchAndJoinCustomAudienceRequest(
    // Example: Optional verification token passed inside the fetch URL
    FetchURI = Uri.parse("https://example-dsp.com/...?mytoken=arbitrary1234"),
    // All the following parameters are optional
    Name = "running-shoes",
    ActivationTime = now(),
    ExpirationTime = ActivationTime.plus(30 days),
    UserBiddingSignals = new JSONObject("{...}")
);

fetchAndJoinCustomAudience(fetchRequest);

खरीदार के मालिकाना हक वाला यूआरएल एंडपॉइंट, CustomAudience JSON के साथ जवाब देता है ऑब्जेक्ट होता है. कस्टम ऑडियंस के खरीदार और मालिक वाले फ़ील्ड नज़रअंदाज़ किया जाता है और एपीआई से अपने-आप भरा जाता है. एपीआई यह भी लागू करता है कि हर दिन अपडेट यूआरएल, खरीदार के eTLD+1 से मेल खाएगा.

{
 "name": "running-shoes",
 "activation_time": 1680603133000,
 "expiration_time": 1680803133000,
 "user_bidding_signals" : {"signal1": "value"},
 "trusted_bidding_data": {
    "trusted_bidding_uri": "https://example-dsp.com/.."
    "trusted_bidding_keys": ["k1", "k2"],
 },
 "bidding_logic_uri": "https://example-dsp.com/...",
 "daily_update_uri": "https://example-dsp.com/...",
 "ads": [
   {
     "render_uri": "https://example-dsp.com/...",
     "metadata": {},
     "ad_filters": {
       "frequency_cap": {
         "win": [
           {
             "ad_counter_key": 1,
             "max_count": 2,
             "interval_in_seconds": 60
           },
         ],
         "view": [
           {
             "ad_counter_key": 2,
             "max_count": 10,
             "interval_in_seconds": 3600
           },
         ]
       },
       "app_install": {
         "package_names": [
           "package.name.one",
           "package.name.two", ...
         ]
       }
     }
   },
   ...
 ]
}

fetchAndJoinCustomAudience() एपीआई, खरीदार की पहचान fetchUri में से eTLD+1. CustomAudience खरीदार की पहचान का इस्तेमाल, joinCustomAudience() के ज़रिए किए गए रजिस्ट्रेशन और ऐप्लिकेशन की अनुमति की जांच करने के लिए किया जाता है. साथ ही, फ़ेच किए गए रिस्पॉन्स से इसमें बदलाव नहीं किया जा सकता. CustomAudience के मालिक के तौर पर कॉल करने वाले ऐप्लिकेशन के पैकेज का नाम. इसका कोई और पुष्टि नहीं है eTLD+1 चेक के अलावा fetchUri और खास तौर पर, कोई k-anon नहीं है चेक करें. fetchAndJoinCustomAudience() एपीआई, एचटीटीपी जीईटी अनुरोध जारी करता है, ताकि fetchUri और उम्मीद है कि JSON ऑब्जेक्ट, कस्टम ऑडियंस को दिखा रहा हो. रिस्पॉन्स पर, कस्टम ऑडियंस ऑब्जेक्ट फ़ील्ड के लिए वही ज़रूरी, वैकल्पिक शर्तें और डिफ़ॉल्ट वैल्यू लागू होती हैं. वर्तमान शर्तों और सीमाओं के बारे में ज़्यादा जानें.

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

CustomAudienceFetchRequest ऑब्जेक्ट की मदद से, एपीआई कॉलर ऊपर दिए गए उदाहरण में दिखाई गई वैकल्पिक प्रॉपर्टी का इस्तेमाल करके, कस्टम ऑडियंस के लिए कुछ जानकारी तय कर सकता है. अगर अनुरोध में सेट किया गया है, तो इन वैल्यू को इससे बदला नहीं जा सकता प्लैटफ़ॉर्म को खरीदार का जवाब मिला; Protected Audience API, इसे अनदेखा करता है दिए गए फ़ील्ड में. अगर इन्हें अनुरोध में सेट नहीं किया गया है, तो उन्हें इन्हें रिस्पॉन्स में सेट किया जाना चाहिए, क्योंकि कस्टम बनाने के लिए ये फ़ील्ड ज़रूरी हैं ऑडियंस. CustomAudience का कॉन्टेंट, JSON फ़ॉर्मैट में इस तरह दिखाया गया है एपीआई कॉलर की ओर से तय किया गया कुछ हद तक, fetchUri को किए गए जीईटी अनुरोध में शामिल है विशेष हेडर X-CUSTOM-AUDIENCE-DATA में. कस्टम ऑडियंस के लिए तय किए गए डेटा के सीरियलाइज़ किए गए फ़ॉर्म का साइज़ 8 केबी तक सीमित है. अगर साइज़ fetchAndJoinCustomAudience से ज़्यादा एपीआई कॉल नहीं किया गया.

k-anon चेक मौजूद न होने पर, आप खरीदार की पुष्टि करने के लिए fetchUri का इस्तेमाल कर सकते हैं साथ ही, खरीदार और SDK टूल के बीच जानकारी शेयर करने की सुविधा चालू की जा सकती है. कस्टम विज्ञापन बनाने के लिए ऑडियंस की पुष्टि की है, तो खरीदार के लिए पुष्टि करना संभव है टोकन. डिवाइस पर मौजूद SDK टूल के fetchUri में यह टोकन शामिल होना चाहिए, ताकि खरीदार का होस्ट किया गया एंडपॉइंट, कस्टम ऑडियंस का कॉन्टेंट फ़ेच कर सकता है और टोकन का इस्तेमाल करके पुष्टि करें कि fetchAndJoinCustomAudience() ऑपरेशन, खरीदार के मुताबिक होता है और किसी भरोसेमंद ऑन-डिवाइस से शुरू होता है पार्टनर के साथ शेयर करें. जानकारी शेयर करने के लिए, खरीदार डिवाइस पर मौजूद कॉलर से सहमत हो सकता है कस्टम ऑडियंस बनाने के लिए इस्तेमाल की जाने वाली कुछ जानकारी को fetchUri में क्वेरी पैरामीटर के रूप में जोड़ा गया. इससे, खरीदार को कॉल का ऑडिट करने और यह पता लगाने में मदद मिलती है कि किसी नुकसान पहुंचाने वाले विज्ञापन टेक्नोलॉजी ने पुष्टि करने वाले टोकन का इस्तेमाल, कई अलग-अलग कस्टम ऑडियंस बनाने के लिए किया है या नहीं.

पुष्टि वाले टोकन की परिभाषा और डिवाइस के स्टोरेज के बारे में जानकारी

Protected Audience किसी भी मकसद के लिए, पुष्टि वाले टोकन का इस्तेमाल नहीं करता एपीआई की मदद से ऐसा करना ज़रूरी नहीं है.
- खरीदार, इस बात की पुष्टि करने के लिए पुष्टि टोकन का इस्तेमाल कर सकता है कि ऑडियंस बनाई जा रही हैं.
- Protected Audience API, प्रस्ताव में पुष्टि के लिए टोकन या टोकन कैसे ट्रांसफ़र किया जाता है कॉलर है. उदाहरण के लिए, पुष्टि करने वाला टोकन, Google Ads में पहले से लोड हो सकता है SDK टूल या बैकएंड को नुकसान हो सकता है. इसके अलावा, मालिक इसे रीयल-टाइम में वापस ले सकता है खरीदार के सर्वर से SDK टूल.

कस्टम ऑडियंस छोड़ें

कस्टम ऑडियंस का मालिक, leaveCustomAudience() को कॉल करके ऑडियंस छोड़ सकता है. इस बारे में ज़्यादा जानने के लिए, नीचे दिए गए उदाहरण के तौर पर दिए गए कोड स्निपेट को देखें:

// Invoke ad services API to leave a custom audience.
leaveCustomAudience(buyer, name);

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

ऐप्लिकेशन पर उपयोगकर्ताओं के कंट्रोल की जानकारी

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

इस सुविधा के डिज़ाइन पर काम चल रहा है. ब्यौरे में बाद के अपडेट में शामिल किया गया है.

शेड्यूल किए गए अपडेट

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

इसे आसान बनाने के लिए, विज्ञापन टेक्नोलॉजी, scheduleCustomAudienceUpdate() एपीआई. यह एपीआई, कॉलर को यह तय करने में मदद करता है कि एपीआई कॉल करने में देरी की वजह से, अतिरिक्त समय लग सकता है के लिए, ऐप्लिकेशन लेवल के इवेंट को प्रोसेस किया जा सकता है. सुरक्षित ऑडियंस, जिसमें उपयोगकर्ता को शामिल होना चाहिए या जिससे उसे हटाया जाना चाहिए.

/**
* API To schedule delayed update events for Custom Audience
*
* @param request Criteria that determine when and where to trigger a call to a
* DSP endpoint to update one or more Custom Audiences
*/

public void scheduleCustomAudienceUpdate(
    @NonNull ScheduleCustomAudienceUpdateRequest request,
    @NonNull @CallBackExecutor Executor executor,
    @NonNull AdServicesOutcomeReceiver<Object, Exception> receiver)

ScheduleCustomAudienceUpdateRequest

public final class ScheduleCustomAudienceUpdateRequest {
  // Required Field
  @NonNull public Uri getUpdateUri() {
    return mUpdateUri;
  }

  // Required Field
  @NonNull public Duration getMinDelay() {
    return mMinDelay;
  }

  //  Required Field
  @NonNull public List<PartialCustomAudience> getPartialCustomAudienceList() {
    return mPartialCustomAudiences;
  }

  //  Optional Field (default false)
  public boolean shouldReplacePendingUpdates () {
    return mShouldReplacePendingUpdates;
  }
}

ScheduleCustomAudienceUpdateRequest में वह जानकारी शामिल है जो रजिस्टर करने में देरी हो रही हो और नौकरी मिलने में देरी हो. तय देरी के बाद, बैकग्राउंड काम समय-समय पर चलेगा और अनुरोध भेजेगा. कॉन्टेंट बनाने ScheduleCustomAudienceUpdateRequest में यह जानकारी शामिल हो सकती है:

UpdateUri: यूआरआई एंडपॉइंट जिसे अपडेट फ़ेच करने के लिए GET कॉल भेजा जाएगा. खरीदार की पहचान, ईटीएलडी+1 से अपने-आप पता चलती है. इसलिए, इसे साफ़ तौर पर देने की ज़रूरत नहीं है. साथ ही, अपडेट रिस्पॉन्स से इसमें बदलाव नहीं किया जा सकता. जीईटी अनुरोध में ऐसे JSON ऑब्जेक्ट की ज़रूरत है जिसमें customAudience ऑब्जेक्ट की सूची हो वापसी.
DelayTime: समय अपडेट शेड्यूल करने के लिए, scheduleCustomAudienceUpdate() एपीआई कॉल.

PartialCustomAudience: यह एपीआई, डिवाइस पर मौजूद SDK टूल को सूची भेजने की भी अनुमति देता है पूरी तरह से नहीं बनीं कस्टम ऑडियंस. इससे, इन-ऐप्लिकेशन SDK टूल इस्तेमाल किए जा सकते हैं कस्टम ऑडियंस मैनेजमेंट पर पूरी से कुछ हद तक कंट्रोल पर आधारित है.
- इससे यह एपीआई, fetchAndJoinCustomAudience() एपीआई के साथ भी काम करता रहता है. इस एपीआई की मदद से, मिलती-जुलती जानकारी शेयर की जा सकती है.
ShouldReplacePendingUpdates: बूलियन जो तय करता है कि कोई मंज़ूरी बाकी है या नहीं शेड्यूल किए गए अपडेट रद्द कर दिए जाने चाहिए और उन्हें मौजूदा ScheduleCustomAudienceUpdateRequest. अगर यह false और पर सेट किया जाता है इस इसी ऐप्लिकेशन के साथ, scheduleCustomAudienceUpdate पर कॉल करने की सुविधा ScheduleCustomAudienceUpdateRequest इस्तेमाल नहीं किया जा सकेगा. डिफ़ॉल्ट तौर पर, यह false पर सेट होती है.

ऐप्लिकेशन की अनुमतियां और कंट्रोल

इस प्रस्ताव का मकसद, ऐप्लिकेशन को अपनी पसंद के मुताबिक ऑडियंस पर कंट्रोल देना है:

कोई ऐप्लिकेशन, पसंद के मुताबिक ऑडियंस के साथ अपने असोसिएशन को मैनेज कर सकता है.
ऐप्लिकेशन, तीसरे पक्ष के विज्ञापन टेक्नोलॉजी प्लैटफ़ॉर्म को अनुमतियां दे सकता है, ताकि वे उसकी ओर से कस्टम ऑडियंस मैनेज कर सकें.

विज्ञापन टेक्नोलॉजी प्लैटफ़ॉर्म का कंट्रोल

इस प्रस्ताव में बताया गया है कि विज्ञापन टेक्नोलॉजी से जुड़ी कंपनियां, अपनी पसंद के मुताबिक ऑडियंस को कैसे कंट्रोल कर सकती हैं:

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

उम्मीदवारों के विज्ञापन और मेटाडेटा का जवाब

बाय-साइड प्लैटफ़ॉर्म से लौटाए गए उम्मीदवार के विज्ञापनों और मेटाडेटा में, ये फ़ील्ड शामिल होते हैं:

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

विज्ञापन चुनने का वर्कफ़्लो

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

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

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

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

विज्ञापन चुनने का वर्कफ़्लो शुरू करने वाला फ़्लो चार्ट.

विज्ञापन चुनने का यह वर्कफ़्लो, उपयोगकर्ता के डिवाइस पर यह तय करता है कि विज्ञापन तकनीक से मिला JavaScript कोड नीचे दिया गया क्रम:

बाय-साइड बिडिंग के लॉजिक को लागू करना
बाय-साइड विज्ञापन फ़िल्टर करना और प्रोसेस करना
सेल-साइड के फ़ैसले वाले लॉजिक को लागू करना

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

विज्ञापन चुनने के ऐसे विकल्पों का डिज़ाइन, जिनमें कस्टम ऑडियंस शामिल नहीं हैं, फ़िलहाल तैयार किया जा रहा है.

विज्ञापन चुनने का वर्कफ़्लो शुरू करें

जब किसी ऐप्लिकेशन को विज्ञापन दिखाने की ज़रूरत होती है, तो विज्ञापन टेक्नोलॉजी प्लैटफ़ॉर्म SDK टूल, विज्ञापन शुरू कर सकता है इंस्टैंशिएट करने के बाद, selectAds() तरीके को कॉल करके चुनने का वर्कफ़्लो सही पैरामीटर के साथ AdSelectionConfig ऑब्जेक्ट:

सेलर: eTLD+1 के बाद, सेल-साइड विज्ञापन प्लैटफ़ॉर्म के लिए आइडेंटिफ़ायर फ़ॉर्मैट
डिसिज़न लॉजिक यूआरएल: जब विज्ञापन नीलामी शुरू होती है, तब प्लैटफ़ॉर्म इस यूआरएल में, सेल-साइड प्लैटफ़ॉर्म से JavaScript कोड को फ़ेच किया जाएगा. जीतने वाला विज्ञापन.
कस्टम ऑडियंस खरीदार: कस्टम ऑडियंस के साथ बाय-साइड प्लैटफ़ॉर्म की सूची eTLD+1 फ़ॉर्मैट के हिसाब से, इस नीलामी के लिए ऑडियंस की मांग.
विज्ञापन चुनने के सिग्नल: नीलामी के बारे में जानकारी (विज्ञापन का साइज़, विज्ञापन फ़ॉर्मैट वगैरह).
सेलर के सिग्नल: साइड प्लैटफ़ॉर्म से जुड़े सिग्नल उपलब्ध कराएं.
भरोसेमंद स्कोरिंग सिग्नल का यूआरएल: सेल-साइड के भरोसेमंद सिग्नल का यूआरएल एंडपॉइंट किस क्रिएटिव से रीयल टाइम जानकारी मिल सकती है.
हर खरीदार के सिग्नल: मांग में हिस्सा लेने वाले पक्ष, इन कामों के लिए इस पैरामीटर का इस्तेमाल कर सकते हैं हम नीलामी के लिए इनपुट देते हैं. उदाहरण के लिए, इस पैरामीटर में बिड तय करने में मदद करने वाली, काम की पूरी जानकारी दें.

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

AdSelectionConfig myAdSelectionConfig = new AdSelectionConfig {
    Seller = "example-ssp1.com",
    DecisionLogicURL = Uri.parse("https://..."),
    CustomAudienceBuyerList = Arrays.asList("example-dsp1.com","bexample-dsp2.com"),
    AdSelectionSignals = "{"min_price": 10,"auction_attempts": 3}"
    SellerSignals = "{"seller_type": "news", "content_category": "sports","mature_ads_accepted" :"false"}"
    PerBuyerSignals = " {"buyer1Name": {"key1" : "value1"},
                         "buyer2Name": {"key1" : "value1", "key2" : "value2" }"
};

// Invoke ad services API to initiate ad selection workflow.
Ad winningAd = selectAds(myAdSelectionConfig);

बाय-साइड बिडिंग लॉजिक

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

प्लैटफ़ॉर्म, कस्टम ऑडियंस के "बिडिंग लॉजिक यूआरएल" का इस्तेमाल करेगा मेटाडेटा के लिए JavaScript कोड फ़ेच करें, जिसमें नीचे दिया गया फ़ंक्शन हस्ताक्षर शामिल होना चाहिए:

generateBid(ad, auction_signals, per_buyer_signals, trusted_bidding_signals,
        contextual_signals, user_signals, custom_audience_signals) {
    // ...
    return {'bid': ...};
}

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

इस फ़ंक्शन में ये पैरामीटर होने चाहिए:

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

विज्ञापन की लागत

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

generateBid(ad, auction_signals, per_buyer_signals, trusted_bidding_signals,
        contextual_signals, user_signals, custom_audience_signals) {
    // ...
    return {'bid': ..., 'adCost': ...,};
}

अगर यह विज्ञापन विजेता है, तो adCost को स्टोकेटिक रूप से राउंड में 8 बिट में बदल दिया जाएगा निजता. इसके बाद, adCost का पूर्णांकित मान इंप्रेशन रिपोर्टिंग के दौरान, reportWin में contextual_signals पैरामीटर.

बाय-साइड फ़िल्टरिंग लॉजिक

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

बाय-साइड फ़िल्टरिंग लॉजिक को 0 की बिड वैल्यू दिखाकर, बिडिंग का लॉजिक दिए जाते हैं.

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

सेल-साइड स्कोरिंग लॉजिक

आम तौर पर, स्कोरिंग लॉजिक, सेल-साइड प्लैटफ़ॉर्म उपलब्ध कराता है. कोड का मकसद, बिडिंग लॉजिक के आउटपुट के आधार पर, विज्ञापन दिखाने के लिए चुना गया विज्ञापन तय करना है. यह हो सकता है नतीजा तय करने के लिए, अतिरिक्त कारोबारी नियम लागू करें. अगर एक से ज़्यादा डिसिज़न लॉजिक प्रोवाइडर, सिस्टम एक्ज़िक्यूशन सीक्वेंस की गारंटी नहीं देता. उपलब्ध कराता है. प्लैटफ़ॉर्म, "डिसिज़न लॉजिक यूआरएल" का इस्तेमाल करेगा इनपुट वह JavaScript कोड फ़ेच करने के लिए selectAds() API का पैरामीटर जो नीचे फ़ंक्शन हस्ताक्षर शामिल करें:

scoreAd(ad, bid, auction_config, trusted_scoring_signals,
        contextual_signals, user_signals, custom_audience_signals) {
    // ...
    return score_for_this_ad;
}

फ़ंक्शन में ये पैरामीटर होने चाहिए:

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

विज्ञापन चुनने के कोड का रनटाइम

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

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

नीलामी कोड, जैसे कि बिडिंग लॉजिक को किसी निजी उपयोगकर्ता को ऐक्सेस करने की ज़रूरत पड़ सकती है जैसे कि ऐप्लिकेशन इंस्टॉल करने के सोर्स, रनटाइम, नेटवर्क की जानकारी नहीं देगा या स्टोरेज ऐक्सेस.

प्रोग्रामिंग भाषा

AdTech प्लैटफ़ॉर्म से मिला नीलामी कोड, JavaScript में लिखा जाना चाहिए. उदाहरण के लिए, इससे विज्ञापन टेक्नोलॉजी प्लैटफ़ॉर्म, Privacy Sandbox के साथ काम करने वाले सभी प्लैटफ़ॉर्म पर बिडिंग कोड शेयर कर पाएंगे.

विज्ञापन रेंडर करने की सुविधा

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

इस प्लान का मकसद ऐसे समाधान को तैयार करना है जिससे यह पक्का किया जा सके कि उपयोगकर्ता की कस्टम ऑडियंस सदस्यता या ऐप्लिकेशन में दिलचस्पी बढ़ाने का इतिहास, जीतने वाले विज्ञापन की जानकारी के ज़रिए ऐप्लिकेशन या SDK टूल (Chrome के फ़ेंस किए गए फ़्रेम के प्रपोज़ल).

इंप्रेशन और इवेंट रिपोर्टिंग

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

सेल-साइड रिपोर्टिंग.
बाय-साइड रिपोर्टिंग.

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

इवेंट की रिपोर्टिंग के लिए दो चरणों को पूरा करना ज़रूरी है: सेल-साइड और बाय-साइड JavaScript को यह रजिस्टर करना होगा कि उसे किस इवेंट की रिपोर्ट मिलनी चाहिए, और सेल-साइड, इवेंट-लेवल की जानकारी देने के लिए ज़िम्मेदार होता है.

Protected Audience, आने वाले समय में होने वाले इवेंट की सदस्यता लेने का तरीका उपलब्ध कराता है बीकन रजिस्टर करके नीलामी जीतने में मदद करने वाला विज्ञापन. विक्रेता के reportResult() में JavaScript फ़ंक्शन, सेल-साइड प्लैटफ़ॉर्म, बीकन रजिस्टर करने के लिए प्लैटफ़ॉर्म का registerAdBeacon() फ़ंक्शन. इसी तरह, बाय-साइड प्लैटफ़ॉर्म से registerAdBeacon() तरीके को उनके reportWin() JavaScript फ़ंक्शन से लिया गया है.

registerAdBeacon(beacons)

इनपुट:

event_key: इस स्ट्रिंग से पता चलता है कि किस तरह के इंटरैक्शन के लिए रजिस्टर करना है. इसका इस्तेमाल प्लैटफ़ॉर्म पर मौजूद पिंग एंड पॉइंट का पता लगाने के लिए किया जाता है हम नीलामी के नतीजों की जानकारी देते हैं.
reporting_url: इवेंट को मैनेज करने के लिए, विज्ञापन टेक्नोलॉजी प्लैटफ़ॉर्म के मालिकाना हक वाला यूआरएल.

इवेंट कुंजियां, स्ट्रिंग आइडेंटिफ़ायर हैं जिनका मालिकाना हक सेल-साइड SDK टूल के पास है नीलामी के परिणामों की रिपोर्ट करने के लिए ज़िम्मेदार है. कॉलबैक करने के लिए, AdTech की टीम, बीकन को उन कुंजियों से रजिस्टर करती है जो विक्रेता की ओर से इस्तेमाल की जाने वाली कुंजियों से मेल खाती हैं इवेंट की रिपोर्ट करते समय. इनका के-अनाम होना ज़रूरी नहीं है, हालांकि ऐसे में सीमाओं को उन कुंजियों की संख्या और लंबाई तक सीमित करता है जिन्हें दिए गए कस्टम ऑडियंस को टारगेट करता है. अगर reportEvent() का इस्तेमाल किया जाता है, तो सेल-साइड प्लैटफ़ॉर्म नीलामी के दौरान ये इवेंट रिपोर्ट हमेशा पाई जा सकती हैं. सिर्फ़ बाय-साइड प्लैटफ़ॉर्म को जीतने वाले लोग, ये रिपोर्ट पा सकते हैं.

सेल-साइड रिपोर्टिंग

यह प्लैटफ़ॉर्म, सप्लाई में reportResult() JavaScript फ़ंक्शन को शुरू करता है की ओर से दिया गया कोड, विक्रेता के डिसिज़न लॉजिक यूआरएल से डाउनलोड किया गया selectAds() एपीआई के लिए पैरामीटर:

reportResult(render_url, bid, auction_config, contextual_signals) {
    // ...
    beacons = {"click":clickUri}
    registerAdBeacon(beacons)
    return {
      "status": 0,
      "results": {"reporting_url": reporting_url,
                  "signals_for_buyer": signals_for_buyer}};
}

आउटपुट: JSON ऑब्जेक्ट में शामिल है

स्थिति: सफलता के लिए 0, विफलता के लिए कोई अन्य मान.
रिपोर्टिंग यूआरएल: प्लैटफ़ॉर्म, फ़ंक्शन से लौटाए गए इस यूआरएल को शुरू करता है.
खरीदार के लिए सिग्नल: खरीदार के reportWin को भेजा जाने वाला JSON ऑब्जेक्ट फ़ंक्शन का इस्तेमाल करना होगा.

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

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

बाय-साइड रिपोर्टिंग

यह प्लैटफ़ॉर्म, मांग में reportWin() JavaScript फ़ंक्शन को शुरू करता है साथ में दिया गया कोड, इसे बिडिंग लॉजिक यूआरएल मेटाडेटा से डाउनलोड किया गया नीलामी से संबद्ध कस्टम ऑडियंस.

reportWin(render_url, bid, auction_signals, per_buyer_signals,
        signals_for_buyer, contextual_signals, custom_audience_signals) {
    // ...
    beacons = {"click":clickUri}
    registerAdBeacon(beacons)
    return {
      "status": 0,
      "results": {"reporting_uri": reporting_uri}};
}

इनपुट:

auction_signals और per_buyer_signals को यहां से फ़ेच किया गया है AuctionConfig. ऐसी कोई भी जानकारी जिसे बाय-साइड प्लैटफ़ॉर्म को देना होगा रिपोर्टिंग यूआरएल इस डेटम से आ सकता है.
signals_for_buyer, सेल-साइड रिपोर्ट के नतीजे का आउटपुट है. इससे यह पता चलता है कि सेल-साइड प्लैटफ़ॉर्म, जो बाय-साइड के साथ डेटा शेयर करने का मौका देता है का इस्तेमाल कर सकते हैं.
contextual_signals में ऐप्लिकेशन का नाम और ऐसी जानकारी शामिल है custom_audience_signals में कस्टम ऑडियंस जानकारी शामिल है. किसी और तरह का कॉन्टेंट आने वाले समय में यह जानकारी जोड़ी जा सकती है.

आउटपुट:

स्थिति: सफलता के लिए 0, विफलता के लिए कोई अन्य मान.
रिपोर्टिंग यूआरएल: प्लैटफ़ॉर्म, फ़ंक्शन से मिले इस यूआरएल को लागू करता है.

इवेंट की रिपोर्ट करना

इवेंट की रिपोर्टिंग सिर्फ़ तब की जा सकती है, जब नीलामी के लिए इंप्रेशन की रिपोर्टिंग पूरी हो गई हो. किसी भी इवेंट को रिपोर्ट करने के लिए, सेल-साइड SDK टूल ज़िम्मेदार होता है. कॉन्टेंट बनाने प्लैटफ़ॉर्म एक एपीआई दिखाता है, जो ReportEventRequest को लेता है जो हाल ही में चलाई गई नीलामी, रिपोर्ट की जाने वाली इवेंट कुंजी, वह कुंजी है, भले ही रिपोर्ट खरीदार को भेजी जाए या विक्रेता को (या दोनों) और विज्ञापन इवेंट के लिए एक वैकल्पिक इनपुट इवेंट. क्लाइंट, इवेंट की कुंजी और रिपोर्ट करने के लिए डेटा इकट्ठा करने का तरीका तय करता है.

ReportEventRequest request = new ReportEventRequest(
  AdSelectionId = ad_selection_id,
  event_key = "view"
  event_data = "{ "viewTimeInSeconds" :1 }",
  reporting_destinations =
    FLAG_REPORTING_DESTINATION_SELLER |
      FLAG_REPORTING_DESTINATION_BUYER,
  input_event = clickInputEvent // or null for view
  )

reportEvent(request)

इनपुट:

ad_selection_id, हाल ही में हुई नीलामी का AdSelectionId होना चाहिए AdSelectionOutcome से मिला.
event_key, सेल साइड की तय की गई स्ट्रिंग है, जिसमें इंटरैक्शन इवेंट के बारे में बताया गया है.
event_data एक स्ट्रिंग है, जो event_key
reporting_destinations एक बिट मास्क सेट है, जो प्लैटफ़ॉर्म. यह FLAG_REPORTING_DESTINATION_SELLER या FLAG_REPORTING_DESTINATION_BUYER या दोनों.
input_event (ज़रूरी नहीं) का इस्तेमाल एट्रिब्यूशन रिपोर्टिंग के साथ इंटिग्रेशन के लिए किया जाता है एपीआई. यह क्लिक इवेंट के लिए InputEvent ऑब्जेक्ट या व्यू इवेंट के लिए null होता है. ज़्यादा जानकारी के लिए, Attribution Reporting API का इंटिग्रेशन लेख पढ़ें इस पैरामीटर के बारे में जानकारी.

सेल-साइड SDK टूल की मदद से, reportEvent को शुरू करने के बाद और इसके आधार पर reporting_destinations फ़्लैग, प्लैटफ़ॉर्म event_key का मिलान करने की कोशिश करता है खरीदारों और विक्रेताओं के reportWin में रजिस्टर की गई कुंजियां और reportResult JavaScript फ़ंक्शन. अगर कोई मिलान होता है, तो प्लैटफ़ॉर्म event_data को संबंधित reporting_url से. अनुरोध का कॉन्टेंट किस तरह का है एक सादा टेक्स्ट है, जिसमें मुख्य हिस्सा event_data है. इस अनुरोध की समीक्षा इसलिए की गई है कोशिश करती है और नेटवर्क की गड़बड़ी, सर्वर की गड़बड़ी होने पर, बिना किसी सूचना के काम नहीं करती या अगर कोई मिलती-जुलती कुंजी नहीं मिली.

Attribution Reporting API का इंटिग्रेशन

Protected Audience API से जुड़ी नीलामी में हिस्सा लेने वाले खरीदारों की मदद करने के लिए, हम Protected Audience और एट्रिब्यूशन के लिए, क्रॉस-एपीआई की सुविधा उपलब्ध कराना Reporting API (ARA). इस सुविधा की मदद से, विज्ञापन टेक्नोलॉजी विशेषज्ञ, रीमार्केटिंग की अलग-अलग रणनीतियों में अपने एट्रिब्यूशन की परफ़ॉर्मेंस का आकलन कर सकते हैं. इससे वे यह समझ सकते हैं कि किस तरह की ऑडियंस सबसे ज़्यादा आरओआई देती है.

इस क्रॉस-एपीआई इंटिग्रेशन की मदद से, AdTech ये काम कर सकते हैं:

दोनों के लिए इस्तेमाल किए जाने के लिए यूआरआई का एक की-वैल्यू मैप बनाएं 1) विज्ञापन इंटरैक्शन रिपोर्टिंग और 2) सोर्स रजिस्ट्रेशन.
Protected Audience API से मिलने वाली नीलामी से जुड़े डेटा को, सोर्स-साइड में शामिल करना एग्रीगेट समरी रिपोर्टिंग के लिए की मैपिंग (एट्रिब्यूशन रिपोर्टिंग का इस्तेमाल करके) API) ज़्यादा जानकारी के लिए ARA डिज़ाइन का प्रस्ताव देखें.

जब कोई उपयोगकर्ता किसी विज्ञापन को देखता है या उस पर क्लिक करता है:

सुरक्षित ऑडियंस का इस्तेमाल करके, उन इवेंट इंटरैक्शन की रिपोर्ट करने के लिए इस्तेमाल किए गए यूआरएल से, खरीदार को ज़रूरी डेटा मिलेगा. इस डेटा का इस्तेमाल, Attribution Reporting API के साथ ज़रूरी सोर्स के तौर पर व्यू या क्लिक को रजिस्टर करने के लिए किया जाएगा.
विज्ञापन टेक्नोलॉजी, उस यूआरएल का इस्तेमाल करके CustomAudience (या विज्ञापन के बारे में काम की अन्य जानकारी, जैसे कि विज्ञापन प्लेसमेंट या व्यू की अवधि) पास कर सकती है, ताकि विज्ञापन टेक्नोलॉजी, कैंपेन की कुल परफ़ॉर्मेंस की समीक्षा करते समय, यह मेटाडेटा समरी रिपोर्ट में भेजा जा सके.

सोर्स रजिस्ट्रेशन की सुविधा चालू करना

reportEvent() एक नया वैकल्पिक पैरामीटर InputEvent स्वीकार करेगा. जीत विज्ञापन बीकन रजिस्टर करने वाले खरीदार यह चुन सकते हैं कि किस reportEvent रिपोर्ट को एट्रिब्यूशन रिपोर्टिंग एपीआई के साथ रजिस्टर किए गए सोर्स के तौर पर रजिस्टर किया गया हो. अनुरोध हेडर एट्रिब्यूशन-रिपोर्टिंग-मंज़ूरी दी गई को सभी इवेंट रिपोर्टिंग में जोड़ दिया जाएगा reportEvent() से अनुरोध भेजे गए. ARA हेडर के साथ कोई भी जवाब को ARA के किसी अन्य सोर्स रजिस्ट्रेशन की तरह ही पार्स किया जाएगा यह होगा. Attribution Reporting API की जानकारी देखें और जानें कि कैसे सोर्स यूआरएल रजिस्टर करें.

Android पर ARA, व्यू और क्लिक इवेंट के साथ काम करता है. इसलिए, InputEvents का इस्तेमाल इन दोनों इवेंट के बीच अंतर करने के लिए किया जाता है. ARA सोर्स की तरह तो reportEvent() API, प्लैटफ़ॉर्म से पुष्टि किए गए InputEvent, क्लिक इवेंट के तौर पर. अगर InputEvent मौजूद नहीं है, शून्य या अमान्य है, सोर्स रजिस्ट्रेशन को व्यू माना जाएगा.

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

यूज़र ऐक्टिविटी और कन्वर्ज़न रिपोर्टिंग का उदाहरण

इस उदाहरण में, हम इसे खरीदार के नज़रिए से देखेंगे, जो डेटा को नीलामी, रेंडर किए गए विज्ञापन, और कन्वर्ज़न ऐप्लिकेशन के डेटा से जोड़ने में मदद मिलती है हैं बेमिसाल.

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

वर्कफ़्लो: नीलामी शुरू होने से पहले, खरीदार, सेलर को प्रोग्रामैटिक रीयल-टाइम बिडिंग ("आरटीबी") बिड रिस्पॉन्स को सही तरीके से मेज़र करता हो. आईडी इनमें से किसी भी auctionId जैसे वैरिएबल के तौर पर सेट करें. आईडी को perBuyerSignals के तौर पर पास किया जाता है: auctionConfig और यह खरीदार के बिडिंग लॉजिक में उपलब्ध हो जाता है.

reportWin को लागू करने के दौरान, खरीदार विज्ञापन के रेंडर होने के समय और खास इंटरैक्शन इवेंट (registerAdBeacon()) के लिए, ट्रिगर किए जाने वाले विज्ञापन बीकन को रजिस्टर कर सकता है. किसी विज्ञापन इवेंट के लिए नीलामी के सिग्नल जोड़ने के लिए, auctionId को बीकन यूआरएल के क्वेरी पैरामीटर के तौर पर सेट करें.
विज्ञापन रेंडर होने के दौरान, नीलामी के समय रजिस्टर किए गए बीकन को इवेंट-लेवल के डेटा से ट्रिगर किया जा सकता है या बेहतर बनाया जा सकता है. विक्रेता को reportEvent() और इवेंट-लेवल का डेटा पास करें. प्लैटफ़ॉर्म, खरीदार के रजिस्टर किए गए विज्ञापन बीकन यूआरएल को पिंग करेगा. यह यूआरएल, ट्रिगर किए गए reportEvent() से जुड़ा होगा.
खरीदार इस समय तक Attribution Reporting API के साथ विज्ञापन को रजिस्टर करेगा विज्ञापन बीकन के अनुरोधों का जवाब देने के लिए Attribution-Reporting-Register-Source हेडर. किसी कन्वर्ज़न इवेंट के लिए नीलामी के सिग्नल जोड़ने के लिए, रजिस्टर सोर्स यूआरएल में auctionId सेट करें.

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

मिलता-जुलता वर्कफ़्लो किसी विक्रेता पर लागू होता है, जब उसे एट्रिब्यूशन डेटा के ऐक्सेस की ज़रूरत होती है और सेलर, registerAdBeacon() से भेजने के लिए यूनीक आईडी का भी इस्तेमाल कर सकता है. reportEvent() कॉल में एक डेस्टिनेशन प्रॉपर्टी होती है. इसका इस्तेमाल, खरीदार और सेलर, दोनों को रिपोर्ट भेजने के लिए किया जा सकता है.

AdTech प्लैटफ़ॉर्म से मैनेज किया जाने वाला भरोसेमंद सर्वर

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

इन सर्वर के व्यवहार के बारे में, इस सेक्शन में बाद में बताया गया है. उपयोगकर्ता की जानकारी लीक करते हैं.
सर्वर, दिखने वाले डेटा के आधार पर, पहचान बदलकर दिखने वाली प्रोफ़ाइल नहीं बनाते, इसका मतलब है कि इसे 'भरोसेमंद' होना चाहिए.

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

भरोसेमंद बिडिंग के आधार पर, भरोसेमंद बिडिंग का डेटा फ़ेच करने के लिए, यहां एक सैंपल यूआरएल दिया गया है कस्टम ऑडियंस से मिलने वाला सिग्नल मेटाडेटा:

https://www.kv-server.example/getvalues?keys=key1,key2

सर्वर से मिलने वाला रिस्पॉन्स एक JSON ऑब्जेक्ट होना चाहिए, जिसकी कुंजियां key1, key2 हों, वगैरह. और जिनके मान खरीदार के बोली-प्रक्रिया फ़ंक्शन में उपलब्ध कराए जाएंगे.

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

यहां क्रिएटिव रेंडर यूआरएल के आधार पर, नीलामी में शामिल किए गए क्रिएटिव के बारे में जानकारी फ़ेच करने के लिए, एक सैंपल यूआरएल दिया गया है:

https://www.kv-server.example/getvalues?renderUrls=render_url1,render_url2

सर्वर से मिला रिस्पॉन्स एक JSON ऑब्जेक्ट होना चाहिए, जिसकी कुंजियां यूआरएल रेंडर करती हैं जो अनुरोध में भेजी गई है.

ये सर्वर कई तरह की सुरक्षा देने के लिए, भरोसेमंद तरीके से काम करेंगे और निजता से जुड़े फ़ायदे:

हर कुंजी के लिए, सर्वर की रिटर्न वैल्यू सिर्फ़ इन पर आधारित होती है क्लिक करें.
सर्वर, इवेंट-लेवल की लॉगिंग नहीं करता.
इन अनुरोधों के आधार पर, सर्वर पर कोई अन्य खराब असर नहीं पड़ता.

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

खरीदार और विक्रेता ये ऐसे प्लैटफ़ॉर्म हैं जो Android और वेब पर प्राइवसी सैंडबॉक्स के साथ काम करते हैं.