[पुराना] माइग्रेशन गाइड (Chrome 92): कन्वर्ज़न मेज़रमेंट एपीआई से एट्रिब्यूशन रिपोर्टिंग एपीआई

Chrome 92 में कन्वर्ज़न मेज़रमेंट एपीआई बदल रहा है.

ध्यान दें: माइग्रेशन के दौरान अगर आपको कोई सवाल पूछना है या कोई मदद चाहिए, तो ईमेल पाने वाले लोगों की सूची में शामिल हों और अपना सवाल पूछें.

क्या बदलाव होने वाले हैं?

2021 के शुरुआती महीनों में एपीआई प्रस्ताव में हुए बदलावों के बाद, Chrome में एपीआई को लागू करने का तरीका बेहतर बनाया जा रहा है. क्या-क्या बदलाव हो रहे हैं, इस बारे में यहां बताया गया है:

• एपीआई का नाम और अनुमतियों की नीति का नाम.
• एचटीएमएल एट्रिब्यूट के नाम और .well-known यूआरएल.
• रिपोर्ट का फ़ॉर्मैट. अब रिपोर्ट को अनुरोध के मुख्य हिस्से में, JSON के तौर पर भेजा जाता है.
• इन रिपोर्ट का कॉन्टेंट: credit को हटा दिया गया है और साथ ही, ऐसी रिपोर्ट भी हटा दी गई हैं जिनमें शून्य क्रेडिट होता था.

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

ये बदलाव कब लागू होंगे?

ये बदलाव Chrome 92 से लागू होंगे. ये 20 जुलाई, 2021 से लागू होंगे. Chrome 92 का बीटा वर्शन 3 जून, 2021 को रिलीज़ किया गया था.

ऐसे में आपको क्या करना चाहिए?

ध्यान दें: आने वाले वर्शन में, इस एपीआई में और भी बदलाव होने वाले हैं. वे Chrome 92 में अपनाए गए नए नाम का इस्तेमाल करेंगे.

अगर आप ऑरिजिन ट्रायल चला रहे थे या आपने इस एपीआई के लिए डेमो दिया है, तो आपके पास दो विकल्प हैं:

• पहला विकल्प (इसका सुझाव दिया जाता है): अपना कोड अभी या आने वाले हफ़्तों में माइग्रेट करें. आम तौर पर, इसे जुलाई 2021 के मध्य से पहले माइग्रेट किया जा सकता है. इस तरह, आपका कोड बेस आने वाले समय में होने वाले बदलावों के लिए तैयार रहेगा और नए Chrome क्लाइंट के लिए काम करता रहेगा.
• दूसरा विकल्प: Chrome के आने वाले वर्शन में, ज़्यादा अपडेट और सुविधाएं रिलीज़ होने तक इंतज़ार करें और कोड में सभी ज़रूरी बदलाव एक साथ करें.

माइग्रेट करें

माइग्रेशन का उदाहरण

पुल अनुरोध (ड्राफ़्ट) में छोटे डेमो ऐप्लिकेशन के माइग्रेशन का उदाहरण देखा जा सकता है.

अनुमतियों की नीति का कोड अपडेट करें

लेगसी कोड	नया कोड
allow='conversion-measurement'	allow='attribution-reporting'

सुविधा की पहचान करने वाला कोड अपडेट करना

लेगसी कोड	नया कोड
document.featurePolicy.features() .includes('conversion-measurement')	document.featurePolicy.features() .includes('attribution-reporting')

एचटीएमएल एट्रिब्यूट अपडेट करना

लेगसी कोड	नया कोड
conversiondestination	attributiondestination
impressiondata	attributionsourceeventid
impressionexpiry	attributionexpiry
reportingorigin	attributionreportto

window.open() आर्ग्युमेंट अपडेट करें

window.open() से शुरू किए गए नेविगेशन के लिए, एट्रिब्यूशन सोर्स रजिस्टर किया जा सकता है. अगर एट्रिब्यूशन सोर्स को रजिस्टर करने के लिए, window.open() का इस्तेमाल किया जा रहा है, तो इन कॉल को अपडेट करें.

आपका नया कोड इस तरह दिखेगा (एचटीएमएल एट्रिब्यूट का नाम बदलने के बाद इसका नाम बदला गया है):

window.open(
  'https://dest.example',
  '_blank',
  'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);

अपने रजिस्ट्रेशन कॉल का यूआरएल और पैरामीटर अपडेट करना

लेगसी कोड	नया कोड
.well-known/register-conversion?conversion-data={DATA}	.well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}

रिपोर्टिंग एंडपॉइंट कोड अपडेट करना

	लेगसी कोड	नया कोड
ब्राउज़र से मिलने वाले अनुरोध	.well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100	.well-known/attribution-reporting/trigger-attribution
इनकमिंग रिपोर्ट	यूआरएल पैरामीटर के तौर पर भेजा गया.	अनुरोध के मुख्य भाग में JSON के तौर पर भेजा गया. रिपोर्ट के डेटा को अनुरोध के मुख्य हिस्से में JSON ऑब्जेक्ट के तौर पर शामिल किया जाता है. इसके लिए, यहां दी गई कुंजियों का इस्तेमाल किया जाता है: source_event_id: इसका नाम पहले impression-data था, जो एट्रिब्यूशन सोर्स पर 64-बिट इवेंट आईडी सेट किया गया था. trigger_data: पहले conversion-data के नाम से जाना जाता था, जो एट्रिब्यूशन ट्रिगर रीडायरेक्ट में 3-बिट डेटा सेट है. ⚠️ credit को हटा दिया गया है.

एट्रिब्यूशन रिपोर्टिंग: सभी संसाधन

एट्रिब्यूशन रिपोर्टिंग देखें.