session_attributes के बारे में जानकारी

ऑफ़लाइन कन्वर्ज़न इंपोर्ट (ओसीआई), GCLID का इस्तेमाल करके, इंपोर्ट से मिले ऑफ़लाइन कन्वर्ज़न को ट्रैक करता है. जिन मामलों में GCLID उपलब्ध नहीं होता उनमें ओसीआई का इस्तेमाल करने वाले उपयोगकर्ता, अन्य आइडेंटिफ़ायर का इस्तेमाल कर सकते हैं. जैसे, उपयोगकर्ता से मिला हैश किया गया डेटा, wbraid/gbraid या session_attributes.

इस पेज पर इन विषयों के बारे में बताया गया है

• session_attributes के बारे में जानकारी
• session_attributes को कैप्चर करने का तरीका
• Google Ads को डेटा भेजने का तरीका

---

session_attributes के बारे में जानकारी

session_attributes ऐसा फ़ील्ड है जो आपकी वेबसाइट के साथ उपयोगकर्ता के इंटरैक्शन के बारे में अतिरिक्त जानकारी और सिग्नल देता है. इससे कन्वर्ज़न मेज़रमेंट, रिपोर्टिंग (इसमें एक ही या अलग-अलग डिवाइस के हिसाब से रिपोर्टिंग शामिल है), और बिडिंग को ज़्यादा सटीक बनाया जा सकता है. आपके पास, base64 कोड में बदली गई session_attributes की स्ट्रिंग बनाने के लिए, यहां दी गई हमारी फ़्रंट-एंड स्क्रिप्ट को इस्तेमाल करने का विकल्प होता है. इसके बाद, इस स्ट्रिंग को अपने डेटाबेस/सीआरएम में पास करें और अपने एपीआई इंपोर्ट में Google को भेजें. अगर आपको फ़्रंट-एंड स्क्रिप्ट इस्तेमाल करने का विकल्प नहीं मिलता, तो हर की/वैल्यू पेयर को अलग-अलग भेजने के लिए, session_attributes_key_value_pairs फ़ील्ड का इस्तेमाल करें.

हमारा सुझाव है कि session_attributes फ़ील्ड के इन सभी सब-फ़ील्ड का डेटा भेजें. हालांकि, इनमें से सिर्फ़ चार सब-फ़ील्ड का डेटा भेजना ज़रूरी है:

• gad_source (ज़रूरी है): यह यूआरएल में दिखाया जाने वाला एग्रीगेट पैरामीटर है, जो विज्ञापनों से आने वाले ट्रैफ़िक के सोर्स की पहचान करता है. gad_* के यूआरएल पैरामीटर के बारे में ज़्यादा जानें.
• उदाहरण के लिए वैल्यू: "1"
  दिशा-निर्देश: ये एग्रीगेट पैरामीटर हैं, जिन्हें विज्ञापन पर क्लिक करने वाले यूआरएल में जोड़ा जाता है. उदाहरण के लिए: &gad_source=1. आपको लैंडिंग पेज यूआरएल में मौजूद वैल्यू को कैप्चर करना चाहिए.

gad_campaignid (ज़रूरी है): उस विज्ञापन कैंपेन का आईडी जिसकी वजह से विज्ञापन पर क्लिक मिला. gad_* के यूआरएल पैरामीटर के बारे में ज़्यादा जानें.

वैल्यू का उदाहरण: "1234567890"
दिशा-निर्देश: यह भी एक यूआरएल पैरामीटर है. उदाहरण के लिए: &gad_campaignid=1234567890. इसे लैंडिंग पेज यूआरएल से कैप्चर किया जाना चाहिए.

session_start_time_usec (ज़रूरी है): आपकी वेबसाइट पर उपयोगकर्ता के सेशन के शुरू होने का टाइमस्टैंप. इससे उपयोगकर्ताओं के विज़िट की अवधि को ट्रैक करने में मदद मिलती है. UNIX epoch माइक्रोसेकंड वाले टाइमस्टैंप के तौर पर एक जैसा टाइम फ़ॉर्मैट इस्तेमाल करना ज़रूरी है.

वैल्यू का उदाहरण: "1678886400000000" (यह माइक्रोसेकंड में किसी खास समय को दिखाता है)
दिशा-निर्देश: पक्का करें कि टाइम फ़ॉर्मैट एक जैसा हो (UNIX टाइमस्टैंप epoch माइक्रोसेकंड). इससे वेबसाइट पर उपयोगकर्ता की विज़िट की अवधि को ट्रैक करने में मदद मिलती है.

landing_page_user_agent (ज़रूरी है): यह एक स्ट्रिंग है, जो उपयोगकर्ता के ब्राउज़र और ऑपरेटिंग सिस्टम की पहचान करती है. इससे आपको अपने उपयोगकर्ताओं के डिवाइस की तकनीकी जानकारी मिल सकती है.

उदाहरण के लिए वैल्यू: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36"
दिशा-निर्देश: इसे लैंडिंग पेज के लिए आने वाली एचटीटीपी अनुरोध के उपयोगकर्ता-एजेंट हेडर से कैप्चर किया जाना चाहिए. सामान्य या हार्डकोड की गई वैल्यू का इस्तेमाल न करें.

landing_page_url: आपकी वेबसाइट के लैंडिंग पेज का पूरा यूआरएल. इससे उस पेज के बारे में पता चलता है जिस पर उपयोगकर्ता सबसे पहले पहुंचा था.

वैल्यू का उदाहरण: "https://www.example.com/product/deluxe-widget?gad_source=1&gad_campaignid=1234567890"
दिशा-निर्देश: सटीक और पूरा यूआरएल दें. प्लेसहोल्डर स्ट्रिंग, ऐप्लिकेशन के इंटरनल पाथ (जैसे, "/productdetailscreen") या अधूरे यूआरएल का इस्तेमाल न करें. अगर पूरा और सटीक यूआरएल उपलब्ध नहीं है, तो इस फ़ील्ड को छोड़ना बेहतर है.

landing_page_referrer: उस वेबपेज का यूआरएल जिसने उपयोगकर्ता को आपकी वेबसाइट पर रीडायरेक्ट किया. इससे, आपकी साइट पर आने वाले ट्रैफ़िक सोर्स को समझने में मदद मिलती है. रेफ़रर के बारे में ज़्यादा जानने के लिए, यह लेखपढ़ें. यह लेख, Analytics पर फ़ोकस करता है, लेकिन रेफ़रर का कॉन्सेप्ट पूरे वेब पर एक जैसा होने के बारे में बताता है.

• वैल्यू का उदाहरण: "https://www.google.com/" या"https://www.socialmedia.com/referral"
  दिशा-निर्देश: इससे पता चलता है कि उपयोगकर्ता आपकी साइट पर आने से पहले, किस पेज पर था.

डेटा क्वालिटी के लिए सबसे सही तरीके

• landing_page_url एट्रिब्यूट के लिए गलत डेटा न भेजें: landing_page_url एट्रिब्यूट की गलत या अधूरी वैल्यू से मॉडलिंग पर बुरा असर पड़ता है. अगर पूरा और सटीक यूआरएल नहीं दिया जा सकता, तो इसे शामिल न करना बेहतर है.
• डुप्लीकेट अपलोड से बचें: एक ही कन्वर्ज़न इवेंट को कई बार न भेजें. डुप्लीकेट कन्वर्ज़न हटाने के लिए, ऑर्डर आईडी जैसे यूनीक आइडेंटिफ़ायर का इस्तेमाल करें.

हमारा सुझाव है कि session_attributes फ़ील्ड के लिए स्टोरेज का साइज़ 5 केबी हो. ज़्यादातर मामलों में, इससे ज़्यादा साइज़ की ज़रूरत नहीं होती. अगर session_attributes का साइज़ 5 केबी से ज़्यादा है, तो हमारा सुझाव है कि आप फ़ील्ड के साइज़ में बदलाव करने के लिए, अपने सीआरएम सेवा देने वाली कंपनी के साथ काम करें. इसके अलावा, JavaScript के हेल्पर फ़ंक्शन से landing_page_url और landing_page_referrer पैरामीटर हटाएं.

---

session_attributes को कैप्चर करने का तरीका

session_attributes को कैप्चर और सेव करने के लिए, अपने लैंडिंग पेज पर नीचे दिए गए JavaScript के हेल्पर फ़ंक्शन और एचटीएमएल फ़ॉर्म का इस्तेमाल किया जा सकता है.

उदाहरण के तौर पर दिया गया यह कोड, डेटा को localStorage में सेव करता है. अपनी वेबसाइट पर लागू करने से पहले, कृपया यह भी पक्का करें कि आपकी वेबसाइट के लिए, सहमति और डेटा के रखरखाव से जुड़ी ज़रूरी शर्तों को पूरा किया जा रहा हो.

एचटीएमएल फ़ॉर्म

1. session_attributes के लिए छिपे हुए फ़ील्ड को जोड़ने के लिए, आपको हर फ़ॉर्म सबमिशन पेज में बदलाव करना होगा. session_attributes को आपके बैकएंड सिस्टम में इस तरह पास किया जाएगा. यह दिखाने के लिए नीचे एक सैंपल कोड दिया गया है.
   <form action="" name="myForm">
Name: <input type="text" name="name">
<input type="hidden" id="session_attributes_field" name="session_attributes_field" value="">
<input type="submit" value="Submit Form" name="btnSubmit">
</form>
2. session_attributes_encoded को कैप्चर करने और उसे फ़ॉर्म फ़ील्ड में सेट करने के लिए, सैंपल स्क्रिप्ट. उदाहरण के तौर पर दिया गया यह कोड, डेटा को localStorage में सेव करता है.

   <script>
function getSessionAttributes() {
const searchParams = new URLSearchParams(window.location.search);
if (Array.from(searchParams.keys()).some(key => key.startsWith('gad_')) ||
searchParams.has('gclid') || searchParams.has('gbraid')) {
const params = {};
searchParams.forEach((value, key) => {
if (key.startsWith('gad_')) params[key] = value;
});
params['session_start_time_usec'] =
(new Date().getTime() * 1000).toString();
params['landing_page_url'] = window.location.href;
params['landing_page_referrer'] = document.referrer;
params['landing_page_user_agent'] = navigator.userAgent;
const sessionAttributesEncoded = btoa(JSON.stringify(params))
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, '');
localStorage.setItem('google_session_attributes', sessionAttributesEncoded);
return sessionAttributesEncoded;
}
return localStorage.getItem('google_session_attributes') || '';
}

   
   function addSessionAttributes() {
const sessionAttributesEncoded = getSessionAttributes();
var sessionAttributesFormField =
document.getElementById('session_attributes_field');
if (sessionAttributesFormField && sessionAttributesEncoded != '') {
sessionAttributesFormField.value = sessionAttributesEncoded;
}
}
window.addEventListener('load', addSessionAttributes);
</script>

---

Google Ads को डेटा भेजने का तरीका

1. Google Ads API में session_attributes_encoded फ़ील्ड

Google Ads API, 2 फ़रवरी, 2026 से कन्वर्ज़न इंपोर्ट के तहत, सेशन एट्रिब्यूट या आईपी पते का इस्तेमाल करने वाले नए लोगों को इंपोर्ट की अनुमति नहीं देगा. हमारा सुझाव है कि कन्वर्ज़न और उपयोगकर्ता के डेटा को इंपोर्ट करने वाले एपीआई के तौर पर Google Ads API का इस्तेमाल करने वाले डेवलपर, Data Manager API का इस्तेमाल करें. इससे यह पक्का होता है कि उन्हें जटिल डेटा को मैनेज करने का बेहतर अनुभव मिले और वे ज़्यादा से ज़्यादा डेटा मैनेज कर सकें. Data Manager API में आईपी पता और सेशन एट्रिब्यूट, दोनों इस्तेमाल किए जाते हैं. Google Ads API में आईपी पते और सेशन एट्रिब्यूट इस्तेमाल करने की सुविधा में हुए बदलावों के बारे में ज़्यादा जानें.

JavaScript का इस्तेमाल करने वाले, ऑफ़लाइन कन्वर्ज़न इंपोर्ट (ओसीआई) के मौजूदा उपयोगकर्ता, कोड में बदले गए session_attributes के डेटा को दिए गए JavaScript का इस्तेमाल करके कैप्चर करें. इसके बाद, इस डेटा को आपके अपलोड किए गए मौजूदा स्कीमा में ClickConversion.session_attributes_encoded नाम के नए फ़ील्ड में भेजें. अपनी मौजूदा ओसीआई प्रोसेस का इस्तेमाल जारी रखें, लेकिन इंपोर्ट करते समय इस नए फ़ील्ड को सेट करें. आपके अन्य आइडेंटिफ़ायर मौजूद न होने पर Google Ads, session_attributes का इस्तेमाल करेगा.

सभी नए उपयोगकर्ताओं को Data Manager API का इस्तेमाल करना होगा. अगर किसी खाते को Google Ads API के ज़रिए आईपी पते या सेशन एट्रिब्यूट भेजने की अनुमति नहीं दी गई है, तो आपको उन कन्वर्ज़न के लिए गड़बड़ी का मैसेज मिलेगा.

ध्यान दें: Google Ads API में नए फ़ील्ड को ऐक्सेस करने के लिए, v19 या उसके बाद के वर्शन पर अपग्रेड करना ज़रूरी है.

ऐडवांस

अगर आप JavaScript का इस्तेमाल नहीं कर सकते, तो आप हर की/वैल्यू पेयर को कैप्चर कर सकते हैं और उन्हें अपने ऑफ़लाइन कन्वर्ज़न इंपोर्ट के साथ भेज सकते हैं.

JavaScript का इस्तेमाल नहीं करने वाले, ऑफ़लाइन कन्वर्ज़न इंपोर्ट (ओसीआई) के मौजूदा उपयोगकर्ताओं के लिए, आप अपने अपलोड किए गए मौजूदा स्कीमा में की/वैल्यू पेयर वाला फ़ील्ड भी सेट कर सकते हैं. यह फ़ील्ड ClickConversion.session_attributes_key_value_pairs के नाम से जाना जाता है. हमारा सुझाव है कि आप एपीआई को कॉल करते समय, इन फ़ील्ड के साथ की वैल्यू पेयर भेजें. ClickConversion में अलग-अलग की वैल्यू पेयर जोड़ने का तरीका बताने वाला डेवलपर दस्तावेज़ देखें.

यहां दिए गए सुझावों को देखें और अपने सेटअप को अपडेट करें, ताकि यह पक्का किया जा सके कि मान्य डेटा भेजा जा रहा है:

• gad_campaignid (Campaign ID): पक्का करें कि विज्ञापन पर क्लिक से जुड़ा मान्य Google Ads कैंपेन आईडी लगातार भेजा जा रहा हो. यह वह कैंपेन आईडी है जिसे विज्ञापन पर क्लिक के यूआरएल में “gad_campaignid=1234” के तौर पर दिखाया जाता है. यह एक मुख्य एट्रिब्यूट है और सटीक एट्रिब्यूशन के लिए ज़रूरी है.
• session_start_time_usec: इस एट्रिब्यूट (उपयोगकर्ता के सेशन के शुरू होने का टाइमस्टैंप) को लगातार भेजें.
• landing_page_url (URL): पक्का करें कि आपने लैंडिंग पेज का सही और पूरा यूआरएल भेजा हो. प्लेसहोल्डर स्ट्रिंग, ऐप्लिकेशन के इंटरनल पाथ या अधूरे यूआरएल न भेजें.
  • ध्यान दें: अगर सटीक और पूरा यूआरएल उपलब्ध नहीं है, तो हमारा सुझाव है कि पूरे फ़ील्ड को ही हटा दें. ऐसा इसलिए, क्योंकि गलत डेटा से मॉडलिंग पर बुरा असर पड़ सकता है.
• landing_page_user_agent (User agent): पक्का करें कि स्ट्रिंग में उपयोगकर्ता के ब्राउज़र और ऑपरेटिंग सिस्टम की जानकारी सही तरीके से दी गई हो. साथ ही, सामान्य या हार्डकोड की गई वैल्यू न भेजें.

2. डेटा मैनेजर का इस्तेमाल करके session_attributes फ़ील्ड

डेटा मैनेजर का इस्तेमाल करके, session_attributes फ़ील्ड भी भेजा जा सकता है.

• डेटा मैनेजर का यूज़र इंटरफ़ेस (यूआई): दिए गए JavaScript का इस्तेमाल करके, session_attributes फ़ील्ड बनाएं. इसके बाद, इसे डेटा मैनेजर के यूज़र इंटरफ़ेस (यूआई) के ज़रिए अपलोड करें.
• Data Manager API: प्रोग्राम के हिसाब से डेटा अपलोड करने के लिए, Data Manager API के साथ इंटिग्रेट किया जा सकता है. खास निर्देशों और स्कीमा की जानकारी के लिए, डेटा मैनेजर के बारे में दस्तावेज़ देखें.

सही डेटा भेजने पर, आप Google Ads को इस जानकारी का इस्तेमाल करके, कन्वर्ज़न को सही कैंपेन को एट्रिब्यूट करने की सुविधा देते हैं. इसकी मदद से वह आपको ज़्यादा बेहतर कन्वर्ज़न रिपोर्टिंग भी दे सकता है.