इस गाइड में, Attribution Reporting API का इस्तेमाल करके, इवेंट-लेवल और खास जानकारी वाली एट्रिब्यूशन रिपोर्ट, दोनों के बारे में खास जानकारी दी गई है. साथ ही, इन्हें सेट अप करने के निर्देश दिए गए हैं.
शुरू करने के लिए, आपको इनके बारे में जानकारी मिलेगी:
Attribution Reporting API की रिपोर्ट के टाइप के बीच अंतर करना
एपीआई लागू करने और रिपोर्ट जनरेट करने के चरणों को पूरा करें
रेफ़रंस और समस्या हल करने से जुड़ी जानकारी ढूंढना
रिपोर्ट का टाइप चुनें
विज्ञापन कैंपेन की परफ़ॉर्मेंस को अलग-अलग लेवल की जानकारी और निजता के साथ मेज़र करने के लिए, Attribution Reporting API दो तरह की रिपोर्ट उपलब्ध कराता है:
इवेंट-लेवल की रिपोर्ट: ये रिपोर्ट, किसी विज्ञापन पर हुए क्लिक या व्यू (सोर्स) को उससे जुड़े कन्वर्ज़न डेटा (ट्रिगर) से लिंक करने वाला ज़्यादा जानकारी वाला डेटा उपलब्ध कराती हैं. इवेंट-लेवल की रिपोर्ट में, कन्वर्ज़न डेटा की मात्रा सीमित होती है. साथ ही, रिपोर्ट में नॉइज़ भी जुड़ जाता है. ये उन मामलों में इस्तेमाल करने के लिए सबसे सही होते हैं जहां अलग-अलग इवेंट के एट्रिब्यूशन को ध्यान में रखना ज़रूरी होता है. जैसे, कैंपेन की पहुंच का आकलन करना.
खास जानकारी वाली रिपोर्ट: इनमें एग्रीगेट किया गया उपयोगकर्ता डेटा होता है. साथ ही, इनमें कन्वर्ज़न की ज़्यादा जानकारी भी शामिल हो सकती है. हालांकि, इसमें कुछ नॉइज़ भी शामिल हो सकता है. Attribution Reporting API और Private Aggregation API, दोनों का इस्तेमाल करके इन्हें एग्रीगेट रिपोर्ट से बनाया जाता है. साथ ही, ये इवेंट-लेवल की रिपोर्ट की तुलना में ज़्यादा जानकारी वाला डेटा मॉडल उपलब्ध कराती हैं. खास जानकारी वाली रिपोर्ट, उन स्थितियों में खास तौर पर काम आती हैं जिनमें एग्रीगेट की गई अहम जानकारी की ज़रूरत होती है. जैसे, कन्वर्ज़न वैल्यू का हिसाब लगाना या उपयोगकर्ता सेगमेंट के हिसाब से कैंपेन की परफ़ॉर्मेंस का विश्लेषण करना.
लागू करने के बारे में खास जानकारी
यहां दिए गए सेक्शन में, हर तरह की रिपोर्ट जनरेट करने के लिए ज़रूरी चरणों के बारे में बताया गया है. पूरी प्रोसेस के बारे में सिलसिलेवार तरीके से जानने के लिए, Attribution Reporting API का डेमो भी देखा जा सकता है.
ज़रूरी शर्त: सोर्स और ट्रिगर रजिस्टर करने और रिपोर्ट पाने के लिए, आपकी साइटों के पास एसएसएल/TLS सर्टिफ़िकेट (एचटीटीपीएस) होने चाहिए.
इवेंट-लेवल की रिपोर्ट जनरेट करना
इवेंट-लेवल की रिपोर्ट जनरेट करने का तरीका यहां बताया गया है:
सोर्स रजिस्टर करना: इससे विज्ञापन पर हुए क्लिक या व्यू को एट्रिब्यूशन की जानकारी से जोड़ा जाता है. ज़्यादा जानकारी के लिए, एट्रिब्यूशन सोर्स रजिस्टर करना और एट्रिब्यूशन सोर्स का रजिस्ट्रेशन देखें. ध्यान दें कि क्लिक और व्यू के लिए रजिस्ट्रेशन की प्रोसेस थोड़ी अलग होती है.
ट्रिगर रजिस्टर करें: यह कन्वर्ज़न इवेंट को रिकॉर्ड करता है और उसे पहले से रजिस्टर किए गए सोर्स से लिंक करता है. निर्देशों के लिए, एट्रिब्यूशन ट्रिगर रजिस्टर करना लेख पढ़ें.
रिपोर्टिंग एंडपॉइंट सेट अप करें: इवेंट-लेवल की रिपोर्ट पाने के लिए, अपने सर्वर पर एक एंडपॉइंट बनाएं. एंडपॉइंट यूआरएल इस फ़ॉर्मैट में होना चाहिए:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution.POSTतरीके का उदाहरण देखने के लिए,adtech.jsमें उदाहरण के तौर पर दिया गया कोड देखें..well-knownके बारे में ज़्यादा जानकारी के लिए, Wikipedia पर जाएं.
इवेंट-लेवल की रिपोर्ट के बारे में ज़्यादा जानने के लिए, इवेंट-लेवल की रिपोर्ट के बारे में जानकारी देने वाला लेख पढ़ें.
खास जानकारी वाली रिपोर्ट जनरेट करना
सोर्स रजिस्टर करना: यह इवेंट-लेवल की रिपोर्ट के लिए रजिस्टर करने जैसा ही है. ज़्यादा जानकारी के लिए, एट्रिब्यूशन सोर्स रजिस्टर करना और एट्रिब्यूशन सोर्स का रजिस्ट्रेशन देखें.
ट्रिगर रजिस्टर करना: यह इवेंट-लेवल की रिपोर्ट के लिए रजिस्टर करने जैसा ही है. एट्रिब्यूशन ट्रिगर रजिस्टर करना लेख पढ़ें.
रिपोर्टिंग एंडपॉइंट सेट अप करें: एग्रीगेट रिपोर्ट पाने के लिए एक एंडपॉइंट बनाएं. यूआरएल यह होना चाहिए:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution.POSTतरीके के उदाहरण के लिए,adtech.jsदेखें. साथ ही,.well-knownकी जानकारी के लिए, Wikipedia देखें.रिपोर्ट बैच करें और भेजें: एग्रीगेट की गई रिपोर्ट को बैच करें और उन्हें प्रोसेस करने के लिए, एग्रीगेशन सेवा को भेजें. इसके बाद, एग्रीगेशन सेवा खास जानकारी वाली रिपोर्ट जनरेट करेगी. ज़्यादा जानकारी के लिए, बैचिंग की रणनीतियां देखें.
खास जानकारी वाली रिपोर्ट के बारे में ज़्यादा जानने के लिए, एग्रीगेट की जा सकने वाली रिपोर्ट के बारे में जानकारी देखें.
लागू करने के चरणों के अलावा, यहां दिए गए विषयों से आपको खास जानकारी वाली रिपोर्टिंग की रणनीति बनाने में मदद मिलेगी:
फ़िल्टर सेट अप करना (ज़रूरी नहीं)
आपको जो एट्रिब्यूशन डेटा मिलता है उसे ज़्यादा बेहतर तरीके से कंट्रोल करने के लिए, फ़िल्टर सेट अप किए जा सकते हैं.
फ़िल्टर करने की सुविधा से, डेटा का बेहतर तरीके से विश्लेषण किया जा सकता है. इससे विश्लेषण के लिए, डेटा के खास सबसेट को अलग किया जा सकता है. साथ ही, इससे नॉइज़ कम हो जाती है. इससे किसी खास विज्ञापन कैंपेन और कन्वर्ज़न इवेंट की परफ़ॉर्मेंस को ट्रैक करने में भी मदद मिलती है, ताकि ज़्यादा सटीक मेज़रमेंट किया जा सके.
फ़िल्टरिंग सेट अप करने के लिए, फ़िल्टर का इस्तेमाल करके कस्टम नियम तय करना लेख पढ़ें. साथ ही, एग्रीगेट की जा सकने वाली रिपोर्ट के बारे में ज़्यादा जानकारी के लिए, एट्रिब्यूशन ट्रिगर रजिस्ट्रेशन के ट्रिगर सेक्शन पर जाएं.
पुष्टि करें कि एपीआई चालू है
एपीआई का इस्तेमाल करने से पहले, देखें कि यह चालू है या नहीं. इसके लिए, इस कोड का इस्तेमाल करें:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
इस जांच से पता चलता है कि मौजूदा कॉन्टेक्स्ट में एपीआई को अनुमति है या नहीं. हालांकि, उपयोगकर्ता की ब्राउज़र सेटिंग या अन्य वजहों से, एपीआई का इस्तेमाल अब भी नहीं किया जा सकता. निजता से जुड़ी बातों को ध्यान में रखते हुए, एपीआई के इस्तेमाल की पुष्टि करने का कोई प्रोग्रामैटिक तरीका नहीं है.
अगले चरण
एट्रिब्यूशन रिपोर्टिंग का इस्तेमाल शुरू करने के बारे में ज़्यादा जानकारी यहां दी गई है.
लागू करना
बैकग्राउंड और कॉन्सेप्ट
- एग्रीगेशन रिपोर्टिंग के डेटा से जुड़ी शर्तें
- नॉइज़ (ग़ैर-ज़रूरी आवाज़) को समझना
- ग़ैर-ज़रूरी डेटा के साथ काम करना
डेमो और टूल
प्लानिंग
- सिस्टम के बारे में खास जानकारी
- डिज़ाइन से जुड़े फ़ैसले
- योगदान बजट
- नॉइज़ (ग़ैर-ज़रूरी आवाज़) को समझना