एसएसपी के लिए, Protected Audience को पहले FLEDGE के नाम से जाना जाता था. साथ ही, इंटिग्रेशन और टेस्टिंग गाइड

Privacy Sandbox के हिस्से के तौर पर, Chrome ने सुरक्षित ऑडियंस एपीआई, ब्राउज़र में मौजूद एपीआई इसकी मदद से, विज्ञापन देने वाले लोग या कंपनियां और विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनियां, इंटरेस्ट ग्रुप चुनकर उन्हें टारगेट कर सकती हैं (ऑडियंस की सूचियां) और उपयोगकर्ताओं को सुरक्षित रखते हुए, तीसरे पक्ष की कुकी के भरोसे न रहें ट्रैक किया जा सकता है. डेवलपर गाइड

SSP, Display &Video 360 के साथ Protected Audience API की जांच कर सकती हैं Video 360 और Google Ads से:

• Protected Audience API फ़्लो के असर के बारे में जानकारी मिलती है और उसे बार-बार दोहराया जाता है.
• सार्वजनिक जगहों पर, एपीआई में होने वाले संभावित सुधारों पर सुझाव देना और सुझाव देना फ़ोरम—उदाहरण के लिए, GitHub.
• Protected Audience की मदद से, लोगों के हिसाब से विज्ञापन दिखाने की सुविधा को बढ़ावा देने की तैयारी करना तीसरे पक्ष की कुकी के बिना एपीआई का इस्तेमाल करें.

नीचे दी गई गाइड में, SSP और Display &Display के बीच इंटिग्रेशन की जानकारी दी गई है Video 360 और Google Ads. जांच कोऑर्डिनेट करने में दिलचस्पी रखने वाले एसएसपी को प्रोग्राम में शामिल होना चाहिए अन्य लोगों से संपर्क करें Video 360 पार्टनरशिप का प्रतिनिधि.

रजिस्ट्रेशन

एसएसपी को रजिस्टर करना चाहिए खुद को Protected Audience API का इस्तेमाल करना होगा.

विज्ञापन दिखाने के फ़्लो की खास जानकारी

नीचे दिया गया डायग्राम, Chrome, SSP, Display & Display & Video 360 के बीच के मुख्य इंटरैक्शन पॉइंट को बताने वाला सामान्य फ़्लो दिखाता है Video 360 और Google Ads.

एकीकरण विकल्प

पहला विकल्प: डायरेक्ट / एक सेलर वाला खाता

कदम:

1. SSP विज्ञापन टैग, SSP सर्वर को विज्ञापन अनुरोध भेजता है. इससे पता चलता है कि ब्राउज़र Protected Audience API के साथ काम करता है.
2. SSP सर्वर, DSP को संदर्भ के हिसाब से OpenRTB बोली अनुरोध भेजता है. इससे पता चलता है कि ब्राउज़र, Protected Audience API के साथ काम करता है
3. डीएसपी, OpenRTB बिड रिस्पॉन्स के साथ जवाब देता है. इसमें उपयोगकर्ता के डिवाइस पर नीलामी.
4. SSP सर्वर, नीलामी के कॉन्फ़िगरेशन के साथ SSP विज्ञापन टैग को विज्ञापन रिस्पॉन्स भेजता है.
5. SSP विज्ञापन टैग, कॉल करके उपयोगकर्ता के डिवाइस पर नीलामी की शुरुआत करता है runAdAuction() DSP की OpenRTB बोली प्रतिक्रिया से सिग्नल पास करना perBuyerSignals.
6. Chrome, कुंजी/वैल्यू का भरोसेमंद डीएसपी बिडिंग सर्वर को कॉल करता है का इस्तेमाल करें.
7. Chrome कॉल generateBid() DSP JavaScript फ़ंक्शन. यह सुविधा, इस प्रोग्राम में हिस्सा लेने वाले सभी इंटरेस्ट ग्रुप के लिए उपलब्ध है.
8. Chrome, Key/Value भरोसेमंद SSP स्कोरिंग सर्वर को कॉल करता है का इस्तेमाल करें.
9. Chrome कॉल scoreAd() SSP JavaScript फ़ंक्शन, जो इस प्रोग्राम में हिस्सा लेने वाले सभी इंटरेस्ट ग्रुप के लिए है.
10. Chrome कॉल reportWin() DSP JavaScript फ़ंक्शन. इसका इस्तेमाल DSP को विजेता की जानकारी देने के लिए किया जाता है.
11. Chrome कॉल reportResult() SSP JavaScript फ़ंक्शन का इस्तेमाल करके, SSP को विजेता की जानकारी दें.

SSP की ओर से किए जाने वाले कम से कम बदलाव

• SSP विज्ञापन टैग को इसमें अपडेट करना ज़रूरी है

  • पता लगाएं कि ब्राउज़र, Protected Audience API की सुविधा देता है या नहीं
  • विज्ञापन अनुरोध के तहत, एसएसपी सर्वर [1] को यह जानकारी भेजें
  • runAdAuction() पास को कॉल करके, उपयोगकर्ता के डिवाइस पर नीलामी शुरू करें डीएसपी के OpenRTB बिड रिस्पॉन्स [5] से मिले सिग्नल (इस पर खरीदार का डेटा फ़ील्ड देखें बिड रिक्वेस्ट और रिस्पॉन्स का स्ट्रक्चर नीचे बताया गया है).

• SSP सर्वर को यह काम करना होगा

  • Protected Audience API से जुड़ी सहायता के बारे में जानकारी को डीएसपी में लागू करें OpenRTB बिड रिक्वेस्ट [2] में मौजूद फ़ील्ड के ज़रिए (बिड से जुड़ा सेक्शन देखें) अनुरोध और जवाब का स्ट्रक्चर नीचे दिया गया है).
  • SSP विज्ञापन के लिए, OpenRTB बिड रिस्पॉन्स में डीएसपी के खरीदार के सिग्नल लागू करें टैग (नीचे बिड रिक्वेस्ट / बिड रिस्पॉन्स स्ट्रक्चर पर सेक्शन देखें) [4]

• [Optional] रीयलटाइम फ़ेच करने के लिए SSP को भरोसेमंद SSP सर्वर लागू करना होगा विज्ञापन की क्वालिटी की जांच और पब्लिशर सेटिंग को लागू करने में मदद करने के लिए, स्कोरिंग सिग्नल [8]

• एसएसपी को "scoreAd(...)" और "reportResult(...)" के साथ JavaScript लागू करना होगा फ़ंक्शन [9], [11]

दूसरा विकल्प: एक से ज़्यादा सेलर

कदम:

1. SSP अडैप्टर, SSP सर्वर को विज्ञापन अनुरोध भेजता है. इससे पता चलता है कि ब्राउज़र Protected Audience API के साथ काम करता है.
2. SSP सर्वर, DSP को संदर्भ के हिसाब से OpenRTB बोली अनुरोध भेजता है. इससे पता चलता है कि यह ब्राउज़र, Protected Audience API के साथ काम करता है.
3. डीएसपी सर्वर, OpenRTB बिड रिस्पॉन्स के साथ जवाब देता है. इसमें उपयोगकर्ता के डिवाइस पर नीलामी.
4. SSP सर्वर, नीलामी के कॉन्फ़िगरेशन के साथ SSP विज्ञापन टैग को विज्ञापन रिस्पॉन्स भेजता है.
5. SSP प्रीबिड अडैप्टर, पब्लिशर विज्ञापन सर्वर को कॉम्पोनेंट नीलामी का कॉन्फ़िगरेशन उपलब्ध कराता है टैग के साथ जोड़ा जा सकता है.
6. पब्लिशर का विज्ञापन सर्वर टैग, पब्लिशर के विज्ञापन सर्वर के सर्वर को विज्ञापन अनुरोध भेजता है.
7. पब्लिशर का विज्ञापन सर्वर टैग, उपयोगकर्ता के डिवाइस पर नीलामी की शुरुआत करने के लिए, runAdAuction(...) एपीआई.
8. Chrome, कुंजी/वैल्यू का भरोसेमंद डीएसपी बिडिंग सर्वर को कॉल करता है का इस्तेमाल करें.
9. Chrome कॉल generateBid() DSP JavaScript फ़ंक्शन का इस्तेमाल करना होगा.
10. Chrome, कुंजी/वैल्यू भरोसेमंद एसएसपी स्कोरिंग सर्वर को कॉल करता है का इस्तेमाल करें.
11. Chrome कॉल scoreAd() SSP JavaScript फ़ंक्शन. यह सुविधा, इस प्रोग्राम में हिस्सा लेने वाले सभी इंटरेस्ट ग्रुप के लिए उपलब्ध है.
12. Chrome कॉल reportWin() DSP JavaScript फ़ंक्शन का इस्तेमाल करके, DSP को विजेता की जानकारी देना.
13. Chrome कॉल reportResult() SSP JavaScript फ़ंक्शन का इस्तेमाल करके, SSP को विजेता की जानकारी दें.

SSP की ओर से किए जाने वाले कम से कम बदलाव

• SSP अडैप्टर को इससे अपडेट करने की ज़रूरत है

  • पता लगाएं कि ब्राउज़र, Protected Audience के साथ काम करता है या नहीं
  • विज्ञापन अनुरोध के तहत, एसएसपी सर्वर [1] को यह जानकारी भेजें
  • पब्लिशर विज्ञापन सर्वर के विज्ञापन टैग [5] में कॉम्पोनेंट की नीलामी का कॉन्फ़िगरेशन उपलब्ध कराएं.
  • अगर Google Ad Manager पब्लिशर का विज्ञापन सर्वर है, तो SSP सिर्फ़ ये काम कर सकता है: * प्रीबिड सुरक्षित ऑडियंस का इस्तेमाल करें मॉड्यूल * Google Ad Manager विज्ञापन टैग setConfig() को कॉल करें एपीआई एक से ज़्यादा सेलर

• SSP सर्वर को यह काम करना होगा

  • Protected Audience Support के बारे में जानकारी देने के लिए, डीएसपी को OpenRTB बिड रिक्वेस्ट [2] में फ़ील्ड (बिड से जुड़ा सेक्शन देखें) अनुरोध और रिस्पॉन्स का स्ट्रक्चर नीचे दिया गया है).
  • SSP विज्ञापन के लिए OpenRTB बिड रिस्पॉन्स में डीएसपी के खरीदार के सिग्नल लागू करें टैग (नीचे बिड रिक्वेस्ट / बिड रिस्पॉन्स स्ट्रक्चर पर सेक्शन देखें) [4]

• [Optional] रीयलटाइम फ़ेच करने के लिए SSP को भरोसेमंद SSP सर्वर लागू करना होगा विज्ञापन की क्वालिटी की जांच और पब्लिशर सेटिंग को लागू करने में मदद करने के लिए, स्कोरिंग सिग्नल [10]

• SSP को scoreAd() और reportResult() के साथ JavaScript को सार्वजनिक करना होगा फ़ंक्शन [11], [14].

बिडिंग और नीलामी से जुड़ी सेवाएं

हम बिडिंग और बिडिंग की रणनीति का बारीकी से आकलन कर रहे हैं. नीलामी से जुड़ी सेवाएं (B&A) proposal.

जब प्रदर्शन और Video 360 में, Protected Audience API और B&A की जांच की जा सकती है, हम ज़्यादा जानकारी देने के लिए आपसे संपर्क करेंगे.

OpenRTB प्रोटोकॉल

बिड रिक्वेस्ट

Protected का समर्थन करने वाले इंप्रेशन अवसरों के बीच अंतर करने के लिए Audience API की ऑन-डिवाइस नीलामी, जो सिर्फ़ स्टैंडर्ड के साथ काम करती है सर्वर-साइड एक्सचेंज नीलामी, "नीलामी के लिए ae" नाम का एक नया Enum फ़ील्ड वातावरण" इसे OpenRTB में Imp ऑब्जेक्ट में एक्सटेंशन के तौर पर जोड़ा जाना चाहिए बिड रिक्वेस्ट यह बताने के लिए है कि विज्ञापन देने वाली कंपनी, नीलामी के किस एनवायरमेंट का इस्तेमाल करती है इंप्रेशन स्लॉट के बारे में ज़्यादा जानें. ae ईनम के ये मान हो सकते हैं:

• 0: सर्वर साइड की स्टैंडर्ड नीलामियां
• 1: Protected Audience API की सुविधा वाले अनुरोध, जिनमें नीलामी, एक्सचेंज के सर्वर और इंटरेस्ट ग्रुप की बिडिंग पर चलती है और ब्राउज़र में चलने वाली आखिरी नीलामी

{
  "id": …
  "imp": [{
    "id": "1"
    "video": {...}
    "ext": {
      "ae": 1
    }]
}

बिड रिस्पॉन्स

संदर्भ के हिसाब से बिड के अलावा, बिड रिस्पॉन्स का इस्तेमाल, आपके काम की जानकारी, Display & इसमें, Video 360 और Google Ads की भागीदारी Protected Audience API इंटरेस्ट ग्रुप की नीलामियां. बोली प्रतिक्रिया अपडेट कर दी गई है इंटरेस्ट ग्रुप वाली नीलामियों को इस तरह से सहायता दे सकते हैं:

{
  "seatbid": [{
    "bid": [{
      … // Traditional contextual bids
    }]
  }],

  "ext": {
    // InterestGroupBidding object which holds information for running an
    // in-browser interest group auction.
    "igbid": [{
      // ID of the Imp object of the impression to which
      // these interest group bidding signals apply to.
      "impid": "1",

      // InterestGroupBuyer object which holds DSP information for the in-browser
      // auction.
      "igbuyer": [{
        // Origin of Display & Video 360 and Google Ads to participate in the
        // interest group auction. For more info regarding the origin see:
        // https://developer.mozilla.org/en-US/docs/Glossary/Origin
        "origin": "https://td.doubleclick.net",

        // Buyer-specific signals to use in auctionConfig as perBuyerSignals.
        // Used by the buyer's interest group bidding function. Can be left empty
        "buyerdata": ...,

        // Buyer experiment group id to support coordinated experiments with
        // buyers' trusted servers. This experiment id should be added to the
        // `perBuyerExperimentGroupIds` map in auctionConfig.
        "buyer_experiment_group_id": 12345
      }]
    }]
  }
}

इन स्थितियों में पुष्टि की जा सकती है.

• पहली क्रम: Display & वीडियो 360 और Google Ads सिर्फ़ इसमें शामिल होना चाहते हैं का इस्तेमाल कर सकते हैं. इस स्थिति में कोई igbid फ़ील्ड मौजूद नहीं है.

• दूसरी क्रम: Display & वीडियो 360 और Google Ads सिर्फ़ इसमें शामिल होना चाहते हैं दिलचस्पी के आधार पर होने वाली नीलामी में. इस स्थिति में, Display & Video 360 और Google Ads, बिड रिस्पॉन्स में सीटबिड फ़ील्ड डाल देगा और सिर्फ़ igbid जानकारी नहीं मिलेगी. दूसरे शब्दों में, igbid फ़ील्ड की मौजूदगी से पता चलता है कि तथ्य यह है कि Display & Video 360 और Google Ads को अपने इंटरेस्ट ग्रुप की ज़रूरत है हिस्सा लेने के लिए डिज़ाइन किया गया है.

• तीसरी स्थिति: Display & Video 360 और Google Ads इसमें शामिल होना चाहते हैं . इस स्थिति में, Display & वीडियो 360 और Google Ads, बिड रिस्पॉन्स में सीटबिड फ़ील्ड दिखाएंगे के दायरे में आता है.

विज्ञापन बोली वाला मेटाडेटा

Protected Audience API, passing arbitrary metadata की अनुमति देता है generateBid() फ़ंक्शन से विज्ञापन के बारे में.

डिसप्ले और Video 360, इन चीज़ों पर भरोसा करने की योजना बना रहा है specification मिलेगी: Protected Audience API और OpenRTB.

डिसप्ले और Video 360, विज्ञापन के हिस्से के तौर पर इन फ़ील्ड दिखाएगा ऑब्जेक्ट:

पीए एट्रिब्यूट	टाइप	OpenRTB का ब्यौरा
ad.seat	String; आवश्यक	उस खरीदार की सीट (जैसे कि विज्ञापन देने वाले व्यक्ति या कंपनी या एजेंसी) का आईडी जिसकी ओर से यह बिड की गई है.
ad.adomain	String[]	ब्लॉक सूची की जांच के लिए, विज्ञापन देने वाले व्यक्ति या कंपनी का डोमेन (उदाहरण के लिए, "ford.com"). यह रोटेटिंग क्रिएटिव के मामले में एक कलेक्शन हो सकता है. एक्सचेंज, यह आदेश दे सकते हैं कि सिर्फ़ एक डोमेन की अनुमति है.
ad.cid	स्ट्रिंग	विज्ञापन की क्वालिटी की जांच करने में मदद के लिए कैंपेन आईडी.
ad.crid	स्ट्रिंग	विज्ञापन की क्वालिटी की जांच करने में मदद के लिए क्रिएटिव आईडी.
ad.language	स्ट्रिंग	ISO-639-1-alpha-2 का इस्तेमाल करने वाले क्रिएटिव की भाषा. बिना स्टैंडर्ड वाला कोड "xx" अगर क्रिएटिव में भाषा से जुड़ा कॉन्टेंट नहीं है, तब भी उसका इस्तेमाल किया जा सकता है (उदाहरण के लिए, सिर्फ़ कंपनी के लोगो वाला बैनर). भाषा या langb में से सिर्फ़ एक मौजूद होना चाहिए.
ad.w	पूर्णांक	डिवाइस इंडिपेंडेंट पिक्सल (DIPS) में क्रिएटिव की चौड़ाई.
ad.h	पूर्णांक	डिवाइस इंडिपेंडेंट पिक्सल (डीआईपीएस) में क्रिएटिव की ऊंचाई.

उदाहरण

{
  "seat": "123"
  "adomain": ["example.com"]
  "cid": "12345"
  "crid": "12345"
  "language": "en"
  "w": 300
  "h": 250
}

इवेंट रिपोर्टिंग

Protected Audience API, इवेंट-लेवल का Reporting API उपलब्ध कराता है. इस एपीआई के बारे में इसमें बताया गया है GitHub पोस्ट: Fenced Frame Ads Reporting. हालांकि, फ़ेंस्ड फ़्रेम वाले विज्ञापनों की रिपोर्टिंग के लिए एपीआई उपलब्ध है फ़ेंस किए गए फ़्रेम और iframes (विवरण देखें) here).

SSP registerAdBeacon() को कॉल किया जा रहा है एपीआई.

डिसप्ले और Video 360 में reportEvent() को कॉल किया जाएगा 'कॉम्पोनेंट-सेलर' डेस्टिनेशन वाला एपीआई क्रिएटिव से लेकर रिपोर्ट तक इंप्रेशन और क्लिक इवेंट. इस तरह एक बीकन को रजिस्टर किया गया यूआरएल.

ध्यान दें कि Display & इंप्रेशन और इंप्रेशन के लिए, Video 360, reportEvent() API को कॉल करेगा खाली पोस्ट डेटा वाले क्लिक.

उदाहरण

registerAdBeacon({
 'impression': 'https://ssp.example/impression?ssp_event_id=abc',
});
registerAdBeacon({
 'click': 'https://ssp.example/click?ssp_event_id=abc',
});

कुकी के इस्तेमाल पर रोक लगाने का टेस्ट लेबल

डिसप्ले और Video 360, Chrome-facilitated testing में हिस्सा लेगा तीसरे पक्ष की कुकी का इस्तेमाल बंद होना. टेस्टिंग करने के लिए, हम अपने सभी पार्टनर को यह अनुमति देने के लिए कहते हैं नीचे दिए गए निर्देशों के मुताबिक, OpenRTB बिड रिक्वेस्ट में हमें Chrome लेबल भेजें specification:

ऑब्जेक्ट: Device.ext

एट्रिब्यूट	टाइप	ब्यौरा
सीडीईपी	स्ट्रिंग	Chrome या अपस्ट्रीम पार्टनर से मिला लेबल.

मिलते-जुलते दस्तावेज़

• Chrome Developers पर, Protected Audience API
• GitHub पर पहला एक्सपेरिमेंट