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

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, तो आरएफ़सी 3339 फ़ॉर्मैट का इस्तेमाल करें. यहां RFC 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 एन्कोडिंग का इस्तेमाल करके, एन्क्रिप्ट किए गए टेक्स्ट को कोड में बदला जा सकता है.

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