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

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

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

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

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

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

AddressInfo বিন্যাস

UserIdentifier এর address বৈশিষ্ট্য তৈরি করতে নিম্নলিখিত বিন্যাস নির্দেশিকাগুলি ব্যবহার করুন।

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

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

PairData অবজেক্টের pair_ids ফিল্ডে ID গুলির একটি তালিকা তৈরি করুন। নিম্নলিখিত ধাপগুলি ব্যবহার করে তালিকার প্রতিটি উপাদান ফর্ম্যাট করুন:

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

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

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

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

যদি Timestamp ফিল্ডের জন্য JSON ফর্ম্যাট ব্যবহার করেন, যেমন timestamp এবং Event এর last_updated_timestamp , তাহলে RFC 3339 ফর্ম্যাট ব্যবহার করুন। RFC 3339 ফর্ম্যাট এবং বিভিন্ন সময় অঞ্চলে 8 আগস্ট, 2025 তারিখের 5:18:44.291 PM এর UTC সময়ের কিছু উদাহরণ এখানে দেওয়া হল:

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

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

• seconds : 1754683124
• nanos : 291000000

এনকোডিং

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

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