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

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

अपना सवाल पूछें.

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

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

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

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

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

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

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

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

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

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

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