ব্যবহারকারীর ডেটা ফর্ম্যাট করুন

ডেটা ম্যানেজার এপিআই একাধিক ধরনের ব্যবহারকারীর ডেটা আপলোড করা সমর্থন করে। প্রতিটি ডেটা উপাদানের জন্য ফরম্যাটিং, হ্যাশিং এবং এনকোডিংয়ের নিয়মাবলী অনুসরণ করুন, যাতে আপনার ডেটা সফলভাবে গৃহীত ও প্রক্রিয়াজাত হয়।

UserData প্রয়োজনীয়তা

একটি UserData অবজেক্ট হলো UserIdentifier অবজেক্টের একটি সংগ্রহ। প্রতিটি UserIdentifier নিম্নলিখিত সারণিতে থাকা অ্যাট্রিবিউটগুলোর মধ্যে ঠিক একটি থাকে।

ব্যবহারকারী শনাক্তকারী
email_address
ফর্ম্যাট
string
ছোট হাতের অক্ষরে রূপান্তর করুন।
ইমেল ঠিকানাটির ডোমেইন যদি gmail.com বা googlemail.com হয়, তাহলে @ চিহ্নের আগে থাকা সমস্ত ডট ( . ) মুছে ফেলুন।
ফাঁকা স্থান শুরুতে, শেষে এবং মাঝের ফাঁকা স্থান ছেঁটে ফেলুন।
হ্যাশিং SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ করুন। হেক্স অথবা বেস৬৪ এনকোডিং ব্যবহার করে হ্যাশ বাইটগুলো এনকোড করুন।
phone_number
ফর্ম্যাট
string
E.164 ফরম্যাট ব্যবহার করুন।
যোগ চিহ্ন ( + ) এবং দেশের কোড অন্তর্ভুক্ত করুন। যোগ চিহ্নের পরের সমস্ত অক্ষর অবশ্যই অঙ্ক হতে হবে।
উদাহরণস্বরূপ, মার্কিন ফোন নম্বর (800)555-0100 কে +18005550100 -এ ফরম্যাট এবং স্বাভাবিক করা উচিত।
ফাঁকা স্থান শুরুতে ও শেষে থাকা অতিরিক্ত অংশ ছেঁটে ফেলুন।
হ্যাশিং SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ করুন। হেক্স অথবা বেস৬৪ এনকোডিং ব্যবহার করে হ্যাশ বাইটগুলো এনকোড করুন।
address
AddressInfo অবজেক্ট

AddressInfo বিন্যাস

UserIdentifier এর address অ্যাট্রিবিউটটি তৈরি করতে নিম্নলিখিত ফরম্যাটিং নির্দেশিকা ব্যবহার করুন।

ঠিকানা তথ্য
given_name
ফর্ম্যাট
string
ছোট হাতের অক্ষরে রূপান্তর করুন।
Mrs. এর মতো উপসর্গ যোগ করবেন না।
ফাঁকা স্থান শুরুতে ও শেষে থাকা অতিরিক্ত অংশ ছেঁটে ফেলুন।
হ্যাশিং SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ করুন। হেক্স অথবা বেস৬৪ এনকোডিং ব্যবহার করে হ্যাশ বাইটগুলো এনকোড করুন।
family_name
ফর্ম্যাট
string
ছোট হাতের অক্ষরে রূপান্তর করুন।
Jr. এর মতো প্রত্যয় যোগ করবেন না।
ফাঁকা স্থান শুরুতে ও শেষে থাকা অতিরিক্ত অংশ ছেঁটে ফেলুন।
হ্যাশিং SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ করুন। হেক্স অথবা বেস৬৪ এনকোডিং ব্যবহার করে হ্যাশ বাইটগুলো এনকোড করুন।
region_code
ফর্ম্যাট
string
দুই অক্ষরের একটি ISO-3166-1 আলফা-2 কোড।
ফাঁকা স্থান শুরুতে ও শেষে থাকা অতিরিক্ত অংশ ছেঁটে ফেলুন।
হ্যাশিং region_code হ্যাশ করবেন না।
postal_code
ফর্ম্যাট
string
মার্কিন ও আন্তর্জাতিক উভয় প্রকারের জিপ এবং পোস্টাল কোড অনুমোদিত।
মার্কিন যুক্তরাষ্ট্রের ঠিকানার জন্য, হয় ৫টি সংখ্যা অথবা ৫টি সংখ্যার পর একটি ৪-সংখ্যার এক্সটেনশন ব্যবহার করুন। ৪-সংখ্যার এক্সটেনশন ব্যবহার করলে আপনার ঠিকানা খুঁজে পাওয়ার সম্ভাবনা বাড়তে পারে।
অন্য সব দেশের জন্য পোস্টাল কোড এক্সটেনশন ব্যবহার করবেন না।
ফাঁকা স্থান শুরুতে ও শেষে থাকা অতিরিক্ত অংশ ছেঁটে ফেলুন।
হ্যাশিং postal_code হ্যাশ করবেন না।

IpData প্রয়োজনীয়তা

একটি IpData অবজেক্টের নিম্নলিখিত অ্যাট্রিবিউটগুলো রয়েছে।

আইপিডেটা
ip_address
ফর্ম্যাট
string
IPv4 বা IPv6 ঠিকানা।
IPv6 অ্যাড্রেসের ক্ষেত্রে কেস কোনো বিষয় নয় (বড় হাতের বা ছোট হাতের যেকোনোটিই ব্যবহার করা যেতে পারে)।
ফাঁকা স্থান শুরুতে ও শেষে থাকা অতিরিক্ত অংশ ছেঁটে ফেলুন।
হ্যাশিং ip_address হ্যাশ করবেন না।

PairData প্রয়োজনীয়তা

একটি PairData অবজেক্টের pair_ids ফিল্ডে আইডিগুলোর একটি তালিকা পূরণ করুন। নিম্নলিখিত ধাপগুলো অনুসরণ করে তালিকার প্রতিটি উপাদান ফরম্যাট করুন:

  1. SHA-256 অ্যালগরিদম ব্যবহার করে ক্লিনরুম থেকে প্রদত্ত PII ডেটা হ্যাশ করুন।
  2. PAIR ব্যবহারকারী তালিকার জন্য পাবলিশার কী ব্যবহার করে একটি EC কমিউটেটিভ সাইফার দিয়ে হ্যাশ বাইটগুলো এনক্রিপ্ট করুন।
  3. এনক্রিপ্ট করা ডেটা হেক্স অথবা বেস৬৪ এনকোডিং ব্যবহার করে এনকোড করুন।

MobileData প্রয়োজনীয়তা

MobileData অবজেক্টের mobile_ids ফিল্ডে মোবাইল আইডিগুলোর একটি তালিকা দিয়ে পূরণ করুন। মোবাইল আইডিগুলো হ্যাশ করবেন না।

টাইমস্ট্যাম্প ফরম্যাট

Event এর timestamp এবং last_updated_timestamp এর মতো Timestamp ফিল্ডগুলির জন্য JSON ফরম্যাট ব্যবহার করলে, RFC 3339 ফরম্যাটটি ব্যবহার করুন। নিচে RFC 3339 ফরম্যাট এবং বিভিন্ন টাইম জোনে ৮ই আগস্ট, ২০২৫ তারিখের বিকাল ৫:১৮:৪৪.২৯১-এর UTC সময়ের কিছু উদাহরণ দেওয়া হলো:

  • ইউটিসি সময় অঞ্চল: 2025-08-08T17:18:44.291Z
  • EDT সময় অঞ্চল, যা সেই সময়ে UTC-এর ৪ ঘন্টা আগে ছিল: 2025-08-08T13:18:44.291-04:00
  • পিডিটি সময় অঞ্চল, যা সেই সময়ে ইউটিসি-র থেকে ৭ ঘন্টা এগিয়ে ছিল: 2025-08-08T10:18:44.291-07:00
  • জাপানের টোকিওর সময় অঞ্চল, যা UTC থেকে ৯ ঘণ্টা এগিয়ে এবং দিবালোক সংরক্ষণ সময় অনুসরণ করে না: 2025-08-08T22:18:44.291+09:00

প্রোটোকল বাফার ফরম্যাট ব্যবহার করলে, Timestamp তৈরি করার সময় seconds এবং ঐচ্ছিকভাবে nanos সেট করুন। নিচে ৮ই আগস্ট, ২০২৫ তারিখের বিকাল ৫:১৮:৪৪.২৯১ UTC সময়ের জন্য seconds এবং nanos মান দেওয়া হলো:

  • seconds : 1754683124
  • nanos : 291000000

এনকোডিং

ডেটা এনকোড করার সময় নিম্নলিখিত বিষয়গুলো মনে রাখবেন:

  • হেক্সাডেসিমাল এনকোডিং (হেক্স) ব্যবহার করার সময় এনকোডিং আউটপুটের কেস কোনো বিষয় নয়।
  • Base64 এনকোডিং ব্যবহার করার সময় এনকোডিং আউটপুটের কেস বা অক্ষরের অবস্থান গুরুত্বপূর্ণ ।
পূর্ববর্তী
গন্তব্য এবং হেডার কনফিগার করুন
পরবর্তী
ব্যবহারকারীর ডেটা এনক্রিপ্ট করুন