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

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

AddressInfo ফর্ম্যাট

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

AddressInfo
given_name
ফর্ম্যাট
string
ছোট হাতের অক্ষরে কনভার্ট করুন।
Mrs.-এর মতো প্রিফিক্স যোগ করবেন না
Whitespace শুরু ও শেষের হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ করুন। হেক্স বা Base64 এনকোডিং ব্যবহার করে হ্যাশ বাইট এনকোড করুন।
family_name
ফর্ম্যাট
string
ছোট হাতের অক্ষরে কনভার্ট করুন।
Jr.-এর মতো নামের পরে যোগ করা হয় এমন বিশেষণ বা সাফিক্স যোগ করবেন না
Whitespace শুরু ও শেষের হোয়াইটস্পেস ট্রিম করুন।
হ্যাশিং SHA-256 অ্যালগরিদম ব্যবহার করে হ্যাশ করুন। হেক্স বা Base64 এনকোডিং ব্যবহার করে হ্যাশ বাইট এনকোড করুন।
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 অ্যালগরিদম ব্যবহার করে হ্যাশ করুন। হেক্স বা Base64 এনকোডিং ব্যবহার করে হ্যাশ বাইট এনকোড করুন।
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. hex বা 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

এনকোডিং

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

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