Private एग्रीगेशन API से जुड़ी बुनियादी बातें

Private एग्रीगेशन API के मुख्य कॉन्सेप्ट

यह दस्तावेज़ किसके लिए है?

Private Aggregation API, क्रॉस-साइट डेटा का ऐक्सेस रखने वाले वर्कलेट से डेटा इकट्ठा करने की सुविधा देता है. यहां शेयर किए गए कॉन्सेप्ट, रिपोर्टिंग बनाने वाले डेवलपर के लिए ज़रूरी हैं शेयर किए गए स्टोरेज और Protected Audience API के अंदर मौजूद फ़ंक्शन.

• अगर आप कोई डेवलपर हैं और क्रॉस-साइट के लिए रिपोर्टिंग सिस्टम बना रहे हैं और उन्हें मापा जा सकता है.
• अगर आप मार्केटर, डेटा साइंटिस्ट या खास जानकारी वाली रिपोर्ट हैं उपभोक्ता, इन प्रक्रियाओं को समझने से आपको अपने संगठन के लिए फ़ैसले के तहत, ऑप्टिमाइज़ की गई खास जानकारी वाली रिपोर्ट को फिर से हासिल किया जा सकता है.

मुख्य शब्द

इस दस्तावेज़ को पढ़ने से पहले, आपको मुख्य शब्दों और सिद्धांतों के बारे में जानना होगा. इनमें से हर शब्द के बारे में यहां पूरी जानकारी दी गई है.

• एग्रीगेशन पासकोड (जिसे बकेट भी कहा जाता है) पहले से तय डेटा पॉइंट इकट्ठा करना. उदाहरण के लिए, हो सकता है कि आप जगह की जानकारी के उस डेटा की बकेट इकट्ठा करना चाहें जहां ब्राउज़र, देश के नाम की जानकारी देता है. एग्रीगेशन कुंजी में एक से ज़्यादा डाइमेंशन हो सकते हैं. उदाहरण के लिए, आपके कॉन्टेंट विजेट का देश और आईडी.
• एग्रीगेट की जा सकने वाली वैल्यू, एक निजी डेटा पॉइंट होता है को एग्रीगेशन कुंजी में इकट्ठा किया जा सकता है. अगर आपको यह मेज़र करना है कि फ़्रांस के कितने उपयोगकर्ताओं ने आपका कॉन्टेंट देखा है, तो France एग्रीगेशन बटन में डाइमेंशन है और 1 की viewCount एग्रीगेट की जा सकने वाली वैल्यू है.
• एग्रीगेट की जा सकने वाली रिपोर्ट, ब्राउज़र में जनरेट और एन्क्रिप्ट (सुरक्षित) की जाती हैं. Private Aggregation API के लिए, इसमें किसी एक इवेंट का डेटा होता है.
• एग्रीगेशन सेवा खास जानकारी वाली रिपोर्ट बनाने के लिए, एग्रीगेट की जा सकने वाली रिपोर्ट के डेटा को प्रोसेस करता है.
• खास जानकारी वाली रिपोर्ट, एग्रीगेशन सेवा का आखिरी आउटपुट है. इसमें, उपयोगकर्ता का एग्रीगेट किया गया ग़ैर-ज़रूरी डेटा और कन्वर्ज़न का पूरा डेटा शामिल होता है.
• वर्कलेट एक टुकड़ा होता है एक ऐसी बुनियादी संरचना है जो आपको विशिष्ट JavaScript फ़ंक्शन चलाने और अनुरोधकर्ता को जानकारी वापस लौटाएं. वर्कलेट में, JavaScript लेकिन आप बाहरी पेज से इंटरैक्ट या संवाद नहीं कर सकते.

निजी एग्रीगेशन वर्कफ़्लो

जब आप निजी एग्रीगेशन एपीआई को किसी एग्रीगेशन कुंजी और जब ब्राउज़र, एग्रीगेट की जा सकने वाली रिपोर्ट जनरेट करता है. रिपोर्ट, आपके सर्वर पर भेजी जाती हैं, जो रिपोर्ट को एक साथ भेजता है. बैच में बनाई गई रिपोर्ट एग्रीगेशन सेवा के ज़रिए प्रोसेस किया जाता है और खास जानकारी वाली रिपोर्ट जनरेट की जाती है.

1. Private Aggregation API को कॉल करने पर, क्लाइंट (ब्राउज़र) एग्रीगेट की जा सकने वाली रिपोर्ट जनरेट करता है और उसे इकट्ठा करने के लिए आपके सर्वर पर भेजता है.
2. आपका सर्वर क्लाइंट से रिपोर्ट इकट्ठा करता है और उन्हें एक को एग्रीगेशन सेवा को भेजा गया.
3. पर्याप्त रिपोर्ट इकट्ठा कर लेने के बाद, आप उन्हें बैच बनाकर एग्रीगेशन सेवा, जो भरोसेमंद एक्ज़ीक्यूशन एनवायरमेंट में चल रही है. इससे ये जनरेट किए जा सकते हैं खास जानकारी वाली रिपोर्ट में.

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

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

एग्रीगेशन की कुंजी

एग्रीगेशन की (कम शब्दों में "कुंजी") उस बकेट के बारे में बताती है जहां एग्रीगेट की जा सकने वाली वैल्यू इकट्ठा हो जाएंगी. एक या उससे ज़्यादा डाइमेंशन को पासकोड में एन्कोड किया जा सकता है. डाइमेंशन किसी ऐसे पहलू को दिखाता है जिसमें आपको ज़्यादा फ़ायदा पाना है के बारे में अहम जानकारी, जैसे कि उपयोगकर्ताओं के उम्र समूह या किसी विज्ञापन के इंप्रेशन की संख्या कैंपेन बनाएं.

उदाहरण के लिए, आपके पास ऐसा विजेट हो सकता है जिसे कई साइटों पर एम्बेड किया गया हो. साथ ही, आपको उन उपयोगकर्ताओं के देश का विश्लेषण करना हो जिन्होंने आपका विजेट देखा है. आपको "मेरे विजेट को देखने वाले कितने उपयोगकर्ता, देश X से हैं?" जैसे सवालों के जवाब चाहिए. इस सवाल की रिपोर्ट करने के लिए, एक एग्रीगेशन पासकोड सेट अप किया जा सकता है, जो दो डाइमेंशन को कोड में बदलता है: विजेट आईडी और देश आईडी.

निजी एग्रीगेशन एपीआई को दी गई कुंजी यह है BigInt, जिसमें कई डाइमेंशन होते हैं. इस उदाहरण में, डाइमेंशन के तौर पर विजेट आईडी और देश का आईडी इस्तेमाल किया गया है. मान लें कि विजेट आईडी में ज़्यादा से ज़्यादा चार अंक हो सकते हैं, जैसे कि 1234. साथ ही, हर देश को वर्णमाला के क्रम में किसी नंबर से मैप किया गया है. जैसे, अफ़ग़ानिस्तान को 1, फ़्रांस को 61, और जिम्बाब्वे को '195'. इसलिए, इकट्ठा की जा सकने वाली कुंजी सात अंकों की होगी, जिसमें पहले चार वर्ण WidgetID के लिए आरक्षित हैं और अंतिम 3 वर्ण हैं CountryID के लिए बुक किया गया.

मान लें कि यह कुंजी, फ़्रांस के उपयोगकर्ताओं की संख्या (देश आईडी 061) के बारे में बताती है जिन लोगों ने विजेट आईडी 3276 देखा है, एग्रीगेशन कुंजी 3276061 है.

एग्रीगेशन की कुंजी
विजेट आईडी	देश का आईडी
3276	061

उदाहरण: अगर किसी डाइमेंशन में कई अंकों के लिए की-स्पेस उपलब्ध है, लेकिन वैल्यू में कम अंक हैं, तो शुरुआत में शून्य जोड़ें. उदाहरण के लिए, अगर देश के आईडी में तीन अंक होने चाहिए, तो अल्जीरिया के लिए देश का आईडी 003 होगा.

एग्रीगेशन पासकोड को हैशिंग की सुविधा की मदद से भी जनरेट किया जा सकता है. जैसे, SHA-256. उदाहरण के लिए, स्ट्रिंग {"WidgetId":3276,"CountryID":67} को हैश किया जा सकता है और फिर 42943797454801331377966796057547478208888578253058197330928948081739249096287n की BigInt वैल्यू में बदला जा सकता है. अगर हैश वैल्यू में 128 बिट से ज़्यादा हैं, तो इसे छोटा किया जा सकता है, ताकि यह 2^128−1 की तय सीमा से ज़्यादा न हो.

Shared Storage के वर्कलेट में, आप crypto और TextEncoder मॉड्यूल जिसकी मदद से हैश जनरेट किया जा सकता है. हैश जनरेट करने के बारे में ज़्यादा जानने के लिए, यहां जाएं SubtleCrypto.digest() चालू है एमडीएन.

नीचे दिए गए उदाहरण में, हैश किए गए कोड से बकेट कुंजी जनरेट करने का तरीका बताया गया है मान:

async function convertToBucket(data) {
  // Encode as UTF-8 Uint8Array
  const encodedData = new TextEncoder().encode(data);

  // Generate SHA-256 hash
  const hashBuffer = await crypto.subtle.digest('SHA-256', encodedData);

  // Truncate the hash
  const truncatedHash = Array.from(new Uint8Array(hashBuffer, 0, 16));

  // Convert the byte sequence to a decimal
  return truncatedHash.reduce((acc, curr) => acc * 256n + BigInt(curr), 0n);
}

const data = {
  WidgetId: 3276,
  CountryID: 67
};

const dataString = JSON.stringify(data);
const bucket = await convertToBucket(dataString);

console.log(bucket); // 126200478277438733997751102134640640264n

ध्यान दें: दोनों एपीआई के कॉन्सेप्ट एक जैसे हैं. हालांकि, Attribution Reporting API के मुकाबले, Private Aggregation API के लिए पासकोड को अलग तरीके से बनाया जाता है. निजी एग्रीगेशन के लिए, पूरी कुंजी एक ही बार में, JavaScript कॉल में तय किया जाता है.

एग्रीगेट की जा सकने वाली वैल्यू

एग्रीगेट किए गए नतीजे जनरेट करने के लिए, कई उपयोगकर्ताओं से इकट्ठा की जा सकने वाली वैल्यू को हर कुंजी के हिसाब से जोड़ा जाता है खास जानकारी की रिपोर्ट में, खास जानकारी के तौर पर.

अब, पहले पूछे गए उदाहरण वाले सवाल पर वापस जाएं: "मेरे विजेट को देखने वाले कितने उपयोगकर्ता फ़्रांस से हैं?" इस सवाल का जवाब दिखेगा "मेरा विजेट आईडी 3276 देखने वाले करीब 4881 उपयोगकर्ताओं ने फ़्रांस से." हर उपयोगकर्ता के लिए, एग्रीगेट की जा सकने वाली वैल्यू 1 होती है. साथ ही, "4881 उपयोगकर्ता" एग्रीगेट की गई वैल्यू होती है. यह उस एग्रीगेशन की सभी एग्रीगेट की जा सकने वाली वैल्यू का योग होती है.

एग्रीगेशन की कुंजी		एग्रीगेट की जा सकने वाली वैल्यू
विजेट आईडी	देश का आईडी	देखे जाने की संख्या
3276	061	1

इस उदाहरण के लिए, हम विजेट देखने वाले हर उपयोगकर्ता के लिए वैल्यू को 1 से बढ़ाते हैं. व्यावहारिक तौर पर, सिग्नल-टू-नॉइज़ को बेहतर बनाने के लिए, इकट्ठा की जा सकने वाली वैल्यू को बढ़ाया जा सकता है अनुपात.

योगदान का बजट

Private एग्रीगेशन API के लिए किए जाने वाले हर कॉल को योगदान कहा जाता है. उपयोगकर्ता की निजता को सुरक्षित रखने के लिए, किसी व्यक्ति से ज़्यादा योगदान नहीं लिए जा सकते.

सभी एग्रीगेशन बटन के लिए, एग्रीगेट की जा सकने वाली सभी वैल्यू का योग, योगदान बजट से कम होना चाहिए. बजट का दायरा हर वर्कलेट के हिसाब से है शुरुआत की जगह, हर दिन, और यह है Protected Audience API और Shared Storage के वर्कलेट के लिए अलग-अलग हैं. दिन के लिए, करीब-करीब पिछले 24 घंटों की रोलिंग विंडो का इस्तेमाल किया जाता है. अगर नए एग्रीगेट करने लायक रिपोर्ट से बजट की सीमा बढ़ जाएगी, लेकिन रिपोर्ट बनाया गया.

योगदान के लिए बजट पैरामीटर L₁ से दिखाया जाता है. 2²⁰ के बैकस्टॉप के साथ, हर दिन हर 10 मिनट के लिए ¹⁶ (65,536) पर सेट किया गया

(1,048,576). देखें जानकारी देने वाला से इन पैरामीटर के बारे में ज़्यादा जानें.

योगदान बजट की वैल्यू मनमुताबिक होती है, लेकिन नॉइज़ को इसके हिसाब से स्केल किया जाता है. इस बजट का इस्तेमाल, खास जानकारी वाली वैल्यू पर सिग्नल-टू-नॉइज़ रेशियो को बढ़ाने के लिए किया जा सकता है (इसकी ज़्यादा जानकारी शोर और स्केलिंग सेक्शन में दी गई है).

योगदान के लिए बजट के बारे में ज़्यादा जानने के लिए, जानकारी देने वाला. साथ ही, योगदान देने वाला सेक्शन देखें बजट की मदद ली जा सकती है.

हर रिपोर्ट के लिए योगदान की सीमा

कॉलर के आधार पर, योगदान की सीमा अलग-अलग हो सकती है. फ़िलहाल, रिपोर्ट Shared Storage API का इस्तेमाल करने वाले कॉलर, हर रिपोर्ट में ज़्यादा से ज़्यादा 20 योगदान दे सकते हैं. वहीं दूसरी ओर, Protected Audience API से कॉल करने वाले लोगों के लिए, योगदान देने की सीमा 100 होती है प्रति रिपोर्ट. ये सीमाएं, पेलोड के साइज़ के साथ एम्बेड किए जा सकने वाले योगदान की संख्या को संतुलित करने के लिए चुनी गई थीं.

शेयर किए गए स्टोरेज के लिए, एक ही run() या selectURL() ऑपरेशन में किए गए योगदान को एक रिपोर्ट में रखा जाता है. सुरक्षित ऑडियंस के लिए, योगदान दिया गया नीलामी में एक ही ऑरिजिन के हिसाब से बैच बनाकर उन्हें एक साथ रखा जाता है.

पैडिंग (जगह) से जुड़े योगदान

पैडिंग (जगह) सुविधा की मदद से योगदान में और बदलाव किए जाते हैं. पैडिंग (जगह) पेलोड की मदद से, इस बात की सुरक्षा की जा सकती है कि योगदान देने वाले लोगों की सही संख्या बताई गई है या नहीं इकट्ठा करने वाली रिपोर्ट. पैडिंग, तय लंबाई तक पहुंचने के लिए, null योगदान (यानी वैल्यू 0) के साथ पेलोड को बढ़ाती है.

एग्रीगेट की जा सकने वाली रिपोर्ट

जब उपयोगकर्ता Private Aggregation API को कॉल करता है, तो ब्राउज़र एग्रीगेट की जा सकने वाली रिपोर्ट जनरेट करता है. इन रिपोर्ट को एग्रीगेशन सेवा बाद में प्रोसेस करती है, ताकि खास जानकारी वाली रिपोर्ट जनरेट की जा सकें. एग्रीगेट की जा सकने वाली रिपोर्ट, JSON फ़ॉर्मैट में होती है. इसमें योगदान की एन्क्रिप्ट की गई सूची होती है. हर सूची में एक {aggregation key, aggregatable value} जोड़ा होता है. अलग-अलग डेटा को मिलाकर तैयार की गई रिपोर्ट, एक घंटे तक की देरी के साथ भेजी जाती हैं.

योगदान एन्क्रिप्ट (सुरक्षित) किए जाते हैं और एग्रीगेशन सेवा के बाहर उन्हें पढ़ा नहीं जा सकता. एग्रीगेशन सेवा, रिपोर्ट को डिक्रिप्ट करती है और खास जानकारी वाली रिपोर्ट जनरेट करती है. ब्राउज़र के लिए एन्क्रिप्शन पासकोड और एग्रीगेशन सेवा के लिए डिक्रिप्शन पासकोड, कोऑर्डिनेटर जारी करता है. यह पासकोड, पासकोड मैनेज करने वाली सेवा के तौर पर काम करता है. कोऑर्डिनेटर, सेवा इमेज के बाइनरी हैश की सूची रखता है, ताकि यह पुष्टि की जा सके कि कॉलर को डिक्रिप्ट करने की कुंजी पाने की अनुमति है या नहीं.

डीबग मोड चालू होने पर, एग्रीगेट की जा सकने वाली रिपोर्ट का उदाहरण:

  "aggregation_service_payloads": [
    {
      "debug_cleartext_payload": "omRkYXRhgaJldmFsdWVEAAAAgGZidWNrZXRQAAAAAAAAAAAAAAAAAAAE0mlvcGVyYXRpb25paGlzdG9ncmFt",
      "key_id": "2cc72b6a-b92f-4b78-b929-e3048294f4d6",
      "payload": "a9Mk3XxvnfX70FsKrzcLNZPy+00kWYnoXF23ZpNXPz/Htv1KCzl/exzplqVlM/wvXdKUXCCtiGrDEL7BQ6MCbQp1NxbWzdXfdsZHGkZaLS2eF+vXw2UmLFH+BUg/zYMu13CxHtlNSFcZQQTwnCHb"
    }
  ],
  "debug_key": "777",
  "shared_info": "{\"api\":\"shared-storage\",\"debug_mode\":\"enabled\",\"report_id\":\"5bc74ea5-7656-43da-9d76-5ea3ebb5fca5\",\"reporting_origin\":\"https://localhost:4437\",\"scheduled_report_time\":\"1664907229\",\"version\":\"0.1\"}"

एग्रीगेट की जा सकने वाली रिपोर्ट की समीक्षा करने के लिए, chrome://private-aggregation-internals पेज पर जाएं:

जांच के लिए, "चुनी गई रिपोर्ट भेजें" बटन का इस्तेमाल इन्हें भेजने के लिए किया जा सकता है तो तुरंत सर्वर को रिपोर्ट करें.

एग्रीगेट की जा सकने वाली रिपोर्ट इकट्ठा करना और उन्हें एक साथ भेजना

ब्राउज़र, वर्कलेट की शुरुआत में इकट्ठा की जा सकने वाली रिपोर्ट भेजता है इसमें सूची में दिए गए जाने-माने लोगों की जानकारी का इस्तेमाल करके, Private एग्रीगेशन एपीआई को कॉल किया गया है पथ:

• शेयर किए गए स्टोरेज के लिए: /.well-known/private-aggregation/report-shared-storage
• सुरक्षित ऑडियंस के लिए: /.well-known/private-aggregation/report-protected-audience अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

इन एंडपॉइंट पर, आपको एक सर्वर चलाना होगा. यह सर्वर, क्लाइंट से भेजी गई ऐसी रिपोर्ट इकट्ठा करता है जिन्हें एग्रीगेट किया जा सकता है.

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

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

एग्रीगेशन सेवा

एग्रीगेशन सेवा कलेक्टर से एन्क्रिप्ट की गई एग्रीगेट की जा सकने वाली रिपोर्ट हासिल करता है और खास जानकारी जनरेट करता है रिपोर्ट.

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

खास जानकारी वाली रिपोर्ट

खास जानकारी वाली रिपोर्ट इससे आपको अतिरिक्त गै़र-ज़रूरी डेटा के साथ इकट्ठा किया गया डेटा देखने की सुविधा मिलती है. आप इसका अनुरोध कर सकते हैं कुंजियों के सेट की खास जानकारी वाली रिपोर्ट.

खास जानकारी वाली रिपोर्ट में, की-वैल्यू पेयर का JSON डिक्शनरी स्टाइल वाला सेट होता है. हर जोड़े में ये शामिल होते हैं:

• bucket: बाइनरी नंबर स्ट्रिंग के तौर पर एग्रीगेशन पासकोड. अगर एग्रीगेशन की "123" है, फिर बकेट "1111011" है.
• value: किसी मेज़रमेंट लक्ष्य की खास जानकारी वाली वैल्यू, जो एग्रीगेट की जा सकने वाली सभी उपलब्ध रिपोर्ट से जोड़ी गई है.

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

[
  {"bucket":` `"111001001",` `"value":` `"2558500"},
  {"bucket":` `"111101001",` `"value":` `"3256211"},
  {"bucket":` `"111101001",` `"value":` `"6536542"},
]

शोर और स्केलिंग

उपयोगकर्ता की निजता को बनाए रखने के लिए, एग्रीगेशन सेवा हर एक में नॉइज़ जोड़ती है हर बार समरी रिपोर्ट का अनुरोध किए जाने पर सारांश मान. गड़बड़ी की वैल्यू, लाप्लास प्रायिकता डिस्ट्रिब्यूशन से रैंडम तौर पर ली जाती हैं. आपके पास, शोर जोड़ने के तरीकों को सीधे तौर पर कंट्रोल करने का विकल्प नहीं होता. हालांकि, आपके पास मेज़रमेंट डेटा पर शोर के असर को कम करने का विकल्प होता है.

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

उदाहरण के लिए, मान लें कि शोर के डिस्ट्रिब्यूशन का स्टैंडर्ड डीविएशन 100 है और शून्य पर केंद्रित होता है. अगर इकट्ठा की गई ऐसी रिपोर्ट की वैल्यू (या "एग्रीगेटेबल वैल्यू") सिर्फ़ 200 है, तो नॉइज़ का स्टैंडर्ड डिविएशन होगा एग्रीगेट की गई वैल्यू का 50%. हालांकि, अगर एग्रीगेट की जा सकने वाली वैल्यू 20,000 है, तो गड़बड़ी का स्टैंडर्ड डेविएशन, एग्रीगेट की गई वैल्यू का सिर्फ़ 0.5% होगा. इसलिए, 20,000 की एग्रीगेट की जा सकने वाली वैल्यू का सिग्नल-शोर अनुपात बहुत ज़्यादा होगा.

इसलिए, एग्रीगेट की जा सकने वाली वैल्यू को स्केलिंग फ़ैक्टर से गुणा करने से, ग़ैर-ज़रूरी डेटा को कम करने में मदद मिल सकती है. स्केलिंग फ़ैक्टर से यह पता चलता है कि आपको किसी दिए गए डाइमेंशन को कितना स्केल करना है एग्रीगेट किया जा सकने वाला मान.

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

स्केलिंग फ़ैक्टर का सही हिसाब लगाने के लिए, योगदान के बजट को सभी बटन के लिए एग्रीगेट की जा सकने वाली वैल्यू के सबसे बड़े योग से भाग दें.

योगदान का बजट देखें दस्तावेज़ देखें.

दिलचस्पी बढ़ाएं और सुझाव दें

Private Aggregation API के बारे में फ़िलहाल चर्चा की जा रही है. आने वाले समय में, इसमें बदलाव हो सकता है. अगर आपने इस एपीआई को आज़माया है और आपके पास कोई सुझाव है, तो हमें ज़रूर बताएं.

• GitHub: पढ़ें जानकारी देने वाला, सवाल पूछें और इनमें हिस्सा लें चर्चा. * डेवलपर सहायता: Privacy Sandbox के डेवलपर सहायता रिपॉज़िटरी पर सवाल पूछें और चर्चाओं में हिस्सा लें. * निजी एग्रीगेशन से जुड़े नए एलान पाने के लिए, Shared Storage API ग्रुप और Protected Audience API ग्रुप के साथ जुड़ें.