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

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

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

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 फ़ॉर्मैट

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
IPv4 या IPv6 पता.
IPv6 पतों के लिए, केस से कोई फ़र्क़ नहीं पड़ता. अपरकेस या लोअरकेस, दोनों का इस्तेमाल किया जा सकता है.
वाइटस्‍पेस आगे और पीछे के व्हाइटस्पेस हटाएं.
हैशिंग ip_address को हैश न करें.

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 फ़ॉर्मैट का इस्तेमाल करें. यहां 8 अगस्त, 2025 को शाम 5:18:44.291 बजे के यूटीसी समय के कुछ उदाहरण दिए गए हैं. ये उदाहरण, आरएफ़सी 3339 फ़ॉर्मैट और अलग-अलग टाइम ज़ोन के हिसाब से दिए गए हैं:

  • यूटीसी टाइम ज़ोन: 2025-08-08T17:18:44.291Z
  • ईडीटी टाइम ज़ोन, जो उस समय यूटीसी से चार घंटे पहले था: 2025-08-08T13:18:44.291-04:00
  • पीडीटी टाइम ज़ोन, जो उस समय यूटीसी से सात घंटे पहले था: 2025-08-08T10:18:44.291-07:00
  • जापान के टोक्यो का टाइम ज़ोन, जो यूटीसी से 9 घंटे आगे है और डेलाइट सेविंग टाइम का पालन नहीं करता: 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 का इस्तेमाल करते समय, एनकोडिंग आउटपुट का केस अहम होता है.
पीछे जाएं
डेस्टिनेशन और हेडर कॉन्फ़िगर करना
आगे बढ़ें
उपयोगकर्ता का डेटा एन्क्रिप्ट (सुरक्षित) करें