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

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

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

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

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

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

अपनी प्रोफ़ाइल बनाना शुरू करें

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

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

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

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

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

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

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

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

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

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

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

पहले से मौजूद समस्याओं को हल करना

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

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

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

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

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

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

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

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

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

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

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

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