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.