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

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

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

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

UserIdentifier
email_address
फ़ॉर्मैट
string
  • अंग्रेज़ी के छोटे अक्षरों में बदलें.
  • अगर ईमेल पते में gmail.com या googlemail.com डोमेन है, तो:
    • `@` सिंबल से पहले मौजूद सभी डॉट (.) हटाएं.
    • लोकल-पार्ट से प्लस (+) का निशान हटाएं और उसके बाद के सभी वर्ण हटाएं.
    • उदाहरण: cloudy.sanfrancisco+shopping@gmail.com → cloudysanfrancisco@gmail.com
  • अगर ईमेल पते में gmail.com या googlemail.com के अलावा कोई दूसरा डोमेन है, तो डॉट या प्लस के निशान न हटाएं.
    • उदाहरण: user.name+NYC@Example.com → user.name+nyc@example.com
वाइटस्‍पेस शुरुआत, आखिर, और बीच में मौजूद व्हाइटस्पेस हटाएं.
हैशिंग SHA-256 एल्गोरिदम का इस्तेमाल करके हैश करें. हैश बाइट को हेक्स या Base64 एन्कोडिंग का इस्तेमाल करके कोड में बदलें.
phone_number
फ़ॉर्मैट
string
E.164 फ़ॉर्मैट का इस्तेमाल करें.
प्लस (+) का निशान और देश कोड शामिल करें. प्लस के निशान के बाद के सभी वर्ण, अंक होने चाहिए.
उदाहरण के लिए, अमेरिका के फ़ोन नंबर (800)555-0100 को +18005550100 के तौर पर फ़ॉर्मैट और सामान्य किया जाना चाहिए.
वाइटस्‍पेस शुरुआत और आखिर में मौजूद व्हाइटस्पेस हटाएं.
हैशिंग SHA-256 एल्गोरिदम का इस्तेमाल करके हैश करें. हैश बाइट को हेक्स या Base64 एन्कोडिंग का इस्तेमाल करके कोड में बदलें.
address
AddressInfo ऑब्जेक्ट

AddressInfo का फ़ॉर्मैट

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

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

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

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

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

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

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

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

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

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

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

Timestamp फ़ील्ड के लिए JSON फ़ॉर्मैट का इस्तेमाल करने पर, RFC 3339 फ़ॉर्मैट का इस्तेमाल करें. जैसे, Event के timestamp और last_updated_timestamp फ़ील्ड के लिए. यहां आरएफ़सी 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

एन्कोडिंग

डेटा को कोड में बदलते समय इन बातों का ध्यान रखें:

  • हेक्साडेसिमल एन्कोडिंग (हेक्स) का इस्तेमाल करने पर, एन्कोडिंग आउटपुट के केस से कोई फ़र्क़ नहीं पड़ता.
  • Base64 एन्कोडिंग का इस्तेमाल करने पर, एन्कोडिंग आउटपुट के केस से फ़र्क़ पड़ता है.
पीछे जाएं
डेस्टिनेशन और हेडर कॉन्फ़िगर करना
आगे बढ़ें
उपयोगकर्ता का डेटा एन्क्रिप्ट (सुरक्षित) करें