कस्टम ऑडियंस

public final class CustomAudience
extends Object implements Parcelable

java.lang.Object
android.adservices.customaudience.Customaudience


इससे वह जानकारी मिलती है जो कस्टम ऑडियंस को विज्ञापन चुनने में मदद करने के लिए ज़रूरी है.

कस्टम ऑडियंस, एक जैसी दिलचस्पी रखने वाले उपयोगकर्ताओं का एब्सट्रैक्ट ग्रुप होता है. यह क्लास, ऐसे डिवाइस पर स्टोर किए गए कुछ डेटा का कलेक्शन है जो विज्ञापन दिखाने के लिए ज़रूरी होता है किसी कस्टम ऑडियंस को टारगेट करते हैं.

खास जानकारी

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

class CustomAudience.Builder

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

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

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

public static final Creator<CustomAudience> CREATOR

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

boolean equals(Object o)

यह जांचता है कि क्या दो CustomAudience ऑब्जेक्ट में एक जैसी जानकारी है.

Instant getActivationTime()

CustomAudience ऑब्जेक्ट बनाने के बाद, इसे चालू करने का वैकल्पिक समय सेट किया जा सकता है. देर से ऐक्टिवेशन के लिए.

List<AdData> getAds()

AdData ऑब्जेक्ट की यह सूची उन विज्ञापनों की पूरी सूची है जिन्हें विज्ञापन चुनने की प्रोसेस के दौरान इस CustomAudience ने दिखाया है.

Uri getBiddingLogicUri()

जब कोई कस्टम ऑडियंस विज्ञापन चुनने की प्रोसेस.

AdTechIdentifier getBuyer()

खरीदार की पहचान डोमेन के ज़रिए "buyerexample.com" फ़ॉर्म में की जाती है.

Uri getDailyUpdateUri()

यह यूआरआई, खरीदार की ओर से चलाए जाने वाले सर्वर पर ले जाता है, जो अपडेट किया गया बोली-प्रक्रिया डेटा और विज्ञापन मेटाडेटा होस्ट करता है का इस्तेमाल उपयोगकर्ता के डिवाइस पर विज्ञापन चुनने की प्रोसेस में किया जा सकता है.

Instant getExpirationTime()

समयसीमा खत्म होने के बाद, 'पसंद के मुताबिक दर्शक' को हर दिन इस्तेमाल नहीं किया जा सकता विज्ञापन/बिडिंग का डेटा अपडेट करने या विज्ञापन चुनने की प्रोसेस में हिस्सा लेने के लिए किया जा सकता है.

String getName()

कस्टम ऑडियंस का नाम, एक आर्बिट्रेरी स्ट्रिंग होती है. यह स्ट्रिंग बनाने के समय, मालिक और खरीदार से मिलती है CustomAudience ऑब्जेक्ट में से.

TrustedBiddingData getTrustedBiddingData()

भरोसेमंद बिडिंग डेटा में, खरीदारों के लिए भरोसेमंद सर्वर पर ले जाने वाला यूआरआई शामिल होता है बिडिंग डेटा और सर्वर से क्वेरी करने के लिए कुंजियों की सूची.

AdSelectionSignals getUserBiddingSignals()

खरीदार के उपलब्ध कराए गए प्रॉडक्ट का इस्तेमाल करने के लिए, उपयोगकर्ता के बिडिंग सिग्नल विकल्प के तौर पर उपलब्ध कराए जाते हैं विज्ञापन चुनने के दौरान, JavaScript लागू करने के लिए एक अलग एनवायरमेंट में.

int hashCode()

यह फ़ंक्शन CustomAudience ऑब्जेक्ट के डेटा का हैश दिखाता है.

void writeToParcel(Parcel dest, int flags)

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

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

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

क्रिएटर

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

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

बराबर

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

यह जांचता है कि क्या दो CustomAudience ऑब्जेक्ट में एक जैसी जानकारी है.

पैरामीटर
o Object: वह रेफ़रंस ऑब्जेक्ट जिससे तुलना करनी है.

रिटर्न
boolean true, अगर यह ऑब्जेक्ट, obj जैसा है तर्क; अगर ऐसा नहीं है, तो false.

'ऐक्टिवेशन टाइम'

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

CustomAudience ऑब्जेक्ट बनाने के बाद, इसे चालू करने का वैकल्पिक समय सेट किया जा सकता है. देर से ऐक्टिवेशन के लिए. अगर इस फ़ील्ड को सेट नहीं किया गया है, तो शामिल होते समय CustomAudience चालू हो जाएगी.

उदाहरण के लिए, इनऐक्टिव उपयोगकर्ताओं के लिए कस्टम ऑडियंस, गतिविधि पूरी नहीं होती है, यानी कस्टम ऑडियंस के विज्ञापन, विज्ञापन में शामिल हो जाएंगे चुनने की प्रोसेस से, उन उपयोगकर्ताओं को मूल ऐप्लिकेशन पर रीडायरेक्ट किया जा सकता है जो सक्रिय नहीं हैं.

इसे चालू होने में ज़्यादा से ज़्यादा 60 दिनों का समय लग सकता है.

अगर बताया गया हो, तो ऐक्टिवेशन समय, खत्म होने के समय से पहले का होना चाहिए.

रिटर्न
Instant टाइमस्टैंप Instant को मिलीसेकंड तक काट दिया गया, जिसके बाद कस्टम ऑडियंस चालू है यह वैल्यू null हो सकती है.

विज्ञापन पाएं

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

AdData ऑब्जेक्ट की यह सूची उन विज्ञापनों की पूरी सूची है जिन्हें विज्ञापन चुनने की प्रोसेस के दौरान इस CustomAudience ने दिखाया है.

अगर तय नहीं किया गया है या एक खाली सूची दी गई है, तो CustomAudience विज्ञापन चुनने में तब तक हिस्सा नहीं लेते, जब तक के लिए रोज़ के अपडेट में विज्ञापनों की मान्य सूची नहीं मिल जाती का भी इस्तेमाल कर सकते हैं.

रिटर्न
List<AdData> AdData में से List ऑब्जेक्ट, उन विज्ञापनों की जानकारी दे रहा है जो फ़िलहाल पसंद के मुताबिक दर्शक यह मान null नहीं हो सकता.

getBiddingLogicUri

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

जब कोई कस्टम ऑडियंस विज्ञापन चुनने की प्रोसेस. यूआरआई में एचटीटीपीएस का इस्तेमाल करना ज़रूरी है.

रिटर्न
Uri खरीदार का बिडिंग लॉजिक फ़ेच करने के लिए यूआरआई यह मान null नहीं हो सकता.

गेटखरीदार

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

खरीदार की पहचान डोमेन के ज़रिए "buyerexample.com" फ़ॉर्म में की जाती है.

रिटर्न
AdTechIdentifier एक AdTechIdentifier जिसमें कस्टम ऑडियंस के खरीदार का डोमेन शामिल है यह मान null नहीं हो सकता.

Get DailyUpdateUri

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

यह यूआरआई, खरीदार की ओर से चलाए जाने वाले सर्वर पर ले जाता है, जो अपडेट किया गया बोली-प्रक्रिया डेटा और विज्ञापन मेटाडेटा होस्ट करता है का इस्तेमाल उपयोगकर्ता के डिवाइस पर विज्ञापन चुनने की प्रोसेस में किया जा सकता है. यूआरआई में एचटीटीपीएस का इस्तेमाल करना ज़रूरी है.

रिटर्न
Uri कस्टम ऑडियंस के रोज़ के अपडेट का यूआरआई यह मान null नहीं हो सकता.

'समयसीमा खत्म होने का समय'

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

समयसीमा खत्म होने के बाद, 'पसंद के मुताबिक दर्शक' को हर दिन इस्तेमाल नहीं किया जा सकता विज्ञापन/बिडिंग का डेटा अपडेट करने या विज्ञापन चुनने की प्रोसेस में हिस्सा लेने के लिए किया जा सकता है. कस्टम ऑडियंस इसे हर दिन के अगले अपडेट से, मेमोरी से मिटा दिया जाएगा.

अगर CustomAudience बनाते समय, कार्ड की समयसीमा खत्म होने की कोई समयसीमा नहीं दी गई है, तो समयसीमा खत्म होने की तारीख डिफ़ॉल्ट रूप से, चालू होने के 60 दिनों तक चालू रहता है.

लाइसेंस की समयसीमा शुरू होने के 60 दिनों के बाद, इसे इस्तेमाल नहीं किया जा सकता.

रिटर्न
Instant टाइमस्टैंप Instant को मिलीसेकंड तक काट दिया गया, जिसके बाद कस्टम ऑडियंस को हटाना चाहिए यह वैल्यू null हो सकती है.

गेटनाम

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

कस्टम ऑडियंस का नाम, एक आर्बिट्रेरी स्ट्रिंग होती है. यह स्ट्रिंग बनाने के समय, मालिक और खरीदार से मिलती है CustomAudience ऑब्जेक्ट में से.

रिटर्न
String कस्टम ऑडियंस का स्ट्रिंग नाम यह मान null नहीं हो सकता.

getTrustedBiddingData

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

भरोसेमंद बिडिंग डेटा में, खरीदारों के लिए भरोसेमंद सर्वर पर ले जाने वाला यूआरआई शामिल होता है बिडिंग डेटा और सर्वर से क्वेरी करने के लिए कुंजियों की सूची. ध्यान दें कि कुंजियां आर्बिट्रेरी आइडेंटिफ़ायर हैं जिसका इस्तेमाल सिर्फ़ विज्ञापन के दौरान, खरीदार के बिडिंग लॉजिक के बारे में भरोसेमंद सर्वर से क्वेरी करने के लिए किया जाएगा चुनें.

अगर इसके बारे में नहीं बताया गया है, तो CustomAudience इस समय तक विज्ञापन चुनने में हिस्सा नहीं लेगा भरोसेमंद बिडिंग का डेटा, कस्टम ऑडियंस के लिए रोज़ होने वाले अपडेट के ज़रिए दिया जाता है.

रिटर्न
TrustedBiddingData TrustedBiddingData ऑब्जेक्ट, जिसमें कस्टम ऑडियंस की भरोसेमंद बिडिंग शामिल है डेटा यह वैल्यू null हो सकती है.

getUser-बिडिंग सिग्नल

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

खरीदार के उपलब्ध कराए गए प्रॉडक्ट का इस्तेमाल करने के लिए, उपयोगकर्ता के बिडिंग सिग्नल विकल्प के तौर पर उपलब्ध कराए जाते हैं विज्ञापन चुनने के दौरान, JavaScript लागू करने के लिए एक अलग एनवायरमेंट में.

अगर उपयोगकर्ता के बिडिंग सिग्नल, ऐसा मान्य JSON ऑब्जेक्ट नहीं हैं जिसे उपयोगकर्ता इस्तेमाल कर सके खरीदार की JS, कस्टम ऑडियंस विज्ञापन चुनने के लिए योग्य नहीं होगी.

अगर इसके बारे में नहीं बताया गया है, तो CustomAudience इस समय तक विज्ञापन चुनने में हिस्सा नहीं लेगा उपयोगकर्ता के बिडिंग सिग्नल, कस्टम ऑडियंस के लिए हर दिन होने वाले अपडेट के ज़रिए उपलब्ध कराए जाते हैं.

रिटर्न
AdSelectionSignals एक AdSelectionSignals ऑब्जेक्ट, जो पसंद के मुताबिक दर्शक यह वैल्यू null हो सकती है.

हैशकोड

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

यह फ़ंक्शन CustomAudience ऑब्जेक्ट के डेटा का हैश दिखाता है.

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