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

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

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

একটি UserData অবজেক্ট হল UserIdentifier অবজেক্টের একটি সংগ্রহ। প্রতিটি UserIdentifier নিচের সারণীতে ঠিক একটি বৈশিষ্ট্য আছে।

ব্যবহারকারী সনাক্তকারী
email_address
বিন্যাস
string
ছোট হাতের অক্ষরে রূপান্তর করুন।
যদি ইমেল ঠিকানায় gmail.com বা googlemail.com ডোমেন থাকে, তাহলে @ চিহ্নের আগে সব ডট ( . সরিয়ে দিন।
হোয়াইটস্পেস অগ্রণী, অনুগামী এবং মধ্যবর্তী হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ। হেক্স বা বেস 64 এনকোডিং ব্যবহার করে হ্যাশ বাইট এনকোড করুন।
phone_number
বিন্যাস
string
E.164 বিন্যাস ব্যবহার করুন।
যোগ চিহ্ন ( + ) এবং দেশের কোড অন্তর্ভুক্ত করুন। প্লাস চিহ্নের পরে সমস্ত অক্ষর অবশ্যই সংখ্যা হতে হবে।
উদাহরণস্বরূপ, মার্কিন ফোন নম্বর (800)555-0100 ফর্ম্যাট করা উচিত এবং +18005550100 -এ স্বাভাবিক করা উচিত।
হোয়াইটস্পেস অগ্রণী এবং পিছনের হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ। হেক্স বা বেস 64 এনকোডিং ব্যবহার করে হ্যাশ বাইট এনকোড করুন।
address
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
মার্কিন এবং আন্তর্জাতিক উভয় জিপ এবং পোস্টাল কোড অনুমোদিত।
মার্কিন ঠিকানাগুলির জন্য, 5 সংখ্যা বা 5 সংখ্যার পরে 4-সংখ্যার এক্সটেনশন ব্যবহার করুন৷ একটি 4-সংখ্যার এক্সটেনশন ব্যবহার করা আপনার ম্যাচের হার উন্নত করতে পারে।
অন্য সব দেশের জন্য, পোস্টাল কোড এক্সটেনশন ব্যবহার করবেন না।
হোয়াইটস্পেস অগ্রণী এবং পিছনের হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং postal_code হ্যাশ করবেন না।

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

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

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

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 এর 4 ঘন্টা আগে ছিল: 2025-08-08T13:18:44.291-04:00
  • PDT টাইম জোন, যেটি সেই সময়ে UTC এর 7 ঘন্টা আগে ছিল: 2025-08-08T10:18:44.291-07:00
  • টোকিও, জাপানের সময় অঞ্চল, যা UTC থেকে 9 ঘন্টা এগিয়ে ছিল এবং দিবালোক সংরক্ষণের সময় পালন করে না: 2025-08-08T22:18:44.291+09:00

প্রোটোকল বাফার বিন্যাস ব্যবহার করলে, Timestamp তৈরি করার সময় seconds এবং ঐচ্ছিকভাবে nanos সেট করুন। এখানে 8 আগস্ট, 2025 বিকাল 5:18:44.291 PM-এ UTC সময়ের জন্য seconds এবং nanos মান রয়েছে:

  • seconds : 1754683124
  • nanos : 291000000

এনকোডিং

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

পরবর্তী পদক্ষেপ