Android के लिए प्राइवसी सैंडबॉक्स का इस्तेमाल शुरू करें

Android के बीटा प्रोग्राम पर मौजूद प्राइवसी सैंडबॉक्स, स्थायी एपीआई उपलब्ध कराता है. हम 2023 में कई बीटा वर्शन रिलीज़ करने के बारे में सोच रहे हैं. बीटा प्रोग्राम की रिलीज़ का इस्तेमाल करके, Android 13 वाले मोबाइल डिवाइसों पर सीमित प्रोडक्शन टेस्टिंग से जुड़े समाधान बनाए और उनकी जांच की जा सकती है. हम कुछ डिवाइसों पर काम करना शुरू करेंगे और समय के साथ इनकी संख्या बढ़ाएंगे. इसमें हिस्सा लेने के लिए, संगठन कुछ डिवाइसों के ऐक्सेस का अनुरोध कर सकते हैं. साथ ही, Privacy Sandbox API का इस्तेमाल करने वाले ऐप्लिकेशन को रजिस्टर कर सकते हैं.

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

बीटा रिलीज़ का इस्तेमाल करने के लिए, डेवलपर को एपीआई लेवल 33 SDK एक्सटेंशन अपडेट के साथ अपने समाधानों को कंपाइल करना होगा.

Android SDK के एक्सटेंशन

बीटा रिलीज़ में स्थायी एपीआई डिलीवर करने के लिए, Android SDK एक्सटेंशन रिलीज़ करने के नए तरीके का इस्तेमाल किया जाता है. रिलीज़ का यह तरीका मुख्य रिलीज़ के बीच Android की स्थिर सुविधाओं को रिलीज़ करता है. इसमें वर्शन का एक नया तरीका है जो Google Play सिस्टम अपडेट का इस्तेमाल करके कई एपीआई लेवल पर ऐप्लिकेशन के लिए नए एपीआई उपलब्ध कराता है. Android SDK एक्सटेंशन पर प्राइवसी सैंडबॉक्स को विज्ञापन सेवाओं के एक्सटेंशन कहा जाता है. Android SDK एक्सटेंशन के बारे में ज़्यादा जानें.

शुरू करें

शुरू करने के लिए, नीचे दिया गया तरीका अपनाएं:

पहला चरण: बीटा प्रोग्राम के लिए रजिस्टर और रजिस्टर करना

  • नाम रजिस्टर करें: विज्ञापन से जुड़े एपीआई इस्तेमाल करने के लिए रजिस्ट्रेशन की प्रक्रिया पूरी करें.
  • रजिस्टर करें: बीटा प्रोग्राम में शामिल होने के लिए, आपको register ज़रूरी है. रजिस्टर करने पर, ये काम किए जा सकते हैं:
    • इंंटरनल टेस्टिंग के लिए, अपने डिवाइसों को चालू करें.
    • Google Play Store पर पब्लिश किए गए ऐसे ऐप्लिकेशन की संख्या तय करें जो निजता बनाए रखने वाले एपीआई को सीधे तौर पर इंटिग्रेट कर सकें या एपीआई का इस्तेमाल करने वाले SDK टूल को इंटिग्रेट कर सकें.
    • Google Play Store का इस्तेमाल करके, रनटाइम के साथ काम करने वाले SDK टूल के डिस्ट्रिब्यूशन की जांच करें. अगर आपको सिर्फ़ डिवाइस पर SDK टूल का रनटाइम टेस्ट करने की ज़रूरत है, तो इस चरण की ज़रूरत नहीं है.

दूसरा चरण: अपना डेवलपमेंट एनवायरमेंट सेट अप करना

Android Studio में, Android SDK टूल पर प्राइवसी सैंडबॉक्स सेट अप करें.

तीसरा चरण: AdServices की अनुमतियां कॉन्फ़िगर करना

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

चौथा चरण: डिवाइस या एम्युलेटर की इमेज सेट अप करें

एंड-टू-एंड टेस्टिंग के लिए, आपको ऐसे Android 13 डिवाइस का इस्तेमाल करना होगा जिस पर यह सुविधा काम करती है या SDK टूल के सही एक्सटेंशन के लिए, एम्युलेटर इमेज का इस्तेमाल करें.

पांचवां चरण: Android पर प्राइवसी सैंडबॉक्स का इस्तेमाल करने के लिए, डिवाइसों को कॉन्फ़िगर करना

डिवाइसों पर चलाने के लिए, Android पर प्राइवसी सैंडबॉक्स को चालू (या बंद) करने के लिए, सेटिंग कॉन्फ़िगर करें.

जानी-पहचानी समस्याओं को हल करना

Android 12 और इससे पहले के वर्शन वाले डिवाइसों पर पीपी एपीआई इंटिग्रेशन से जुड़ी समस्याओं से बचने के लिए, Android 12 और इससे पहले के वर्शन वाले डिवाइसों के लिए, विज्ञापन सेवाओं के एपीआई इंटिग्रेट करने वाले डेवलपर को ये काम करने होंगे:

  1. पुष्टि करें कि क्लाइंट ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइल में <uses-library> Extservices टैग शामिल है. इससे जुड़ा टैग यहां दिया गया है:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. अगर androidx.privacysandbox.ads जेटपैक लाइब्रेरी का इस्तेमाल किया जा रहा है, तो पक्का करें कि वर्शन 1.1.0-beta05 या इसके बाद के वर्शन का इस्तेमाल किया जा रहा है.

कौनसे डेवलपर संसाधन उपलब्ध हैं?

Android के बीटा प्रोग्राम पर Privacy Sandbox में ये टूल और संसाधन शामिल हैं.

SDK टूल और एम्युलेटर सिस्टम की इमेज

Android Studio का इस्तेमाल करके, SDK Manager के ज़रिए विज्ञापन सेवाएं एक्सटेंशन और एम्युलेटर सिस्टम की सबसे नई इमेज डाउनलोड की जा सकती हैं. अपना डेवलपमेंट एनवायरमेंट सेट अप करने और एपीआई ऐक्सेस सेट अप करने के तरीके के बारे में ज़्यादा जानें.

एपीआई का संदर्भ

पूरा एपीआई रेफ़रंस उपलब्ध है.

सहायता और सुझाव

Android पर प्राइवसी सैंडबॉक्स की मदद से टेस्ट और डेवलप करने के दौरान, प्रॉडक्ट की जानकारी पढ़ें. साथ ही, समस्याओं की शिकायत करने और सुझाव देने के लिए, समस्या को ट्रैक करने वाले टूल का इस्तेमाल करें.

अपने डेवलपमेंट एनवायरमेंट को अप-टू-डेट रखें

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