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

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

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 ऐल्फ़ा-2 कोड.
वाइटस्‍पेस आगे और पीछे के व्हाइटस्पेस हटाएं.
हैशिंग region_code को हैश न करें.
postal_code
फ़ॉर्मैट
string
अमेरिका के पिन कोड और अंतरराष्ट्रीय पिन कोड, दोनों की अनुमति है.
अमेरिका के पतों के लिए, पांच अंकों या पांच अंकों के बाद चार अंकों के एक्सटेंशन का इस्तेमाल करें. चार अंकों के एक्सटेंशन का इस्तेमाल करने से, मैच रेट बेहतर हो सकता है.
अन्य सभी देशों के लिए, पिन कोड एक्सटेंशन का इस्तेमाल न करें.
वाइटस्‍पेस आगे और पीछे के व्हाइटस्पेस हटाएं.
हैशिंग postal_code को हैश न करें.

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 फ़ील्ड में, मोबाइल आईडी की सूची डालें. मोबाइल आईडी को हैश न करें.

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

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

एन्कोडिंग

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

पीछे जाएं
डेस्टिनेशन और हेडर कॉन्फ़िगर करना
आगे बढ़ें
उपयोगकर्ता का डेटा एन्क्रिप्ट (सुरक्षित) करें