AdSelectionConfig

public final class AdSelectionConfig
extends Object implements Parcelable

java.lang.Object
   ↳ android.adservices.adselection.AdSelectionConfig

इसमें विज्ञापन चुनने की प्रोसेस का कॉन्फ़िगरेशन शामिल होता है.

इस क्लास के इंस्टेंस, एसडीके टूल बनाते हैं, ताकि उन्हें AdSelectionManager में AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) और AdSelectionManager#reportImpression तरीकों के आर्ग्युमेंट के तौर पर दिया जा सके.

खास जानकारी

नेस्ट की गई क्लास

class AdSelectionConfig.Builder

AdSelectionConfig ऑब्जेक्ट के लिए बिल्डर. 

इनहेरिट किए गए कॉन्सटेंट

int CONTENTS_FILE_DESCRIPTOR

describeContents() के साथ इस्तेमाल किया जाने वाला डिस्क्रिप्टर बिट: इससे पता चलता है कि Parcelable ऑब्जेक्ट के फ़्लैट किए गए वर्शन में फ़ाइल डिस्क्रिप्टर शामिल है.

int PARCELABLE_WRITE_RETURN_VALUE

writeToParcel(Parcel, int) के साथ इस्तेमाल करने के लिए फ़्लैग: लिखा जा रहा ऑब्जेक्ट एक रिटर्न वैल्यू है. यह "Parcelable someFunction()", "void someFunction(out Parcelable)" या "void someFunction(inout Parcelable)" जैसे फ़ंक्शन का नतीजा होता है.

फ़ील्ड्स की फ़िल्में

public static final Creator<AdSelectionConfig> CREATOR

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

int describeContents()

पार्स किए जा सकने वाले इस इंस्टेंस के मार्शल आर्ट में दिखने वाले खास ऑब्जेक्ट के बारे में बताएं.

boolean equals(Object o)

इससे पता चलता है कि कोई दूसरा ऑब्जेक्ट, इस ऑब्जेक्ट से "बराबर" है या नहीं.

AdSelectionSignals getAdSelectionSignals()
List<AdTechIdentifier> getCustomAudienceBuyers()
Uri getDecisionLogicUri()
Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals()
AdTechIdentifier getSeller()
AdSelectionSignals getSellerSignals()
Uri getTrustedScoringSignalsUri()
int hashCode()

ऑब्जेक्ट के लिए हैश कोड की वैल्यू दिखाता है.

void writeToParcel(Parcel dest, int flags)

इस ऑब्जेक्ट को पार्सल में फ़्लैट करें.

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

Object clone()

इस ऑब्जेक्ट की कॉपी बनाता है और उसे दिखाता है.

boolean equals(Object obj)

इससे पता चलता है कि कोई दूसरा ऑब्जेक्ट, इस ऑब्जेक्ट से "बराबर" है या नहीं.

void finalize()

जब कचरा इकट्ठा करने वाला प्रोग्राम यह तय करता है कि ऑब्जेक्ट का कोई रेफ़रंस नहीं है, तब वह ऑब्जेक्ट पर इस फ़ंक्शन को कॉल करता है.

final Class<?> getClass()

इस Object की रनटाइम क्लास दिखाता है.

int hashCode()

यह फ़ंक्शन किसी ऑब्जेक्ट के लिए हैश कोड की वैल्यू दिखाता है.

final void notify()

उस एक थ्रेड को जगाता है जो इस ऑब्जेक्ट के मॉनिटर पर इंतज़ार कर रहा है.

final void notifyAll()

इस ऑब्जेक्ट के मॉनिटर पर इंतज़ार कर रही सभी थ्रेड को वेक अप करता है.

String toString()

ऑब्जेक्ट की स्ट्रिंग वैल्यू दिखाता है.

final void wait(long timeoutMillis, int nanos)

इससे मौजूदा थ्रेड तब तक इंतज़ार करता है, जब तक उसे सूचना या बाधा नहीं मिलती या जब तक तय समय नहीं बीत जाता.

final void wait(long timeoutMillis)

इससे मौजूदा थ्रेड तब तक इंतज़ार करता है, जब तक उसे सूचना या बाधा नहीं मिलती या जब तक तय समय नहीं बीत जाता.

final void wait()

इससे मौजूदा थ्रेड तब तक इंतज़ार करती है, जब तक उसे सूचना या बाधा नहीं दी जाती.

abstract int describeContents()

इस Parcelable उदाहरण के मार्शल किए गए वर्शन में मौजूद खास ऑब्जेक्ट के बारे में बताएं.

abstract void writeToParcel(Parcel dest, int flags)

इस ऑब्जेक्ट को पार्सल में फ़्लैट करें.

फ़ील्ड्स की फ़िल्में

क्रिएटर

एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 4 में भी जोड़ा गया 
public static final Creator<AdSelectionConfig> CREATOR

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

कॉन्टेंट का ब्यौरा

एपीआई लेवल 34 में जोड़ा गया 
public int describeContents ()

पार्स किए जा सकने वाले इस इंस्टेंस के मार्शल आर्ट में दिखने वाले खास ऑब्जेक्ट के बारे में बताएं. उदाहरण के लिए, अगर ऑब्जेक्ट में writeToParcel(android.os.Parcel, int) के आउटपुट में फ़ाइल डिस्क्रिप्टर शामिल होगा, तो इस तरीके की रिटर्न वैल्यू में CONTENTS_FILE_DESCRIPTOR बिट शामिल होना चाहिए.

रिटर्न
int एक बिटमास्क, जो इस Parcelable ऑब्जेक्ट इंस्टेंस के ज़रिए मार्शल किए गए खास ऑब्जेक्ट टाइप के सेट को दिखाता है. वैल्यू 0 या CONTENTS_FILE_DESCRIPTOR होनी चाहिए

बराबर

एपीआई लेवल 34 में जोड़ा गया 
public boolean equals (Object o)

इससे पता चलता है कि कोई दूसरा ऑब्जेक्ट, इस ऑब्जेक्ट से "बराबर" है या नहीं.

equals तरीका, नॉन-नल ऑब्जेक्ट रेफ़रंस पर, एक जैसी वैल्यू के बीच संबंध लागू करता है:

  • यह रिफ़्लेक्सिव है: किसी भी ऐसी रेफ़रंस वैल्यू के लिए जो शून्य नहीं है x, x.equals(x) को true दिखाना चाहिए.
  • यह सिममेट्रिक है: x और y के लिए, x.equals(y) को true तब ही दिखाना चाहिए, जब y.equals(x) true दिखाता हो.
  • यह ट्रांसिटिव है: अगर x, y, और z जैसी कोई भी गैर-शून्य रेफ़रंस वैल्यू के लिए, x.equals(y) true दिखाता है और y.equals(z) true दिखाता है, तो x.equals(z) को भी true दिखाना चाहिए.
  • यह एक जैसा होता है: किसी भी ऐसी रेफ़रंस वैल्यू के लिए जो शून्य नहीं है x और y, x.equals(y) को कई बार इस्तेमाल करने पर, true या false एक जैसा दिखता है. हालांकि, ऐसा तब होता है, जब ऑब्जेक्ट पर equals की तुलना में इस्तेमाल की गई किसी भी जानकारी में बदलाव न किया गया हो.
  • किसी भी ऐसी रेफ़रंस वैल्यू x के लिए, x.equals(null) को false दिखाना चाहिए जो शून्य न हो.

क्लास Object के लिए equals तरीका, ऑब्जेक्ट पर सबसे ज़्यादा भेदभाव करने वाला संभावित समानता संबंध लागू करता है. इसका मतलब है कि किसी भी गैर-शून्य रेफ़रंस वैल्यू x और y के लिए, यह तरीका सिर्फ़ तब true दिखाता है, जब x और y एक ही ऑब्जेक्ट का रेफ़रंस देते हों (x == y की वैल्यू true होती है).

ध्यान दें कि आम तौर पर, जब भी इस तरीके को बदला जाता है, तो hashCode तरीके को बदलना ज़रूरी होता है. ऐसा इसलिए किया जाता है, ताकि hashCode तरीके के लिए सामान्य समझौता बनाए रखा जा सके. इस समझौते के मुताबिक, एक जैसे ऑब्जेक्ट के हैश कोड एक जैसे होने चाहिए.

पैरामीटर
o Object: वह रेफ़रंस ऑब्जेक्ट जिसकी तुलना करनी है.
रिटर्न
boolean true अगर यह ऑब्जेक्ट, obj आर्ग्युमेंट जैसा है, तो false.

getAdSelectionSignals

एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 4 में भी जोड़ा गया 
public AdSelectionSignals getAdSelectionSignals ()

रिटर्न
AdSelectionSignals AdSelectionSignals ऑब्जेक्ट में मौजूद JSON, AdSelectionConfig से फ़ेच किया जाता है और DSP से फ़ेच किए गए JS लॉजिक का इस्तेमाल करके, विज्ञापन चुनने और रिपोर्टिंग की प्रोसेस में हिस्सा लेने वाले खरीदारों को दिए गए सिग्नल दिखाता है. यह वैल्यू null नहीं हो सकती.

getCustomAudienceBuyers

एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 4 में भी जोड़ा गया 
public List<AdTechIdentifier> getCustomAudienceBuyers ()

रिटर्न
List<AdTechIdentifier> कस्टम ऑडियंस के उन खरीदारों की सूची जिन्हें एसएसपी ने विज्ञापन चुनने की प्रोसेस में हिस्सा लेने की अनुमति दी है यह वैल्यू null नहीं हो सकती.

getDecisionLogicUri

एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 4 में भी जोड़ा गया 
public Uri getDecisionLogicUri ()

रिटर्न
Uri यूआरआई का इस्तेमाल उस JS कोड को फिर से पाने के लिए किया जाता है जिसमें विक्रेता/SSP ScoreAd फ़ंक्शन, विज्ञापन को चुनने और रिपोर्टिंग की प्रोसेस के दौरान इस्तेमाल किया गया था यह वैल्यू null नहीं हो सकती.

getPerBuyerSignals

एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 4 में भी जोड़ा गया 
public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

रिटर्न
Map<AdTechIdentifier, AdSelectionSignals> AdSelectionConfig से फ़ेच किए गए, खरीदारों और AdSelectionSignals का मैप. इसे DSP से फ़ेच किए गए JS लॉजिक का इस्तेमाल करके इस्तेमाल किया जाता है. इसमें वह जानकारी होती है जो हर खरीदार, विज्ञापन चुनने के दौरान हिस्सा लेने वालों को उपलब्ध कराता है. जैसे, बिड फ़्लोर, विज्ञापन चुनने का तरीका वगैरह यह वैल्यू null नहीं हो सकती.

getSeller

एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 4 में भी जोड़ा गया 
public AdTechIdentifier getSeller ()

रिटर्न
AdTechIdentifier सेलर का AdTechIdentifier, उदाहरण के लिए "www.example-ssp.com". यह वैल्यू null नहीं हो सकती.

getSellerSignals

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया 
public AdSelectionSignals getSellerSignals ()

रिटर्न
AdSelectionSignals AdSelectionSignals ऑब्जेक्ट में मौजूद JSON, एसएसपी से मिलने वाली जानकारी को दिखाता है. इस जानकारी का इस्तेमाल, एसएसपी विज्ञापन चुनने की प्रोसेस के नतीजों में बदलाव करने के लिए, विज्ञापन को स्कोर करने की प्रोसेस में करता है. जैसे, ब्रैंड सेफ़्टी की जांच, कॉन्टेक्स्ट के हिसाब से विज्ञापन दिखाने की सुविधा को हटाना. यह जानकारी, एसएसपी से फ़ेच किए गए JS लॉजिक का इस्तेमाल करके खपत की जाती है. यह वैल्यू null नहीं हो सकती.

getTrustedScoringSignalsUri

एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 4 में भी जोड़ा गया 
public Uri getTrustedScoringSignalsUri ()

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

hashCode

एपीआई लेवल 34 में जोड़ा गया 
public int hashCode ()

ऑब्जेक्ट के लिए हैश कोड की वैल्यू दिखाता है. यह तरीका, HashMap जैसी हैश टेबल के फ़ायदे के लिए काम करता है.

hashCode का सामान्य समझौता:

  • जब भी किसी Java ऐप्लिकेशन को चलाने के दौरान, एक ही ऑब्जेक्ट पर एक से ज़्यादा बार कॉल किया जाता है, तो hashCode मेथड को एक ही इंटिजर दिखाना चाहिए. हालांकि, ऐसा तब ही होगा, जब ऑब्जेक्ट पर equals की तुलना में इस्तेमाल की गई जानकारी में बदलाव न किया गया हो. ज़रूरी नहीं है कि इस इंटीजर के हिसाब से, ऐप्लिकेशन को एक बार चलाया जाए और उसी ऐप्लिकेशन को दूसरे ऐप्लिकेशन पर लागू किया जाए.
  • अगर equals(Object) तरीके के हिसाब से दो ऑब्जेक्ट एक जैसे हैं, तो दोनों ऑब्जेक्ट पर hashCode तरीका इस्तेमाल करने पर, एक ही पूर्णांक का नतीजा मिलना चाहिए.
  • अगर equals(java.lang.Object) तरीके के हिसाब से दो ऑब्जेक्ट असमान हैं, तो यह ज़रूरी नहीं है कि दोनों ऑब्जेक्ट पर hashCode तरीके को कॉल करने पर, अलग-अलग पूर्णांक वाले नतीजे मिलें. हालांकि, प्रोग्रामर को इस बात का ध्यान रखना चाहिए कि अलग-अलग ऑब्जेक्ट के लिए अलग-अलग पूर्णांक नतीजे देने से, हैश टेबल की परफ़ॉर्मेंस बेहतर हो सकती है.

Object क्लास के hashCode मेथड से, अलग-अलग ऑब्जेक्ट के लिए अलग-अलग पूर्णांक मिलते हैं. (हो सकता है कि किसी समय, किसी ऑब्जेक्ट के मेमोरी पते के किसी फ़ंक्शन के तौर पर, hashCode को लागू किया गया हो या न किया गया हो.)

रिटर्न
int इस ऑब्जेक्ट के लिए हैश कोड की वैल्यू.

WriteToParcel

एपीआई लेवल 34 में जोड़ा गया 
public void writeToParcel (Parcel dest, 
                int flags)

इस ऑब्जेक्ट को पार्सल में फ़्लैट करें.

पैरामीटर
dest Parcel: यह वैल्यू null नहीं हो सकती.
flags int: ऑब्जेक्ट को लिखने के तरीके के बारे में अतिरिक्त फ़्लैग. 0 या Parcelable.PARCELABLE_WRITE_RETURN_VALUE हो सकता है. इसका मान या तो 0 या Parcelable.PARCELABLE_WRITE_RETURN_VALUE और android.os.Parcelable.PARCELABLE_ELIDE_ सवाल का हल है