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

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 ऐसे वेब सर्वर के बारे में बताता है जो joinAdInterestGroup() को पास किए गए इंटरेस्ट ग्रुप ऑब्जेक्ट के हिसाब से, इंटरेस्ट ग्रुप की प्रॉपर्टी तय करने वाला JSON दिखाता है.

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

  • 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 के बारे में जानकारी देने वाला टूल , सुविधाओं के इस्तेमाल और पाबंदियों के बारे में भी जानकारी देता है.