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

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

UserData की ज़रूरी शर्तें

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

UserIdentifier
email_address
फ़ॉर्मैट
string
अंग्रेज़ी के छोटे अक्षरों में बदलें.
अगर ईमेल पते में gmail.com या googlemail.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 को हैश न करें.

PairData की ज़रूरी शर्तें

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

  1. क्लीनरूम से मिले व्यक्तिगत पहचान से जुड़े डेटा को SHA-256 एल्गोरिदम का इस्तेमाल करके हैश करें.
  2. PAIR उपयोगकर्ता सूची के लिए, पब्लिशर की कुंजी का इस्तेमाल करके, EC कम्यूटेटिव साइफ़र की मदद से हैश बाइट को एन्क्रिप्ट (सुरक्षित) करें.
  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
  • PDT टाइम ज़ोन, जो उस समय यूटीसी से सात घंटे पहले था: 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 encoding का इस्तेमाल करते समय, एनकोडिंग आउटपुट का केस अहम होता है.

अगले चरण