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

Protected Audience से मिले डेटा और Shared Storage से अलग-अलग साइटों से मिले डेटा का इस्तेमाल करके, एग्रीगेट डेटा रिपोर्ट जनरेट करना.

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

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

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

Private Aggregation API क्या है

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

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

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

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

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

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

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

Attribution Reporting से अंतर

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

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

इस एपीआई को आज़माएं

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

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

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

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

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

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

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

Shared Storage की मदद से

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

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

ऐसा हो सकता है कि आपको यह मेज़र करना हो कि कितने यूनीक उपयोगकर्ताओं ने उनका कॉन्टेंट देखा है. Private Aggregation API, इस तरह का जवाब दे सकता है: "लगभग 317 यूनीक उपयोगकर्ताओं ने Content ID 861 देखा है."

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

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

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

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

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

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

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

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

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

Protected Audience API की मदद से

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

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

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

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

contributeToHistogram()

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

यहां एक उदाहरण दिया गया है कि पहुंच मेज़रमेंट के लिए, इसे Shared Storage में कैसे कॉल किया जा सकता है:

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 का कॉन्टेंट लोड होने पर, Private Aggregation को कॉल करेगा. आईफ़्रेम कोड, वर्कलेट को लोड करता है. इसके बाद, वर्कलेट, Private Aggregation API को कॉल करता है. इसमें कॉन्टेंट आईडी को एग्रीगेशन कुंजी (बकेट) में बदल दिया जाता है.

contributeToHistogramOnEvent()

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

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

नीलामी इवेंट के लिए रिपोर्ट भेजने के लिए, आरक्षित किए गए इन तीन कीवर्ड का इस्तेमाल किया जा सकता है: reserved.win, reserved.loss, और reserved.always. फ़ेन्स्ड फ़्रेम से ट्रिगर हुए किसी इवेंट की रिपोर्ट सबमिट करने के लिए, कस्टम इवेंट टाइप तय करें. फ़ेंस किए गए फ़्रेम से इवेंट को ट्रिगर करने के लिए, Fenced Frames Ads Reporting API से उपलब्ध 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
  });

ज़्यादा जानने के लिए, Extended Private Aggregation Reporting के बारे में जानकारी देने वाला लेख देखें.

enableDebugMode()

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

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

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

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

Shared Storage

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

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

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

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

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

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

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

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

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

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

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

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

सुझाव/राय देना या शिकायत करना

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