विषय, फ़ेंस किए गए फ़्रेम, और शेयर किया गया स्टोरेज. कीवर्ड: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Beginner
Privacy Sandbox में कुछ सुझाव शामिल हैं. इनकी मदद से, क्रॉस-साइट ट्रैकिंग के बिना विज्ञापन दिखाने के उदाहरणों को चालू किया जा सकता है. ओरिजिन ट्रायल की मदद से, डेवलपर को असल दुनिया में टेस्टिंग करके, नई वेब टेक्नोलॉजी का आकलन करने और उन पर सुझाव देने का मौका मिलता है. Privacy Sandbox के ज़रिए उपयोगकर्ताओं के लिए काम के विज्ञापन दिखाने और मेज़रमेंट के ऑरिजिन ट्रायल में, एक ही ट्रायल उपलब्ध कराया जाता है. इससे साइटों को Attribution Reporting, Protected Audience API, Topics, फ़ेंस किए गए फ़्रेम, और शेयर किए गए स्टोरेज पर एक साथ एक्सपेरिमेंट चलाने की सुविधा मिलती है. डेवलपर, एक ही ऑरिजिन के इस ट्रायल के लिए साइन अप कर सकते हैं. इससे आपको Topics, Protected Audience API, और Attribution Reporting API को टेस्ट करने की सुविधा मिलती है. इस गाइड में, एपीआई को ऐक्सेस करने के लिए कॉन्फ़िगरेशन के चरणों के बारे में बताया गया है. साथ ही, कॉन्फ़िगरेशन की पुष्टि करने का तरीका भी बताया गया है. इसके अलावा, एपीआई की जांच करने के लिए ज़्यादा संसाधन भी उपलब्ध कराए गए हैं.
ऑरिजिन ट्रायल का स्टेटस देखना
जून 2023
स्टेबल वर्शन में, निजी एग्रीगेशन की सुविधा का इस्तेमाल करने वाले उपयोगकर्ताओं की संख्या में 7% की बढ़ोतरी
Private Aggregation API, 6 जून, 2023 को मंगलवार से Chrome के स्टेबल वर्शन के 7% ट्रैफ़िक के लिए उपलब्ध होगा. यह एपीआई, मुख्य यूनिफ़ाइड ऑरिजिन ट्रायल ग्रुप (5%), Protected Audience के अलग किए गए ग्रुप (1%), और शेयर किए गए स्टोरेज के अलग किए गए ग्रुप (1%) में उपलब्ध होगा. सुरक्षित ऑडियंस और शेयर किए गए स्टोरेज के लिए ट्रैफ़िक का बंटवारा नहीं बदलेगा, क्योंकि निजी एग्रीगेशन को अलग-अलग मौजूदा प्रयोगों में जोड़ा जा रहा है.
मंगलवार, 6 जून तक ट्रैफ़िक का बंटवारा:
| एपीआई | ट्रैफ़िक का बंटवारा | स्टेटस |
| Attribution Reporting | यूनिफ़ाइड - 5% | 13 मार्च, 2023 तक, स्थिर ट्रैफ़िक का 6% |
| आइसोलेट किया गया - 1% - सिर्फ़ ARA | ||
| फ़ेंस्ड फ़्रेम | यूनिफ़ाइड - 5% | 13 मार्च, 2023 तक, स्थिर ट्रैफ़िक का 7% |
| अलग-अलग - 1% - शेयर किया गया स्टोरेज + निजी एग्रीगेशन + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| अलग-अलग - 1% - Protected Audience + निजी एग्रीगेशन + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| Protected Audience | यूनिफ़ाइड - 5% | 13 मार्च, 2023 तक, स्थिर ट्रैफ़िक का 6% |
| अलग-अलग - 1% - Protected Audience + निजी एग्रीगेशन + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| Private Aggregation | यूनिफ़ाइड - 5% | 6 जून, 2023 तक, स्थिर ट्रैफ़िक का 7% |
| अलग-अलग - 1% - Protected Audience + निजी एग्रीगेशन + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| अलग-अलग - 1% - शेयर किया गया स्टोरेज + निजी एग्रीगेशन + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| शेयर किया गया स्टोरेज | यूनिफ़ाइड - 5% | 13 मार्च, 2023 तक, स्थिर ट्रैफ़िक का 6% |
| अलग-अलग - 1% - शेयर किया गया स्टोरेज + निजी एग्रीगेशन + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| विषय | यूनिफ़ाइड - 5% | 13 मार्च, 2023 तक, स्थिर ट्रैफ़िक का 6% |
| अलग-अलग - 1% - सिर्फ़ विषय |
पिछले अपडेट
ऑरिजिन ट्रायल के बारे में पिछले अपडेट देखें.
अप्रैल 2023
स्टेबल वर्शन में निजी एग्रीगेशन की सुविधा का 1% रैंप-अप
Private
Aggregation API का ऑरिजिन ट्रायल, 17 अप्रैल, सोमवार से Chrome के स्टैबल वर्शन के 1% यूनिफ़ाइड एक्सपेरिमेंट ट्रैफ़िक के लिए उपलब्ध होगा. Private Aggregation का sendHistogramReport()
फ़ंक्शन, Protected Audience API
और शेयर किए गए स्टोरेज
वर्कलेट में इस्तेमाल किया जा सकता है.
ट्रैफ़िक का बंटवारा 17 अप्रैल, सोमवार से इस तरह दिखेगा:
| एपीआई | ट्रैफ़िक का बंटवारा | स्टेटस |
| Attribution Reporting | यूनिफ़ाइड - 5% | 13 मार्च, 2023 से, स्टैबल ट्रैफ़िक का 6% |
| आइसोलेट किया गया - 1% - सिर्फ़ ARA | ||
| फ़ेंस्ड फ़्रेम | यूनिफ़ाइड - 5% | 13 मार्च, 2023 से, स्टैबल ट्रैफ़िक का 7% |
| अलग-अलग - 1% - शेयर किया गया स्टोरेज (यूआरएल चुनना) + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| अलग - 1% - सिर्फ़ Protected Audience API + Fenced Frames | ||
| Protected Audience API | यूनिफ़ाइड - 5% | 13 मार्च, 2023 से, स्टैबल ट्रैफ़िक का 6% |
| अलग - 1% - सिर्फ़ Protected Audience API + Fenced Frames | ||
| Private Aggregation | यूनिफ़ाइड - 1% | 17 अप्रैल, 2023 से, स्टेबल ट्रैफ़िक का 1% |
| शेयर किया गया स्टोरेज (यूआरएल चुनना) | यूनिफ़ाइड - 5% | 13 मार्च, 2023 से, स्टैबल ट्रैफ़िक का 6% |
| अलग-अलग - 1% - शेयर किया गया स्टोरेज (यूआरएल चुनना) + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| विषय | यूनिफ़ाइड - 5% | 13 मार्च, 2023 से, स्टैबल ट्रैफ़िक का 6% |
| अलग-अलग - 1% - सिर्फ़ विषय |
मार्च 2023
टाइमलाइन से जुड़ा अपडेट
हमने शुरुआत में बताया था कि हम अलग-अलग एक्सपेरिमेंट 13 मार्च, 2023, सोमवार से शुरू करेंगे. हालांकि, एक्सपेरिमेंट सेट अप करने में ज़्यादा समय लगने की वजह से, ये एक्सपेरिमेंट अब 16 मार्च, 2023, गुरुवार से शुरू होंगे. Protected Audience API के लिए, 1% का रैंप अप भी गुरुवार, 16 मार्च, 2023 को होगा.
Protected Audience API को 1% तक बढ़ाना
पिछले महीने, हमने टेस्टिंग के लिए Protected Audience API के ऑरिजिन ट्रायल के ट्रैफ़िक को कुछ समय के लिए कम कर दिया था. यह ट्रैफ़िक, Chrome के स्टैबल वर्शन के 5% से घटकर 4% हो गया था. शुरुआती टेस्टिंग पूरी हो चुकी है. हम 16 मार्च, 2023 गुरुवार को एक साथ किए जा रहे एक्सपेरिमेंट के लिए, Protected Audience API को 4% से बढ़ाकर 5% पर वापस ले जाने वाले हैं.
रैंप-अप किए गए उपयोगकर्ताओं का सेट, रैंप-डाउन किए गए उपयोगकर्ताओं का ही सेट होगा. हालांकि, उनके पिछले इंटरेस्ट ग्रुप की समयसीमा खत्म हो गई है, क्योंकि रैंप-डाउन के 30 दिन से ज़्यादा समय बीत चुका है.
अलग-अलग एक्सपेरिमेंट
अपनी टेस्टिंग प्रोसेस को बेहतर बनाने और ऑरिजिन ट्रायल एपीआई की मेट्रिक को देखते रहने के लिए, हम मौजूदा यूनिफ़ाइड एक्सपेरिमेंट के अलावा, हर एपीआई के लिए अलग-अलग एक्सपेरिमेंट बना रहे हैं. एट्रिब्यूशन रिपोर्टिंग, विषयों, Protected Audience API और फ़ेंस किए गए फ़्रेम के कॉम्बिनेशन, और शेयर किए गए स्टोरेज के यूआरएल चुनने की प्रोसेस और फ़ेंस किए गए फ़्रेम के कॉम्बिनेशन के लिए नए प्रयोग बनाए जाएंगे. अलग-अलग एक्सपेरिमेंट में, उस ग्रुप के उपयोगकर्ताओं के लिए सिर्फ़ असाइन किए गए एपीआई उपलब्ध होंगे.
| एपीआई | अलग-अलग एक्सपेरिमेंट ट्रैफ़िक का बंटवारा |
|---|---|
| Attribution Reporting | 1% |
| Protected Audience API + Fenced Frames | 1% |
| शेयर किया गया स्टोरेज (यूआरएल चुनना) + फ़ेंस किए गए फ़्रेम | 1% |
| विषय | 1% |
ऊपर दिए गए एपीआई के लिए, आपको 16 मार्च, गुरुवार से Chrome के स्टैबल वर्शन पर 1% ज़्यादा ट्रैफ़िक मिलेगा. यह ट्रैफ़िक, यूनिफ़ाइड एक्सपेरिमेंट से मिलने वाले 5% ट्रैफ़िक के अलावा होगा. नए उपयोगकर्ताओं को हर एक्सपेरिमेंट में बांटा जाएगा.
ट्रैफ़िक का बंटवारा
मंगलवार, 28 फ़रवरी तक, यूनिफ़ाइड ऑरिजिन ट्रायल के लिए ट्रैफ़िक का मौजूदा बंटवारा इस तरह है:
| एपीआई | मौजूदा यूनिफ़ाइड एक्सपेरिमेंट ट्रैफ़िक का बंटवारा |
|---|---|
| Attribution Reporting | 5% |
| फ़ेंस्ड फ़्रेम | 5% |
| Protected Audience API | 4% |
| शेयर किया गया स्टोरेज (यूआरएल चुनना) | 5% |
| विषय | 5% |
Protected Audience API के फिर से चालू होने और अलग-अलग प्रयोग शुरू होने के बाद, 16 मार्च गुरुवार से ट्रैफ़िक का बंटवारा इस तरह दिखेगा:
| एपीआई | ट्रैफ़िक का नया बंटवारा | स्थिति |
|---|---|---|
| Attribution Reporting | यूनिफ़ाइड - 5% | 16 मार्च, 2023 से, स्टैबल ट्रैफ़िक का 6% |
| आइसोलेट किया गया - 1% - सिर्फ़ ARA | ||
| फ़ेंस्ड फ़्रेम | यूनिफ़ाइड - 5% | 16 मार्च, 2023 से, स्थिर ट्रैफ़िक का 7% |
| अलग-अलग - 1% - शेयर किया गया स्टोरेज (यूआरएल चुनना) + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| अलग - 1% - सिर्फ़ Protected Audience API + Fenced Frames | ||
| Protected Audience API | यूनिफ़ाइड - 5% (मौजूदा अलोकेशन 4% + 1% रैंप बैक अप) | 16 मार्च, 2023 से, स्टैबल ट्रैफ़िक का 6% |
| अलग - 1% - सिर्फ़ Protected Audience API + Fenced Frames | ||
| शेयर किया गया स्टोरेज (यूआरएल चुनना) |
यूनिफ़ाइड - 5% | 16 मार्च, 2023 से, स्टैबल ट्रैफ़िक का 6% |
| अलग-अलग - 1% - शेयर किया गया स्टोरेज (यूआरएल चुनना) + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| विषय | यूनिफ़ाइड - 5% | 16 मार्च, 2023 से, स्टैबल ट्रैफ़िक का 6% |
| अलग-अलग - 1% - सिर्फ़ विषय |
इन बदलावों का असर, आपके मौजूदा ऑरिजिन ट्रायल टोकन के सेटअप पर नहीं पड़ेगा. साथ ही, आपको नया ऑरिजिन ट्रायल टोकन जनरेट या रिन्यू करने की ज़रूरत नहीं होगी.
जनवरी 2023
Chrome में हुई गड़बड़ी की जांच के तहत, हम 26 जनवरी, 2023 से Chrome के स्टैबल वर्शन में, Protected Audience API के ऑरिजिन ट्रायल के ट्रैफ़िक को 5% से घटाकर 4% कर देंगे. हमारा अनुमान है कि जांच में करीब एक महीना लगेगा. ट्रैफ़िक वापस बढ़ने पर, हम आपको इसकी सूचना देंगे.
यह बदलाव अपने-आप होगा. इससे आपके मौजूदा ऑरिजिन ट्रायल टोकन पर कोई असर नहीं पड़ेगा. 1% ट्रैफ़िक में शामिल उपयोगकर्ताओं के लिए, रुचियों के हिसाब से बनाए गए ग्रुप उनके ब्राउज़र में बने रहेंगे. ये उपयोगकर्ता ही रैंप बैक अप का हिस्सा होंगे. साथ ही, उनकी दिलचस्पी के ग्रुप का फिर से इस्तेमाल किया जा सकता है. हालांकि, दिलचस्पी के ग्रुप 30 दिनों में खत्म हो जाते हैं और रेग्रेशन की जांच में इससे ज़्यादा समय लग सकता है.
साथ ही, 26 जनवरी, 2023 से, शेयर किए गए स्टोरेज के यूआरएल सिलेक्शन एपीआई के ऑरिजिन ट्रायल में, Chrome के स्टैबल ट्रैफ़िक का 5% हिस्सा शामिल किया जाएगा.
| एपीआई | नोट |
|---|---|
| एट्रिब्यूशन रिपोर्टिंग | यह सुविधा, स्टेबल वर्शन में उपलब्ध है. इसे 26 अक्टूबर, 2022 से 5% तक बढ़ा दिया गया है. |
| विषय | यह सुविधा, स्टेबल वर्शन में उपलब्ध है. इसे 26 अक्टूबर, 2022 से 5% तक बढ़ा दिया गया है. |
| Protected Audience API | यह सुविधा, स्टेबल वर्शन में उपलब्ध है. इसे 26 जनवरी, 2023 से कुछ समय के लिए 4% तक कम कर दिया जाएगा. |
| फ़ेंस्ड फ़्रेम | यह सुविधा, स्टेबल वर्शन में उपलब्ध है. इसे 9 नवंबर, 2022 से 5% तक बढ़ाया जाएगा. |
| शेयर किया गया स्टोरेज | यह सुविधा, स्टेबल वर्शन में उपलब्ध है. इसे 26 जनवरी, 2023 से 5% बढ़ा दिया जाएगा. |
नवंबर 2022
शेयर किए गए स्टोरेज का `selectURL` API, 9 नवंबर से Chrome के स्टैबल ट्रैफ़िक के 1% पर ऑरिजिन ट्रायल में शामिल होगा.
जैसा कि Privacy Sandbox के ऑरिजिन ट्रायल में, काम के विज्ञापन दिखाने और मेज़रमेंट की सुविधा को 5%तक बढ़ाना ब्लॉग पोस्ट में पहले ही बताया गया था, Attribution Reporting और Topics अब 5% पर हैं. साथ ही, Protected Audience API और फ़ेंस किए गए फ़्रेम भी 9 नवंबर से उपलब्ध होंगे.
| एपीआई | नोट |
|---|---|
| एट्रिब्यूशन रिपोर्टिंग | यह सुविधा, स्टेबल वर्शन में उपलब्ध है. इसे 26 अक्टूबर से 5% तक बढ़ा दिया गया है. |
| विषय | यह सुविधा, स्टेबल वर्शन में उपलब्ध है. इसे 26 अक्टूबर से 5% तक बढ़ा दिया गया है. |
| Protected Audience API | यह सुविधा, स्टेबल वर्शन में उपलब्ध है. इसे 9 नवंबर से 5% तक बढ़ाया जाएगा. |
| फ़ेंस्ड फ़्रेम | यह सुविधा, स्टेबल वर्शन में उपलब्ध है. इसे 9 नवंबर से 5% तक बढ़ाया जाएगा. |
| शेयर किया गया स्टोरेज | यह 9 नवंबर से, स्टेबल वर्शन में 1% के तौर पर उपलब्ध होगा. |
अक्टूबर 2022: 5% की बढ़ोतरी
एट्रिब्यूशन रिपोर्टिंग, Topics, Protected Audience API, और फ़ेंस किए गए फ़्रेम, फ़िलहाल Chrome के स्टैबल वर्शन में उपलब्ध हैं. ये सभी सुविधाएं, बढ़े हुए ट्रैफ़िक का हिस्सा होंगी.
हम इस हफ़्ते से एट्रिब्यूशन रिपोर्टिंग और विषयों के लिए ट्रैफ़िक बढ़ाना शुरू करेंगे. Protected Audience API और फ़ेंस किए गए फ़्रेम के लिए, 9 नवंबर से ट्रैफ़िक बढ़ाया जाएगा.
ज़्यादा जानकारी के लिए, प्राइवसी सैंडबॉक्स के काम के होने और मेज़रमेंट के ऑरिजिन ट्रायल को 5%तक बढ़ाना ब्लॉग पोस्ट पढ़ें.
| एपीआई | नोट |
|---|---|
| एट्रिब्यूशन रिपोर्टिंग | यह सुविधा, स्टेबल वर्शन में उपलब्ध है. 26 अक्टूबर के बाद, यह 5% तक बढ़ जाएगी. |
| विषय | यह सुविधा, स्टेबल वर्शन में उपलब्ध है. 26 अक्टूबर के बाद, यह 5% तक बढ़ जाएगी. |
| Protected Audience API | यह सुविधा, स्टेबल वर्शन में उपलब्ध है. इसे 9 नवंबर से 5% तक बढ़ाया जाएगा. |
| फ़ेंस्ड फ़्रेम | यह सुविधा, स्टेबल वर्शन में उपलब्ध है. इसे 9 नवंबर से 5% तक बढ़ाया जाएगा. |
| शेयर किया गया स्टोरेज | फ़िलहाल, यह सुविधा सिर्फ़ M105+ कैनरी, डेवलपर, और बीटा वर्शन में उपलब्ध है. |
अक्टूबर 2022
- ऑरिजिन ट्रायल को Chrome 110 तक बढ़ा दिया गया है.
- Chrome के ऑरिजिन ट्रायल का इस्तेमाल शुरू करना लेख में, ऑरिजिन ट्रायल के लिए रजिस्टर करने की प्रक्रिया को रिन्यू करने का तरीका बताया गया है. इसमें, हिस्सा लेने वाले ऑरिजिन को नया टोकन देना शामिल है. यह वही प्रोसेस है जो किसी भी दूसरे ऑरिजिन के ट्रायल एक्सटेंशन के लिए अपनाई जाती है.
यह एक्सटेंशन इसलिए दिया गया था, ताकि नेटवर्क को स्टैबल चैनल में समय मिल सके. इससे एपीआई में किए गए सुधारों की जांच और पुष्टि की जा सकेगी. साथ ही, हमारी मौजूदा सार्वजनिक टाइमलाइन के मुताबिक सुझाव दिए जा सकेंगे.
Privacy Sandbox की टाइमलाइन में कोई बदलाव नहीं हुआ है.
मुफ़्त में आज़माने की सुविधा में शामिल एपीआई:
| एपीआई | नोट |
|---|---|
| एट्रिब्यूशन रिपोर्टिंग | ओरिजिन ट्रायल के लिए डेवलपर गाइड. |
| Protected Audience API | ओरिजिन ट्रायल के लिए डेवलपर गाइड. |
| विषय | ओरिजिन ट्रायल के लिए डेवलपर गाइड. |
| फ़ेंस्ड फ़्रेम | ऑरिजिन ट्रायल के इस्तेमाल के लिए, Protected Audience API के दिशा-निर्देश देखें. |
| शेयर किया गया स्टोरेज | फ़िलहाल, यह सुविधा सिर्फ़ M105+ कैनरी, डेवलपर, और बीटा वर्शन में उपलब्ध है. |
अगस्त 2022
- Chrome के स्टेबल वर्शन 104 का इस्तेमाल करने वाले 1% डेस्कटॉप उपयोगकर्ताओं के लिए, Origin के ट्रायल वर्शन की उपलब्धता बढ़ाई गई है.
- जब मोबाइल उपयोगकर्ताओं के लिए भी यह सुविधा उपलब्ध होगी, तब अपडेट किए जाएंगे.
- बीटा वर्शन और कैनरी चैनल पर 50% उपयोगकर्ता ही बने रहेंगे.
- iOS के लिए उपलब्ध Chrome पर एपीआई उपलब्ध नहीं हैं.
मई 2022
ऑरिजिन ट्रायल की उपलब्धता, Chrome 102 बीटा वर्शन के 50% उपयोगकर्ताओं तक बढ़ाई गई है.
मुफ़्त में आज़माने की सुविधा में शामिल एपीआई:
| एपीआई | नोट |
|---|---|
| एट्रिब्यूशन रिपोर्टिंग | ओरिजिन ट्रायल के लिए डेवलपर गाइड. |
| Protected Audience API | ओरिजिन ट्रायल के लिए डेवलपर गाइड. |
| विषय | ऑरिजिन ट्रायल के लिए डेवलपर गाइड. एक गड़बड़ी की वजह से, ब्राउज़र के काम करने के तरीके पर असर पड़ा. इस वजह से, Topics को ऑरिजिन ट्रायल में कुछ समय के लिए बंद कर दिया गया था. |
| फ़ेंस्ड फ़्रेम | ऑरिजिन ट्रायल में फ़ेंस किए गए फ़्रेम जोड़े गए. एक्सपेरिमेंट के इस्तेमाल के लिए, Protected Audience API के दिशा-निर्देश देखें. |
अप्रैल 2022
ऑरिजिन ट्रायल, Chrome 102 बीटा वर्शन का इस्तेमाल करने वाले कुछ उपयोगकर्ताओं के साथ शुरू होता है.
मुफ़्त में आज़माने की सुविधा में शामिल एपीआई:
| एपीआई | नोट |
|---|---|
| एट्रिब्यूशन रिपोर्टिंग | अलग-अलग इंटेंट से एक्सपेरिमेंट (I2E) पोस्ट. एट्रिब्यूशन रिपोर्टिंग, ऑरिजिन के लिए अलग से किए गए ट्रायल के तौर पर भी उपलब्ध है. |
| Protected Audience API | अलग-अलग इंटेंट से एक्सपेरिमेंट (I2E) पोस्ट. Protected Audience API, सिर्फ़ डेस्कटॉप पर उपलब्ध है. इसमें कुछ ही सुविधाएं काम करती हैं. |
| विषय | अलग-अलग इंटेंट से एक्सपेरिमेंट (I2E) पोस्ट. |
ऑरिजिन ट्रायल के लिए साइन अप करना और उसे कॉन्फ़िगर करना
अपनी साइट पर ऑरिजिन ट्रायल को चालू करने के लिए, आपको असाइन किया गया ऑरिजिन ट्रायल टोकन रजिस्टर करना होगा और उसे एम्बेड करना होगा. यह टोकन, ऑरिजिन ट्रायल के लिए आपके खास ऐक्सेस के लिए, समय के हिसाब से बनी स्ट्रिंग होती है. Chrome के ऑरिजिन ट्रायल का इस्तेमाल शुरू करना लेख में ज़्यादा जानें.
ऑरिजिन ट्रायल के टोकन तुरंत मिल जाते हैं. साथ ही, आपके पास उन्हें किसी भी समय रद्द करने या फिर से बनाने का विकल्प होता है.
आपको जिस पेज पर ऑरिजिन ट्रायल का इस्तेमाल करना है उसके एचटीएमएल या रिस्पॉन्स में, आपको ट्रायल टोकन शामिल करना होगा.
पेज के <head> सेक्शन में <meta> टैग का इस्तेमाल करें:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
इसके अलावा, पेज के रिस्पॉन्स में यह एचटीटीपी हेडर शामिल करें:
Origin-Trial: TOKEN_GOES_HERE
iframe की मदद से कॉन्फ़िगर करना
अगर किसी iframe में ऑरिजिन ट्रायल की सुविधाओं का इस्तेमाल किया जा रहा है, जैसे कि Protected Audience API का joinAdInterestGroup(), तो टोकन को iframe में दिया जाना चाहिए और वह iframe के ऑरिजिन से मेल खाना चाहिए.
JavaScript की मदद से क्रॉस-साइट कॉन्फ़िगर करना
अगर क्रॉस-साइट JavaScript के ज़रिए ऑरिजिन ट्रायल की सुविधाओं का इस्तेमाल किया जा रहा है, तो आपको ये काम करने होंगे:
- ऑरिजिन ट्रायल के लिए रजिस्टर करते समय, तीसरे पक्ष की मैचिंग का विकल्प चुनें.
- वेब ऑरिजिन फ़ील्ड, आपकी स्क्रिप्ट का ऑरिजिन होना चाहिए.
- अपनी स्क्रिप्ट से, टॉप-लेवल पेज (यानी, पहले पक्ष का पेज, न कि आपका कॉन्टेंट) में
<meta>टैग इंजेक्ट करें. उदाहरण के लिए:
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
ऑरिजिन ट्रायल को डीबग करना
ऑरिजिन ट्रायल की स्थिति देखने के लिए, DevTools > ऐप्लिकेशन पैनल पर जाएं.
- नीचे की ओर स्क्रोल करके, फ़्रेम पैनल पर जाएं.
- वह फ़्रेम चुनें जहां आपको टोकन सेट करना है. उदाहरण के लिए, टॉप-लेवल पेज के लिए top फ़्रेम या एम्बेड किए गए पेजों के लिए कोई खास iframe.
- दाएं पैनल में, नीचे की ओर स्क्रोल करके ऑरिजिन ट्रायल सेक्शन पर जाएं.
- आपको
PrivacySandboxAdsAPIsको मुफ़्त में आज़माने की सुविधा के लिए एक एंट्री दिखेगी. - ऑरिजिन ट्रायल और अपने खास टोकन का स्टेटस देखने के लिए, इस एंट्री को बड़ा करें.
ऑरिजिन ट्रायल, Chrome के कुछ उपयोगकर्ताओं के लिए ही उपलब्ध है. ऐसा हो सकता है कि आपका ब्राउज़र, एक्सपेरिमेंट ग्रुप में शामिल न हो. इस वजह से, आपको PrivacySandboxAdsAPIs के बगल में लाल रंग में TrialNotAllowed मैसेज दिख सकता है. टोकन की स्थिति देखने के लिए एंट्री को बड़ा करने पर, अगर आपको हरे रंग का Success मैसेज दिखता है, तो इसका मतलब है कि आपका ऑरिजिन ट्रायल कॉन्फ़िगरेशन सही है. ज़रूरी शर्तें पूरी करने वाले उपयोगकर्ताओं को मैसेज Enabled पर सेट दिखेगा.
अगर आपको अलग-अलग मैसेज दिखते हैं, तो ऑरिजिन ट्रायल के कॉन्फ़िगरेशन की पुष्टि करने के लिए, Chrome के ऑरिजिन ट्रायल से जुड़ी समस्या हल करना लेख पढ़ें. इसमें, ऑरिजिन ट्रायल से जुड़ी पूरी चेकलिस्ट दी गई है.
सुविधाओं का पता लगाना
वेब की सभी सुविधाओं की तरह ही, इनका इस्तेमाल करने से पहले यह देख लें कि वे ब्राउज़र में उपलब्ध हैं या नहीं. इसके लिए, सही जगह पर काम का एपीआई मौजूद है या नहीं, यह देखें:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting enabled
}
if ('runAdAuction' in navigator) {
// Protected Audience API enabled
}
if ('browsingTopics' in document) {
// Topics enabled
}
if ('HTMLFencedFrameElement' in window) {
// Fenced Frames enabled
}
if ('sharedStorage' in window) {
// Shared Storage enabled
}
if (window?.sharedStorage?.selectURL instanceof Function) {
// optionally check specifically for the selectURL function in Shared Storage
}
यह तय करना कि उपयोगकर्ता ज़रूरी शर्तें पूरी करता है या नहीं
ऑरिजिन ट्रायल, Chrome के कुछ उपयोगकर्ताओं के लिए चल रहा है. मुफ़्त में आज़माने की सुविधा पाने के लिए, यह भी ज़रूरी है कि उपयोगकर्ता ने अपनी सेटिंग में, इन सुविधाओं को चालू किया हो:
ब्राउज़र सेटिंग
किसी उपयोगकर्ता को मुफ़्त में आज़माने की सुविधा पाने के लिए, इन शर्तों का पालन करना ज़रूरी है:
आपने Chrome के उस वर्शन और चैनल का इस्तेमाल किया हो जहां ऑरिजिन ट्रायल चल रहा हो.
- मौजूदा कॉन्फ़िगरेशन के लिए, ऑरिजिन ट्रायल की स्थिति देखें.
Chrome में एक्सपेरिमेंट के चालू ग्रुप में शामिल होना.
उपयोगकर्ता सेटिंग
किसी उपयोगकर्ता को मुफ़्त में आज़माने की सुविधा पाने के लिए, इन शर्तों का पालन करना ज़रूरी है:
- आपने सेटिंग > सुरक्षा और
निजता > निजता सैंडबॉक्स पर जाकर, निजता सैंडबॉक्स ट्रायल चालू किया हो. इसे
chrome://settings/adPrivacyसे भी ऐक्सेस किया जा सकता है. - सेटिंग > सुरक्षा और निजता > कुकी और साइट का अन्य डेटा पर जाएं और "सभी कुकी को अनुमति दें" या "गुप्त मोड में तीसरे पक्ष की कुकी ब्लॉक करें" पर सेट करें. इसे
chrome://settings/cookiesसे भी ऐक्सेस किया जा सकता है. इससे, तीसरे पक्ष की कुकी चालू होंगी. - आप स्टैंडर्ड ब्राउज़िंग सेशन में हों और गुप्त मोड में न हों.
ऑरिजिन ट्रायल सिर्फ़ ज़रूरी शर्तें पूरी करने वाले उपयोगकर्ताओं को चालू के तौर पर दिखेगा. हालांकि, अपनी प्रोडक्शन साइट के साथ टेस्ट करने के लिए, डेवलपर फ़्लैग का भी इस्तेमाल किया जा सकता है.
ऑरिजिन ट्रायल में अपनी भागीदारी को कंट्रोल करना
ऑरिजिन ट्रायल का तरीका पहले जैसा ही रहेगा: आपको उन कॉन्टेक्स्ट के लिए ऑरिजिन ट्रायल के टोकन मिलेंगे जिनमें आपको एपीआई के साथ प्रयोग करना है. टेस्टिंग के लिए ज़्यादा लोगों को शामिल करने पर, आपको यह पक्का करना होगा कि आपने ट्रायल को जिन जगहों पर चालू किया है वहां ट्रैफ़िक के लेवल को लगातार मॉनिटर और कंट्रोल किया जा रहा हो.
यहां एक अच्छा तरीका यह है कि:
- जिन सभी संदर्भों में आपको एक्सपेरिमेंट करना है उनमें डिफ़ॉल्ट रूप से ऑरिजिन ट्रायल टोकन शामिल करें.
- चालू एपीआई की जांच करने के लिए, सुविधा की पहचान करने की सुविधा का इस्तेमाल करें.
- अगर एपीआई चालू हैं (इसलिए, ब्राउज़र इस एक्सपेरिमेंट के लिए ज़रूरी शर्तें पूरी करता है), तो अपने एक्सपेरिमेंट की शर्तों के आधार पर चुनें कि उनका इस्तेमाल करना है या नहीं. उदाहरण के लिए, अगर आपके पास पहले से ही A/B टेस्टिंग इन्फ़्रास्ट्रक्चर है, ताकि ट्रैफ़िक के प्रतिशत, सैंपलिंग या किसी अन्य एट्रिब्यूट पर प्रयोग किया जा सके, तो इस समय यह तय किया जा सकता है कि आपको किन सुविधाओं का इस्तेमाल करना है.
रिस्पॉन्स में टोकन शामिल न करके, किसी भी ब्राउज़र इंस्टेंस के लिए, ऑरिजिन ट्रायल में पूरी तरह से हिस्सा लेने से रोका जा सकता है. उदाहरण के लिए, अगर आपने किसी प्रयोग के लिए तय कोटा पूरा कर लिया है या आपको ट्रायल के दौरान किसी समस्या को हल करना है, तो टोकन शामिल न करने से यह पक्का होता है कि पेज पर कोई भी एक्सपेरिमेंटल फ़ंक्शन उपलब्ध या चालू नहीं होगा.
भौगोलिक क्षेत्र के हिसाब से ऑरिजिन ट्रायल को कंट्रोल करना
कुछ खास इलाकों के लिए, ऑरिजिन ट्रायल से ऑप्ट-आउट नहीं किया जा सकता. ऑरिजिन ट्रायल उन पेजों पर चालू होते हैं जिनमें टोकन शामिल होता है. टोकन को एचटीटीपी हेडर (सर्वर-साइड) या एचटीएमएल मेटा टैग (क्लाइंट-साइड) के ज़रिए शामिल किया जाता है.
अगर उपयोगकर्ता की जगह की जानकारी का पता लगाया जा सकता है, तो उस जगह की जानकारी के आधार पर ऑरिजिन ट्रायल टोकन को शामिल करने के लिए, कोड लिखा जा सकता है. उदाहरण के लिए, किसी उपयोगकर्ता की जगह की जानकारी का पता लगाने के लिए, आईपी पतों का इस्तेमाल किया जा सकता है. आईपी पतों को बदला जा सकता है. इसलिए, यह पक्का नहीं किया जा सकता कि यह तरीका हमेशा काम करेगा.
हालांकि, किसी देश/इलाके के हिसाब से ऑरिजिन, अनुमतियों की नीति सेट कर सकता है. इससे यह कंट्रोल किया जा सकता है कि किन सुविधाओं का इस्तेमाल किया जा सकता है. उदाहरण के लिए, us.example.com और uk.example.com, जगह के हिसाब से ऑरिजिन हैं जिन्हें कंट्रोल किया जा सकता है. इसका मतलब यह नहीं है कि किसी इलाके ने ऑरिजिन ट्रायल से ऑप्ट-आउट किया है.
अनुमतियों की नीति की मदद से, कोई साइट अपने पेजों पर कोड का एक छोटा स्निपेट जोड़ती है. इससे ब्राउज़र को निर्देश मिलते हैं. पेज लोड होने पर, ब्राउज़र अनुमति नीति के निर्देशों को पढ़ता है. साथ ही, अनुमति नीति में बताए गए तरीके के मुताबिक, सुविधाओं (या एपीआई) को अनुमति देता है या ब्लॉक करता है. अगर किसी साइट को किसी खास इलाके में किसी एपीआई पर पाबंदी लगानी है, तो डेवलपर उस इलाके से अनुरोध किए गए सभी पेजों के लिए नीति सेट कर सकता है.
अपना टोकन रिन्यू करना
Origin के ट्रायल टोकन, जारी होने की तारीख से छह हफ़्ते बाद खत्म हो जाते हैं. अगर ट्रायल की अवधि खत्म होने से पहले ही टोकन खत्म हो जाते हैं, तो वे उसी समय खत्म हो जाते हैं.
ऑरिजिन ट्रायल की सुविधाओं का बिना किसी रुकावट के इस्तेमाल करने के लिए, यह ज़रूरी है कि आप उस विंडो के दौरान अपने नए टोकन रिन्यू और डिप्लॉय करें.
टोकन रिन्यू करने में सिर्फ़ कुछ मिनट लगते हैं. साथ ही, एक ही पेज पर एक ही ट्रायल के लिए कई टोकन डिप्लॉय किए जा सकते हैं. मौजूदा टोकन की समयसीमा खत्म होने से पहले, नया टोकन डिप्लॉय किया जा सकता है, ताकि उपयोगकर्ताओं को सेवा में कोई रुकावट न आए.
स्थानीय तौर पर जांच करना
स्थानीय डेवलपर की जांच के बारे में खास निर्देशों के लिए, ये देखें:
एपीआई डिफ़ॉल्ट रूप से चालू नहीं होते. जांच के लिए, इन्हें फ़्लैग की मदद से चालू करना ज़रूरी है. आपको यह पक्का करना चाहिए कि आपने ऊपर बताई गई कॉन्फ़िगरेशन सेटिंग चालू की हों. इसके बाद:
- Chrome के उस वर्शन और चैनल का इस्तेमाल करें जहां ये सुविधाएं उपलब्ध हैं.
chrome://settings/adPrivacyमें जाकर, विज्ञापन देखने वाले की निजता बनाए रखने से जुड़े सभी एपीआई चालू करें.
किसी खास एपीआई और सुविधाओं की उपलब्धता के बारे में जानने के लिए, डेवलपर गाइड देखें. साथ ही, बेहतर कॉन्फ़िगरेशन के लिए अतिरिक्त फ़्लैग देखें.