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

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

क्या बदल रहा है?

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

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

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

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

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

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

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

  • पहला विकल्प (सुझाया गया): अपने कोड को अभी या आने वाले हफ़्तों में माइग्रेट करें. बेहतर होगा कि आप इसे 15 जुलाई, 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 को हटा दिया गया है.

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

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