मेज़रमेंट मैनेजर

public class MeasurementManager
extends Object

java.lang.Object
android.adservices.measurement.मेज़रमेंटManager


MeasurementManager, सोर्स को मैनेज करने और रजिस्ट्रेशन ट्रिगर करने के लिए, एपीआई उपलब्ध कराता है.

खास जानकारी

स्थिरांक

int MEASUREMENT_API_STATE_DISABLED

इस स्थिति से पता चलता है कि मेज़रमेंट एपीआई उपलब्ध नहीं हैं.

int MEASUREMENT_API_STATE_ENABLED

इस स्थिति से पता चलता है कि मेज़रमेंट एपीआई चालू हैं.

सार्वजनिक तरीके

void deleteRegistrations(DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<ObjectException> callback)

पिछले रजिस्ट्रेशन मिटाएं.

static MeasurementManager get(Context context)

MeasurementManager का इंस्टेंस बनाने का फ़ैक्ट्री तरीका.

void getMeasurementApiStatus(Executor executor, OutcomeReceiver<IntegerException> callback)

मेज़रमेंट एपीआई का स्टेटस पाएं.

void registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<ObjectException> callback)

एट्रिब्यूशन सोर्स रजिस्टर करें (क्लिक करें या व्यू देखें).

void registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<ObjectException> callback)

किसी ऐप्लिकेशन कॉन्टेक्स्ट से एट्रिब्यूशन सोर्स(क्लिक या व्यू) रजिस्टर करें.

void registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<ObjectException> callback)

ट्रिगर (कन्वर्ज़न) रजिस्टर करें.

void registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<ObjectException> callback)

वेब संदर्भ से कोई एट्रिब्यूशन सोर्स(क्लिक या व्यू) रजिस्टर करें.

void registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<ObjectException> callback)

वेब संदर्भ से कोई एट्रिब्यूशन ट्रिगर(क्लिक या व्यू) रजिस्टर करें.

इनहेरिट किए गए तरीके

स्थिरांक

MEASUREMENT_API_6_6D

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया
public static final int MEASUREMENT_API_STATE_DISABLED

इस स्थिति से पता चलता है कि मेज़रमेंट एपीआई उपलब्ध नहीं हैं. उन्हें इस्तेमाल करने का नतीजा है कि UnsupportedOperationException.

कॉन्स्टेंट वैल्यू: 0 (0x00000000)

MEASUREMENT_API_स्टेट_क्षेप

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया
public static final int MEASUREMENT_API_STATE_ENABLED

इस स्थिति से पता चलता है कि मेज़रमेंट एपीआई चालू हैं.

कॉन्स्टेंट वैल्यू: 1 (0x00000001)

सार्वजनिक तरीके

रजिस्ट्रेशन मिटाएं

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया
public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

पिछले रजिस्ट्रेशन मिटाएं. अगर मिटा दिया जाता है, तो कॉलबैक के OutcomeReceiver.onResult(R) को शून्य के साथ शुरू किया जाता है. अगर कोई गड़बड़ी होती है, तो Exception कॉलबैक के OutcomeReceiver#onError के ज़रिए भेजा जाता है. सफलता और असफल, दोनों दिए गए Executor पर सुझाव लागू किए जाते हैं.

पैरामीटर
deletionRequest DeletionRequest: डेटा मिटाने का अनुरोध. यह मान null नहीं हो सकता.

executor Executor: कॉलबैक चलाने वाला एक्ज़ीक्यूटर. यह मान null नहीं हो सकता. कॉलबैक और लिसनर इवेंट इस तरीके से भेजे जाते हैं Executor की मदद से, यह आसानी से कंट्रोल किया जा सकता है कि कौनसा थ्रेड इस्तेमाल किया गया. अपने मुख्य थ्रेड के ज़रिए इवेंट भेजने के लिए तो आप उपयोग कर सकते हैं Context.getMainExecutor(). अगर ऐसा नहीं है, तो सही थ्रेड पर भेजने वाला Executor दें.

callback OutcomeReceiver: इसका इस्तेमाल एपीआई के नतीजे को एसिंक्रोनस तरीके से सूचना देने के लिए किया जाता है. यह मान null नहीं हो सकता.

पाएं

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 6 में भी जोड़ा गया
public static MeasurementManager get (Context context)

MeasurementManager का इंस्टेंस बनाने का फ़ैक्ट्री तरीका.

पैरामीटर
context Context: इस्तेमाल करने के लिए Context यह मान null नहीं हो सकता.

रिटर्न
MeasurementManager MeasurementManager इंस्टेंस यह मान null नहीं हो सकता.

getमेज़रमेंटApiStatus

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया
public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<IntegerException> callback)

मेज़रमेंट एपीआई का स्टेटस पाएं.

कॉलबैक की Integer वैल्यू, MeasurementApiState में से एक है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION की ज़रूरत है

पैरामीटर
executor Executor: नतीजे भेजने के लिए कॉलबैक का इस्तेमाल किया जाता है. यह मान null नहीं हो सकता. कॉलबैक और लिसनर इवेंट इस तरीके से भेजे जाते हैं Executor की मदद से, यह आसानी से कंट्रोल किया जा सकता है कि कौनसा थ्रेड इस्तेमाल किया गया. अपने मुख्य थ्रेड के ज़रिए इवेंट भेजने के लिए तो आप उपयोग कर सकते हैं Context.getMainExecutor(). अगर ऐसा नहीं है, तो सही थ्रेड पर भेजने वाला Executor दें.

callback OutcomeReceiver: इसका इस्तेमाल एपीआई के नतीजे को एसिंक्रोनस तरीके से सूचना देने के लिए किया जाता है. यह मान null नहीं हो सकता.

रजिस्टर सोर्स

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया
public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

एट्रिब्यूशन सोर्स रजिस्टर करें (क्लिक करें या व्यू देखें).
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION की ज़रूरत है

पैरामीटर
attributionSource Uri: मेटाडेटा फ़ेच करने के लिए, प्लैटफ़ॉर्म इस यूआरआई को अनुरोध भेजता है एट्रिब्यूशन सोर्स से जुड़ा होता है. सोर्स मेटाडेटा को डिवाइस में सेव किया जाता है, जिससे इसे आने वाले समय में ट्रिगर होने वाले ट्रिगर से मैच किया जा सके. यह मान null नहीं हो सकता.

inputEvent InputEvent: या तो InputEvent ऑब्जेक्ट (क्लिक इवेंट के लिए) या शून्य (व्यू के लिए) इवेंट).

executor Executor: नतीजे भेजने के लिए कॉलबैक का इस्तेमाल किया जाता है. यह वैल्यू null हो सकती है. कॉलबैक और लिसनर इवेंट इस तरीके से भेजे जाते हैं Executor की मदद से, यह आसानी से कंट्रोल किया जा सकता है कि कौनसा थ्रेड इस्तेमाल किया गया. अपने मुख्य थ्रेड के ज़रिए इवेंट भेजने के लिए तो आप उपयोग कर सकते हैं Context.getMainExecutor(). अगर ऐसा नहीं है, तो सही थ्रेड पर भेजने वाला Executor दें.

callback OutcomeReceiver: इसका इस्तेमाल एपीआई के नतीजे को एसिंक्रोनस तरीके से सूचना देने के लिए किया जाता है. यह वैल्यू null हो सकती है.

थ्रो
IllegalArgumentException अगर attributionSource की स्कीम एचटीटीपीएस नहीं है

रजिस्टर सोर्स

public void registerSource (SourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

किसी ऐप्लिकेशन कॉन्टेक्स्ट से एट्रिब्यूशन सोर्स(क्लिक या व्यू) रजिस्टर करें. यह एपीआई प्रोसेस नहीं करेगा कोई भी रीडायरेक्ट, अनुरोध के साथ सभी रजिस्ट्रेशन यूआरएल दिए जाने चाहिए.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION की ज़रूरत है

पैरामीटर
request SourceRegistrationRequest: ऐप्लिकेशन के सोर्स के रजिस्ट्रेशन का अनुरोध यह मान null नहीं हो सकता.

executor Executor: नतीजे भेजने के लिए कॉलबैक का इस्तेमाल किया जाता है यह वैल्यू null हो सकती है. कॉलबैक और लिसनर इवेंट इस तरीके से भेजे जाते हैं Executor की मदद से, यह आसानी से कंट्रोल किया जा सकता है कि कौनसा थ्रेड इस्तेमाल किया गया. अपने मुख्य थ्रेड के ज़रिए इवेंट भेजने के लिए तो आप उपयोग कर सकते हैं Context.getMainExecutor(). अगर ऐसा नहीं है, तो सही थ्रेड पर भेजने वाला Executor दें.

callback OutcomeReceiver: इसका मकसद, एपीआई के नतीजे को एसिंक्रोनस तरीके से सूचना देना है यह वैल्यू null हो सकती है.

रजिस्टर ट्रिगर

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया
public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

ट्रिगर (कन्वर्ज़न) रजिस्टर करें.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION की ज़रूरत है

पैरामीटर
trigger Uri: एपीआई, इस यूआरआई को अनुरोध भेजने का अनुरोध करता है, ताकि इससे जुड़ा मेटाडेटा फ़ेच किया जा सके ट्रिगर होना चाहिए. ट्रिगर मेटाडेटा डिवाइस पर सेव किया जाता है और इससे मिलान किया जा सकता है सोर्स को सही तरीके से दिखाता है. यह मान null नहीं हो सकता.

executor Executor: नतीजे भेजने के लिए कॉलबैक का इस्तेमाल किया जाता है. यह वैल्यू null हो सकती है. कॉलबैक और लिसनर इवेंट इस तरीके से भेजे जाते हैं Executor की मदद से, यह आसानी से कंट्रोल किया जा सकता है कि कौनसा थ्रेड इस्तेमाल किया गया. अपने मुख्य थ्रेड के ज़रिए इवेंट भेजने के लिए तो आप उपयोग कर सकते हैं Context.getMainExecutor(). अगर ऐसा नहीं है, तो सही थ्रेड पर भेजने वाला Executor दें.

callback OutcomeReceiver: इसका इस्तेमाल एपीआई के नतीजे को एसिंक्रोनस तरीके से सूचना देने के लिए किया जाता है. यह वैल्यू null हो सकती है.

थ्रो
IllegalArgumentException अगर trigger की स्कीम एचटीटीपीएस नहीं है

रजिस्टर वेबसोर्स

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया
public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

वेब संदर्भ से कोई एट्रिब्यूशन सोर्स(क्लिक या व्यू) रजिस्टर करें. यह एपीआई किसी भी डेटा को प्रोसेस नहीं करेगा रीडायरेक्ट करते हैं, तो सभी पंजीकरण URL की आपूर्ति अनुरोध के साथ की जानी चाहिए. कम से कम एक appDestination या webDestination पैरामीटर देने ज़रूरी हैं. अगर रजिस्ट्रेशन सफल रहा, callback की OutcomeReceiver#onResult को शून्य से शुरू किया गया है. तय सीमा में गड़बड़ी होने पर, callback के OutcomeReceiver.onError(E) के ज़रिए Exception भेजा जाता है. सफलता और विफलता, दोनों के सुझाव दिए गए पर लागू किए जाते हैं Executor.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION की ज़रूरत है

पैरामीटर
request WebSourceRegistrationRequest: सोर्स के रजिस्ट्रेशन का अनुरोध यह मान null नहीं हो सकता.

executor Executor: नतीजे भेजने के लिए कॉलबैक का इस्तेमाल किया जाता है. यह वैल्यू null हो सकती है.

callback OutcomeReceiver: इसका इस्तेमाल एपीआई के नतीजे को एसिंक्रोनस तरीके से सूचना देने के लिए किया जाता है. यह वैल्यू null हो सकती है.

रजिस्टर वेबट्रिगर

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया
public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

वेब संदर्भ से कोई एट्रिब्यूशन ट्रिगर(क्लिक या व्यू) रजिस्टर करें. यह एपीआई प्रोसेस नहीं करेगा कोई भी रीडायरेक्ट, अनुरोध के साथ सभी रजिस्ट्रेशन यूआरएल दिए जाने चाहिए. अगर रजिस्ट्रेशन सफल रहा, callback की OutcomeReceiver#onResult को शून्य से शुरू किया गया है. तय सीमा में गड़बड़ी होने पर, callback के OutcomeReceiver.onError(E) के ज़रिए Exception भेजा जाता है. सफलता और विफलता, दोनों के सुझाव दिए गए पर लागू किए जाते हैं Executor.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION की ज़रूरत है

पैरामीटर
request WebTriggerRegistrationRequest: रजिस्ट्रेशन अनुरोध ट्रिगर करें यह मान null नहीं हो सकता.

executor Executor: नतीजे भेजने के लिए कॉलबैक का इस्तेमाल किया जाता है यह वैल्यू null हो सकती है.

callback OutcomeReceiver: इसका मकसद, एपीआई के नतीजे को एसिंक्रोनस तरीके से सूचना देना है यह वैल्यू null हो सकती है.