ऑडियंस डेटा अपडेट करना और विज्ञापनों को रीफ़्रेश करना

Protected Audience API इंटरेस्ट ग्रुप के लिए अपडेट यूआरएल कॉन्फ़िगर करके, ऑडियंस डेटा अपडेट करने का तरीका जानें. Protected Audience API के पूरे लाइफ़साइकल के बारे में जानने के लिए, डेवलपर गाइड पढ़ें. साथ ही, इस बारे में ज़्यादा जानकारी पाने के लिए Protected Audience API के बारे में बताने वाला लेख पढ़ें कि ब्राउज़र, इंटरेस्ट ग्रुप को कैसे रिकॉर्ड करते हैं.

क्या आप डेवलपर नहीं हैं? Protected Audience API की खास जानकारी देखें.

Protected Audience API के इंटरेस्ट ग्रुप

Protected Audience API इंटरेस्ट ग्रुप, एक जैसी दिलचस्पी वाले लोगों के ग्रुप को दिखाता है. यह रीमार्केटिंग सूची से जुड़ा होता है. Protected Audience API के हर इंटरेस्ट ग्रुप का एक मालिक होता है.

इंटरेस्ट ग्रुप के मालिक, Protected Audience API की मदद से होने वाली विज्ञापन की नीलामी में खरीदार के तौर पर काम करते हैं. ब्राउज़र, उपयोगकर्ता के डिवाइस पर एक जैसी दिलचस्पी वाले ग्रुप की सदस्यता सेव करता है. इसे ब्राउज़र वेंडर या किसी अन्य व्यक्ति के साथ शेयर नहीं किया जाता.

एपीआई फ़ंक्शन

इस्तेमाल से जुड़ा उदाहरण

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

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  updateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

updateUrl, एक ऐसा यूआरएल उपलब्ध कराता है जो दिलचस्पी वाले ग्रुप के एट्रिब्यूट अपडेट करने के लिए JSON दिखाता है. इसका ऑरिजिन, owner के ऑरिजिन के जैसा ही होना चाहिए.

एट्रिब्यूट अपडेट करना

updateUrl, ऐसे वेब सर्वर के बारे में बताता है जो JSON दिखाता है. इसमें दिलचस्पी वाले ग्रुप की प्रॉपर्टी के बारे में जानकारी होती है. यह जानकारी, joinAdInterestGroup() को पास किए गए दिलचस्पी वाले ग्रुप के ऑब्जेक्ट से जुड़ी होती है.

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

  • biddingLogicUrl
  • biddingWasmHelperUrl
  • trustedBiddingSignalsUrl
  • trustedBiddingSignalsKeys
  • ads
  • priority

JSON में नहीं बताया गया कोई भी फ़ील्ड नहीं बदला जाएगा. सिर्फ़ JSON में बताए गए फ़ील्ड अपडेट किए जाएंगे. वहीं, navigator.joinAdInterestGroup() को कॉल करने पर, मौजूदा इंटरेस्ट ग्रुप बदल जाता है.

अपडेट उपलब्ध कराने की हमारी पूरी कोशिश रहती है. हालांकि, यहां दी गई स्थितियों में अपडेट नहीं हो सकते:

  • नेटवर्क अनुरोध का टाइम आउट (फ़िलहाल, 30 सेकंड).
  • नेटवर्क से जुड़ी कोई और समस्या.
  • JSON पार्स नहीं किया जा सका.

अपडेट करने की दर को सीमित किया गया है. हर दिन सिर्फ़ एक बार अपडेट किया जा सकता है.

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

मैन्‍युअल अपडेट

मौजूदा फ़्रेम के ऑरिजिन के मालिकाना हक वाले दिलचस्पी वाले ग्रुप में अपडेट, navigator.updateAdInterestGroups() का इस्तेमाल करके मैन्युअल तरीके से ट्रिगर किए जा सकते हैं.

रेट लिमिटिंग की वजह से, अपडेट बार-बार नहीं होते हैं: navigator.updateAdInterestGroups() को बार-बार कॉल करने से कोई फ़र्क़ नहीं पड़ता, जब तक कि रेट लिमिट की अवधि (फ़िलहाल एक दिन) खत्म नहीं हो जाती.

अगर एक ही इंटरेस्ट ग्रुप owner और name के लिए navigator.joinAdInterestGroup() को फिर से कॉल किया जाता है, तो दर की सीमा रीसेट हो जाती है.

अपने-आप होने वाले अपडेट

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

नीलामी में हिस्सा लेने वाले हर मालिक के लिए, कम से कम एक दिलचस्पी वाला ग्रुप होता है. ऐसा माना जाता है कि navigator.updateAdInterestGroups() को ऐसे iframe से कॉल किया जाता है जिसका ऑरिजिन उस मालिक से मेल खाता है.

Protected Audience API के सभी रेफ़रंस

एपीआई रेफ़रंस गाइड उपलब्ध हैं:

Protected Audience API के बारे में जानकारी देने वाला टूल , सुविधाओं के इस्तेमाल और पाबंदियों के बारे में भी जानकारी देता है.