Privacy Sandbox में, विज्ञापन के इस्तेमाल से जुड़े उदाहरणों को पूरा करने के लिए कई सुझाव शामिल हैं. इसके लिए, क्रॉस-साइट ट्रैकिंग की ज़रूरत नहीं होती. ऑरिजिन ट्रायल से डेवलपर को नई वेब टेक्नोलॉजी का आकलन करने का मौका मिलता है. साथ ही, वे असल दुनिया में टेस्टिंग करके, इन टेक्नोलॉजी के बारे में सुझाव/राय दे सकते हैं या शिकायत कर सकते हैं. Privacy Sandbox Relevance and Measurement के ऑरिजिन ट्रायल में, एक ही ट्रायल उपलब्ध कराया जाता है. इससे साइटें, Attribution Reporting, Protected Audience API, Topics, फ़ेंस किए गए फ़्रेम, और Shared Storage में एक साथ एक्सपेरिमेंट कर सकती हैं. डेवलपर, इस एक ऑरिजिन ट्रायल के लिए साइन अप कर सकते हैं. इससे आपको Topics, Protected Audience API, और Attribution Reporting API के साथ-साथ अन्य एपीआई को टेस्ट करने की अनुमति मिलती है. इस गाइड में, एपीआई ऐक्सेस करने के लिए कॉन्फ़िगरेशन के चरणों के बारे में बताया गया है. इसमें यह भी बताया गया है कि कॉन्फ़िगरेशन की पुष्टि कैसे करें. साथ ही, एपीआई के ख़िलाफ़ टेस्टिंग के लिए ज़्यादा संसाधन उपलब्ध कराए गए हैं.
ऑरिजिन ट्रायल का स्टेटस देखना
जून 2023
Private Aggregation की सुविधा को स्टेबल वर्शन में 7% तक रोल आउट किया गया
Private Aggregation API, 6 जून, 2023 से Chrome के स्टेबल वर्शन के 7% ट्रैफ़िक के लिए उपलब्ध होगा. यह एपीआई, यूनिफ़ाइड ऑरिजिन ट्रायल ग्रुप (5%), Protected Audience के आइसोलेटेड ग्रुप (1%), और Shared Storage के आइसोलेटेड ग्रुप (1%) में उपलब्ध होगा. Protected Audience और Shared Storage के लिए, ट्रैफ़िक का बंटवारा नहीं बदलेगा. ऐसा इसलिए, क्योंकि Private Aggregation को मौजूदा आइसोलेटेड एक्सपेरिमेंट में जोड़ा जा रहा है.
6 जून, मंगलवार के हिसाब से ट्रैफ़िक का बंटवारा:
| एपीआई | ट्रैफ़िक का बंटवारा | स्टेटस |
| Attribution Reporting | यूनिफ़ाइड - 5% | 13 मार्च, 2023 तक, स्टेबल वर्शन के 6% ट्रैफ़िक के लिए |
| आइसोलेट किया गया - 1% - सिर्फ़ एआरए के लिए | ||
| फ़ेंस्ड फ़्रेम | यूनिफ़ाइड - 5% | 13 मार्च, 2023 तक, स्टेबल वर्शन के 7% ट्रैफ़िक के लिए |
| आइसोलेटेड - 1% - सिर्फ़ Shared Storage + Private Aggregation + फ़ेंस किए गए फ़्रेम | ||
| आइसोलेटेड - 1% - Protected Audience + Private Aggregation + सिर्फ़ फ़ेन्स्ड फ़्रेम | ||
| Protected Audience | यूनिफ़ाइड - 5% | 13 मार्च, 2023 तक, स्टेबल वर्शन के 6% ट्रैफ़िक के लिए |
| आइसोलेटेड - 1% - Protected Audience + Private Aggregation + सिर्फ़ फ़ेन्स्ड फ़्रेम | ||
| Private Aggregation | यूनिफ़ाइड - 5% | 6 जून, 2023 तक, स्टेबल वर्शन का 7% ट्रैफ़िक |
| आइसोलेटेड - 1% - Protected Audience + Private Aggregation + सिर्फ़ फ़ेन्स्ड फ़्रेम | ||
| आइसोलेटेड - 1% - सिर्फ़ Shared Storage + Private Aggregation + फ़ेंस किए गए फ़्रेम | ||
| Shared Storage | यूनिफ़ाइड - 5% | 13 मार्च, 2023 तक, स्टेबल वर्शन के 6% ट्रैफ़िक के लिए |
| अलग किया गया - 1% - सिर्फ़ शेयर किया गया स्टोरेज + निजी एकत्रीकरण + फ़ेंस किए गए फ़्रेम | ||
| विषय | यूनिफ़ाइड - 5% | 13 मार्च, 2023 तक, स्टेबल वर्शन के 6% ट्रैफ़िक के लिए |
| आइसोलेट किया गया - 1% - सिर्फ़ विषय |
पिछले अपडेट
ऑरिजिन ट्रायल से जुड़े पिछले अपडेट देखें.
अप्रैल 2023
Stable वर्शन में Private Aggregation को 1% तक बढ़ाना
Private Aggregation API का ऑरिजिन ट्रायल, 17 अप्रैल से Chrome Stable के यूनिफ़ाइड एक्सपेरिमेंट के ट्रैफ़िक के 1% हिस्से के लिए उपलब्ध होगा. Private Aggregation का sendHistogramReport()
फ़ंक्शन, Protected Audience API
और Shared Storage
वर्कलेट में इस्तेमाल किया जा सकता है.
ट्रैफ़िक का बंटवारा, 17 अप्रैल से कुछ इस तरह दिखेगा:
| एपीआई | ट्रैफ़िक का बंटवारा | स्टेटस |
| Attribution Reporting | यूनिफ़ाइड - 5% | 13 मार्च, 2023 से स्टेबल वर्शन के 6% ट्रैफ़िक के लिए |
| आइसोलेट किया गया - 1% - सिर्फ़ एआरए के लिए | ||
| फ़ेंस्ड फ़्रेम | यूनिफ़ाइड - 5% | 13 मार्च, 2023 से स्टेबल वर्शन के 7% ट्रैफ़िक के लिए |
| आइसोलेटेड - 1% - शेयर किया गया स्टोरेज (यूआरएल चुनना) + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| आइसोलेटेड - 1% - सिर्फ़ Protected Audience API + फ़ेन्स्ड फ़्रेम | ||
| Protected Audience API | यूनिफ़ाइड - 5% | 13 मार्च, 2023 से स्टेबल वर्शन के 6% ट्रैफ़िक के लिए |
| आइसोलेटेड - 1% - सिर्फ़ Protected Audience API + फ़ेन्स्ड फ़्रेम | ||
| Private Aggregation | यूनिफ़ाइड - 1% | 17 अप्रैल, 2023 से स्टेबल वर्शन के 1% ट्रैफ़िक के लिए |
| Shared Storage (यूआरएल चुनना) | यूनिफ़ाइड - 5% | 13 मार्च, 2023 से स्टेबल वर्शन के 6% ट्रैफ़िक के लिए |
| आइसोलेटेड - 1% - शेयर किया गया स्टोरेज (यूआरएल चुनना) + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| विषय | यूनिफ़ाइड - 5% | 13 मार्च, 2023 से स्टेबल वर्शन के 6% ट्रैफ़िक के लिए |
| आइसोलेट किया गया - 1% - सिर्फ़ विषय |
मार्च 2023
टाइमलाइन अपडेट की गई
हमने आपको बताया था कि हम 13 मार्च, 2023, सोमवार से अलग-अलग एक्सपेरिमेंट शुरू करेंगे. हालांकि, एक्सपेरिमेंट सेट अप करने के लिए ज़्यादा समय की ज़रूरत होने की वजह से, अब नए एक्सपेरिमेंट 16 मार्च, 2023, गुरुवार से शुरू होंगे. Protected Audience API के लिए, 1% उपयोगकर्ताओं को शामिल करने की सुविधा को 4% से बढ़ाकर 5% करने की प्रोसेस भी गुरुवार, 16 मार्च, 2023 को होगी.
Protected Audience API को 1% तक फिर से चालू करना
पिछले महीने, हमने टेस्टिंग के लिए Chrome के स्टेबल वर्शन पर, Protected Audience API के ऑरिजिन ट्रायल के ट्रैफ़िक को कुछ समय के लिए कम कर दिया था. इसे 5% से घटाकर 4% कर दिया गया था. शुरुआती टेस्टिंग पूरी हो गई है. हम 16 मार्च, 2023 को एक साथ किए जाने वाले एक्सपेरिमेंट के लिए, Protected Audience API को 4% से बढ़ाकर 5% करने का प्लान बना रहे हैं.
उपयोगकर्ताओं का वही सेट, रैंप-अप किया जाएगा जिसे रैंप-डाउन किया गया था. हालांकि, उनके पिछले इंटरेस्ट ग्रुप की समयसीमा खत्म हो गई है, क्योंकि रैंप-डाउन के बाद 30 दिन से ज़्यादा समय बीत चुका है.
अलग-अलग एक्सपेरिमेंट
हम टेस्टिंग की प्रोसेस को बेहतर बनाने के लिए, हर एपीआई के लिए अलग-अलग एक्सपेरिमेंट बना रहे हैं. साथ ही, हम ऑरिजिन ट्रायल एपीआई की मेट्रिक पर नज़र रखना जारी रखेंगे. हम मौजूदा यूनीफ़ाइड एक्सपेरिमेंट के साथ-साथ, ये एक्सपेरिमेंट भी चलाएंगे. एट्रिब्यूशन रिपोर्टिंग, विषय, Protected Audience API और फ़ेन्स्ड फ़्रेम के कॉम्बिनेशन, और शेयर किए गए स्टोरेज के यूआरएल चुनने की सुविधा और फ़ेन्स्ड फ़्रेम के कॉम्बिनेशन के लिए नए एक्सपेरिमेंट बनाए जाएंगे. हर अलग-अलग एक्सपेरिमेंट में, उस ग्रुप के उपयोगकर्ताओं के लिए सिर्फ़ असाइन किए गए एपीआई उपलब्ध होंगे.
| एपीआई | अलग-अलग किए गए एक्सपेरिमेंट के लिए ट्रैफ़िक का बंटवारा |
|---|---|
| Attribution Reporting | 1% |
| Protected Audience API + फ़ेन्स्ड फ़्रेम | 1% |
| शेयर किया गया स्टोरेज (यूआरएल चुनना) + फ़ेंस किए गए फ़्रेम | 1% |
| विषय | 1% |
ऊपर दिए गए एपीआई के लिए, आपको 16 मार्च, गुरुवार से Chrome Stable के ट्रैफ़िक का 1% हिस्सा अतिरिक्त तौर पर मिलेगा. यह हिस्सा, आपको मौजूदा यूनीफ़ाइड एक्सपेरिमेंट से मिलने वाले 5% ट्रैफ़िक के अलावा मिलेगा. नए उपयोगकर्ताओं को हर एक्सपेरिमेंट के लिए असाइन किया जाएगा.
ट्रैफ़िक का बंटवारा
28 फ़रवरी, मंगलवार को, यूनिफ़ाइड ओरिजिन ट्रायल के लिए ट्रैफ़िक का मौजूदा बंटवारा इस तरह है:
| एपीआई | मौजूदा यूनीफ़ाइड एक्सपेरिमेंट ट्रैफ़िक का बंटवारा |
|---|---|
| Attribution Reporting | 5% |
| फ़ेंस्ड फ़्रेम | 5% |
| Protected Audience API | 4% |
| Shared Storage (यूआरएल चुनने की सुविधा) | 5% |
| विषय | 5% |
Protected Audience API के फिर से शुरू होने और नए आइसोलेटेड एक्सपेरिमेंट शुरू होने के बाद, 16 मार्च, गुरुवार से ट्रैफ़िक का बंटवारा इस तरह दिखेगा:
| एपीआई | ट्रैफ़िक का नया बंटवारा | स्थिति |
|---|---|---|
| Attribution Reporting | यूनिफ़ाइड - 5% | 16 मार्च, 2023 से स्टेबल वर्शन के 6% ट्रैफ़िक के लिए |
| आइसोलेट किया गया - 1% - सिर्फ़ एआरए के लिए | ||
| फ़ेंस्ड फ़्रेम | यूनिफ़ाइड - 5% | 16 मार्च, 2023 से स्टेबल वर्शन के 7% ट्रैफ़िक के लिए |
| आइसोलेटेड - 1% - शेयर किया गया स्टोरेज (यूआरएल चुनना) + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| आइसोलेटेड - 1% - सिर्फ़ Protected Audience API + फ़ेन्स्ड फ़्रेम | ||
| Protected Audience API | यूनिफ़ाइड - 5% (मौजूदा बंटवारा 4% + 1% रैंप बैक अप) | 16 मार्च, 2023 से स्टेबल वर्शन के 6% ट्रैफ़िक के लिए |
| आइसोलेटेड - 1% - सिर्फ़ Protected Audience API + फ़ेन्स्ड फ़्रेम | ||
| Shared Storage (यूआरएल चुनना) |
यूनिफ़ाइड - 5% | 16 मार्च, 2023 से स्टेबल वर्शन के 6% ट्रैफ़िक के लिए |
| आइसोलेटेड - 1% - शेयर किया गया स्टोरेज (यूआरएल चुनना) + सिर्फ़ फ़ेंस किए गए फ़्रेम | ||
| विषय | यूनिफ़ाइड - 5% | 16 मार्च, 2023 से स्टेबल वर्शन के 6% ट्रैफ़िक के लिए |
| आइसोलेट किया गया - 1% - सिर्फ़ विषय |
इन बदलावों का असर, आपके मौजूदा ओरिजिन ट्रायल टोकन सेटअप पर नहीं पड़ेगा. साथ ही, आपको ओरिजिन ट्रायल टोकन को रिन्यू या नया टोकन जनरेट नहीं करना होगा.
जनवरी 2023
Chrome में हुई गड़बड़ी की जांच के तहत, हम 26 जनवरी, 2023 से Chrome के स्टेबल वर्शन पर, Protected Audience API के ऑरिजिन ट्रायल के ट्रैफ़िक को कुछ समय के लिए 5% से घटाकर 4% कर देंगे. हमारा अनुमान है कि जांच में करीब एक महीना लगेगा. ट्रैफ़िक बढ़ने पर, हम आपको इसकी सूचना देंगे.
यह बदलाव अपने-आप होगा. साथ ही, इससे आपके मौजूदा ऑरिजिन ट्रायल टोकन पर कोई असर नहीं पड़ेगा. जिन उपयोगकर्ताओं के लिए कुकी का इस्तेमाल कम किया जाएगा उनके ब्राउज़र में दिलचस्पी के हिसाब से बनाए गए ग्रुप बने रहेंगे. ये उपयोगकर्ता, रैंप बैक अप का हिस्सा होंगे. साथ ही, उनके दिलचस्पी वाले ग्रुप का फिर से इस्तेमाल किया जा सकता है. हालांकि, दिलचस्पी के हिसाब से बनाए गए ग्रुप 30 दिनों में खत्म हो जाते हैं. साथ ही, रिग्रेशन की जांच में इससे ज़्यादा समय लग सकता है.
इसके अलावा, Shared Storage के यूआरएल चुनने वाले API का ऑरिजिन ट्रायल, 26 जनवरी, 2023 से Chrome के स्टेबल वर्शन के ट्रैफ़िक के 5% तक बढ़ जाएगा.
| एपीआई | नोट |
|---|---|
| Attribution Reporting | यह सुविधा स्टेबल वर्शन में उपलब्ध है. 26 अक्टूबर, 2022 से इसे 5% तक बढ़ा दिया गया है. |
| विषय | यह सुविधा स्टेबल वर्शन में उपलब्ध है. 26 अक्टूबर, 2022 से इसे 5% तक बढ़ा दिया गया है. |
| Protected Audience API | यह स्टेबल वर्शन में उपलब्ध है. हालांकि, 26 जनवरी, 2023 से कुछ समय के लिए यह 4% तक कम हो जाएगा. |
| फ़ेंस्ड फ़्रेम | यह सुविधा स्टेबल वर्शन में उपलब्ध है. 9 नवंबर, 2022 से इसे बढ़ाकर 5% कर दिया गया है. |
| Shared Storage | यह सुविधा स्टेबल वर्शन में उपलब्ध है. 26 जनवरी, 2023 से इसमें 5% की बढ़ोतरी हुई है. |
नवंबर 2022
Shared Storage का `selectURL` एपीआई, 9 नवंबर से Chrome के स्टेबल वर्शन के 1% ट्रैफ़िक के लिए ऑरिजिन ट्रायल में शामिल हो जाएगा.
हमने Privacy Sandbox के Relevance and Measurement ऑरिजिन ट्रायल को 5% तक बढ़ाने के बारे में ब्लॉग पोस्ट में पहले ही बता दिया था. अब Attribution Reporting और Topics, 5% पर हैं. Protected Audience API और Fenced Frames भी 9 नवंबर से 5% पर आ जाएंगे.
| एपीआई | नोट |
|---|---|
| Attribution Reporting | यह सुविधा स्टेबल वर्शन में उपलब्ध है. 26 अक्टूबर से, इसे 2% से बढ़ाकर 5% कर दिया गया है. |
| विषय | यह सुविधा स्टेबल वर्शन में उपलब्ध है. 26 अक्टूबर से, इसे 2% से बढ़ाकर 5% कर दिया गया है. |
| Protected Audience API | यह सुविधा स्टेबल वर्शन में उपलब्ध है. 9 नवंबर से, यह 5% तक बढ़ जाएगी. |
| फ़ेंस्ड फ़्रेम | यह सुविधा स्टेबल वर्शन में उपलब्ध है. 9 नवंबर से, यह 5% तक बढ़ जाएगी. |
| Shared Storage | यह सुविधा, 9 नवंबर से स्टेबल वर्शन में उपलब्ध होगी. शुरुआत में, यह सुविधा सिर्फ़ 1% उपयोगकर्ताओं के लिए उपलब्ध होगी. |
अक्टूबर 2022: 5% की बढ़ोतरी
Attribution Reporting, Topics, Protected Audience API, और Fenced Frames, ये सभी सुविधाएं फ़िलहाल Chrome के स्टेबल वर्शन में उपलब्ध हैं. साथ ही, ये बढ़े हुए ट्रैफ़िक का हिस्सा होंगी.
हम इस हफ़्ते से, एट्रिब्यूशन रिपोर्टिंग और विषय के लिए ट्रैफ़िक बढ़ाना शुरू कर देंगे. Protected Audience API और फ़ेन्स्ड फ़्रेम के लिए ट्रैफ़िक 9 नवंबर से बढ़ेगा.
ज़्यादा जानने के लिए, Privacy Sandbox की Relevance and Measurement सुविधा के ऑरिजिन ट्रायल को 5%तक बढ़ाना ब्लॉग पोस्ट पढ़ें.
| एपीआई | नोट |
|---|---|
| Attribution Reporting | यह सुविधा स्टेबल वर्शन में उपलब्ध है. 26 अक्टूबर के बाद, यह 5% तक बढ़ जाएगी. |
| विषय | यह सुविधा स्टेबल वर्शन में उपलब्ध है. 26 अक्टूबर के बाद, यह 5% तक बढ़ जाएगी. |
| Protected Audience API | यह सुविधा स्टेबल वर्शन में उपलब्ध है. 9 नवंबर से, यह 5% तक बढ़ जाएगी. |
| फ़ेंस्ड फ़्रेम | यह सुविधा स्टेबल वर्शन में उपलब्ध है. 9 नवंबर से, यह 5% तक बढ़ जाएगी. |
| Shared Storage | फ़िलहाल, यह सुविधा सिर्फ़ M105+ Canary, Dev, और Beta वर्शन में उपलब्ध है. |
अक्टूबर 2022
- ऑरिजिन ट्रायल की अवधि को Chrome 110 तक बढ़ा दिया गया है.
- Chrome के ऑरिजिन ट्रायल का इस्तेमाल शुरू करना लेख में, ऑरिजिन ट्रायल के लिए रजिस्टर करने की प्रोसेस को रिन्यू करने का तरीका बताया गया है. इसमें, हिस्सा लेने वाले ऑरिजिन को नया टोकन देना शामिल है. यह वही प्रोसेस है जिसका पालन किसी अन्य ऑरिजिन ट्रायल एक्सटेंशन के लिए किया जाता है.
यह एक्सटेंशन इसलिए दिया गया था, ताकि नेटवर्क को स्टेबल चैनल में समय मिल सके. इस दौरान, वे एपीआई में किए गए सुधारों की जांच कर सकें और उन्हें मान्य कर सकें. साथ ही, वे हमारी मौजूदा सार्वजनिक टाइमलाइन के हिसाब से सुझाव दे सकें.
Privacy Sandbox की टाइमलाइन में कोई बदलाव नहीं किया गया है.
मुफ़्त में आज़माने की सुविधा में शामिल एपीआई:
| एपीआई | नोट |
|---|---|
| Attribution Reporting | ऑरिजिन ट्रायल के लिए डेवलपर गाइड. |
| Protected Audience API | ऑरिजिन ट्रायल के लिए डेवलपर गाइड. |
| विषय | ऑरिजिन ट्रायल के लिए डेवलपर गाइड. |
| फ़ेंस्ड फ़्रेम | ऑरिजिन ट्रायल के इस्तेमाल के लिए, Protected Audience API से जुड़े दिशा-निर्देश देखें. |
| Shared Storage | फ़िलहाल, यह सुविधा सिर्फ़ M105+ Canary, Dev, और Beta वर्शन में उपलब्ध है. |
अगस्त 2022
- ऑरिजिन ट्रायल की सुविधा, Chrome के स्टेबल वर्शन 104 का इस्तेमाल करने वाले 1% डेस्कटॉप उपयोगकर्ताओं के लिए उपलब्ध है.
- अगर मोबाइल उपयोगकर्ताओं के लिए अपडेट उपलब्ध होगा, तो उन्हें अपडेट मिल जाएंगे.
- प्री-स्टेबल चैनल (कैनरी, बीटा) का इस्तेमाल करने वाले लोगों की संख्या 50% पर बनी रहेगी.
- ये एपीआई, iOS Chrome पर उपलब्ध नहीं हैं.
मई 2022
ऑरिजिन ट्रायल की उपलब्धता, Chrome 102 के बीटा वर्शन का इस्तेमाल करने वाले 50% लोगों के लिए बढ़ा दी गई है.
मुफ़्त में आज़माने की सुविधा में शामिल एपीआई:
| एपीआई | नोट |
|---|---|
| Attribution Reporting | ऑरिजिन ट्रायल के लिए डेवलपर गाइड. |
| Protected Audience API | ऑरिजिन ट्रायल के लिए डेवलपर गाइड. |
| विषय | ऑरिजिन ट्रायल के लिए डेवलपर गाइड. ऑरिजिन ट्रायल में, कुछ समय के लिए Topics API को बंद कर दिया गया था. ऐसा एक बग की वजह से हुआ था, जिससे ब्राउज़र की स्थिरता पर असर पड़ा था. |
| फ़ेंस्ड फ़्रेम | Fenced Frames को ऑरिजिन ट्रायल में जोड़ा गया. एक्सपेरिमेंट के लिए, Protected Audience API से जुड़ी गाइडलाइन देखें. |
अप्रैल 2022
ऑरिजिन ट्रायल, Chrome 102 Beta के कुछ उपयोगकर्ताओं के साथ शुरू होता है.
मुफ़्त में आज़माने की सुविधा में शामिल एपीआई:
| एपीआई | नोट |
|---|---|
| Attribution Reporting | व्यक्तिगत इरादा से एक्सपेरिमेंट (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 में ऑरिजिन ट्रायल की सुविधाओं (जैसे, Protected Audience API का joinAdInterestGroup()) का इस्तेमाल किया जा रहा है, तो iframe में टोकन देना होगा. साथ ही, यह iframe के ऑरिजिन से मेल खाना चाहिए.
JavaScript की मदद से, क्रॉस-साइट ट्रैकिंग को कॉन्फ़िगर करना
अगर क्रॉस-साइट 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 > Applications पैनल में जाकर, ऑरिजिन ट्रायल की स्थिति देखी जा सकती है.
- नीचे की ओर स्क्रोल करके, फ़्रेम पैनल पर जाएं.
- वह फ़्रेम चुनें जहां आपको टोकन सेट करना है. उदाहरण के लिए, टॉप-लेवल पेज के लिए टॉप फ़्रेम या एम्बेड किए गए पेजों के लिए खास iframe.
- दाईं ओर मौजूद पैनल में, नीचे की ओर स्क्रोल करके Origin Trials सेक्शन पर जाएं.
- आपको
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 में चालू एक्सपेरिमेंट ग्रुप में शामिल हों.
उपयोगकर्ता सेटिंग
किसी उपयोगकर्ता को बिना किसी शुल्क आज़माने की सुविधा पाने के लिए, इन शर्तों का पालन करना ज़रूरी है:
- सेटिंग > सुरक्षा और निजता > Privacy Sandbox में जाकर, Privacy Sandbox का ट्रायल चालू किया हो. इसे
chrome://settings/adPrivacyसे भी ऐक्सेस किया जा सकता है. - सेटिंग > सुरक्षा और निजता > कुकी और साइट का अन्य डेटा में जाकर, तीसरे पक्ष की कुकी चालू की हों. साथ ही, "सभी कुकी को अनुमति दें" या "गुमनाम मोड में तीसरे पक्ष की कुकी ब्लॉक करें" को चुना हो. इसे
chrome://settings/cookiesसे भी ऐक्सेस किया जा सकता है. - स्टैंडर्ड ब्राउज़िंग सेशन में हो और गुप्त मोड में न हो.
ओरिजिन ट्रायल सिर्फ़ ज़रूरी शर्तें पूरी करने वाले उपयोगकर्ताओं को चालू दिखेगा. हालांकि, डेवलपर फ़्लैग का इस्तेमाल करके, अपनी प्रोडक्शन साइट पर भी इसे टेस्ट किया जा सकता है.
ऑरिजिन ट्रायल में अपनी भागीदारी को कंट्रोल करना
ओरिजिन ट्रायल का तरीका पहले जैसा ही है: आपको उन कॉन्टेक्स्ट के लिए ओरिजिन ट्रायल टोकन मिलते हैं जहां आपको एपीआई के साथ एक्सपेरिमेंट करना है. टेस्टिंग के लिए ज़्यादा लोगों को शामिल करने पर, आपको यह पक्का करना होगा कि आपने उस ट्रैफ़िक लेवल को मॉनिटर और कंट्रोल किया हो जहां आपको बिना किसी शुल्क आज़माने की सुविधा चालू करनी है.
यहां यह तरीका अपनाना सही होगा:
- डिफ़ॉल्ट रूप से, उन सभी कॉन्टेक्स्ट में ऑरिजिन ट्रायल टोकन शामिल करें जहां आपको एक्सपेरिमेंट करना है.
- चालू एपीआई की जांच करने के लिए, सुविधा की पहचान करने की सुविधा का इस्तेमाल करें.
- अगर एपीआई चालू हैं (और इसलिए, ब्राउज़र इस एक्सपेरिमेंट के लिए ज़रूरी शर्तें पूरी करता है), तो अपने एक्सपेरिमेंट की शर्तों के आधार पर चुनें कि उनका इस्तेमाल करना है या नहीं. उदाहरण के लिए, अगर आपके पास पहले से ही A/B टेस्टिंग का इन्फ़्रास्ट्रक्चर है, तो ट्रैफ़िक के प्रतिशत, सैंपलिंग या किसी अन्य एट्रिब्यूट पर एक्सपेरिमेंट किया जा सकता है. ऐसे में, आपके पास यह तय करने का विकल्प होता है कि आपको किन सुविधाओं का इस्तेमाल करना है.
किसी भी ब्राउज़र इंस्टेंस के लिए, ओरिजिन ट्रायल में हिस्सा लेने से पूरी तरह से रोका जा सकता है. इसके लिए, रिस्पॉन्स में टोकन शामिल न करें. उदाहरण के लिए, अगर आपने किसी एक्सपेरिमेंट के लिए अपना कोटा पूरा कर लिया है या आपको बिना शुल्क आज़माने की अवधि के दौरान किसी समस्या को ठीक करना है, तो टोकन को शामिल न करने से यह पक्का होता है कि पेज पर एक्सपेरिमेंट से जुड़ी कोई भी सुविधा उपलब्ध या चालू नहीं होगी.
ऑरिजिन ट्रायल को भौगोलिक क्षेत्र के हिसाब से कंट्रोल करना
किसी खास इलाके के लिए, ऑरिजिन ट्रायल से ऑप्ट-आउट नहीं किया जा सकता. ऑरिजिन ट्रायल उन पेजों पर चालू होते हैं जिनमें टोकन शामिल होता है. इसे एचटीटीपी हेडर (सर्वर-साइड) या एचटीएमएल मेटा टैग (क्लाइंट-साइड) के ज़रिए शामिल किया जाता है.
अगर आपको उपयोगकर्ता की जगह की जानकारी मिल जाती है, तो उस जानकारी के आधार पर, ऑरिजिन ट्रायल टोकन को शामिल करने के लिए कोड लिखा जा सकता है. उदाहरण के लिए, किसी उपयोगकर्ता की जगह की जानकारी का पता लगाने के लिए, आईपी पतों का इस्तेमाल किया जा सकता है. आईपी पतों की स्पूफ़िंग की जा सकती है. इसलिए, यह समस्या हल करने का गारंटीड तरीका नहीं है.
हालांकि, किसी खास देश/इलाके का ऑरिजिन, Permissions
Policy सेट कर सकता है. इससे यह कंट्रोल किया जा सकता है कि कौनसी सुविधाओं का इस्तेमाल किया जा सकता है. उदाहरण के लिए, us.example.com और uk.example.com, भौगोलिक क्षेत्र के हिसाब से तय किए गए ऐसे ऑरिजिन हैं जिन्हें कंट्रोल किया जा सकता है. इसका मतलब यह नहीं है कि किसी क्षेत्र ने ऑरिजिन ट्रायल से ऑप्ट-आउट कर लिया है.
अनुमति की नीति की मदद से, कोई साइट अपने पेजों में कोड का एक छोटा स्निपेट जोड़ती है. यह स्निपेट, ब्राउज़र को निर्देश देता है. जब पेज लोड होता है, तो ब्राउज़र, अनुमति से जुड़ी नीति के निर्देशों को पढ़ता है. इसके बाद, अनुमति से जुड़ी नीति में बताए गए तरीके से सुविधाओं या एपीआई को अनुमति देता है या उन्हें ब्लॉक करता है. अगर कोई साइट किसी खास इलाके में एपीआई को सीमित करना चाहती है, तो डेवलपर उस इलाके से अनुरोध किए गए सभी पेजों के लिए एक नीति सेट कर सकता है.
अपना टोकन रिन्यू करना
ऑरिजिन ट्रायल टोकन, जारी होने की तारीख से छह हफ़्तों के बाद खत्म हो जाते हैं. अगर ट्रायल की अवधि इससे पहले खत्म हो जाती है, तो टोकन भी उसी समय खत्म हो जाते हैं.
इसलिए, यह ज़रूरी है कि आप अपने नए टोकन को रिन्यू करें और उन्हें डिप्लॉय करें. ऐसा करने पर, ओरिजिन ट्रायल की सुविधाओं का इस्तेमाल बिना किसी रुकावट के किया जा सकेगा.
टोकन रिन्यू करने में सिर्फ़ कुछ मिनट लगते हैं. साथ ही, एक ही पेज पर एक ही ट्रायल के लिए कई टोकन डिप्लॉय किए जा सकते हैं. आपके पास मौजूदा टोकन की समयसीमा खत्म होने से पहले, नया टोकन डिप्लॉय करने का विकल्प होता है. इससे उपयोगकर्ताओं को सेवा में कोई रुकावट नहीं आएगी.
लोकल तौर पर टेस्ट करना
स्थानीय डेवलपर टेस्टिंग के बारे में खास जानकारी पाने के लिए, यह लेख पढ़ें:
ये एपीआई डिफ़ॉल्ट रूप से चालू नहीं होते हैं. इसलिए, टेस्टिंग के लिए इन्हें फ़्लैग की मदद से चालू करना ज़रूरी है. आपको यह पक्का करना चाहिए कि ऊपर दी गई कॉन्फ़िगरेशन सेटिंग चालू हों. इसके बाद:
- Chrome के ऐसे वर्शन और चैनल का इस्तेमाल करें जहां ये सुविधाएं उपलब्ध हों.
chrome://settings/adPrivacyमें जाकर, विज्ञापन देखने वाले की निजता बनाए रखने से जुड़े सभी एपीआई चालू करें.
कुछ खास एपीआई और सुविधाओं की उपलब्धता के बारे में जानने के लिए, डेवलपर गाइड देखें. साथ ही, ज़्यादा बेहतर कॉन्फ़िगरेशन के लिए अतिरिक्त फ़्लैग देखें.