इस पेज का अनुवाद Cloud Translation API से किया गया है.

Private एग्रीगेशन एपीआई की खास जानकारी

सुरक्षित ऑडियंस के डेटा और शेयर किए गए स्टोरेज के क्रॉस-साइट डेटा का इस्तेमाल करके, एग्रीगेट डेटा रिपोर्ट जनरेट करें.

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

लागू करने की स्थिति

प्रस्ताव	स्थिति
शेयर किए गए स्टोरेज के लिए, रिपोर्ट की पुष्टि करके Private Aggregation API की अमान्य रिपोर्ट को रोकना एक्सप्लेनर	Chrome में उपलब्ध
निजी एग्रीगेशन डीबग मोड की उपलब्धता, तीसरे पक्ष के लिए ज़रूरी शर्तों पर निर्भर करती है GitHub से जुड़ी समस्या	Chrome M119 में उपलब्ध है
रिपोर्ट में देरी को कम करना एक्सप्लेनर	Chrome M119 में उपलब्ध है
शेयर किए गए स्टोरेज के लिए, निजी एग्रीगेशन में योगदान देने की समयसीमा एक्सप्लेनर	M119 में उपलब्ध है
Google Cloud के लिए Private Aggregation API और एग्रीगेशन सेवा के लिए सहायता एक्सप्लेनर	Chrome M121 में उपलब्ध है
अलग-अलग डेटा को मिलाकर तैयार की गई रिपोर्ट के पेलोड के लिए पैडिंग एक्सप्लेनर	Chrome M119 में उपलब्ध है
auctionReportBuyers रिपोर्टिंग के लिए, निजी एग्रीगेशन डीबग मोड उपलब्ध है एक्सप्लेनर	Chrome M123 में उपलब्ध है
आईडी से जुड़ी सहायता फ़िल्टर करना एक्सप्लेनर	Chrome M128 में उपलब्ध है
क्लाइंट-साइड योगदान को मर्ज करना एक्सप्लेनर	Chrome M129 में उपलब्ध

Private Aggregation API क्या है

Private Aggregation API की मदद से, डेवलपर Protected Audience API के डेटा और शेयर किए गए स्टोरेज के क्रॉस-साइट डेटा का इस्तेमाल करके, एग्रीगेट डेटा रिपोर्ट जनरेट कर सकते हैं.

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

उदाहरण के लिए, अगर आपने पहले शेयर किए गए स्टोरेज में डेमोग्राफ़िक और भौगोलिक डेटा रिकॉर्ड किया है, तो Private Aggregation API का इस्तेमाल करके हिस्टोग्राम बनाया जा सकता है. इससे आपको यह पता चलता है कि न्यूयॉर्क शहर के कितने उपयोगकर्ताओं ने क्रॉस-साइट पर आपका कॉन्टेंट देखा है. इस मेज़रमेंट के लिए एग्रीगेट करने के लिए, एग्रीगेशन की में भौगोलिक डाइमेंशन को कोड में बदला जा सकता है. साथ ही, एग्रीगेट की जा सकने वाली वैल्यू में उपयोगकर्ताओं की गिनती की जा सकती है.

मुख्य सिद्धांत

जब एग्रीगेशन की-वैल्यू और एग्रीगेट की जा सकने वाली वैल्यू के साथ Private Aggregation API को कॉल किया जाता है, तो ब्राउज़र एक एग्रीगेट की जा सकने वाली रिपोर्ट जनरेट करता है.

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

Private Aggregation API से जुड़े मुख्य कॉन्सेप्ट के बारे में ज़्यादा जानने के लिए, Private Aggregation API के बुनियादी सिद्धांत दस्तावेज़ देखें.

एट्रिब्यूशन रिपोर्टिंग से अंतर

Private Aggregation API, Attribution Reporting API से कई मामलों में मिलता-जुलता है. Attribution Reporting एक स्टैंडअलोन एपीआई है, जिसे कन्वर्ज़न मेज़र करने के लिए डिज़ाइन किया गया है. वहीं, Private Aggregation को Protected Audience API और Shared Storage जैसे एपीआई के साथ क्रॉस-साइट मेज़रमेंट के लिए बनाया गया है. दोनों एपीआई, एग्रीगेट की जा सकने वाली रिपोर्ट जनरेट करते हैं. एग्रीगेशन सेवा के बैकएंड, खास जानकारी वाली रिपोर्ट जनरेट करने के लिए इन रिपोर्ट का इस्तेमाल करते हैं.

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

इस एपीआई की जांच करना

निजी एग्रीगेशन एपीआई को स्थानीय तौर पर टेस्ट करने के लिए, chrome://settings/adPrivacy में जाकर, विज्ञापन देखने वाले की निजता बनाए रखने की सुविधा से जुड़े सभी एपीआई चालू करें.

एक्सपेरिमेंट में शामिल होने और जांच करने के बारे में ज़्यादा पढ़ें.

डेमो का इस्तेमाल करना

शेयर किए गए स्टोरेज के लिए निजी एग्रीगेशन एपीआई का डेमो goo.gle/shared-storage-demo पर ऐक्सेस किया जा सकता है. साथ ही, इसका कोड GitHub पर उपलब्ध है. डेमो, क्लाइंट-साइड ऑपरेशन लागू करता है और एग्रीगेट की जा सकने वाली रिपोर्ट बनाता है. यह रिपोर्ट आपके सर्वर पर भेजी जाती है.

Protected Audience API के लिए, Private Aggregation API का डेमो आने वाले समय में पब्लिश किया जाएगा.

उपयोग के उदाहरण

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

शेयर किए गए स्टोरेज के साथ

शेयर किए गए स्टोरेज की मदद से, क्रॉस-साइट डेटा को सुरक्षित तरीके से पढ़ा और लिखा जा सकता है, ताकि डेटा लीक न हो. साथ ही, Private Aggregation API की मदद से, शेयर किए गए स्टोरेज में सेव किए गए क्रॉस-साइट डेटा को मेज़र किया जा सकता है.

यूनीक रीच का मेज़रमेंट

शायद आप यह मेज़र करना चाहें कि कितने यूनीक उपयोगकर्ताओं ने उनका कॉन्टेंट देखा है. निजी एग्रीगेशन एपीआई, "Content ID 861 को करीब 317 यूनीक उपयोगकर्ताओं ने देखा है" जैसा जवाब दे सकता है.

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

डेमोग्राफ़िक्स मेज़रमेंट

हो सकता है कि आप उन उपयोगकर्ताओं की डेमोग्राफ़िक्स मेज़र करना चाहें जिन्होंने अलग-अलग साइटों पर आपका कॉन्टेंट देखा है.

निजी एग्रीगेशन से यह जवाब मिल सकता है, जैसे कि "जर्मनी में रहने वाले 18 से 45 साल के करीब 317 यूनीक उपयोगकर्ता हैं." तीसरे पक्ष के संदर्भ से डेमोग्राफ़िक्स का डेटा ऐक्सेस करने के लिए, शेयर किए गए स्टोरेज का इस्तेमाल करें. बाद में, एग्रीगेशन बटन में उम्र समूह और देश के डाइमेंशन को कोड करके, निजी एग्रीगेशन की मदद से रिपोर्ट जनरेट की जा सकती है.

K+ फ़्रीक्वेंसी मेज़रमेंट

हो सकता है कि आपको उन उपयोगकर्ताओं की संख्या मेज़र करनी हो जिन्होंने किसी ब्राउज़र पर, किसी कॉन्टेंट या विज्ञापन को कम से कम K बार देखा हो. इसके लिए, K की पहले से चुनी गई वैल्यू का इस्तेमाल किया जा सकता है.

निजी एग्रीगेशन से यह जवाब मिल सकता है, "लगभग 89 उपयोगकर्ताओं ने Content ID 581 को कम से कम तीन बार देखा है." अलग-अलग साइटों से, शेयर किए गए स्टोरेज में काउंटर की वैल्यू बढ़ाई जा सकती है. साथ ही, उसे वर्कलेट में पढ़ा जा सकता है. जब डेटा की संख्या K तक पहुंच जाती है, तो निजी एग्रीगेशन का इस्तेमाल करके रिपोर्ट सबमिट की जा सकती है.

मल्टी-टच एट्रिब्यूशन

इस दिशा-निर्देश को डेवलपर साइट पर पब्लिश किया जाएगा, ताकि विज्ञापन टेक्नोलॉजी विशेषज्ञ, शेयर किए गए स्टोरेज और निजी एग्रीगेशन में एमटीए लागू करने का तरीका समझ सकें.

Protected Audience API की मदद से

Protected Audience API, रीटारगेटिंग और कस्टम ऑडियंस के इस्तेमाल के उदाहरणों को चालू करता है. साथ ही, Private Aggregation की मदद से, खरीदार और सेलर वर्कलेट के इवेंट की रिपोर्ट की जा सकती है. एपीआई का इस्तेमाल, नीलामी की बिड के डिस्ट्रिब्यूशन को मेज़र करने जैसे टास्क के लिए किया जा सकता है.

Protected Audience API वर्कलेट की मदद से, contributeToHistogram() का इस्तेमाल करके सीधे अपने डेटा को इकट्ठा किया जा सकता है. साथ ही, contributeToHistogramOnEvent() का इस्तेमाल करके, किसी ट्रिगर के आधार पर अपने डेटा की रिपोर्ट भी की जा सकती है. contributeToHistogramOnEvent(), Protected Audience API का एक खास एक्सटेंशन है.

उपलब्ध फ़ंक्शन

शेयर किए गए स्टोरेज और Protected Audience API वर्कलेट में मौजूद privateAggregation ऑब्जेक्ट में ये फ़ंक्शन उपलब्ध हैं.

contributeToHistogram()

privateAggregation.contributeToHistogram({ bucket: <bucket>, value: <value> }) को कॉल किया जा सकता है, जहां एग्रीगेशन की कुंजी bucket है और एग्रीगेट की जा सकने वाली वैल्यू value है. bucket पैरामीटर के लिए, BigInt ज़रूरी है. value पैरामीटर के लिए, पूर्णांक डालना ज़रूरी है.

रीच मेज़रमेंट के लिए, शेयर किए गए स्टोरेज में इसे कॉल करने का उदाहरण यहां दिया गया है:

`iframe.js`

// Cross-site iframe code

async function measureReach() {
 // Register worklet
 await window.sharedStorage.worklet.addModule('worklet.js');

 // Run reach measurement operation
 await window.sharedStorage.run('reach-measurement', {
  data: { contentId: '1234' }
 });
}

measureReach();

`worklet.js`

// Shared storage worklet code

function convertContentIdToBucket(campaignId){
  // Generate aggregation key
}

// The scale factor is multiplied by the aggregatable value to
// maximize the signal-to-noise ratio. See "Noise and scaling"
// section in the Aggregation Fundamentals document to learn more.
const SCALE_FACTOR = 65536;

class ReachMeasurementOperation {
  async run(data) {
    const key = 'has-reported-content';
    // Read the flag from Shared Storage
    const hasReportedContent = await sharedStorage.get(key) === 'true';

    // Don't send report if the flag is set
    if (hasReportedContent) {
      return;
    }

    // Send histogram report
    // Set the aggregation key in `bucket`
    // Bucket examples: 54153254n or BigInt(54153254)
    // Set the scaled aggregatable value in `value`
    privateAggregation.contributeToHistogram({
      bucket: convertContentIdToBucket(data.contentId),
      value: 1 * SCALE_FACTOR
    });

    // Set the flag in Shared Storage
    await sharedStorage.set(key, true);
  }
}

register('reach-measurement', ReachMeasurementOperation);

पिछले कोड के उदाहरण में, जब भी क्रॉस-साइट iframe कॉन्टेंट लोड होगा, तब निजी एग्रीगेशन को कॉल किया जाएगा. iframe कोड, वर्कलेट को लोड करता है. इसके बाद, वर्कलेट, एग्रीगेशन कुंजी (बकेट) में बदले गए कॉन्टेंट आईडी के साथ निजी एग्रीगेशन एपीआई को कॉल करता है.

contributeToHistogramOnEvent()

हम सिर्फ़ Protected Audience API वर्कलेट में, ट्रिगर पर आधारित एक सुविधा देते हैं. इसकी मदद से, सिर्फ़ किसी खास इवेंट के होने पर रिपोर्ट भेजी जा सकती है. इस फ़ंक्शन की मदद से, बकेट और वैल्यू को उन सिग्नल पर भी निर्भर किया जा सकता है जो नीलामी के उस समय तक उपलब्ध नहीं होते.

privateAggregation.contributeToHistogramOnEvent(eventType, contribution) तरीका, eventType लेता है, जो ट्रिगर करने वाले इवेंट की जानकारी देता है. साथ ही, इवेंट ट्रिगर होने पर सबमिट किए जाने वाले contribution की जानकारी देता है. ट्रिगर करने वाला इवेंट, नीलामी खत्म होने के बाद नीलामी से ही आ सकता है. जैसे, नीलामी जीतने या हारने का इवेंट. इसके अलावा, यह विज्ञापन रेंडर करने वाले फ़ेंस किए गए फ़्रेम से भी आ सकता है.

नीलामी के इवेंट के लिए रिपोर्ट भेजने के लिए, reserved.win, reserved.loss, और reserved.always नाम के दो रिज़र्व कीवर्ड का इस्तेमाल किया जा सकता है. फ़ेंस किए गए फ़्रेम से किसी इवेंट से ट्रिगर की गई रिपोर्ट सबमिट करने के लिए, कस्टम इवेंट टाइप तय करें. फ़ेंस किए गए फ़्रेम से इवेंट को ट्रिगर करने के लिए, फ़ेंस किए गए फ़्रेम के विज्ञापन रिपोर्टिंग एपीआई में उपलब्ध fence.reportEvent() तरीके का इस्तेमाल करें.

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

function generateBid(interestGroup, auctionSignals, perBuyerSignals, trustedBiddingSignals, browserSignals) {
  // …
  privateAggregation.contributeToHistogramOnEvent("reserved.win", {
      bucket: getImpressionReportBucket(),
      value: 1
  });
  privateAggregation.contributeToHistogramOnEvent("click", {
      bucket: getClickReportBuckets(), // 128-bit integer as BigInt
      value: 1
  });

ज़्यादा जानने के लिए, एक्सटेंडेड प्राइवेट एग्रीगेशन रिपोर्टिंग के बारे में जानकारी देखें.

enableDebugMode()

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

वर्कलेट में privateAggregation.enableDebugMode() को कॉल करने से, डीबग मोड चालू हो जाता है. इसकी वजह से, एग्रीगेट की जा सकने वाली रिपोर्ट में, बिना एन्क्रिप्ट किए गए (क्लियरटेक्स्ट) पेलोड शामिल हो जाते हैं. इसके बाद, एग्रीगेशन सेवा के लोकल टेस्टिंग टूल की मदद से, इन पेलोड को प्रोसेस किया जा सकता है.

डीबग मोड सिर्फ़ उन कॉलर के लिए उपलब्ध है जिन्हें तीसरे पक्ष की कुकी ऐक्सेस करने की अनुमति है. अगर कॉल करने वाले के पास तीसरे पक्ष की कुकी का ऐक्सेस नहीं है, तो enableDebugMode() चुपचाप काम नहीं करेगा.

privateAggregation.enableDebugMode({ <debugKey: debugKey> }) को कॉल करके भी डीबग बटन सेट किया जा सकता है. इसमें BigInt का इस्तेमाल डीबग बटन के तौर पर किया जा सकता है. डीबग पासकोड का इस्तेमाल, कुकी पर आधारित मेज़रमेंट और निजी एग्रीगेशन मेज़रमेंट के डेटा को जोड़ने के लिए किया जा सकता है.

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

// Enables debug mode
privateAggregation.enableDebugMode();

// Enables debug mode and sets a debug key
privateAggregation.enableDebugMode({ debugKey: BigInt(1234) });

रिपोर्ट की पुष्टि करना

Private Aggregation API, उपयोगकर्ता की निजता को सुरक्षित रखते हुए, क्रॉस-साइट मेज़रमेंट की सुविधा देता है. हालांकि, नुकसान पहुंचाने वाले लोग इन मेज़रमेंट की सटीक जानकारी में बदलाव करने की कोशिश कर सकते हैं. इससे बचने के लिए, रिपोर्ट की पुष्टि करने के लिए कॉन्टेक्स्ट आईडी का इस्तेमाल किया जा सकता है.

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

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

ध्यान दें: सुरक्षा के ये उपाय, Private Aggregation API के इस्तेमाल के संदर्भ के हिसाब से अलग-अलग होते हैं. रिपोर्ट की पुष्टि करने की सुविधा, run() और selectURL() के शेयर किए गए स्टोरेज के तरीकों के लिए उपलब्ध है. अगर फ़ेंस किए गए फ़्रेम में शेयर किए गए स्टोरेज का इस्तेमाल किया जा रहा है या Protected Audience API के साथ निजी एग्रीगेशन का इस्तेमाल किया जा रहा है, तो रिपोर्ट की पुष्टि करने की सुविधा उपलब्ध नहीं है. ज़्यादा जानने और आने वाले समय में इस सुविधा को लागू करने के बारे में चर्चा में हिस्सा लेने के लिए, रिपोर्ट की पुष्टि करने के बारे में जानकारी देखें.

शेयर किया गया स्टोरेज

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

यह आईडी, वर्कलेट से बनाई गई रिपोर्ट में एम्बेड होता है. privateAggregationConfig कुंजी के नीचे मौजूद विकल्प ऑब्जेक्ट में, run() या selectURL() शेयर किए गए स्टोरेज के तरीकों को कॉल करते समय, इसे बताया जा सकता है.

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

sharedStorage.run('measurement-operation', {
  privateAggregationConfig: {
    contextId: 'exampleId123456789abcdeFGHijk'
  }
});

यह आईडी सेट होने के बाद, इसका इस्तेमाल करके पुष्टि की जा सकती है कि रिपोर्ट आपके शेयर किए गए स्टोरेज ऑपरेशन से भेजी गई है. जानकारी लीक होने से रोकने के लिए, शेयर किए गए स्टोरेज के हर ऑपरेशन के लिए एक ही रिपोर्ट भेजी जाती है. भले ही, कोई योगदान न दिया गया हो. contributeToHistogram() कॉल की संख्या से कोई फ़र्क़ नहीं पड़ता.

Private Aggregation API, एग्रीगेट की जा सकने वाली रिपोर्ट को एक घंटे तक की रैंडम देरी के साथ भेजता है. हालांकि, किसी रिपोर्ट की पुष्टि करने के लिए संदर्भ आईडी सेट करने पर, इस देरी को कम किया जा सकता है. इस मामले में, शेयर किए गए स्टोरेज में फ़ाइलें ट्रांसफ़र होने में 5 सेकंड की देरी होती है.

रिपोर्ट की पुष्टि करने के लिए वर्कफ़्लो का उदाहरण

वर्कफ़्लो का उदाहरण (जैसा कि ऊपर दिए गए डायग्राम में दिखाया गया है):

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

कॉन्टेक्स्ट आईडी की पुष्टि करना

आपके कलेक्टर सर्वर पर आने वाली रिपोर्ट की पुष्टि, एग्रीगेशन सेवा पर भेजे जाने से पहले, कई अलग-अलग तरीकों से की जा सकती है. अमान्य कॉन्टेक्स्ट आईडी वाली रिपोर्ट अस्वीकार की जा सकती हैं. ऐसा तब होता है, जब कॉन्टेक्स्ट आईडी:

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

दर्शकों से जुड़ना और सुझाव, राय या शिकायत शेयर करना

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

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