प्राइवसी सैंडबॉक्स से जुड़े विज्ञापनों के लिए, काम की जानकारी और मेज़रमेंट एपीआई की जांच करना

प्राइवसी सैंडबॉक्स में ऐसे कई प्रपोज़ल शामिल हैं जिनसे विज्ञापन के इस्तेमाल को चालू किया जा सकता है. ऐसा करने के लिए, क्रॉस-साइट ट्रैकिंग की ज़रूरत नहीं होती. ऑरिजिन ट्रायल की सुविधा, डेवलपर को असल दुनिया में की जाने वाली जांच की मदद से, नई वेब टेक्नोलॉजी का आकलन करने और उनके बारे में सुझाव/राय देने या शिकायत करने का मौका देती है. पिछले ऑरिजिन ट्रायल में, साइटों को अलग-अलग एपीआई के हिसाब से टेस्ट करने की सुविधा मिली है. Topics, FLEDGE, और Attribution Reporting API के लिए हम सिंगल ऑरिजिन ट्रायल उपलब्ध करा रहे हैं. इससे साइटें, सभी एपीआई पर यूनिफ़ाइड एक्सपेरिमेंट चला सकती हैं. साथ ही, शुरू से लेकर आखिर तक विज्ञापन की लाइफ़साइकल का शुरुआती वर्शन बना सकती हैं. ये एपीआई, Chrome 101 के बीटा और इसके बाद के वर्शन में जांच के लिए उपलब्ध हैं. Chrome 101 के बीटा वर्शन में, उपयोगकर्ता के कंट्रोल से जुड़े अपडेट भी दिखते हैं. ऐसा इसलिए होता है, क्योंकि हम कॉन्फ़िगरेशन के विकल्पों को लगातार लागू करते रहते हैं.

डेवलपर के तौर पर, आपके पास इस सिंगल ऑरिजिन ट्रायल के लिए साइन अप करने का विकल्प होगा. इससे आपको Topics, FLEDGE, और एट्रिब्यूशन रिपोर्टिंग एपीआई पर टेस्ट करने की अनुमति मिलेगी. यह गाइड आपको एपीआई ऐक्सेस करने के लिए, कॉन्फ़िगरेशन के चरणों के बारे में जानकारी देती है. साथ ही, कॉन्फ़िगरेशन की पुष्टि करने का तरीका बताती है और एपीआई के हिसाब से जांच करने के लिए और संसाधन भी उपलब्ध कराती है.

ऑरिजिन ट्रायल में क्या है?

इस ऑरिजिन ट्रायल का मकसद कई साइटों पर विज्ञापन लाइफ़साइकल के दौरान, काम की टेस्टिंग की अनुमति देना है. इस यात्रा को कवर करने के लिए, ऑरिजिन ट्रायल में ये चीज़ें शामिल हैं:

  • Topics, ताकि आप document.browsingTopics() की मदद से, ब्राउज़र के विषय देख सकें और उन्हें ऐक्सेस कर सकें.
  • FLEDGE का इस्तेमाल, ब्राउज़र के इंटरेस्ट ग्रुप के साथ-साथ विज्ञापन बिडिंग और उन ग्रुप और अन्य सिग्नल के आधार पर चुने गए ग्रुप को मैनेज करने के लिए किया जा सकता है.
    • इस ऑरिजिन ट्रायल में, FLEDGE को डेस्कटॉप पर उपलब्ध कराया गया है और इसमें सुझाए गए सभी फ़ंक्शन का एक खास सबसेट शामिल है. ज़्यादा जानकारी के लिए, FLEDGE के ऑरिजिन ट्रायल की जानकारी पढ़ें.
  • FLEDGE विज्ञापन नीलामी के विजेता के ओपेक यूआरएल को रेंडर करने के लिए, फ़ेंस किए गए फ़्रेम.
  • Attribution Reporting की मदद से, विज्ञापन की लाइफ़साइकल के दौरान परफ़ॉर्मेंस को मेज़र करने की सुविधा मिलती है.
    • एट्रिब्यूशन रिपोर्टिंग के हिस्से के तौर पर, खास जानकारी वाली रिपोर्ट बनाने के लिए एग्रीगेट रिपोर्ट को किसी एग्रीगेशन सेवा की मदद से प्रोसेस और एग्रीगेट किया जाना चाहिए. हम जल्द ही स्थानीय और ऑरिजिन ट्रायल टेस्टिंग के लिए अतिरिक्त टूल और गाइड पब्लिश करेंगे.
    • अगर आपने एट्रिब्यूशन रिपोर्टिंग के पिछले ऑरिजिन ट्रायल में हिस्सा लिया है, तो ध्यान रखें कि आपको एपीआई में हुए नए बदलावों के हिसाब से, पिछले ऑरिजिन ट्रायल को अपडेट करना होगा. ज़्यादा जानकारी के लिए, माइग्रेशन गाइड देखें.

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

डेवलपर ऑरिजिन ट्रायल के लिए साइन अप कैसे करते हैं?

प्राइवसी सैंडबॉक्स की प्रासंगिकता और मेज़रमेंट ट्रायल के लिए रजिस्टर करें. यहां दिए गए एचटीएमएल टैग की मदद से, हर उस पेज पर ट्रायल टोकन दें जिस पर आपको एपीआई कोड चलाना है:

  • टॉप लेवल पेज के <head> सेक्शन में <meta> टैग: <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
  • टॉप-लेवल पेज रिस्पॉन्स में एचटीटीपी हेडर: Origin-Trial: TOKEN_GOES_HERE

ऑरिजिन ट्रायल में उपलब्ध कुछ सुविधाएं, क्रॉस-साइट कॉन्टेक्स्ट में इस्तेमाल के लिए होती हैं. जैसे, टॉप लेवल साइट पर तीसरे पक्ष के तौर पर सेवा देते समय. अगर आपको इन अतिरिक्त कॉन्टेक्स्ट के लिए, ऑरिजिन ट्रायल चालू करना है, तो पक्का करें कि आपने "तीसरे पक्ष से मैचिंग" का विकल्प चुना हो. तीसरे पक्ष के JavaScript से ऑरिजिन ट्रायल को चालू करने के लिए, अपनी स्क्रिप्ट से <meta> टैग को टॉप लेवल पेज (यानी कि पहले पक्ष के पेज, न कि अपने कॉन्टेंट) में इंजेक्ट करें. उदाहरण के लिए:

const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);

ज़्यादा जानकारी के लिए, Chrome के ऑरिजिन ट्रायल का इस्तेमाल शुरू करने की गाइड देखें.

डेवलपर स्थानीय तौर पर टेस्ट कैसे करते हैं?

विषय, एफ़एलईजीई, और एट्रिब्यूशन रिपोर्टिंग के लिए अलग-अलग डेवलपर दस्तावेज़, हर एपीआई के लिए लोकल डेवलपर टेस्टिंग पर खास दिशा-निर्देश देते हैं. एपीआई डिफ़ॉल्ट रूप से चालू नहीं होते हैं और जांच के लिए, इन्हें फ़्लैग के साथ चालू होना चाहिए.

अगर आपको टेस्टिंग के लिए एपीआई चालू करना है, तो:

  • Chrome 101 के बीटा वर्शन या इसके बाद के वर्शन का इस्तेमाल करें.
    • FLEDGE के लिए डेस्कटॉप Chrome की ज़रूरत है.
    • एपीआई, Chrome के iOS वर्शन पर उपलब्ध नहीं हैं.
  • chrome://flags/#privacy-sandbox-ads-apis फ़्लैग का इस्तेमाल करके एपीआई चालू करें.
    • यह फ़्लैग, एपीआई को आसानी से टेस्ट करने के लिए चालू करता है. अगर आपको मंज़ूरी पा चुके ऑरिजिन ट्रायल उपयोगकर्ता को फिर से लागू करना है, जहां उसकी अन्य सेटिंग की वजह से अब भी एपीआई बंद हो सकते हैं, तो आपको सीएलआई फ़्लैग का इस्तेमाल करके Chrome को लॉन्च करना होगा: --enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs.
    • ज़्यादा बारीकी से कॉन्फ़िगरेशन के लिए, अलग-अलग एपीआई में और भी फ़्लैग हो सकते हैं. ज़्यादा जानकारी के लिए, अलग-अलग गाइड देखें.
    • अन्य फ़्लैग भी इससे अलग हो सकते हैं, इसलिए अगर आपको कोई समस्या आती है, तो सिर्फ़ यही फ़्लैग सेट करें.
  • Chrome की सेटिंग में जाकर, प्राइवसी सैंडबॉक्स के ट्रायल को चालू करें: सेटिंग > सुरक्षा और निजता > प्राइवसी सैंडबॉक्स. इसे chrome://settings/adPrivacy पर भी ऐक्सेस किया जा सकता है.
  • Chrome सेटिंग में तीसरे पक्ष की कुकी चालू करें: सेटिंग > सुरक्षा और निजता. कुकी और साइट के अन्य डेटा को "सभी कुकी को अनुमति दें" या "गुप्त मोड में तीसरे पक्ष की कुकी ब्लॉक करें" पर सेट करें. इसे chrome://settings/cookies पर भी ऐक्सेस किया जा सकता है.
  • किसी स्टैंडर्ड ब्राउज़िंग सेशन का इस्तेमाल करना चाहिए. गुप्त मोड का इस्तेमाल न करें.

डेवलपर कैसे देखते हैं कि ऑरिजिन ट्रायल को सही तरीके से कॉन्फ़िगर किया गया है या नहीं?

Chrome के ऑरिजिन ट्रायल से जुड़ी समस्या हल करने से, एक पूरी चेकलिस्ट मिलती है, ताकि ऑरिजिन ट्रायल के आपके कॉन्फ़िगरेशन की पुष्टि की जा सके.

ऐप्लिकेशन में, ऑरिजिन ट्रायल का स्टेटस दिखाने वाला DevTools

DevTools, फ़्रेम के नीचे 'ऐप्लिकेशन' टैब में ऑरिजिन ट्रायल की स्थिति दिखाता है.

ऑरिजिन ट्रायल सिर्फ़ ज़रूरी शर्तें पूरी करने वाले उपयोगकर्ताओं को ही दिखेगा, जैसा कि यहां बताया गया है. हालांकि, अपनी प्रोडक्शन साइट पर टेस्ट करने के लिए, डेवलपर फ़्लैग का भी इस्तेमाल किया जा सकता है.

कौनसे उपयोगकर्ता ऑरिजिन ट्रायल के लिए ज़रूरी शर्तें पूरी करते हैं?

डिज़ाइन के हिसाब से, ऑरिजिन ट्रायल Chrome के पूरे ट्रैफ़िक पर सिर्फ़ एक छोटे हिस्से पर चलाए जाते हैं. आपको हमेशा यह मान लेना चाहिए कि अपनी साइट पर ऑरिजिन ट्रायल चालू करने के बाद भी, उपयोगकर्ता के पास शायद एपीआई चालू न हो. ऑरिजिन ट्रायल में चालू एक्सपेरिमेंट ग्रुप, कम उपयोगकर्ताओं के साथ शुरू होगा और ट्रायल के दौरान इसे और बेहतर बनाया जा सकता है. ध्यान रखें कि हो सकता है कि प्रयोग में Chrome उपयोगकर्ताओं का प्रतिशत, आपकी साइट पर चालू किए गए उपयोगकर्ताओं के प्रतिशत से मेल न खाए.

हालांकि, सभी साइटों पर यूनिफ़ाइड टेस्टिंग की सुविधा को चालू करने के लिए, ज़रूरी शर्तें पूरी करने वाले उपयोगकर्ताओं का सेट लगातार एक जैसा होना चाहिए. उदाहरण के लिए, अगर कोई उपयोगकर्ता, हिस्सा लेने वाली पब्लिशर साइट पर विज्ञापन देखते समय, ऑरिजिन ट्रायल की ज़रूरी शर्तें पूरी करता है, तो उसी उपयोगकर्ता को तब भी मंज़ूरी मिलनी चाहिए, जब वह विज्ञापन देने वाली किसी ऐसी साइट पर ग्राहक में बदलता है जो इस प्रोग्राम में हिस्सा ले रही है.

मंज़ूरी पाने के लिए ज़रूरी है कि उपयोगकर्ता:

  • वह Chrome 101 बीटा या इसके बाद के वर्शन का इस्तेमाल करता हो.
    • FLEDGE के लिए डेस्कटॉप Chrome की ज़रूरत है.
    • Chrome के iOS वर्शन पर ऑरिजिन ट्रायल उपलब्ध नहीं हैं.
  • ऐक्टिव ऑरिजिन ट्रायल अवधि के दौरान ब्राउज़ करते हों.
  • सेटिंग > सुरक्षा और निजता > प्राइवसी सैंडबॉक्स में जाकर, प्राइवसी सैंडबॉक्स ट्रायल की सुविधा चालू करें. इसे chrome://settings/adPrivacy से भी ऐक्सेस किया जा सकता है.
  • उन्हें सेटिंग > सुरक्षा और निजता > कुकी और साइट के अन्य डेटा को "सभी कुकी को अनुमति दें" या "तीसरे पक्ष की कुकी को गुप्त मोड में ब्लॉक करें" पर सेट करके, तीसरे पक्ष की कुकी चालू करनी होगी. इसे chrome://settings/cookies से भी ऐक्सेस किया जा सकता है.
  • स्टैंडर्ड ब्राउज़िंग सेशन का इस्तेमाल किया जा सकता हो और गुप्त मोड में नहीं.
  • Chrome में चालू एक्सपेरिमेंट ग्रुप में होना चाहिए.

डेवलपर को एपीआई की सुविधा के बारे में कैसे पता लगाना चाहिए?

वेब प्लैटफ़ॉर्म की किसी भी अन्य सुविधा की तरह, आपको इसका इस्तेमाल करने से पहले यह पता लगाना चाहिए कि सुविधा उपलब्ध है या नहीं.

विषय

"ब्राउज़िंग-विषय" के लिए, document में browsingTopics() फ़ंक्शन और अनुमतियों की नीति](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeature) में जाएं.

if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
  // Topics enabled
}

फ़्लेज

अगर आपको किसी विज्ञापन इंटरेस्ट ग्रुप में शामिल होना है, तो navigator में joinAdInterestGroup फ़ंक्शन और "join-ad-interest-group" के लिए अनुमतियों की नीति देखें.

if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
  // FLEDGE interest group enabled
}

अगर आपको नीलामी चलानी है, तो navigator में runAdAuctionफ़ंक्शन और "विज्ञापन-नीलामी चलाएं" के लिए अनुमति नीति देखें.

if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
  // FLEDGE auction enabled
}

एट्रिब्यूशन रिपोर्टिंग

"एट्रिब्यूशन-रिपोर्टिंग" के लिए window में attributionReporting ऑब्जेक्ट और अनुमतियों की नीति देखें.

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // Attribution Reporting API enabled
}

डेवलपर कहां सुझाव दे सकते हैं और सहायता पा सकते हैं?

फ़ीडबैक की खास जानकारी देने वाले पेज पर, प्राइवसी सैंडबॉक्स के अलग-अलग पहलुओं पर सुझाव देने के अलग-अलग तरीकों की जानकारी मिलती है. विषय, एफ़एलईजीई, और एट्रिब्यूशन रिपोर्टिंग के लिए खास सेक्शन होते हैं. इन सेक्शन में हर एपीआई के लिए अलग-अलग लिंक होते हैं.

हम प्राइवसी सैंडबॉक्स की सीरीज़ में, प्रोग्रेस के बारे में भी नियमित तौर पर अपडेट देते रहते हैं, जिनमें अहम खबरों की खास जानकारी दी जाती है.