हाल ही के अपडेट
- कस्टम ऑडियंस अपडेट शेड्यूल करने के बारे में जानकारी जोड़ी गई
- Protected Audience के साथ एट्रिब्यूशन रिपोर्टिंग इंटिग्रेशन जोड़ा गया
- 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 की तीसरी तिमाही | साल 2024 की चौथी तिमाही |
खास जानकारी
मोबाइल विज्ञापनों में, विज्ञापन देने वालों को आम तौर पर इस आधार पर कि संभावित रूप से उपयोगकर्ताओं में दिलचस्पी पैदा करने वाले उपयोगकर्ता, विज्ञापन देने वाले के ऐप्लिकेशन पर. उदाहरण के लिए, हो सकता है कि SportingGoodsApp का डेवलपर शॉपिंग कार्ट में आइटम बचे रहने वाले उपयोगकर्ताओं को विज्ञापन दिखाकर लोगों को खरीदारी पूरी करने के लिए याद दिला सकते हैं. आम तौर पर, यह इंडस्ट्री "रीमार्केटिंग" जैसे शब्दों वाला सामान्य सुझाव और "कस्टम ऑडियंस टारगेटिंग".
आज-कल, इस्तेमाल के ये उदाहरण आम तौर पर, विज्ञापन दिखाने के तरीके (जैसे कि ऐप्लिकेशन का नाम) और निजी के बारे में जानकारी जैसे, विज्ञापन टेक्नोलॉजी से जुड़े प्लैटफ़ॉर्म की ऑडियंस की सूची. इसका इस्तेमाल करके जानकारी के आधार पर, विज्ञापनदाता अपने सर्वर पर प्रासंगिक विज्ञापन चुन सकते हैं.
Android पर Protected Audience API (पहले इसे FLEDGE के नाम से जाना जाता था) में विज्ञापन टेक्नोलॉजी से जुड़े प्लैटफ़ॉर्म और विज्ञापन देने वाले लोगों या कंपनियों के लिए, नीचे दिए गए एपीआई इंटरैक्शन के आधार पर इस्तेमाल के ऐसे उदाहरण जो दोनों आइडेंटिफ़ायर को शेयर करने की सीमा तय करते हों और तीसरे पक्षों के साथ उपयोगकर्ता के ऐप्लिकेशन इंटरैक्शन की जानकारी:
- कस्टम ऑडियंस एपीआई: यह "कस्टम ऑडियंस" ऐब्स्ट्रक्शन, जो विज्ञापन देने वाले की ओर से तय किए गए को दिखाता है एक जैसी सोच रखने वाले दर्शकों से. ऑडियंस की जानकारी, डिवाइस पर सेव की जाती है और उसे ऑडियंस के लिए, काम के कैंडिडेट विज्ञापनों से जोड़ा जा सकता है. साथ ही, मेटाडेटा, जैसे कि बिडिंग सिग्नल. जानकारी का इस्तेमाल, आपको सूचना देने के लिए किया जा सकता है विज्ञापन फ़िल्टर करने की सुविधा, और रेंडरिंग के बारे में खास जानकारी.
- Ad Select API: यह ऐसा फ़्रेमवर्क उपलब्ध कराता है जो ऑर्केस्ट्रेट ऐड टेक प्लैटफ़ॉर्म' उपयोगकर्ता के डिवाइस पर मौजूद सिग्नल का इस्तेमाल करने वाले वर्कफ़्लो "विनिंग" तय करते हैं स्थानीय तौर पर सेव किए गए उम्मीदवार के विज्ञापनों को ध्यान में रखकर विज्ञापन बनाना और कैंडिडेट के विज्ञापनों को बेहतर तरीके से प्रोसेस करना, जैसे कि AdTech प्लैटफ़ॉर्म डिवाइस पर वापस चला जाता है.
हाई लेवल पर इंटिग्रेशन इस तरह काम करता है:
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 कॉल भेजा जाएगा.
खरीदार की पहचान, eTLD+1 से ली जाती है. ऐसा ज़रूरी नहीं है कि
यह साफ़ तौर पर बताया जाता है और अपडेट के बाद इसे बदला नहीं जा सकता. जीईटी
अनुरोध में ऐसे JSON ऑब्जेक्ट की ज़रूरत है जिसमें
customAudience
ऑब्जेक्ट की सूची हो वापसी. - DelayTime: समय
अपडेट शेड्यूल करने के लिए,
scheduleCustomAudienceUpdate()
एपीआई कॉल.
PartialCustomAudience: यह एपीआई, डिवाइस पर मौजूद SDK टूल को सूची भेजने की भी अनुमति देता है पूरी तरह से नहीं बनीं कस्टम ऑडियंस. इससे, इन-ऐप्लिकेशन SDK टूल इस्तेमाल किए जा सकते हैं कस्टम ऑडियंस मैनेजमेंट पर पूरी से कुछ हद तक कंट्रोल पर आधारित है.
- ऐसा करने से, यह एपीआई
fetchAndJoinCustomAudience()
के साथ भी काम करता है एपीआई की मदद से, मिलती-जुलती जानकारी शेयर की जा सकती है.
- ऐसा करने से, यह एपीआई
ShouldReplacePendingUpdates: बूलियन जो तय करता है कि कोई मंज़ूरी बाकी है या नहीं शेड्यूल किए गए अपडेट रद्द कर दिए जाने चाहिए और उन्हें मौजूदा
ScheduleCustomAudienceUpdateRequest
. अगर यहfalse
और पर सेट किया जाता है इस इसी ऐप्लिकेशन के साथ,scheduleCustomAudienceUpdate
पर कॉल करने की सुविधाScheduleCustomAudienceUpdateRequest
इस्तेमाल नहीं किया जा सकेगा. डिफ़ॉल्ट तौर पर, यहfalse
पर सेट होती है.
ऐप्लिकेशन अनुमतियां और कंट्रोल
इस प्रस्ताव का मकसद, ऐप्लिकेशन को अपनी पसंद के मुताबिक ऑडियंस पर कंट्रोल देना है:
- कोई ऐप्लिकेशन, पसंद के मुताबिक ऑडियंस के साथ अपने असोसिएशन को मैनेज कर सकता है.
- ऐप्लिकेशन, विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाले तीसरे पक्ष के प्लैटफ़ॉर्म को अपनी ज़रूरत के मुताबिक अपनी ओर से ऑडियंस को एक्सपोर्ट किया जा सकता है.
इस सुविधा के डिज़ाइन पर काम चल रहा है. ब्यौरे में बाद के अपडेट में शामिल किया गया है.
विज्ञापन टेक्नोलॉजी प्लैटफ़ॉर्म का कंट्रोल
इस प्रस्ताव में बताया गया है कि विज्ञापन टेक्नोलॉजी से जुड़ी कंपनियां, अपनी पसंद के मुताबिक ऑडियंस को कैसे कंट्रोल कर सकती हैं:
- AdTech की सेवाएं, प्राइवसी सैंडबॉक्स के साथ रजिस्टर करती हैं और एक eTLD+1 डोमेन उपलब्ध कराती हैं, जो यह कस्टम ऑडियंस के सभी यूआरएल से मेल खाता है.
- विज्ञापन टेक्नोलॉजी, ऐप्लिकेशन या SDK टूल के साथ साझेदारी करके, पुष्टि करने के लिए ऐसे टोकन उपलब्ध करा सकती हैं का इस्तेमाल कस्टम ऑडियंस बनाने की पुष्टि करने के लिए किया जाता है. जब यह प्रोसेस किसी पार्टनर, कस्टम ऑडियंस बनाने की सुविधा को इस तरह कॉन्फ़िगर किया जा सकता है कि से बचा जा सकता है.
- विज्ञापन टेक्नोलॉजी, अपनी ओर से
joinCustomAudience
कॉल को बंद करने का विकल्प चुन सकती है साथ ही, यह कस्टम कॉल सिर्फ़fetchAndJoinCustomAudience
एपीआई को चालू करने की अनुमति देता है ऑडियंस. प्राइवसी सैंडबॉक्स में रजिस्टर करने के दौरान, कंट्रोल को अपडेट किया जा सकता है. ध्यान दें: नियंत्रण या तो सभी विज्ञापन तकनीक को अनुमति देता है या किसी को भी नहीं. प्लैटफ़ॉर्म की सीमाओं की वजह से, ऐक्सेस देने की अनुमतियां, विज्ञापन की टेक्नोलॉजी के हिसाब से नहीं हो सकतीं.
उम्मीदवार के विज्ञापन और मेटाडेटा के जवाब
बाय-साइड प्लैटफ़ॉर्म से लौटाए गए उम्मीदवार के विज्ञापनों और मेटाडेटा में, ये फ़ील्ड शामिल होते हैं:
- मेटाडेटा: बाय-साइड, विज्ञापन तकनीक से जुड़ी खास विज्ञापनों का मेटाडेटा. उदाहरण के लिए, यह हो सकता है उसमें विज्ञापन कैंपेन की जानकारी और टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) मानदंड जैसे जगह और भाषा.
- रेंडर यूआरएल: विज्ञापन क्रिएटिव को रेंडर करने के लिए एंडपॉइंट.
- फ़िल्टर: Protected Audience API से जुड़ी ज़रूरी जानकारी, ताकि डिवाइस के डेटा के आधार पर विज्ञापन फ़िल्टर कर सकते हैं. ज़्यादा जानकारी के लिए, खरीदें साइड फ़िल्टर करने का लॉजिक.
विज्ञापन चुनने का वर्कफ़्लो
इस प्रस्ताव का मकसद, विज्ञापन चुनने की सुविधा देकर निजता को बेहतर बनाना है एपीआई, जो विज्ञापन टेक्नोलॉजी से जुड़े प्लैटफ़ॉर्म के लिए नीलामी की प्रोसेस को पूरा करता है.
आज-कल विज्ञापन टेक्नोलॉजी से जुड़े प्लैटफ़ॉर्म, खास तौर पर बिडिंग और विज्ञापन चुनते हैं ट्रैक करने में मदद मिलती है. इस प्रस्ताव के साथ, कस्टम ऑडियंस और दूसरे संवेदनशील उपयोगकर्ता इंस्टॉल किए गए पैकेज की उपलब्ध जानकारी जैसे सिग्नल ऐक्सेस किए जा सकेंगे सिर्फ़ विज्ञापन चुनने वाले एपीआई के ज़रिए ऐसा किया जा सकता है. इसके अलावा रीमार्केटिंग के इस्तेमाल के उदाहरण के लिए भी उम्मीदवार के विज्ञापनों को बैंड से बाहर लाया जाएगा (यानी कि उस संदर्भ में नहीं जिसमें विज्ञापन दिखाए जाते हैं) दिखाए जाएंगे). विज्ञापन टेक्नोलॉजी से जुड़े प्लैटफ़ॉर्म को विज्ञापन दिखाने के लिए, विज्ञापन देने वाले लोगों या कंपनियों की मौजूदा नीलामी और विज्ञापन चुनने का लॉजिक, डिवाइस. विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाले प्लैटफ़ॉर्म, विज्ञापन में ये बदलाव कर सकते हैं चुनने का वर्कफ़्लो:
- इंस्टॉल किए गए पैकेज की जानकारी सर्वर पर उपलब्ध न होने पर, AdTech ऐसा हो सकता है कि प्लैटफ़ॉर्म, डिवाइस पर काम के कई विज्ञापन वापस भेजना चाहें और ऐप्लिकेशन इंस्टॉल के आधार पर फ़िल्टर करने की सुविधा को चालू करने के लिए, विज्ञापन चुनने का वर्कफ़्लो शुरू करें का इस्तेमाल करें.
- रीमार्केटिंग विज्ञापन बैंड से बाहर निकाले जाते हैं, इसलिए मौजूदा बोली लगाने के मॉडल अपडेट करने की ज़रूरत है. ऐसा हो सकता है कि विज्ञापन टेक्नोलॉजी से जुड़े प्लैटफ़ॉर्म, बिडिंग सब-मॉडल बनाना चाहें (लागू होने की वजह, टू-टावर मॉडल) जो विज्ञापन सुविधाओं और संदर्भ के हिसाब से सिग्नल पर अलग-अलग काम कर सकती हैं. साथ ही, बिड का अनुमान लगाने के लिए, डिवाइस पर मौजूद सब-मॉडल आउटपुट. इससे दोनों को फ़ायदा हो सकता है किसी खास विज्ञापन अवसर के लिए, सर्वर-साइड नीलामियां और नीलामियां.
इस तरीके से, उपयोगकर्ता के ऐप्लिकेशन इंटरैक्शन का डेटा जानकारी के आधार पर चुना जाता है. साथ ही, डेटा शेयर करने की सुविधा को तीसरे पक्ष के साथ सीमित कर दिया जाएगा.
विज्ञापन चुनने का यह वर्कफ़्लो, उपयोगकर्ता के डिवाइस पर यह तय करता है कि विज्ञापन तकनीक से मिला JavaScript कोड नीचे दिया गया क्रम:
- बाय-साइड बिडिंग के लॉजिक को लागू करना
- बाय-साइड विज्ञापन फ़िल्टर करना और प्रोसेस करना
- सेल-साइड के फ़ैसले वाले लॉजिक को लागू करना
जिन विज्ञापन चयनों में कस्टम ऑडियंस शामिल हैं, उनके लिए प्लैटफ़ॉर्म इसकी ओर से तय किए गए सार्वजनिक यूआरएल एंडपॉइंट के आधार पर, साइड से दिया गया JavaScript कोड खरीदें कस्टम ऑडियंस का "बिडिंग लॉजिक यूआरएल" मेटाडेटा. इसके लिए यूआरएल एंडपॉइंट सेल-साइड डिसिज़न कोड को भी शुरुआत करने के लिए, इनपुट के तौर पर पास किया जाएगा विज्ञापन को चुनने के वर्कफ़्लो को तय करता है.
ऐसे विज्ञापन चयनों का डिज़ाइन सक्रिय है जिनमें कस्टम ऑडियंस शामिल नहीं हैं डिज़ाइन.
विज्ञापन चुनने का वर्कफ़्लो शुरू करें
जब किसी ऐप्लिकेशन को विज्ञापन दिखाने की ज़रूरत होती है, तो विज्ञापन टेक्नोलॉजी प्लैटफ़ॉर्म SDK टूल, विज्ञापन शुरू कर सकता है
इंस्टैंशिएट करने के बाद, selectAds()
तरीके को कॉल करके चुनने का वर्कफ़्लो
सही पैरामीटर के साथ AdSelectionConfig
ऑब्जेक्ट:
- सेलर: eTLD+1 के बाद, सेल-साइड विज्ञापन प्लैटफ़ॉर्म के लिए आइडेंटिफ़ायर फ़ॉर्मैट
- डिसिज़न लॉजिक यूआरएल: जब विज्ञापन नीलामी शुरू होती है, तब प्लैटफ़ॉर्म इस यूआरएल में, सेल-साइड प्लैटफ़ॉर्म से JavaScript कोड को फ़ेच किया जाएगा. जीतने वाला विज्ञापन.
- कस्टम ऑडियंस खरीदार: कस्टम ऑडियंस के साथ बाय-साइड प्लैटफ़ॉर्म की सूची eTLD+1 फ़ॉर्मैट के हिसाब से, इस नीलामी के लिए ऑडियंस की मांग.
- विज्ञापन चुनने के सिग्नल: नीलामी के बारे में जानकारी (विज्ञापन का साइज़, विज्ञापन फ़ॉर्मैट वगैरह).
- सेलर के सिग्नल: साइड प्लैटफ़ॉर्म से जुड़े सिग्नल उपलब्ध कराएं.
- भरोसेमंद स्कोरिंग सिग्नल का यूआरएल: सेल-साइड के भरोसेमंद सिग्नल का यूआरएल एंडपॉइंट किस क्रिएटिव से रीयल टाइम जानकारी मिल सकती है.
- हर खरीदार के सिग्नल: मांग में हिस्सा लेने वाले पक्ष, इन कामों के लिए इस पैरामीटर का इस्तेमाल कर सकते हैं हम नीलामी के लिए इनपुट देते हैं. उदाहरण के लिए, इस पैरामीटर में बिड तय करने में मदद करने वाली, काम की पूरी जानकारी दें.
उदाहरण के तौर पर दिया गया यह कोड स्निपेट, AdTech प्लैटफ़ॉर्म के 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, आपकी यूआरएल एंडपॉइंट, जहां से यह रीयल-टाइम डेटा और कुंजियों का सेट फ़ेच किया जा सकता है जिसके लिए रीयल-टाइम लुकअप करना होगा. AdTech प्लैटफ़ॉर्म इस अनुरोध को पूरा करने वाला प्रबंधित सर्वर एक भरोसेमंद सर्वर होगा, जिसे AdTech प्लैटफ़ॉर्म पर.
- काम के सिग्नल: इसमें अनुमानित टाइमस्टैंप या अनुमानित टाइमस्टैंप शामिल हो सकते हैं या विज्ञापन पर हर क्लिक की लागत (सीपीसी) तय करें.
- उपयोगकर्ता सिग्नल: इसमें, इंस्टॉल किए गए ऐप्लिकेशन के तौर पर उपलब्ध जानकारी शामिल हो सकती है पैकेज जानकारी देखें.
विज्ञापन की लागत
बिड के अलावा, बाय-साइड प्लैटफ़ॉर्म के पास लागत लौटाने का विकल्प भी होता है
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 के लिए उपलब्ध अतिरिक्त डिवाइस के सिग्नल के आधार पर फ़िल्टर किया जाना चाहिए दर्शक, डिवाइस पर ही रहेंगे. जैसे-जैसे हम कंपनी के मालिकाना हक वाले कॉन्टेंट को विज्ञापन को फ़िल्टर करने की एक अन्य वजह, बाय-साइड प्लैटफ़ॉर्म भी इसी स्ट्रक्चर का पालन करेंगे ताकि फ़िल्टर किया जा सके.
सेल-साइड स्कोरिंग लॉजिक
आम तौर पर, स्कोरिंग लॉजिक, सेल-साइड प्लैटफ़ॉर्म उपलब्ध कराता है. मकसद
इस कोड का मतलब बिडिंग लॉजिक आउटपुट के आधार पर, जीतने वाले विज्ञापन का पता लगाना है. यह हो सकता है
नतीजा तय करने के लिए, अतिरिक्त कारोबारी नियम लागू करें. अगर एक से ज़्यादा
डिसिज़न लॉजिक प्रोवाइडर, सिस्टम एक्ज़िक्यूशन सीक्वेंस की गारंटी नहीं देता.
उपलब्ध कराता है. प्लैटफ़ॉर्म, "डिसिज़न लॉजिक यूआरएल" का इस्तेमाल करेगा इनपुट
वह 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 में लिखा जाना चाहिए. इससे विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाले प्लैटफ़ॉर्म, बिडिंग कोड को इनके बीच शेयर कर सकते हैं: जो प्राइवसी सैंडबॉक्स के साथ काम करते हैं.
विजेता विज्ञापन रेंडरिंग
सबसे ज़्यादा स्कोर वाले विज्ञापन को नीलामी का विजेता माना जाता है. इसमें शुरुआत में, जीतने वाले विज्ञापन को रेंडरिंग के लिए 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
ऑब्जेक्ट (क्लिक इवेंट के लिए) या शून्य है (व्यू इवेंट के लिए). ज़्यादा जानकारी के लिए, 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 डिज़ाइन का प्रस्ताव देखें.
जब कोई उपयोगकर्ता किसी विज्ञापन को देखता है या उस पर क्लिक करता है:
- Protected Audience का इस्तेमाल करके, इवेंट के साथ हुए इंटरैक्शन की रिपोर्ट करने के लिए इस्तेमाल किया जाने वाला यूआरएल खरीदार को वह ज़रूरी डेटा उपलब्ध कराना जिसका इस्तेमाल करके, व्यू या क्लिक को रजिस्टर किया जा सके 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 हों, वगैरह. और जिनके मान खरीदार के बोली-प्रक्रिया फ़ंक्शन में उपलब्ध कराए जाएंगे.
सेल साइड: ऊपर दिए गए खरीदारी के साइड फ़्लो की तरह ही, सेल साइड को फ़ेच किया जा सकता है नीलामी में विचार किए गए क्रिएटिव के बारे में जानकारी. उदाहरण के लिए, किसी पब्लिशर को यह लागू करने की अनुमति दे सकते हैं कि कुछ क्रिएटिव ब्रैंड सुरक्षा से जुड़ी चिंताएं. यह जानकारी फ़ेच की जा सकती है और सेल साइड नीलामी लॉजिक. खरीदें साइड भरोसेमंद सर्वर लुकअप की तरह ही, बेचें साइड भरोसेमंद सर्वर लुकअप, एचटीटीपी फ़ेच के ज़रिए भी होता है. इस यूआरएल से बनाया गया यूआरएल क्रिएटिव के रेंडर यूआरएल के साथ भरोसेमंद स्कोरिंग सिग्नल का यूआरएल जोड़कर जिसके लिए डेटा फ़ेच करना पड़ता है.
नीचे एक सैंपल यूआरएल दिया गया है, ताकि आप नीलामी, क्रिएटिव रेंडर URL के आधार पर की जाती है:
https://www.kv-server.example/getvalues?renderUrls=render_url1,render_url2
सर्वर से मिला रिस्पॉन्स एक JSON ऑब्जेक्ट होना चाहिए, जिसकी कुंजियां यूआरएल रेंडर करती हैं जो अनुरोध में भेजी गई है.
ये सर्वर कई तरह की सुरक्षा देने के लिए, भरोसेमंद तरीके से काम करेंगे और निजता से जुड़े फ़ायदे:
- हर कुंजी के लिए, सर्वर की रिटर्न वैल्यू सिर्फ़ इन पर आधारित होती है क्लिक करें.
- सर्वर, इवेंट-लेवल पर लॉग इन नहीं करता.
- इन अनुरोधों के आधार पर, सर्वर पर कोई अन्य खराब असर नहीं पड़ता.
कुछ समय के लिए, खरीदार और विक्रेता इन बिडिंग को फ़ेच कर सकते हैं किसी भी सर्वर के सिग्नल का इस्तेमाल कर सकते हैं. इनमें वह सर्वर भी शामिल है जिसे वे खुद ऑपरेट करते हैं. हालांकि, वर्शन रिलीज़ करते समय, अनुरोध सिर्फ़ भरोसेमंद की-वैल्यू-टाइप को भेजा जाएगा सर्वर.
खरीदार और विक्रेता ये ऐसे प्लैटफ़ॉर्म हैं जो Android और वेब पर प्राइवसी सैंडबॉक्स के साथ काम करते हैं.