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