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

bookmark_border संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

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

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

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

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

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

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

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

आयाम

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

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

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

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

एग्रीगेशन बटन (बकेट) क्या हैं?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

आपको बाद में पता चलेगा कि एग्रीगेट की जा सकने वाली {aggregation 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 जैसी दिख सकती है. बकेट और वैल्यू, दोनों बाइट स्ट्रिंग हैं.

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

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

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

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

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

कुंजी के टाइप

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

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

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

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

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

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

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

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

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

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

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

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

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

पासकोड को कोड में बदलना

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

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

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

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

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

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

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

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

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

उदाहरण:

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

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

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

• सोर्स-साइड का पासकोड = 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"))
   • ब्राउज़र की तरह ही, OR इन कुंजियों के हिस्सों का इस्तेमाल करके वही कुंजी जनरेट करता है जो ब्राउज़र ने पहले जनरेट की थी.
     • 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: एक कन्वर्ज़न
• 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 था. 2,558,500 को लक्ष्य के योगदान के बजट से divide करें: 2,558,500/32,768 = 156.15 खरीदारी.
• 687,060 → 687,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.