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

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

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

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

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

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

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

Android के लिए Privacy Sandbox का इस्तेमाल शुरू करने के लिए, यह तरीका अपनाएं:

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

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

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

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

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

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

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

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

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

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

आम तौर पर होने वाली समस्याओं को हल करना

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

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 मैनेजर की मदद से Ad Services एक्सटेंशन और एमुलेटर सिस्टम की इमेज डाउनलोड की जा सकती हैं. अपना डेवलपमेंट एनवायरमेंट सेट अप करने और एपीआई ऐक्सेस सेट अप करने के तरीके के बारे में ज़्यादा जानें.

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

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

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

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

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

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