विज्ञापन चुनें जाने का कॉन्फ़िगरेशन

public final class AdSelectionConfig
extends Object implements Parcelable

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

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

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

खास जानकारी

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

class AdSelectionConfig.Builder

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

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

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

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)

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

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

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

क्रिएटर

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

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

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

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

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

रिटर्न
int बिटमास्क, जो मार्शल किए गए खास ऑब्जेक्ट टाइप के सेट को दिखाता है इस पार्स किए जा सकने वाले ऑब्जेक्ट इंस्टेंस से. मान 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.

AdSelectionसिग्नल पाएं

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

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

पाएंकस्टम ऑडियंसखरीदार

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

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

getडिसीज़नलॉजिकयूरी

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

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

'GetPerBuyerसिग्नल'

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

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

गेटसेलर

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

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

getSellerसिग्नल

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

रिटर्न
AdSelectionSignals AdSelectionSignals ऑब्जेक्ट में JSON, जिसे SSP से मिलता है और JS उसे इस्तेमाल करता है SSP से फ़ेच किया गया लॉजिक, ऐसी किसी भी जानकारी को दिखाता है जिसका इस्तेमाल SSP विज्ञापन में करता है विज्ञापन चुनने की प्रोसेस के नतीजों को बेहतर बनाने के लिए स्कोरिंग प्रोसेस (उदाहरण के लिए, ब्रैंड सुरक्षा और काम के विज्ञापन शामिल नहीं हैं). यह मान null नहीं हो सकता.

पाएंभरोसेमंद स्कोरिंग सिग्नलयूरी

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

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

हैशकोड

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

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

hashCode का सामान्य अनुबंध यह है:

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

जितना व्यावहारिक है, उसके लिए हैशकोड विधि को परिभाषित किया गया था श्रेणी Object के अनुसार के लिए अलग-अलग पूर्णांक लौटाता है अलग-अलग ऑब्जेक्ट होने चाहिए. (हैशकोड लागू किया जा सकता है और नहीं भी किसी ऑब्जेक्ट के मेमोरी पते के कुछ फ़ंक्शन के तौर पर समय में.)

रिटर्न
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_ सवाल का हल है