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

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 से जुड़े सभी रेफ़रंस

API reference guides are available:

• Developer guide for the Protected Audience API.
• Ad buyer guide to Protected Audience interest groups and bid generation.
• Ad seller guide to Protected Audience ad auctions.
• Guide to reporting auction results
• Best practices for Protected Audience ad auction latency
• Troubleshoot Protected Audience

The Protected Audience API explainer also provides detail about feature support and constraints.