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

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

• UserData : ব্যবহারকারীর দেওয়া তথ্য, যেমন ইমেল ঠিকানা বা ফোন নম্বর।
• PairData : প্রকাশক বিজ্ঞাপনদাতা পরিচয় সমন্বয় (PAIR) আইডি।
• MobileData : একটি মোবাইল ডিভাইস শনাক্তকারী ডেটা।

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

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

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

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 এনকোডিং ব্যবহার করার সময় এনকোডিং আউটপুটের কেস বা অক্ষরের অবস্থান গুরুত্বপূর্ণ ।