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

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

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
Whitespace শুরু, শেষ ও মধ্যবর্তী হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ করুন এবং হ্যাশ বাইট এনকোড করুন।
phone_number
ফর্ম্যাট
string
E.164 ফর্ম্যাট ব্যবহার করুন।
যোগ চিহ্ন (+) এবং দেশের কোড লিখুন। প্লাস চিহ্নের পরে সব অক্ষর অবশ্যই সংখ্যা হতে হবে।
যেমন, মার্কিন যুক্তরাষ্ট্রের ফোন নম্বর (800)555-0100 ফর্ম্যাট ও নরমালাইজ করে +18005550100 হিসেবে দেখাতে হবে।
Whitespace শুরু ও শেষের হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ করুন এবং হ্যাশ বাইট এনকোড করুন।
address
AddressInfo অবজেক্ট

AddressInfo ফর্ম্যাট

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

AddressInfo
given_name
ফর্ম্যাট
string
ছোট হাতের অক্ষরে কনভার্ট করুন।
Mrs.-এর মতো প্রিফিক্স যোগ করবেন না
Whitespace শুরু ও শেষের হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ করুন এবং হ্যাশ বাইট এনকোড করুন।
family_name
ফর্ম্যাট
string
ছোট হাতের অক্ষরে কনভার্ট করুন।
Jr.-এর মতো সাফিক্স যোগ করবেন না
Whitespace শুরু ও শেষের হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ করুন এবং হ্যাশ বাইট এনকোড করুন।
region_code
ফর্ম্যাট
string
দুই অক্ষরের ISO-3166-1 alpha-2 কোড।
Whitespace শুরু ও শেষের হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং region_code হ্যাশ করবেন না।
postal_code
ফর্ম্যাট
string
মার্কিন যুক্তরাষ্ট্র এবং আন্তর্জাতিক জিপ এবং পোস্টাল কোড উভয়ই অনুমোদিত।
মার্কিন যুক্তরাষ্ট্রের ঠিকানার ক্ষেত্রে, ৫টি সংখ্যা অথবা ৫টি সংখ্যার পরে ৪-সংখ্যার এক্সটেনশন ব্যবহার করুন। ৪-সংখ্যার এক্সটেনশন ব্যবহার করলে আপনার ম্যাচ রেট উন্নত হতে পারে।
অন্যান্য সব দেশের ক্ষেত্রে, পিন কোড এক্সটেনশন ব্যবহার করবেন না।
Whitespace শুরু ও শেষের হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং postal_code হ্যাশ করবেন না।
address_line
ফর্ম্যাট
string
শুধুমাত্র Google Analytics-এর জন্য ব্যবহার করা হয়।
ব্যবহারকারীর ঠিকানার রাস্তা ও নম্বর।
ছোট হাতের অক্ষরে কনভার্ট করুন।
প্রতীক অক্ষর সরিয়ে দিন।
Whitespace শুরু ও শেষের হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ করুন এবং হ্যাশ বাইট এনকোড করুন।
city
ফর্ম্যাট
string
শুধুমাত্র Google Analytics-এর জন্য ব্যবহার করা হয়।
ব্যবহারকারীর ঠিকানায় থাকা শহরের নাম।
ছোট হাতের অক্ষরে কনভার্ট করুন।
প্রতীক অক্ষর সরিয়ে দিন।
Whitespace শুরু ও শেষের হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং city হ্যাশ করবেন না।
administrative_area
ফর্ম্যাট
string
শুধুমাত্র Google Analytics-এর জন্য ব্যবহার করা হয়।
ব্যবহারকারীর ঠিকানার প্রশাসনিক এলাকা (রাজ্য বা প্রদেশ)।
দুই অক্ষরের সংক্ষিপ্ত রূপ (যেমন, ca) অথবা সম্পূর্ণ নাম (যেমন, california) ব্যবহার করুন।
ছোট হাতের অক্ষরে কনভার্ট করুন।
প্রতীক অক্ষর সরিয়ে দিন।
Whitespace শুরু ও শেষের হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং administrative_area হ্যাশ করবেন না।

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

IpData অবজেক্টে নিম্নলিখিত অ্যাট্রিবিউট আছে।

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

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

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

  1. SHA-256 অ্যালগরিদম ব্যবহার করে ক্লিনরুমের মাধ্যমে প্রদান করা PII ডেটা হ্যাশ করুন।

  2. PAIR ব্যবহারকারীর তালিকার জন্য প্রকাশক কী ব্যবহার করে EC কমিউটেটিভ সাইফারের মাধ্যমে হ্যাশ বাইট এনক্রিপ্ট করুন।

  3. হেক্স বা Base64 এনকোডিং ব্যবহার করে এনক্রিপ্ট করা ডেটা এনকোড করুন।

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

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

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

Timestamp ফিল্ডের জন্য JSON ফর্ম্যাট ব্যবহার করলে, যেমন Event-এর timestamp এবং last_updated_timestamp, RFC 3339 ফর্ম্যাট ব্যবহার করুন। এখানে RFC 3339 ফর্ম্যাটে এবং বিভিন্ন টাইম জোনে ৮ আগস্ট, ২০২৫-এর বিকেল ৫:১৮:৪৪.২৯১-এর 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 সেট করুন। ৮ আগস্ট, ২০২৫-এর বিকেল ৫:১৮:৪৪.২৯১ UTC সময়ের জন্য seconds এবং nanos ভ্যালু এখানে দেওয়া হল:

  • seconds: 1754683124

  • nanos: 291000000

এনকোডিং

আপনি ব্যবহারকারীর ডেটা এনক্রিপ্ট করেন কিনা তার উপর নির্ভর করে এনকোডিংয়ের প্রয়োজনীয়তা আলাদা হয়:

এনকোডিং ওয়ার্কফ্লো

  • আনএনক্রিপ্টেড ব্যবহারকারীর ডেটা: SHA-256 হ্যাশ বাইট এনকোড করুন, হয় হেক্সাডেসিমাল এনকোডিং (hex) অথবা Base64 এনকোডিং ব্যবহার করে।

  • এনক্রিপ্ট করা ব্যবহারকারীর ডেটা: আপনি ব্যবহারকারীর ডেটা এনক্রিপ্ট করলে, এনক্রিপ্ট করার আগে আপনাকে অবশ্যই Base64-এনকোড করা র' হ্যাশ বাইট ব্যবহার করতে হবে। প্রি-এনক্রিপশন হ্যাশের জন্য হেক্সাডেসিমাল এনকোডিং কাজ করে না। তারপর আপনি হেক্সাডেসিমাল বা Base64 এনকোডিং ব্যবহার করে ফলাফল হিসেবে পাওয়া সাইফারটেক্সট এনকোড করতে পারবেন।

পূর্ববর্তী
ডেস্টিনেশন ও হেডার কনফিগার করা
পরবর্তী
ব্যবহারকারীর ডেটা এনক্রিপ্ট করা