मोबाइल के लिए Topics API की खास जानकारी

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

सुझाव या राय देना

Topics API के बारे में जानकारी

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

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

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

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

मुख्य सिद्धांत

• विषय ऐसा विषय होता है जिसे लोग आसानी से पढ़ सकते हैं. साथ ही, यह इस उपयोगकर्ता की पसंद का विषय होता है विषय कैटगरी.
• कॉलर, किसी विषय से जुड़ी निगरानी करता है (ऐसा ऐप्लिकेशन या तीसरे पक्ष का SDK टूल जिसे app) अगर कॉलर ने के बारे में बात करेंगे.
• epoch, विषय की गिनती करने की अवधि होती है, जैसे कि एक हफ़्ता.

यह कैसे काम करता है

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

कोड के उदाहरणों के लिए, Topics API की डेवलपर गाइड देखें दिलचस्पी के हिसाब से विज्ञापन दिखाने के लिए, विषयों को फ़ेच करने की सुविधा सेट अप करने का तरीका क्या है. ध्यान दें: एपीआई अभी तक तय नहीं किए गए हैं.

विषयों को पहले से तय ओपन सोर्स कैटगरी से चुना जाता है.

यह प्लैटफ़ॉर्म, विषयों का अनुमान लगाने के लिए क्लासिफ़ायर मॉडल का इस्तेमाल करता है. विषय एपीआई लागू करना और क्लासिफ़ायर का इसके इस्तेमाल को Android का हिस्सा माना जाएगा ओपन सोर्स प्रोजेक्ट है और इसमें समय के साथ सुधार होगा.

उदाहरण के लिए, नीचे दिया गया कोड का उदाहरण, विषय चुनें. यहां इस्तेमाल किए गए एपीआई फ़ाइनल नहीं हैं.

// Initialize the Topics API.
…
topicsFuture = AdvertisingTopicsClient.getTopics();

// Retrieve Topics and use them in Ad request.
Futures.addCallback(
    topicsFuture,
    new FutureCallback<AdvertisingTopicsInfo>() {
        @Override
        public void onSuccess(@Nullable AdvertisingTopicsInfo topicsInfo) {
            // Sanitize Topics result.
            ...
            // Initialize ad request with Topics obtained.
            AdRequest adRequest = AdRequest.initialize(topicsInfo);
        }

        @Override
        public void onFailure(Throwable t) {
            // Handle error.
            ...
        }
});

डेटा की कैटगरी तय करने वाले मॉडल के काम करने के तरीके को बेहतर तरीके से समझने के लिए, Android Topics Classifier का इस्तेमाल करके, सिस्टम में ऐप्लिकेशन का अलग-अलग डेटा किस तरह प्रतिक्रिया करता है Colab.

Topics API का ऐक्सेस पाएं

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

जानकारी

• हर epoch का विषय, जैसे कि हफ़्ते में एक बार, उपयोगकर्ता के सबसे अहम पांच विषयों का हिसाब लगाया जाता है उपयोगकर्ता के डिवाइस पर सेव किया गया डेटा ऐक्सेस कर सकता है.

  • Topics API को कॉल करने पर, प्लैटफ़ॉर्म यह जांच करेगा कि कोई विषय एपीआई शुरू करने वाले ऐप्लिकेशन को असाइन किया गया है. अगर कोई असाइन नहीं किया गया है, तो इनमें से एक विषय को नीचे बताए गए तरीके से चुना जाएगा और चुना गया विषय इस epoch के लिए, इस ऐप्लिकेशन को असाइन किया गया है.
    • 95% संभावना के साथ, कोई विषय उस युग के लिए हिसाब से टॉप 5 विषयों का डेटा इकट्ठा किया जा सकता है.
    • 5% संभावना के साथ, टेक्सॉनमी में से किसी भी विषय को बिना किसी क्रम के चुना जाता है.
    • कॉल करने वाला (कॉलर) बता सकता है कि वह पैरामीटर का इस्तेमाल करके, getTopics को कॉल करके स्थिति में बदलाव करना shouldRecordObservation = false. इसका मतलब है कि विषय वापस किया गया, लेकिन कॉल को साप्ताहिक Epoch में शामिल नहीं किया जाएगा साथ ही, न ही इसके लिए मॉनिटर किए गए विषयों की सूची को अपडेट करेगा कॉलर है.
  • हर ऐप्लिकेशन को कई विषयों में से एक बनाए जाने की वजह यह पक्का करना है कि अलग-अलग ऐप्लिकेशन को अलग-अलग विषय मिलते हैं. इससे ऐप्लिकेशन के लिए यह मुश्किल हो जाता है का इस्तेमाल करें.
    • उदाहरण के लिए, ऐप्लिकेशन A को उपयोगकर्ता के लिए विषय T1 दिख सकता है, लेकिन ऐप्लिकेशन B दिख सकता है T2 विषय देखें. इससे दोनों ऐप्लिकेशन के लिए, यह काम करना और भी मुश्किल हो जाता है यह पक्का करना ज़रूरी है कि यह जानकारी उसी उपयोगकर्ता की है.

• Topics API ज़्यादा से ज़्यादा तीन विषयों की सूची दिखाता है. पहले के तीन विषयों में से हर एक के लिए एक विषय होता है epochs.

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

• Topics API को शुरू करने वाले ऐप्लिकेशन को किसी विषय को असाइन करने के बाद, प्लैटफ़ॉर्म यह तय करेगा कि कॉलर को यह विषय मिलेगा या नहीं.

  • सिर्फ़ ऐसे कॉलर जिन्होंने पिछले 3 युगों में से जिस विषय पर चर्चा हो रही है, वह उसे मिल सकता है.
  • अगर कॉल करने वाले (कॉलर) ने पहले किसी ऐप्लिकेशन पर उस उपयोगकर्ता के लिए एपीआई को कॉल नहीं किया था तो वह विषय सूची में शामिल नहीं किया जाएगा एपीआई से मिला.
  • अगर कॉल करने वाले (कॉलर) को पिछले तीन एपिसोड में कोई विषय नहीं मिला है, तो Topics API एक खाली सूची दिखाएगा.

  उदाहरण के लिए, मान लें कि उपयोगकर्ता ने डिवाइस पर सात ऐप्लिकेशन इंस्टॉल किए हैं: A, B, C, D, E, एफ़ और जी॰ मान लें कि ऐप्लिकेशन और विज्ञापन के लिए, विषय का क्लासिफ़िकेशन इन ऐप्लिकेशन में मौजूद SDK टूल इस तरह के होते हैं:

  ऐप्लिकेशन	विषय की कैटगरी तय करना	AdTech SDK टूल
  A	टी1, टी5	ad-sdk1, ad-sdk2
  B	T2	विज्ञापन-SDK2
  C	टी3, टी6	ad-sdk3, ad-sdk4
  D	टी1, टी4	विज्ञापन-SDK1
  E	T5	ad-sdk4, ad-sdk5
  F	T6	ad-sdk2, ad-sdk3, ad-sdk4
  G	T7	विज्ञापन-SDK2

  • पहले हफ़्ते का आखिरी हिस्सा: Topics API, इसके लिए उपयोगकर्ता के लिए सबसे लोकप्रिय पांच विषयों को जनरेट करता है Epoch का इस्तेमाल किया जा सकता है.

  मुख्य विषय	किसी विषय के बारे में जानने वाले कॉलर
  T1	ad-sdk1, ad-sdk2
  T2	विज्ञापन-SDK2
  T3	ad-sdk3, ad-sdk4
  T4	विज्ञापन-SDK1
  T5	ad-sdk1, ad-sdk2, ad-sdk4, ad-sdk5

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

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

टेक्सॉनमी

• मौजूदा प्रस्ताव में, शुरुआती टेक्सॉनमी में कुछ सौ और कुछ हज़ार विषय. शुरुआती टेक्सॉनमी प्रपोज़ल इसे इस दस्तावेज़ के आने वाले अपडेट में शेयर किया जाएगा.
• इसे मैन्युअल तरीके से बनाया जाएगा, ताकि संवेदनशील विषय टेक्सॉनमी.
• यह टेक्सॉनमी, विज्ञापनों की उन कैटगरी के हिसाब से बनाई जाएगी जिन पर विज्ञापन दिखाए जा सकते हैं मोबाइल ऐप्लिकेशन पर उपलब्ध है.
• कैटगरी सार्वजनिक रूप से उपलब्ध है और इसमें बदलाव हो सकता है. इस पेज में सबसे ऊपर मौजूद, 'सुझाव/राय दें या शिकायत करें' बटन का इस्तेमाल करके, सुझाव सबमिट किए जा सकते हैं.

विषय की कैटगरी तय करने वाला

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

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

उपयोगकर्ता नियंत्रण

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

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

//Button that launches settings UI
private Button mSettingsAppButton;
private static final String RB_SETTING_APP_INTENT = "android.adservices.ui.SETTINGS";


//Does setup for button on screen that will launch settings UI to observe Topics
private void registerLaunchSettingsAppButton() {
    mSettingsAppButton.setOnClickListener(
        new View.OnClickListener() {

            @Override
            public void onClick(View view) {
                Context context = getApplicationContext();
                Intent activity2Intent = new Intent(RB_SETTING_APP_INTENT);
                activity2Intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                context.startActivity(activity2Intent);
            }
        });
}

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

Topics API ऐक्सेस करने के लिए, विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाले सभी प्लैटफ़ॉर्म (Google के प्लैटफ़ॉर्म भी) को यह करना होगा रजिस्ट्रेशन की प्रक्रिया पूरी करें.

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

लौटाए गए विषयों को एन्क्रिप्ट (सुरक्षित) करने की सुविधा

रजिस्टर किए गए विज्ञापन टेक्नोलॉजी से जुड़े जो प्लैटफ़ॉर्म Topics API को कॉल करते हैं उन्हें भी यह जानकारी देनी होगी एन्क्रिप्शन कुंजियों का इस्तेमाल कर यह सुनिश्चित किया जा सकता है कि लौटाए गए विषय सिर्फ़ कॉलर है.

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

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

एन्क्रिप्ट (सुरक्षित) करने के तरीके की जानकारी

एन्क्रिप्ट (सुरक्षित) करने की सुविधा के लॉन्च होने के बाद, 'GetTopics()' को कॉल किया जाएगा अब एक जनरेट करेगा 'एन्क्रिप्ट किए गए विषय' की सूची के साथ जवाब ऑब्जेक्ट हैं. इन नतीजों को डिक्रिप्ट करने पर नतीजे के तौर पर किसी ऐसे ऑब्जेक्ट का इस्तेमाल करें जिसका JSON फ़ॉर्मैट, पिछले विषय के ऑब्जेक्ट से मिलता-जुलता हो.

Topics API, HPKE (हाइब्रिड पब्लिक की) को एक ही बार में लागू करने की सुविधा देता है एन्क्रिप्ट (सुरक्षित) करने का तरीका). हम चाहते हैं कि रजिस्टर किया गया कॉलर, 32-बिट वाली सार्वजनिक कुंजी रजिस्टर करने के दौरान, सार्वजनिक तौर पर एन्क्रिप्ट (सुरक्षित) करने का यूआरएल एंडपॉइंट दिया गया. ये कुंजियां, ऐसा होना चाहिए कि Base64 कोड में बदला गया हो.

EncryptedTopic के ऑब्जेक्ट में तीन फ़ील्ड होते हैं. वापस किए गए विषयों की सूची सार्वजनिक कुंजी के लिए संबंधित निजी कुंजी का उपयोग करके प्राप्त किया जाता है.

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