Topics API: इंटिग्रेशन गाइड

Android के लिए Topics API को, दिलचस्पी के हिसाब से विज्ञापन दिखाने के लिए डिज़ाइन किया गया है. इसके लिए, क्रॉस ऐप्लिकेशन आइडेंटिफ़ायर पर निर्भर नहीं रहना पड़ता.

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

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

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

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

Topics API की मदद से दिलचस्पी के हिसाब से विज्ञापन दिखाते समय कुछ ज़रूरी बातों का ध्यान रखना चाहिए:

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

  • खरीदार और विज्ञापन देने वाले, बिक्री के पक्ष पर निर्भर रहते हैं: विषय का पता लगाने के लिए, बेचने वाले साइड ऐप्लिकेशन और SDK टूल को कम से कम एक epoch के लिए Topics API पर नज़र रखते हुए, अपनी जगह बनानी चाहिए.

शब्दावली

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

गोल

अगर आपके कारोबार के लिए आईबीए अहम है, तो हम चाहते हैं कि आप Topics API का एक वर्शन अपने ऐप्लिकेशन के बिज़नेस केस के हिसाब से चलाएं, ताकि हमें आपके सुझाव मिल सकें और हम एपीआई को बेहतर बनाने में आपकी मदद कर सकें. हम चाहते हैं कि आपके पास डिज़ाइन और डेवलपमेंट पर लगी रोक को हटाने का विकल्प हो, ताकि बीटा वर्शन लॉन्च होने पर आपको विषय मिल सकें.

इस समय, Android डेवलपर प्रीव्यू पर प्राइवसी सैंडबॉक्स के लिए इंटिग्रेशन प्लानिंग के लक्ष्यों में, ये काम किए जा सकते हैं:

सभी विज्ञापन टेक्नोलॉजी के लिए

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

सेल-साइड विज्ञापन टेक्नोलॉजी के लिए

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

खरीदारी के पक्ष में दिखने वाले विज्ञापन से जुड़ी तकनीकों के लिए

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

ज़रूरी शर्तें और सेटअप

Topics API का इस्तेमाल करने के लिए ऐप्लिकेशन डेवलपर, सेलर, और खरीदारों को यह तरीका अपनाना होगा.

एपीआई के बारे में जानें

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

ऐप्लिकेशन के नमूने को सेटअप और उसकी जांच करें

  1. Android Studio में, Android SDK पर प्राइवसी सैंडबॉक्स सेट अप करने के लिए, इस पेज पर दिए गए निर्देशों का पालन करें.
  2. किसी डिवाइस पर विषयों को फिर से पाने का तरीका जानने के लिए, सैंपल ऐप्लिकेशन के Java या Kotlin वर्शन में कोड को चलाएं और चलाएं.
  3. टेस्ट करते समय, नाम और ब्यौरे के लिए ऐप्लिकेशन की जानकारी के साथ एक्सपेरिमेंट करें. इससे यह बदला जा सकता है कि उपयोगकर्ता के डिवाइस पर कैटगरी तय करने वाली सुविधा से कौनसे विषय दिखेंगे.
  4. क्लाइंट एपीआई और डिवाइस पर डेटा की कैटगरी के काम करने के तरीके को समझने के बाद, अपने इंटिग्रेशन को गाइड करने के लिए, नमूने के तौर पर ऐप्लिकेशन का इस्तेमाल करें.

सलाह: अपने ऐप्लिकेशन के लिए दिखाए जाने वाले विषयों के डेटा की उपयोगिता की ध्यान से समीक्षा करें. उन तरीकों की पहचान करें जिनसे आपको लगता है कि किसी डेटा की कैटगरी या अलग-अलग चीज़ों को बेहतर बनाया जा सकता है. अगर आपके पास कैटगरी को बेहतर बनाने के सुझाव हैं, तो सुझाव, शिकायत या राय सबमिट करें.