विक्रेता गाइड: विज्ञापन नीलामियां करें

सेलर एपीआई की गाइड और Protected Audience API की विज्ञापन नीलामी के रेफ़रंस.

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

पूरी जानकारी के लिए डेवलपर गाइड पढ़ें Protected Audience API का साइकल इस्तेमाल किया जा सकता है. साथ ही, विक्रेता, डिवाइस पर नीलामी कैसे करते हैं.

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

Protected Audience API से जुड़ी विज्ञापन नीलामी क्या होती है?

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

Protected Audience API की विज्ञापन नीलामी के छह चरण
इस डायग्राम में, Protected Audience API से विज्ञापन नीलामी के हर चरण के बारे में बताया गया है.
  1. उपयोगकर्ता किसी ऐसी साइट पर जाता है जो विज्ञापन दिखाती है.
  2. सेलर का कोड, navigator.runAdAuction() को एक्ज़ीक्यूट करता है. इससे पता चलता है कि विज्ञापन स्पेस बिक्री के लिए है और इसके लिए कौन बोली लगा सकता है. विक्रेताओं को एक स्क्रिप्ट भी शामिल करनी होगी जो scoreAd(), प्रत्येक बोली का स्कोर देती है.
  3. आमंत्रित खरीदार का कोड किसी प्रासंगिक विज्ञापन के लिए बोली, URL जनरेट करने का काम शुरू करता है और अन्य डेटा. बिडिंग स्क्रिप्ट, रीयल-टाइम डेटा, जैसे, खरीदार के विज्ञापन कैंपेन का बचा हुआ बजट कुंजी/वैल्यू से जुड़ी सेवा.
  4. विक्रेता का कोड प्रत्येक बोली को स्कोर देता है और एक विजेता का चयन करता है. यह लॉजिक, बिड की वैल्यू और अन्य डेटा से, बिड को बेहतर बनाने में मदद मिलती है. वे विज्ञापन जिन्हें हराया नहीं जा सकता संदर्भ के हिसाब से विजेता को अस्वीकार कर दिया जाता है. सेलर अपनी ऐसेट का इस्तेमाल कर सकते हैं रीयल-टाइम डेटा के लिए कुंजी/वैल्यू सेवा.
  5. विजेता विज्ञापन को एक ओपेक मान के रूप में लौटाया जाता है, जो फ़ेंस किया गया फ़्रेम होना चाहिए. विक्रेता और पब्लिशर यह वैल्यू नहीं देख पाएगा.
  6. नीलामी की रिपोर्ट, सेलर और जीतने वाले खरीदारों को दी जाती है.

नीलामी कब होती है?

Protected Audience API, अकेले या प्रोग्रामैटिक नीलामियों की मदद से भी चलाया जा सकता है. एक से ज़्यादा सेलर वाले कैंपेन में, प्रोग्रैम्ड तरीके से नीलामी:

  1. उपयोगकर्ता, हिस्सा लेने वाली किसी साइट पर जाता है.
  2. प्रोग्राम के हिसाब से अपने-आप होने वाली नीलामी को कोई दूसरा सेलर चलाता है. इससे वह किसी उपलब्ध विज्ञापन स्लॉट के लिए, काम का विज्ञापन ढूंढता है.
  3. Protected Audience API की नीलामी चल रही है.
  4. scoreAd()खरीदार की बिड की तुलना पहली नीलामी के नतीजों से करता है.

ऐसी बिड अस्वीकार कर दी जाती हैं जो कीवर्ड और ट्रैफ़िक के हिसाब से सबसे सही बिड को पीछे छोड़ सकती हैं.

Protected Audience API से जुड़ी विज्ञापन नीलामी कौन चलाता है?

ऐसे कई पक्ष हैं जो विज्ञापन स्पेस बेचने के लिए नीलामी कर सकते हैं.

उदाहरण के लिए:

  • कॉन्टेंट पब्लिशर: अपनी वेबसाइट पर विज्ञापन के कॉन्टेंट को होस्ट करने के लिए काम करता है.
  • सप्लाई-साइड प्लैटफ़ॉर्म (SSP): पब्लिशर के साथ काम करना और अन्य सेवाएं देना.
  • तीसरे पक्ष की स्क्रिप्ट: यह पब्लिशर के लिए काम करती है, ताकि विज्ञापन नीलामियों में हिस्सा लिया जा सके.

Protected Audience API की मदद से, सेलर को तीन काम मिलते हैं:

  • प्रकाशक के नियम लागू करें: कौनसे खरीदार और कौनसी बोलियां लागू की जा सकती हैं.
  • नीलामी का लॉजिक: JavaScript को इस मोड में चलाएं वर्कलेट की मदद से हर बिड के लिए ज़रूरी स्कोर.
  • नीलामी के नतीजे की रिपोर्ट करें.

ये जॉब प्रोग्राम के हिसाब से, विक्रेता के दिए गए कोड में प्रोग्राम के हिसाब से तब किए जाते हैं, जब यह JavaScript फ़ंक्शन को कॉल करके विज्ञापन नीलामी को शुरू करता है navigator.runAdAuction().

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

runAdAuction()

विक्रेता, उपयोगकर्ता के ब्राउज़र को navigator.runAdAuction() पर कॉल करके, विज्ञापन नीलामी शुरू करने का अनुरोध करता है.

उदाहरण के लिए:

const auctionConfig = {
  seller: 'https://ssp.example',
  decisionLogicUrl: ...,
  trustedScoringSignalsUrl: ...,
  interestGroupBuyers: ['https://dsp.example', 'https://buyer2.example', ...],
  auctionSignals: {...},
  sellerSignals: {...},
  sellerTimeout: 100,
  perBuyerSignals: {
    'https://dsp.example': {...},
    'https://another-buyer.example': {...},
    ...
  },
  perBuyerTimeouts: {
    'https://dsp.example': 50,
    'https://another-buyer.example': 200,
    '*': 150,
    ...
  },
  componentAuctions: [
    {
      'seller': 'https://some-other-ssp.example',
      'decisionLogicUrl': ...,
      ...
    },
    ...
  ]
};

try {
  const auctionResultPromise = navigator.runAdAuction(auctionConfig);
} catch (error) {
  // Handle error.
}

runAdAuction() ऐसा प्रॉमिस देता है जो URN (urn:uuid:<something>) की वैल्यू दिखाता है, जो विज्ञापन नीलामी के नतीजे. इसे ब्राउज़र से सिर्फ़ तब डिकोड किया जा सकता है, जब इसे फ़ेंस किए गए फ़्रेम में पास किया गया हो रेंडरिंग के लिए: पब्लिशर पेज, जीतने वाले विज्ञापन की जांच नहीं कर सकता.

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

auctionConfig प्रॉपर्टी

seller
ज़रूरी है
जैसे: 'https://ssp.example'
भूमिका: विक्रेता की शुरुआत.
decisionLogicUrl
ज़रूरी है
जैसे: 'https://ssp.example/auction-decision-logic.js'
भूमिका: नीलामी के वर्कलेट की JavaScript के लिए यूआरएल.
trustedScoringSignalsUrl
ज़रूरी नहीं है
जैसे: 'https://ssp.example/scoring-signals'
भूमिका: विक्रेता के भरोसेमंद सर्वर का यूआरएल.
interestGroupBuyers
ज़रूरी है
जैसे: ['https://dsp.example', 'https://buyer2.example', ...]
भूमिका: इंटरेस्ट ग्रुप के उन सभी मालिकों के ऑरिजिन जिन्हें नीलामी में बिड करने का अनुरोध किया गया है.
अहम जानकारी: सेलर, सभी इंटरेस्ट ग्रुप को बिड करने की अनुमति देने के लिए interestGroupBuyers: तय कर सकता है. इसके बाद, इंटरेस्ट ग्रुप के मालिक को शामिल करने के अलावा, किसी दूसरी शर्त के आधार पर विज्ञापनों को स्वीकार या अस्वीकार किया जाता है. उदाहरण के लिए, सेलर अपनी नीतियों के पालन की पुष्टि करने के लिए, विज्ञापन क्रिएटिव की समीक्षा कर सकता है.
auctionSignals
ज़रूरी नहीं है
जैसे: {...}
भूमिका: विक्रेता के बारे में पेज के कॉन्टेक्स्ट, नीलामी के टाइप वगैरह के बारे में जानकारी.
sellerSignals
ज़रूरी नहीं है
जैसे: {...}
भूमिका: प्रकाशक सेटिंग के आधार पर जानकारी, संदर्भ के हिसाब से विज्ञापन का अनुरोध करना वगैरह.
sellerTimeout
ज़रूरी नहीं है
जैसे: 100
भूमिका: विक्रेता की scoreAd() स्क्रिप्ट का ज़्यादा से ज़्यादा रनटाइम (मि॰से॰).
perBuyerSignals
ज़रूरी नहीं है
उदाहरण: 
{'https://dsp.example': {...}, 'https://another-buyer.example': {...}, ... }
भूमिका: हर खरीदार के लिए, पेज के बारे में जानकारी देने वाले सिग्नल. ये सिग्नल उनके सर्वर से मिलते हैं.
perBuyerTimeouts
ज़रूरी नहीं है
जैसे: 50
भूमिका: किसी खरीदार की generateBid() स्क्रिप्ट का ज़्यादा से ज़्यादा रनटाइम (मि॰से॰).
componentAuctions
ज़रूरी नहीं है
उदाहरण: 
[{'seller': 'https://www.some-other-ssp.com', 'decisionLogicUrl': ..., ...}, ...]
भूमिका: घटक की नीलामियों के लिए अतिरिक्त कॉन्फ़िगरेशन.

decisionLogicUrl

decisionLogicUrl, नीलामी के कॉन्फ़िगरेशन ऑब्जेक्ट की प्रॉपर्टी है, runAdAuction() को पास किया गया. इस URL में scoreAd() फ़ंक्शन का इस्तेमाल करें. इस लॉजिक को हर विज्ञापन के लिए एक बार चलाया जाता है अपनी पसंद का पता लगा सके.

scoreAd(adMetadata, bid, auctionConfig, trustedScoringSignals, browserSignals) {
  ...
  return desirabilityScoreForThisAd;
}

browserSignals

browserSignals एक ऑब्जेक्ट है, जिसे ब्राउज़र ने बनाया है. इसमें जानकारी शामिल है और विक्रेता की नीलामी स्क्रिप्ट सत्यापित करें:

{
  topWindowHostname: 'publisher.example',
  interestGroupOwner: 'https://dsp.example',
  renderUrl: 'https://cdn.example/render',
  adComponents: ['https://cdn.com/ad-component-1', ...],
  biddingDurationMsec: 12,
  dataVersion: 1 /* DValue from the seller's Key/Value service response. */
}

नीलामी शुरू होने से पहले, विक्रेता उपलब्ध विज्ञापन स्लॉट. scoreAd() लॉजिक का हिस्सा ऐसे किसी भी विज्ञापन को अस्वीकार कर देता है जो उन्होंने सबसे सही कीवर्ड को पीछे छोड़ दिया.

scoreAd()

scoreAd() में ये आर्ग्युमेंट इस्तेमाल किए जाते हैं:

आर्ग्यूमेंट भूमिका
adMetadata खरीदार से मिला आर्बिट्ररी मेटाडेटा.
auctionConfig नीलामी कॉन्फ़िगरेशन ऑब्जेक्ट navigator.runAdAuction() को पास किया गया.
bid एक अंकीय बोली मान.
trustedScoringSignals नीलामी के समय विक्रेता के भरोसेमंद सर्वर से मिली वैल्यू, जो विज्ञापन के बारे में विक्रेता की राय दिखाती हैं.

अक्सर पूछे जाने वाले सवाल

नीलामी के विजेता कैसे तय होते हैं और उन्हें कौन चुनता है?

विक्रेता हर विज्ञापन का मनचाहा स्कोर तय करने के लिए स्कोरिंग लॉजिक उपलब्ध कराता है और ब्राउज़र सबसे ज़्यादा स्कोर को जीतने वाले विज्ञापन के तौर पर चुनता है.

विक्रेता, scoreAd() फ़ंक्शन में लॉजिक शामिल करता है और ब्राउज़र ऐसे वर्कलेट में फ़ंक्शन को एक्ज़ीक्यूट करता है जिसके बाहर मौजूद कोड के साथ सीमित कम्यूनिकेशन होता है. ब्राउज़र अपने आप विज्ञापनों को स्कोर नहीं करता. स्कोरिंग लॉजिक को एक्ज़ीक्यूट करने और सबसे ज़्यादा स्कोर वाली बिड चुनने की ज़िम्मेदारी ब्राउज़र की होती है.

Protected Audience API से जुड़े सभी रेफ़रंस

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

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