एट्रिब्यूशन रिपोर्टिंग के लिए एग्रीगेशन कुंजियों को समझना

एग्रीगेशन कुंजियां क्या होती हैं, एट्रिब्यूशन रिपोर्टिंग एपीआई में इनका इस्तेमाल कैसे किया जाता है, और लक्ष्यों को कुंजियों में कैसे बदला जा सकता है.

विज्ञापन टेक्नोलॉजी कंपनी के तौर पर, आपको अलग-अलग प्रॉडक्ट कैटगरी के लिए कई जगहों पर कैंपेन चलाने हैं. इसलिए, आपको विज्ञापन देने वालों को इन सवालों के जवाब देने में मदद करनी है:

1. हर भौगोलिक क्षेत्र में मेरे हर कैंपेन से, हर प्रॉडक्ट कैटगरी की कितनी परचेज़ जनरेट हुईं?
2. हर भौगोलिक क्षेत्र में मेरे हर कैंपेन से, हर प्रॉडक्ट कैटगरी के लिए कितना रेवेन्यू जनरेट हुआ?

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

इसके लिए, आपको डेटा इकट्ठा करने से पहले यह सोचना होगा कि आपको किन सवालों के जवाब देने हैं.

डाइमेंशन, कुंजियां, और वैल्यू

इन सवालों के जवाब के लिए, चलिए डाइमेंशन, कुंजियों, और वैल्यू पर एक नज़र डालते हैं.

आयाम

यहां बताए गए तरीके से यह समझने के लिए कि आपके कैंपेन रेवेन्यू कैसे जनरेट कर रहे हैं, आपको इन डाइमेंशन को ट्रैक करना होगा:

• विज्ञापन कैंपेन आईडी: किसी कैंपेन के लिए आइडेंटिफ़ायर.
• भूगोल आईडी: वह भौगोलिक क्षेत्र जहां विज्ञापन दिखाया गया था.
• प्रॉडक्ट कैटगरी: प्रॉडक्ट का वह टाइप, जो आपने बताया है.

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

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

एग्रीगेशन कुंजियां (बकेट) क्या होती हैं?

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

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

उदाहरण के लिए, मान लें कि आपको प्रॉडक्ट कैटगरी, देश या इलाके का आईडी, और कैंपेन आईडी डाइमेंशन ट्रैक करने हैं.

जब कोई उपयोगकर्ता, भौगोलिक क्षेत्र के आईडी 7 में कैंपेन आईडी 12 का विज्ञापन देखता है और बाद में प्रॉडक्ट कैटगरी 25 में कोई प्रॉडक्ट खरीदकर ग्राहक में बदलता है, तो आपके पास एग्रीगेशन की ऐसी कुंजी सेट करने का विकल्प होता है जो इस इमेज में दिखने वाली कुंजी जैसी दिखती है:

आप बाद में देखेंगे कि एग्रीगेशन कुंजी बिलकुल वैसी नहीं दिखती जैसी असल में दिखती है, लेकिन अभी के लिए आइए कुंजी में शामिल जानकारी पर फ़ोकस करते हैं.

एग्रीगेट की जा सकने वाली वैल्यू क्या होती हैं?

हमने जिन डाइमेंशन के बारे में बताया है उनके बारे में आपको यह जानना होगा:

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

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

जब 'जियोग्राफ़ी आईडी 7' में मौजूद कोई उपयोगकर्ता, कैंपेन आईडी 12 का विज्ञापन देखता है और बाद में 120 डॉलर में प्रॉडक्ट कैटगरी 25 का प्रॉडक्ट खरीदकर (यह मानते हुए कि आपकी मुद्रा डॉलर है), तो एग्रीगेशन कुंजी और इकट्ठा की जा सकने वाली वैल्यू को इस तरह सेट किया जा सकता है:

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

आपके मेज़रमेंट लक्ष्यों के लिए एग्रीगेट की गई इनसाइट जनरेट करने के लिए, इकट्ठा की जा सकने वाली वैल्यू को जोड़ा जाता है.

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

रिपोर्ट में की और वैल्यू

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

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

जब कोई उपयोगकर्ता किसी विज्ञापन पर क्लिक करता है या उसे देखने के बाद ग्राहक में बदलता है, तो आपको ब्राउज़र को एक {aggregation key, aggregatable value} जोड़ी स्टोर करने का निर्देश देना होता है.

हमारे उदाहरण में, जब कोई उपयोगकर्ता किसी विज्ञापन पर क्लिक करता है या उसे देखता है और बाद में ग्राहक में बदल जाता है, तो आप ब्राउज़र को दो योगदान (हर मेज़रमेंट लक्ष्य के लिए एक) जनरेट करने का निर्देश देते हैं.

बाद में आपको दिखेगा कि {agregation key, aggregatable value} एग्रीगेट की जा सकने वाली रिपोर्ट बिलकुल ऐसी नहीं दिखती—लेकिन अभी के लिए, आइए रिपोर्ट में शामिल जानकारी पर फ़ोकस करते हैं.

जब ब्राउज़र को दो योगदान जनरेट करने का निर्देश दिया जाता है, तो ब्राउज़र एक एग्रीगेट की जा सकने वाली रिपोर्ट जनरेट करता है. ऐसा तब होता है, जब कन्वर्ज़न पिछले व्यू या क्लिक से मैच हो सकता हो.

एग्रीगेट की जा सकने वाली रिपोर्ट में ये चीज़ें शामिल होती हैं:

• आपने जो योगदान कॉन्फ़िगर किए हैं.
• क्लिक या व्यू इवेंट और कन्वर्ज़न इवेंट के बारे में मेटाडेटा: वह साइट जहां कन्वर्ज़न हुआ वगैरह. सभी फ़ील्ड एक ही रिपोर्ट में देखें.

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

पेलोड में योगदान की सूची होती है. हर योगदान, {aggregation key, aggregatable value} पेयर होता है:

• bucket: एग्रीगेशन कुंजी, जिसे बाइट स्ट्रिंग के तौर पर एन्कोड किया गया है.
• value: उस मेज़रमेंट लक्ष्य के लिए एग्रीगेट करने लायक वैल्यू, जिसे बाइटस्ट्रिंग के तौर पर एन्कोड किया जाता है.

यहां एक उदाहरण दिया गया है:

{
  "data": [
    {
      "bucket": "111001001",
      "value": "11111010000",
    }
  ],
  "operation": "histogram"
}

आम तौर पर, एग्रीगेट की जा सकने वाली रिपोर्ट को इस तरह से कोड में बदला जाता है कि बकेट और वैल्यू, पिछले उदाहरण से अलग दिखें. इसका मतलब है कि बकेट \u0000\u0000\x80\u0000 जैसी दिख सकती है. बकेट और वैल्यू, दोनों बाइट स्ट्रिंग हैं.

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

एग्रीगेट की जा सकने वाली रिपोर्ट, कई ब्राउज़र और डिवाइसों (उपयोगकर्ताओं) के लिए इस तरह एग्रीगेट की जाती हैं:

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

इसका नतीजा, खास जानकारी वाली रिपोर्ट होती है. इसमें {aggregation key, summary value} पेयर का एक सेट होता है.

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

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

उदाहरण:

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

आम तौर पर, खास जानकारी वाली रिपोर्ट को इस तरह से कोड में बदला जाता है कि बकेट और वैल्यू, उदाहरण में बताई गई वैल्यू से अलग दिखें. इसका मतलब है कि बकेट \u0000\u0000\x80\u0000 जैसी दिख सकती है. बकेट और वैल्यू, दोनों बाइट स्ट्रिंग हैं.

एग्रीगेशन कुंजियां इस्तेमाल की जा रही हैं

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

मुख्य स्ट्रक्चर

हम कुंजी के तौर पर एन्कोड किए गए डाइमेंशन के सेट को तय करने के लिए, मुख्य स्ट्रक्चर शब्द का इस्तेमाल करेंगे.

उदाहरण के लिए, कैंपेन आईडी × GeoID × प्रॉडक्ट कैटगरी एक मुख्य स्ट्रक्चर है.

कुंजी के टाइप

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

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

हमारे पिछले उदाहरण का इस्तेमाल करके, इस मेज़रमेंट लक्ष्य टाइप की दो अलग-अलग वैल्यू होंगी:

• खरीदारी की संख्या, मेज़रमेंट के पहले तरह के लक्ष्य को दिखाती है.
• परचेज़ वैल्यू, मेज़रमेंट लक्ष्य का दूसरा टाइप है.

अगर आपके पास n मेज़रमेंट लक्ष्य थे, तो मेज़रमेंट लक्ष्य टाइप में अलग-अलग तरह की वैल्यू n होगी.

कुंजी के डाइमेंशन को मेट्रिक माना जा सकता है. उदाहरण के लिए, "हर देश/इलाके में हर कैंपेन पर किसी खास प्रॉडक्ट की खरीदारी की संख्या".

कुंजी का साइज़, डाइमेंशन का साइज़

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

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

जैसा कि पहले बताया गया है, डाइमेंशन को एग्रीगेशन पासकोड में कोड में बदला जाता है. हर डाइमेंशन में एलिमेंट की एक तय संख्या होती है. इसका मतलब है कि डाइमेंशन में अलग-अलग वैल्यू की संख्या तय होती है. एलिमेंट की संख्या के आधार पर, हर डाइमेंशन को कुछ बिट में दिखाया जाना चाहिए. n बिट की मदद से, 2ⁿ अलग-अलग विकल्प दिखाए जा सकते हैं.

उदाहरण के लिए, देश डाइमेंशन में एलिमेंट की संख्या 200 हो सकती है, क्योंकि दुनिया में करीब 200 देश हैं. इस डाइमेंशन को कितने बिट की ज़रूरत है?

7 बिट सिर्फ़ 2⁷ = 128 अलग-अलग विकल्प सेव करेंगे, जो ज़रूरी 200 से कम है.

आठ बिट में 2⁸ = 256 अलग-अलग विकल्प सेव किए जा सकते हैं. यह संख्या, ज़रूरी 200 से ज़्यादा है. इसलिए, इस डाइमेंशन को एन्कोड करने के लिए, n=8 बिट का इस्तेमाल किया जा सकता है.

कुंजी एन्कोडिंग

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

पूरी चाबी के लिए दो हिस्से सेट करना

मान लें कि आपने इन डाइमेंशन को ट्रैक करने के लिए किसी कुंजी का इस्तेमाल किया है:

• कैंपेन आईडी
• देश/इलाके का आईडी
• प्रॉडक्ट कैटगरी

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

इसका मतलब है कि आपको दो चरणों में पासकोड सेट करना होगा:

1. आपको क्लिक या देखे जाने के समय पर कुंजी का एक हिस्सा—कैंपेन आईडी × भौगोलिक आईडी—सेट करना होगा.
2. कन्वर्ज़न के समय, आपको प्रॉडक्ट कैटगरी के तौर पर, कुंजी का दूसरा हिस्सा सेट करना होगा.

चाबियों के इन अलग-अलग हिस्सों को की टुकड़े कहा जाता है.

किसी पासकोड का हिसाब लगाने के लिए, उसके पासकोड के हिस्सों को OR (v) के तौर पर जोड़ा जाता है.

उदाहरण:

• सोर्स-साइड का पासकोड = 0x159
• ट्रिगर-साइड कुंजी का टुकड़ा = 0x400
• कुंजी = 0x159 v 0x400 = 0x559

मुख्य हिस्सों को अलाइन करना

ध्यान से रखे गए 64-बिट फ़िलर/ऑफ़सेट (सोलह शून्य) का इस्तेमाल करके, दो 64-बिट कुंजी के हिस्सों को 128 बिट तक बढ़ाया जा सकता है. OR-ing मुख्य टुकड़ों को जोड़ने के बराबर होता है, जिससे रीज़निंग और पुष्टि करना आसान होता है:

• सोर्स-साइड कुंजी का टुकड़ा = 0xa7e297e7c8c8d0540000000000000000
• ट्रिगर-साइड कुंजी का टुकड़ा = 0x0000000000000000674fbe308a597271
• कुंजी = 0xa7e297e7c8c8d0540000000000000000 v 0x0000000000000000674fbe308a597271 = 0xa7e297e7c8c8d054674fbe308a597271

हर विज्ञापन पर क्लिक या व्यू के लिए कई कुंजियां

व्यावहारिक तौर पर, हर एट्रिब्यूशन सोर्स इवेंट (विज्ञापन पर क्लिक या व्यू) के लिए एक से ज़्यादा कुंजियां सेट की जा सकती हैं. उदाहरण के लिए, इन्हें सेट किया जा सकता है:

• भूगोल आईडी × कैंपेन आईडी को ट्रैक करने वाली कुंजी.
• क्रिएटिव टाइप × कैंपेन आईडी को ट्रैक करने वाली एक और कुंजी.

एक और उदाहरण के लिए रणनीति B देखें.

डाइमेंशन को कुंजियों में एन्कोड करना

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

खास जानकारी वाली रिपोर्ट में रॉ {key, Summary value} पेयर होता है और कुंजी के बारे में कोई अतिरिक्त जानकारी नहीं होती है. इसका मतलब कुछ इस तरह है:

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

मुख्य संरचना मैप का इस्तेमाल करके डाइमेंशन को कोड में बदलना

डाइमेंशन को कुंजियों में कोड में बदलने के लिए, विज्ञापन दिखाने के समय से पहले, अपनी कुंजियों को तय करके, कुंजी के स्ट्रक्चर का मैप पहले से बनाया और मैनेज किया जा सकता है.

कीवर्ड स्ट्रक्चर का मैप, आपके हर डाइमेंशन और कीवर्ड में उनकी पोज़िशन दिखाता है.

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

यहां एक उदाहरण दिया गया है:

मान लें कि आपको खास कैंपेन, भौगोलिक क्षेत्रों, और प्रॉडक्ट के लिए, परचेज़ और परचेज़ वैल्यू, दोनों को ट्रैक करना है.

प्रॉडक्ट कैटगरी, देश/इलाके का आईडी, और कैंपेन आईडी, आपकी कुंजियों में डाइमेंशन के तौर पर होने चाहिए. इसके अलावा, आपको दो अलग-अलग मेज़रमेंट लक्ष्यों को ट्रैक करना है—खरीदारी की संख्या और खरीदारी की वैल्यू. इसलिए, आपको अपनी कुंजी में एक डाइमेंशन जोड़ना होगा, जो कुंजी के टाइप को ट्रैक करता है. इससे आपको यह तय करने में मदद मिलेगी कि खास जानकारी वाली रिपोर्ट में {key, aggregatable value} पेयर मिलने पर, एग्रीगेट की जा सकने वाली वैल्यू असल में क्या दिखाती है.

इन मेज़रमेंट लक्ष्यों के साथ, आपकी कुंजी में ये डाइमेंशन होते हैं:

• प्रॉडक्ट कैटगरी
• मेज़रमेंट के लक्ष्य का टाइप
• देश या इलाका आईडी
• कैंपेन आईडी

अब, हर डाइमेंशन को देखते हुए, मान लेते हैं कि आपके इस्तेमाल के उदाहरण के लिए आपको नीचे दी गई जानकारी ट्रैक करनी होगी:

• 29 अलग-अलग प्रॉडक्ट कैटगरी.
• आठ अलग-अलग भौगोलिक क्षेत्र: उत्तरी अमेरिका, मध्य अमेरिका, दक्षिण अमेरिका, यूरोप, अफ़्रीका, एशिया, कैरेबियन, और ओशिएनिया.
• 16 अलग-अलग कैंपेन.

यहां बताया गया है कि आपको अपनी कुंजी में हर डाइमेंशन को कितने बिट में एन्कोड करना होगा:

• प्रॉडक्ट कैटगरी: 5 बिट (2⁵ = 32 > 29).
• मेज़रमेंट का लक्ष्य टाइप: 1 बिट. मेज़रमेंट का लक्ष्य, खरीदारी की संख्या या परचेज़ वैल्यू है. इसका मतलब है कि दो अलग-अलग संभावनाएं हैं. इसलिए, इसे स्टोर करने के लिए एक बिट काफ़ी होता है.

• देश या इलाके का आईडी: तीन बिट (2³ = 8). आपको भौगोलिक आईडी के लिए डाइमेंशन मैप भी तय करना होगा, ताकि यह पता चल सके कि हर बाइनरी वैल्यू किस भौगोलिक क्षेत्र को दिखाती है. आपके भौगोलिक आईडी डाइमेंशन का डाइमेंशन मैप कुछ ऐसा दिख सकता है:

  पासकोड में बाइनरी वैल्यू	भूगोल
  000	उत्तरी अमेरिका
  001	मध्य अमेरिका
  010	दक्षिण अमेरिका
  011	यूरोप
  100	अफ़्रीका
  101	एशिया
  110	कैरिबियन
  111	ओशीनिया

• कैंपेन आईडी: 4 बिट (2⁴ = 16)

इस स्ट्रक्चर के बाद वाली कुंजियां 13 बिट (5 + 1 + 3 + 4) होंगी.

इस उदाहरण के लिए, इन कुंजियों के लिए की स्ट्रक्चर मैप ऐसा दिखेगा:

आपके पास यह तय करने का विकल्प होता है कि मुख्य डाइमेंशन किस क्रम में दिखें.

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

हर डाइमेंशन में, सबसे अहम बिट—जिसमें सबसे ज़्यादा न्यूमेरिक वैल्यू होती है—यानी सबसे बाईं ओर मौजूद बिट. सबसे कम महत्वपूर्ण बिट—जिसका सबसे छोटा संख्यात्मक मान होता है—सबसे दाईं ओर का बिट होता है.

चलिए देखते हैं कि किसी कुंजी को डिकोड करने के लिए आप की स्ट्रक्चर मैप का इस्तेमाल कैसे करेंगे.

मान लीजिए कि 0b1100100111100 को एक आर्बिट्रेरी उदाहरण कुंजी के रूप में लेते हैं और मान लेते हैं कि आपके पास यह जानने का कोई तरीका है कि यह कुंजी पिछले उदाहरण में मुख्य स्ट्रक्चर मैप का पालन करती है.

पासकोड के स्ट्रक्चर मैप के मुताबिक, इस पासकोड को इस तरह डिकोड किया जाएगा:

`11001 0 011 1100`

इसलिए, यूरोप में लॉन्च किए गए कैंपेन आईडी 12 के लिए, प्रॉडक्ट कैटगरी 25 की खरीदारी की संख्या को 0b1100100111100 से दिखाया जाता है.

हैश फ़ंक्शन का इस्तेमाल करके डाइमेंशन को कोड में बदलना

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

यह इस तरह से काम करता है:

1. कोई हैशिंग एल्गोरिदम चुनें.
2. विज्ञापन दिखाने के समय, एक स्ट्रिंग जनरेट करें. इसमें वे सभी डाइमेंशन और उनकी वैल्यू शामिल करें जिन्हें आपको ट्रैक करना है. सोर्स-साइड का पासकोड जनरेट करने के लिए, इस स्ट्रिंग को हैश करें. साथ ही, ट्रिगर-साइड के पासकोड के साथ अलाइन करने के लिए, 64-बिट का शून्य वाला सफ़िक्स जोड़ें. इससे OR को आसानी से समझा जा सकता है.
   • सोर्स-साइड की कुंजी का हिस्सा
     = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
   • ध्यान दें कि COUNT, मुख्य स्ट्रक्चर मैप वाले तरीके में उसी चीज़ को measurementGoalType=0 के तौर पर कोड में बदलता है. COUNT ज़्यादा बेहतर और साफ़ है.
3. कन्वर्ज़न के समय, एक स्ट्रिंग जनरेट करें. इसमें वे सभी डाइमेंशन और उनकी वैल्यू शामिल करें जिन्हें आपको ट्रैक करना है. ट्रिगर-साइड की का एक हिस्सा जनरेट करने के लिए, इस स्ट्रिंग को हैश करें और शून्य का 64-बिट प्रीफ़िक्स जोड़ें:
   • ट्रिगर साइड का बटन = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
4. कुंजी जनरेट करने के लिए, ब्राउज़र इन कुंजी के हिस्सों को OR करता है.
   • 128-बिट एग्रीगेशन पासकोड
     = <64-bit hex source-side key piece hash><64-bit hex source-side key piece hash>
5. बाद में, जब आप इस पासकोड की खास जानकारी वाली रिपोर्ट का अनुरोध करने के लिए तैयार हों, तो उसे तुरंत जनरेट करें:
   • अपनी दिलचस्पी वाले डाइमेंशन के आधार पर, सोर्स-साइड और ट्रिगर-साइड कुंजी जनरेट करें, जैसा कि आपने पहले किया था.
     • सोर्स-साइड कुंजी का टुकड़ा
       = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
     • ट्रिगर-साइड कुंजी का टुकड़ा
       = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
     • ट्रिगर साइड का पासकोड = toHex(hash("productCategory=25"))
   • ब्राउज़र की तरह ही या इन मुख्य हिस्सों से, वही कुंजी जनरेट की जा सकती है जिसे ब्राउज़र ने पहले जनरेट किया था.
     • 128-बिट एग्रीगेशन कुंजी
       = <64-bit source-side key piece hash><64-bit source-side key piece hash>

अगर हैश पर आधारित इस तरीके का इस्तेमाल किया जा रहा है, तो ये कुछ सलाह दी गई हैं:

• हमेशा डाइमेंशन के क्रम में बदलाव न करें. इससे यह पक्का होता है कि आपके हैश को भरोसेमंद तरीके से फिर से जनरेट किया जा सकता है. ("COUNT, CampaignID=12, GeoID=7", "COUNT, GeoID=7, CampaignID=12" जैसा हैश जनरेट नहीं करेगा). ऐसा करने का एक आसान तरीका यह है कि डाइमेंशन को अक्षरों और अंकों के हिसाब से क्रम में लगाया जाए. हम उदाहरण में यही करेंगे. हालांकि, डाइमेंशन में COUNT या VALUE को हमेशा पहला आइटम माना जाएगा. इसे आसानी से पढ़ा जा सकता है, क्योंकि COUNT या VALUE ऐसी जानकारी को कोड में बदलते हैं जो अन्य सभी डाइमेंशन की तुलना में सैद्धांतिक तौर पर थोड़ी अलग होती है.
• कुंजियों में इस्तेमाल किए जा रहे डाइमेंशन के सेट पर नज़र रखें. आपको ऐसे डाइमेंशन के सेट के आधार पर कुंजियां जनरेट करने से बचना है जिनका आपने कभी इस्तेमाल नहीं किया है.
• सही हैश फ़ंक्शन का इस्तेमाल करने पर, हैश कॉलिज़न की संभावना कम होती है. हालांकि, पहले इस्तेमाल किए गए हैश की जांच करके (जिन्हें एग्रीगेशन सेवा के नतीजों का विश्लेषण करने के लिए सेव किया जाना चाहिए), पुरानी कुंजियों से मेल खाने वाली नई कुंजियों को शामिल करने से बचा जा सकता है.

हर क्लिक या व्यू के लिए एक कन्वर्ज़न के उदाहरण में, हैश-आधारित कुंजियों को इस्तेमाल करने का तरीका देखें.

इकट्ठा की जा सकने वाली वैल्यू

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

उपयोगकर्ता की निजता को सुरक्षित रखने के लिए, हर उपयोगकर्ता के योगदान की सीमा तय की गई है. किसी एक सोर्स (विज्ञापन पर क्लिक या व्यू) से जुड़ी सभी इकट्ठा की जा सकने वाली वैल्यू में, योगदान की एक तय सीमा से ज़्यादा वैल्यू नहीं हो सकती.

हम इस सीमा को CONTRIBUTION_BUDGET कहेंगे. एक्सप्लेनर में, इस सीमा को L1 बजट कहा जाता है. हालांकि, यह CONTRIBUTION_BUDGET जैसा ही है.

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

उदाहरण: प्रति क्लिक या व्यू एक कन्वर्ज़न

उदाहरण के लिए, मान लें कि आपको इन सवालों के जवाब चाहिए:

• हर क्षेत्र में कौनसी प्रॉडक्ट कैटगरी सबसे ज़्यादा अहम हैं?
• हर इलाके में कैंपेन की कौनसी रणनीतियां सबसे असरदार हैं?

यह भी मान लें कि आपके इस्तेमाल के उदाहरण के लिए, आपको हर हफ़्ते की अहम जानकारी की ज़रूरत होगी.

आपको इन्हें भी ट्रैक करना होगा:

• 16 अलग-अलग कैंपेन.
• आठ अलग-अलग भौगोलिक क्षेत्र: उत्तरी अमेरिका, मध्य अमेरिका, दक्षिण अमेरिका, यूरोप, अफ़्रीका, एशिया, कैरेबियन, और ओशिनिया.
• 29 अलग-अलग प्रॉडक्ट कैटगरी.

किसका आकलन करें

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

इस उदाहरण में, हम उन कैंपेन सेटअप पर फ़ोकस करेंगे जिनमें हर क्लिक या व्यू के लिए सिर्फ़ एक कन्वर्ज़न मेज़र किया जाता है: खरीदारी.

इसके बावजूद, आपके पास खरीदारी की संख्या और खरीदारी की वैल्यू, दोनों को मेज़र करने का विकल्प होगा. साथ ही, कुल खरीदारी की वैल्यू और भौगोलिक ब्रेकडाउन जैसे कई अहम आंकड़ों को ऐक्सेस किया जा सकेगा. इससे, ग़ैर-ज़रूरी डेटा की संख्या कम रहती है. साथ ही, यह भी पक्का होता है कि आपके योगदान के बजट को आसानी से बढ़ाया जा सके.

मुद्राओं के बारे में क्या?

अलग-अलग इलाकों में कैंपेन चलाने का मतलब है कि मुद्राओं को ध्यान में रखा जाना चाहिए. इसके लिए, ये काम किए जा सकते हैं:

• एग्रीगेशन कुंजियों में मुद्रा को एक खास डाइमेंशन बनाएं.
• इसके अलावा, कैंपेन आईडी से मुद्रा का अनुमान लगाया जा सकता है और सभी मुद्राओं को रेफ़रंस मुद्रा में बदला जा सकता है.

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

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

लक्ष्यों को कुंजियों में बदलना

मेज़रमेंट के लक्ष्यों और मेट्रिक के साथ, आपके पास अपनी मुख्य रणनीति के लिए कई विकल्प होते हैं. आइए, इनमें से दो रणनीतियों पर फ़ोकस करते हैं:

• रणनीति A: एक बारीक मुख्य स्ट्रक्चर.
• रणनीति B: दो अनुमानित मुख्य स्ट्रक्चर.

रणनीति A: एक गहरा पेड़ (एक विस्तृत कुंजी संरचना)

रणनीति A में, एक विस्तृत कुंजी स्ट्रक्चर का इस्तेमाल किया जाता है, जिसमें आपकी ज़रूरत के सभी डाइमेंशन शामिल होते हैं:

आपकी सभी कुंजियां इस स्ट्रक्चर का इस्तेमाल करती हैं.

आपने मेज़रमेंट के दो लक्ष्यों को पूरा करने के लिए, इस पासकोड स्ट्रक्चर को दो तरह से बांटा है.

• कुंजी टाइप 0: मेज़रमेंट के लक्ष्य का टाइप = 0, जिसे खरीदारी की संख्या के तौर पर तय किया जाता है.
• पहला बटन टाइप: मेज़रमेंट लक्ष्य का टाइप = 1, जिसे खरीदारी की वैल्यू के तौर पर तय किया जाता है.

खास जानकारी वाली रिपोर्ट इस तरह दिखती हैं:

रणनीति A को "एक डीप ट्री" रणनीति के तौर पर देखा जा सकता है:

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

रणनीति A के साथ, आपको अपने सवालों के जवाब इस तरह देने होंगे:

रणनीति A की मदद से, सीधे तौर पर इस तीसरे सवाल का जवाब भी दिया जा सकता है:

"हर भौगोलिक क्षेत्र में, मेरे हर कैंपेन से हर प्रॉडक्ट से कितनी आय हुई?"

खास जानकारी वाली वैल्यू में गड़बड़ियां हो सकती हैं. हालांकि, यह पता लगाया जा सकता है कि हर कैंपेन के बीच मेज़र की गई वैल्यू में अंतर, सिर्फ़ गड़बड़ी की वजह से नहीं है. शोर को समझना लेख में, ऐसा करने का तरीका जानें.

रणनीति B: दो छोटे ट्री (दो मुख्य स्ट्रक्चर)

रणनीति B में, दो बड़े की-स्ट्रक्चर का इस्तेमाल किया जाता है. इनमें से हर स्ट्रक्चर में, ज़रूरी डाइमेंशन का सबसेट शामिल होता है:

मेज़रमेंट के दो लक्ष्यों को पूरा करने के लिए, इनमें से हर मुख्य स्ट्रक्चर को दो मुख्य टाइप में बांटा जाता है.

• मेज़रमेंट का लक्ष्य टाइप = 0 है, जिसे खरीदारी की संख्या के तौर पर तय किया जाता है.
• मेज़रमेंट लक्ष्य का टाइप = 1, जिसे परचेज़ वैल्यू के तौर पर तय किया जाता है.

आपको चार तरह की मुख्य कुंजियां मिलती हैं:

• कुंजी का टाइप I-0: कुंजी का स्ट्रक्चर I, खरीदारी की संख्या.
• की-टाइप I-1: की स्ट्रक्चर I, खरीदारी की वैल्यू.
• कुंजी प्रकार II-0: कुंजी संरचना II, खरीदारी की संख्या.
• कुंजी का टाइप II-1: कुंजी का स्ट्रक्चर II, खरीदारी की वैल्यू.

खास जानकारी वाली रिपोर्ट इस तरह दिखती हैं:

रणनीति B को "दो उथले पेड़" की रणनीति माना जा सकता है:

• समरी रिपोर्ट में मौजूद खास जानकारी वाली वैल्यू, डाइमेंशन के दो छोटे सेट में से किसी एक पर मैप होती हैं.
• इन सेट में मौजूद हर डाइमेंशन के साथ खास जानकारी वाली इन वैल्यू को रोल अप किया जा सकता है. इसका मतलब है कि ये रोलअप विकल्प A के मुकाबले उतने डीप नहीं हैं, क्योंकि रोल अप करने के लिए कम डाइमेंशन होते हैं.

रणनीति B के तहत, आपको अपने सवालों के जवाब इस तरह मिलेंगे:

फ़ैसला: रणनीति A

रणनीति A आसान है; सभी डेटा एक ही कुंजी स्ट्रक्चर का पालन करता है, जिसका यह भी मतलब है कि आपके पास सिर्फ़ एक मुख्य स्ट्रक्चर है.

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

रणनीति B के मामले में ऐसा नहीं है. यहां खास जानकारी वाली रिपोर्ट में मौजूद खास जानकारी की वैल्यू से, आपको पहले से ही ज़रूरी जानकारी मिल जाती है. इसका मतलब है कि रणनीति B पर, रणनीति A की तुलना में ग़ैर-ज़रूरी डेटा का कम असर पड़ेगा.

आपको यह कैसे तय करना चाहिए कि किस रणनीति का इस्तेमाल करना है? विज्ञापन देने वाले मौजूदा लोगों या कंपनियों या कैंपेन के लिए, पुराने डेटा का इस्तेमाल करके यह तय किया जा सकता है कि कन्वर्ज़न का वॉल्यूम, रणनीति A के लिए ज़्यादा सही है या रणनीति B के लिए. हालांकि, विज्ञापन देने वाले नए लोगों या कंपनियों या कैंपेन के लिए, ये काम किए जा सकते हैं:

• ज़्यादा जानकारी वाली कुंजियों (रणनीति A) की मदद से, एक महीने का डेटा इकट्ठा करें. डेटा इकट्ठा करने की अवधि बढ़ाने पर, खास जानकारी की वैल्यू ज़्यादा होंगी और ग़ैर-ज़रूरी डेटा कम होगा.
• हर हफ़्ते के कन्वर्ज़न की संख्या और खरीदारी की वैल्यू का सटीक आकलन करें.

इस उदाहरण में, मान लें कि हर हफ़्ते की गई खरीदारी की संख्या और परचेज़ वैल्यू काफ़ी ज़्यादा है. इस वजह से, रणनीति A के आधार पर गै़र-ज़रूरी डेटा का प्रतिशत, आपके इस्तेमाल के उदाहरण के हिसाब से सही है.

रणनीति A आसान है और इससे होने वाले नॉइज़ का असर, फ़ैसले लेने की आपकी क्षमता पर नहीं पड़ता. इसलिए, आपने रणनीति A को अपनाने का फ़ैसला लिया.

हैश करने का कोई एल्गोरिदम चुनना

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

मान लें कि आपने SHA-256 को चुना है. आसान और कम सुरक्षित एल्गोरिदम, जैसे कि MD5 का भी इस्तेमाल किया जा सकता है.

ब्राउज़र में: कुंजियां और मान सेट करें

अब आपने पासकोड के स्ट्रक्चर और हैश एल्गोरिदम का फ़ैसला कर लिया है. अब आपके पास, उपयोगकर्ताओं के विज्ञापनों पर क्लिक करने या उन्हें देखने और बाद में ग्राहक में बदलने पर, पासकोड और वैल्यू रजिस्टर करने का विकल्प है.

आगे उन हेडर की खास जानकारी दी गई है जिन्हें ब्राउज़र में कुंजियों और वैल्यू को रजिस्टर करने के लिए सेट किया जाएगा:

सोर्स-साइड के मुख्य हिस्से सेट करना

जब कोई उपयोगकर्ता किसी विज्ञापन पर क्लिक करता है या उसे देखता है, तो Attribution-Reporting-Register-Aggregatable-Source हेडर में एग्रीगेशन बटन सेट करें. इस चरण में, हर पासकोड के लिए सिर्फ़ वह हिस्सा या पासकोड का हिस्सा सेट किया जा सकता है जो विज्ञापन दिखाने के समय पता होता है.

आइए, मुख्य हिस्से जनरेट करते हैं:

आइए, अब मुख्य चीज़ें सेट अप करते हैं:

// Upon receiving the request from the publisher site
res.set(
  "Attribution-Reporting-Register-Aggregatable-Source",
  JSON.stringify([
    {
      "id": "key_purchaseCount",
      "key_piece": "0x3cf867903fbb73ec0000000000000000"
    },
    {
      "id": "key_purchaseValue",
      "key_piece": "0x245265f432f16e730000000000000000"
    }
  ])
);

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

ज़रूरी नहीं: इवेंट-लेवल की रिपोर्ट

अगर आपको एग्रीगेट की जा सकने वाली रिपोर्ट के साथ इवेंट-लेवल की रिपोर्ट का इस्तेमाल करना है, तो पक्का करें कि दिए गए सोर्स के लिए, इवेंट-लेवल डेटा (सोर्स इवेंट आईडी और ट्रिगर डेटा) और एग्रीगेशन कुंजी मैच हो.

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

कोई उपयोगकर्ता ग्राहक में बदलता है

जब कोई उपयोगकर्ता ग्राहक में बदलता है, तो आम तौर पर विज्ञापन टेक्नोलॉजी के सर्वर को पिक्सल का अनुरोध भेजा जाता है. यह अनुरोध मिलने पर:

• पासकोड पूरा करने के लिए, कन्वर्ज़न-साइड (ट्रिगर-साइड) के पासकोड के हिस्से सेट करें. इन मुख्य हिस्सों को हेडर Attribution-Reporting-Register-Aggregatable-Trigger-Data के ज़रिए सेट किया जाएगा.
• हेडर Attribution-Reporting-Register-Aggregatable-Values की मदद से, उस कन्वर्ज़न के लिए एग्रीगेट की जा सकने वाली वैल्यू सेट करें.

पासकोड सेट अप करने के लिए, ट्रिगर-साइड कुंजी के हिस्से सेट करें

आइए, अहम जानकारी जनरेट करते हैं:

चलिए, अब अहम हिस्से सेट करते हैं:

// Upon receiving the pixel request from the advertiser site
res.set(
  "Attribution-Reporting-Register-Aggregatable-Trigger-Data",
  JSON.stringify([
    // Each dictionary independently adds pieces to multiple source keys
    {
      "key_piece": "0x0000000000000000f9e491fe37e55a0c",
      "source_keys": ["key_purchaseCount", "key_purchaseValue"]
    },
  ])
);

ध्यान दें कि source_keys में कई की-आईडी डालकर, एक ही की-पीस को कई की में कैसे जोड़ा जा रहा है—की-पीस, दोनों की में जोड़ दिया जाएगा.

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

एग्रीगेट की जा सकने वाली वैल्यू सेट करने से पहले, आपको उन्हें बढ़ाना होगा, ताकि ग़ैर-ज़रूरी डेटा कम हो.

मान लें कि प्रॉडक्ट टाइप 25 के लिए 52 डॉलर की एक खरीदारी की गई.

इन्हें सीधे तौर पर एग्रीगेट की जा सकने वाली वैल्यू के तौर पर सेट नहीं किया जाएगा:

• key_purchaseCount: 1 कन्वर्ज़न
• key_purchaseValue: 52 डॉलर

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

योगदान के लिए अपने बजट को खर्च करने के आपके दो लक्ष्य हैं. इसलिए, हो सकता है कि आप योगदान के लिए बजट को दो हिस्सों में बांटना चाहें.

इस मामले में, हर लक्ष्य को ज़्यादा से ज़्यादा CONTRIBUTION_BUDGET/2 (=65,536/2=32,768) असाइन किया जाता है.

मान लें कि साइट के सभी उपयोगकर्ताओं के खरीदारी इतिहास के आधार पर, किसी एक उपयोगकर्ता की ज़्यादा से ज़्यादा परचेज़ वैल्यू 1,500 डॉलर है. कुछ आउटलायर भी हो सकते हैं. उदाहरण के लिए, ऐसे बहुत कम उपयोगकर्ता हो सकते हैं जिन्होंने उस संख्या से ज़्यादा खर्च किया हो. हालांकि, इन फ़ैक्टर को अनदेखा किया जा सकता है.

परचेज़ वैल्यू के लिए स्केलिंग फ़ैक्टर यह होना चाहिए:

((CONTRIBUTION_BUDGET/2) / 1,500) = 32,768/1,500 = 21.8 ≈ 22

खरीदारी की संख्या के लिए आपका स्केलिंग फ़ैक्टर 32,768/1 = 32,768 है, क्योंकि आपने हर विज्ञापन क्लिक या व्यू (सोर्स इवेंट) के लिए ज़्यादा से ज़्यादा एक खरीदारी को ट्रैक करने का फ़ैसला लिया है.

अब ये वैल्यू सेट की जा सकती हैं:

• key_purchaseCount: 1 × 32,768 = 32,768
• key_purchaseValue: 52 × 22 = 1,144

असल में, आपको उन्हें इस तरह सेट करना होगा. इसके लिए, खास हेडर का इस्तेमाल करेंAttribution-Reporting-Register-Aggregatable-Values:

// Instruct the browser to schedule-send a report
res.set(
  "Attribution-Reporting-Register-Aggregatable-Values",
  JSON.stringify({
    "key_purchaseCount": 32768,
    "key_purchaseValue": 1144,
  })
);

ऐसी रिपोर्ट जनरेट होती है जिसे इकट्ठा किया जा सके

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

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

[
  {
    key: 0x3cf867903fbb73ecf9e491fe37e55a0c, // = source-side key piece OR conversion-side key piece for the key key_purchaseCount
    value: 32768 // the scaled value for 1 conversion, in the context of [CONTRIBUTION_BUDGET/2]
  },
  {
    key: 0x245265f432f16e73f9e491fe37e55a0c, // source-side key piece OR conversion-side key piece for the key key_purchaseValue
    value: 1144 // the scaled value for $52, in the context of [CONTRIBUTION_BUDGET/2]
  },
]

यहां, एग्रीगेट की जा सकने वाली एक रिपोर्ट में दो अलग-अलग योगदान देखे जा सकते हैं.

खास जानकारी की रिपोर्ट का अनुरोध करना

• एक साथ कई रिपोर्ट एग्रीगेट की जा सकती हैं. बैचिंग में दी गई सलाह का पालन करें.
• वे कुंजियां जनरेट करें जिनका डेटा आपको देखना है. उदाहरण के लिए, कैंपेन आईडी 12 × देश/इलाके का आईडी 7 × प्रॉडक्ट कैटगरी 25 के लिए, COUNT (खरीदारी की कुल संख्या) और VALUE (खरीदारी की कुल वैल्यू) की खास जानकारी वाला डेटा देखने के लिए:
  • सोर्स-साइड कुंजी का टुकड़ा जनरेट करें, जैसा कि आपने ब्राउज़र में इसे सेट करते हुए किया था.
  • ट्रिगर-साइड का कुंजी हिस्सा जनरेट करें, जैसा आपने ब्राउज़र में सेट करते समय किया था.

• इन कुंजियों के लिए एग्रीगेशन सेवा को सारांश डेटा का अनुरोध करें.

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

आखिरकार, आपको खास जानकारी वाली रिपोर्ट मिलती है, जो कुछ ऐसी दिख सकती है:

[
  {"bucket": "00111100111110000110011110010000001111111011101101110011111011001111100111100100100100011111111000110111111001010101101000001100",
    "value": "2558500"},
  {"bucket": "00100100010100100110010111110100001100101111000101101110011100111111100111100100100100011111111000110111111001010101101000001100",
    "value": "687060"},
  …
]

पहला बकेट बाइनरी में COUNT कुंजी है. दूसरी बकेट, बाइनरी में VALUE कुंजी है. ध्यान दें कि कुंजियां अलग-अलग (COUNT बनाम VALUE) हैं, लेकिन वे एक ही रिपोर्ट में शामिल हैं.

वैल्यू को स्केल करना

• 2,558,500 का मतलब है कि इस पासकोड के लिए खरीदारी की संख्या, पहले से तय किए गए स्केलिंग फ़ैक्टर के हिसाब से बढ़ाई गई है. खरीदारी की संख्या के लिए स्केलिंग फ़ैक्टर 32,768 था. 25,58,500 को लक्ष्य के योगदान के बजट से भाग दें: 2,558,500/32,768 = 156.15 खरीदारी.
• 6,87,060 → 6,87,060/22 = 31,230 डॉलर की कुल परचेज़ वैल्यू.

इस वजह से, खास जानकारी वाली रिपोर्ट से आपको यह अहम जानकारी मिलती है:

- Within the reporting time period, campaign #12
  run in Europe drove about 156 purchases (± noise)
  for the product category #25
  ```

  ```text
- Within the reporting time period, campaign #12
  run in Europe drove $31,230 of purchases (± noise)
  for the product category #25.