Protected Audience, android.adservices.customaudience पैकेज के तहत, कस्टम ऑडियंस में शामिल होने और उनसे बाहर निकलने के लिए कई एपीआई उपलब्ध कराता है. डीबग करने के मकसद से, कस्टम ऑडियंस को लिस्ट करने और देखने के लिए सीएलआई कमांड उपलब्ध हैं. इस गाइड में, विज्ञापन टेक्नोलॉजी डेवलपर के लिए ज़रूरी चरणों के बारे में बताया गया है. इन चरणों को पूरा करके, वे शामिल की गई कस्टम ऑडियंस की स्थिति की जांच कर सकते हैं.
सेटअप
सुरक्षा और निजता की वजहों से, कस्टम ऑडियंस डिफ़ॉल्ट रूप से नहीं दिखती हैं. साथ ही, इन्हें सिर्फ़ डीबग करने के मकसद से सीधे तौर पर देखा जा सकता है. ये सिर्फ़ तब दिखते हैं, जब ये ज़रूरी शर्तें पूरी हों:
- पूरे सिस्टम के लिए डेवलपर के विकल्प चालू हैं
android:debuggable="true"को उस ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में शामिल किया गया है जहां सेCustomAudienceकोjoinCustomAudienceयाfetchAndJoinCustomAudienceका इस्तेमाल करके जोड़ा गया था- ऐप्लिकेशन के सुझाए गए विज्ञापन दिखाने की सुविधा के लिए सहमति चालू है
adservices की शेल कमांड चालू करें
adservicesप्रोसेस को बंद करने के लिए, अपना डिवाइस रीस्टार्ट करें.- पुष्टि करें कि
adservicesचालू नहीं है. इस निर्देश के लिए, कोई आउटपुट नहीं मिला.
adb shell ps -A | grep adservices
इसके बाद, adservices शेल कमांड चालू करने के लिए, ये कमांड चलाएं:
adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true
कस्टम ऑडियंस की सूची बनाना
किसी कस्टम ऑडियंस को देखने के लिए, यह कमांड चलाएं. इसमें owner को ऑडियंस बनाने वाले पैकेज के तौर पर और buyer को ऑडियंस को मैनेज करने वाले विज्ञापन नेटवर्क के आइडेंटिफ़ायर के तौर पर तय करें:
adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>
आउटपुट के तौर पर एक JSON ऑब्जेक्ट मिलेगा. इसमें एक ऐरे custom_audiences शामिल होगा.
इस कलेक्शन में मौजूद एलिमेंट का स्ट्रक्चर, व्यू कस्टम ऑडियंस कमांड के आउटपुट से मेल खाता है. इसके बारे में यहां बताया गया है.
किसी कस्टम ऑडियंस को देखना
किसी कस्टम ऑडियंस को देखने के लिए, यह कमांड चलाएं. इसमें owner को ऑडियंस बनाने वाले पैकेज के तौर पर, buyer को ऑडियंस मैनेज करने वाले विज्ञापन नेटवर्क के आइडेंटिफ़ायर के तौर पर, और name को ऑडियंस के नाम के तौर पर तय करें:
adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>
किसी कस्टम ऑडियंस को रीफ़्रेश करना
किसी कस्टम ऑडियंस के लिए, हर दिन अपडेट होने की सुविधा को मैन्युअल तरीके से ट्रिगर करने के लिए, यहां दिया गया कमांड चलाएं. इसमें owner को ऑडियंस बनाने वाले पैकेज के तौर पर, buyer को ऑडियंस मैनेज करने वाले विज्ञापन नेटवर्क के आइडेंटिफ़ायर के तौर पर, और name को ऑडियंस के नाम के तौर पर तय करें:
adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.