उपयोगकर्ता के डेटा को फ़ॉर्मैट करना

Data Manager API की मदद से, कई तरह का उपयोगकर्ता डेटा अपलोड किया जा सकता है. हर डेटा एलिमेंट के लिए, फ़ॉर्मैटिंग, हैशिंग, और एन्कोडिंग की ज़रूरी शर्तों का पालन करें, ताकि आपका डेटा सही तरीके से मिले और प्रोसेस हो सके.

• UserData: उपयोगकर्ता से मिला डेटा, जैसे कि ईमेल पता या फ़ोन नंबर.

• IpData: आईपी डेटा, जैसे कि आईपी पता और उससे जुड़े टाइमस्टैंप.

• PairData: पब्लिशर और ऐडवर्टाइज़र के लिए उपलब्ध पहले पक्ष का डेटा इस्तेमाल करने से जुड़े समाधान (पीएआईआर) के आईडी.

• MobileData: मोबाइल डिवाइस की पहचान करने वाला डेटा.

UserData से जुड़ी ज़रूरी शर्तें

UserData ऑब्जेक्ट, UserIdentifier ऑब्जेक्ट का कलेक्शन होता है. हर UserIdentifier में, यहां दी गई टेबल में मौजूद एट्रिब्यूट में से सिर्फ़ एक एट्रिब्यूट होता है.

UserIdentifier
email_address	फ़ॉर्मैट string अंग्रेज़ी के छोटे अक्षरों में बदलें. अगर ईमेल पते में gmail.com या googlemail.com डोमेन है, तो: @ सिंबल से पहले मौजूद सभी डॉट (.) हटाएं. ईमेल पते के लोकल-पार्ट से प्लस का निशान (+) हटाएं. साथ ही, इसके बाद आने वाले सभी वर्णों को हटाएं. उदाहरण: [e-mail] → [e-mail] अगर ईमेल पते में gmail.com या googlemail.com के अलावा कोई दूसरा डोमेन है, तो डॉट या प्लस के निशान न हटाएं. उदाहरण: [e-mail] → [e-mail] वाइटस्‍पेस शुरू, आखिर, और बीच में मौजूद व्हाइटस्पेस को हटाएं. हैशिंग SHA-256 एल्गोरिदम का इस्तेमाल करके हैश करें और हैश बाइट को एन्कोड करें.
phone_number	फ़ॉर्मैट string E.164 फ़ॉर्मैट का इस्तेमाल करें. प्लस का निशान (+) और देश का कोड शामिल करें. प्लस के निशान के बाद के सभी वर्ण, अंक होने चाहिए. उदाहरण के लिए, अमेरिका के फ़ोन नंबर [phone] को [phone] के तौर पर फ़ॉर्मैट और नॉर्मलाइज़ किया जाना चाहिए. वाइटस्‍पेस शुरू और आखिर में मौजूद व्हाइटस्पेस हटाएं. हैशिंग SHA-256 एल्गोरिदम का इस्तेमाल करके हैश करें और हैश बाइट को एन्कोड करें.
address	AddressInfo ऑब्जेक्ट AddressInfo फ़ॉर्मैट के बारे में खास जानकारी देखें.

AddressInfo फ़ॉर्मैट

UserIdentifier के address एट्रिब्यूट को बनाने के लिए, फ़ॉर्मैटिंग के इन दिशा-निर्देशों का पालन करें.

AddressInfo
given_name	फ़ॉर्मैट string अंग्रेज़ी के छोटे अक्षरों में बदलें. Mrs. जैसे प्रीफ़िक्स शामिल न करें वाइटस्‍पेस शुरू और आखिर में मौजूद व्हाइटस्पेस हटाएं. हैशिंग SHA-256 एल्गोरिदम का इस्तेमाल करके हैश करें और हैश बाइट को एन्कोड करें.
family_name	फ़ॉर्मैट string अंग्रेज़ी के छोटे अक्षरों में बदलें. Jr. जैसे सफ़िक्स शामिल न करें वाइटस्‍पेस शुरू और आखिर में मौजूद व्हाइटस्पेस हटाएं. हैशिंग SHA-256 एल्गोरिदम का इस्तेमाल करके हैश करें और हैश बाइट को एन्कोड करें.
region_code	फ़ॉर्मैट string दो वर्णों वाला ISO-3166-1 alpha-2 कोड. वाइटस्‍पेस शुरू और आखिर में मौजूद व्हाइटस्पेस हटाएं. हैशिंग region_code को हैश न करें.
postal_code	फ़ॉर्मैट string अमेरिका के पिन कोड और अंतरराष्ट्रीय पिन कोड, दोनों की अनुमति है. अमेरिका के पतों के लिए, पांच अंकों का इस्तेमाल करें या पांच अंकों के बाद चार अंकों का एक्सटेंशन इस्तेमाल करें. चार अंकों वाले एक्सटेंशन का इस्तेमाल करने से, मैच रेट बेहतर हो सकता है. दूसरे सभी देशों के लिए, पिन कोड के एक्सटेंशन इस्तेमाल न करें. वाइटस्‍पेस शुरू और आखिर में मौजूद व्हाइटस्पेस हटाएं. हैशिंग postal_code को हैश न करें.
address_line	फ़ॉर्मैट string इसका इस्तेमाल सिर्फ़ Google Analytics के लिए किया जाता है. उपयोगकर्ता के पते में मौजूद सड़क और नंबर. अंग्रेज़ी के छोटे अक्षरों में बदलें. सिंबल वाले वर्ण हटाएं. वाइटस्‍पेस शुरू और आखिर में मौजूद व्हाइटस्पेस हटाएं. हैशिंग SHA-256 एल्गोरिदम का इस्तेमाल करके हैश करें और हैश बाइट को एन्कोड करें.
city	फ़ॉर्मैट string इसका इस्तेमाल सिर्फ़ Google Analytics के लिए किया जाता है. उपयोगकर्ता के पते का शहर. अंग्रेज़ी के छोटे अक्षरों में बदलें. सिंबल वाले वर्ण हटाएं. वाइटस्‍पेस शुरू और आखिर में मौजूद व्हाइटस्पेस हटाएं. हैशिंग city को हैश न करें.
administrative_area	फ़ॉर्मैट string इसका इस्तेमाल सिर्फ़ Google Analytics के लिए किया जाता है. उपयोगकर्ता के पते का प्रशासनिक क्षेत्र (राज्य या प्रांत). दो अक्षरों वाले छोटे नाम (उदाहरण के लिए, ca) या पूरे नाम (उदाहरण के लिए, california) का इस्तेमाल करें. अंग्रेज़ी के छोटे अक्षरों में बदलें. सिंबल वाले वर्ण हटाएं. वाइटस्‍पेस शुरू और आखिर में मौजूद व्हाइटस्पेस हटाएं. हैशिंग administrative_area को हैश न करें.

IpData से जुड़ी ज़रूरी शर्तें

IpData ऑब्जेक्ट में ये एट्रिब्यूट होते हैं.

IpData
ip_address	फ़ॉर्मैट string IPv4 या IPv6 पता. IPv6 पतों के लिए, केस से कोई फ़र्क़ नहीं पड़ता. इनमें बड़े या छोटे, दोनों तरह के अक्षरों का इस्तेमाल किया जा सकता है. वाइटस्‍पेस शुरू और आखिर में मौजूद व्हाइटस्पेस हटाएं. हैशिंग ip_address को हैश न करें.

PairData से जुड़ी ज़रूरी शर्तें

आईडी की सूची के साथ PairData ऑब्जेक्ट के pair_ids फ़ील्ड को भरें. सूची में मौजूद हर एलिमेंट को फ़ॉर्मैट करने के लिए, यह तरीका अपनाएं:

1. SHA-256 एल्गोरिदम का इस्तेमाल करके, क्लीनरूम से मिले व्यक्तिगत पहचान से जुड़ी जानकारी डेटा को हैश करें.

2. PAIR उपयोगकर्ता सूची के लिए, पब्लिशर पासकोड का इस्तेमाल करके, हैश बाइट को ईसी कम्यूटेटिव साइफ़र के साथ एन्क्रिप्ट करें.

3. एन्क्रिप्ट किए गए डेटा को कोड में बदलने के लिए, हेक्स या Base64 एन्कोडिंग का इस्तेमाल करें.

MobileData से जुड़ी ज़रूरी शर्तें

MobileData ऑब्जेक्ट के mobile_ids फ़ील्ड में, मोबाइल आईडी की सूची डालें. मोबाइल आईडी हैश न करें.

टाइमस्टैंप का फ़ॉर्मैट

अगर Timestamp फ़ील्ड के लिए JSON फ़ॉर्मैट का इस्तेमाल किया जा रहा है, जैसे कि Event के timestamp और last_updated_timestamp, तो RFC 3339 फ़ॉर्मैट का इस्तेमाल करें. यहां आरएफ़सी 3339 फ़ॉर्मैट और अलग-अलग टाइम ज़ोन में, 8 अगस्त, 2025 को शाम 5:18:44.291 बजे के यूटीसी समय के कुछ उदाहरण दिए गए हैं:

• यूटीसी टाइम ज़ोन: 2025-08-08T17:18:44.291Z

• ईडीटी टाइम ज़ोन, जो उस समय यूटीसी से चार घंटे पहले था: 2025-08-08T13:18:44.291-04:00

• पीडीटी टाइम ज़ोन, जो उस समय यूटीसी से सात घंटे पहले था: 2025-08-08T10:18:44.291-07:00

• टोक्यो, जापान का टाइम ज़ोन, जो यूटीसी से नौ घंटे आगे था और डेलाइट सेविंग टाइम का पालन नहीं करता: 2025-08-08T22:18:44.291+09:00

अगर प्रोटोकॉल बफ़र फ़ॉर्मैट का इस्तेमाल किया जा रहा है, तो Timestamp बनाते समय seconds और ज़रूरत पड़ने पर nanos सेट करें. यहां 8 अगस्त, 2025 को शाम 5:18:44.291 बजे के यूटीसी समय के लिए, seconds और nanos की वैल्यू दी गई हैं:

• seconds: 1754683124

• nanos: 291000000

एन्कोडिंग

एन्कोडिंग की ज़रूरी शर्तें इस बात पर निर्भर करती हैं कि उपयोगकर्ता के डेटा को एन्क्रिप्ट (सुरक्षित) किया गया है या नहीं:

• एन्क्रिप्ट (सुरक्षित) नहीं किया गया उपयोगकर्ता का डेटा: SHA-256 हैश बाइट को कोड में बदलने के लिए, हेक्साडेसिमल कोड (हेक्स) या Base64 कोड का इस्तेमाल करें.

• एन्क्रिप्ट किया गया उपयोगकर्ता डेटा: अगर आपको उपयोगकर्ता डेटा को एन्क्रिप्ट करना है, तो एन्क्रिप्ट करने से पहले रॉ हैश बाइट को Base64-कोड में बदलना होगा. एन्क्रिप्ट करने से पहले हैश के लिए, हेक्साडेसिमल एन्कोडिंग का इस्तेमाल नहीं किया जा सकता. इसके बाद, हेक्साडेसिमल या Base64 एन्कोडिंग का इस्तेमाल करके, एन्क्रिप्ट किए गए टेक्स्ट को कोड में बदला जा सकता है.

ध्यान दें: हेक्साडेसिमल एन्कोडिंग का इस्तेमाल करते समय, एन्कोडिंग आउटपुट के केस से कोई फ़र्क़ नहीं पड़ता.