فرمت داده های کاربر

Data Manager API از آپلود انواع مختلف داده های کاربر پشتیبانی می کند. الزامات قالب‌بندی، هش و رمزگذاری هر عنصر داده را دنبال کنید تا داده‌های شما با موفقیت دریافت و پردازش شوند.

الزامات UserData

شی UserData مجموعه ای از اشیاء UserIdentifier است. هر UserIdentifier دقیقا یکی از ویژگی های جدول زیر را دارد.

UserIdentifier
email_address
قالب
string
تبدیل به حروف کوچک
اگر آدرس ایمیل دارای دامنه gmail.com یا googlemail.com است، تمام نقاط ( . ) قبل از نماد @ را حذف کنید.
فضای خالی فضای سفید پیشرو، انتهایی و میانی را کوتاه کنید.
هش کردن هش با استفاده از الگوریتم SHA-256 . بایت های هش را با استفاده از رمزگذاری هگز یا Base64 رمزگذاری کنید.
phone_number
قالب
string
از فرمت E.164 استفاده کنید.
علامت مثبت ( + ) و کد کشور را وارد کنید. همه کاراکترهای بعد از علامت مثبت باید رقمی باشند.
به عنوان مثال، شماره تلفن ایالات متحده (800)555-0100 باید فرمت شده و به +18005550100 تبدیل شود.
فضای خالی فضای سفید پیشرو و انتهایی را کوتاه کنید.
هش کردن هش با استفاده از الگوریتم SHA-256 . بایت های هش را با استفاده از رمزگذاری هگز یا Base64 رمزگذاری کنید.
address
شیء AddressInfo
به مشخصات قالب AddressInfo مراجعه کنید.

فرمت AddressInfo

از دستورالعمل های قالب بندی زیر برای ساختن ویژگی address یک UserIdentifier استفاده کنید.

آدرس اطلاعات
given_name
قالب
string
تبدیل به حروف کوچک
پیشوندهایی مانند Mrs. را وارد نکنید.
فضای خالی فضای سفید پیشرو و انتهایی را کوتاه کنید.
هش کردن هش با استفاده از الگوریتم SHA-256 . بایت های هش را با استفاده از رمزگذاری هگز یا Base64 رمزگذاری کنید.
family_name
قالب
string
تبدیل به حروف کوچک
پسوندهایی مانند Jr. را وارد نکنید.
فضای خالی فضای سفید پیشرو و انتهایی را کوتاه کنید.
هش کردن هش با استفاده از الگوریتم SHA-256 . بایت های هش را با استفاده از رمزگذاری هگز یا Base64 رمزگذاری کنید.
region_code
قالب
string
کد ISO-3166-1 آلفا-2 دو کاراکتری.
فضای خالی فضای سفید پیشرو و انتهایی را کوتاه کنید.
هش کردن region_code هش نکنید.
postal_code
قالب
string
کد پستی و پستی ایالات متحده و بین المللی مجاز است.
برای آدرس های ایالات متحده، از 5 رقم یا 5 رقم و به دنبال آن یک پسوند 4 رقمی استفاده کنید. استفاده از افزونه 4 رقمی ممکن است نرخ تطابق شما را بهبود بخشد.
برای همه کشورهای دیگر، از پسوند کد پستی استفاده نکنید.
فضای خالی فضای سفید پیشرو و انتهایی را کوتاه کنید.
هش کردن postal_code هش نکنید.

الزامات PairData

فیلد pair_ids یک شی PairData را با لیستی از شناسه ها پر کنید. هر عنصر در لیست را با استفاده از مراحل زیر قالب بندی کنید:

  1. داده‌های PII ارائه‌شده توسط اتاق تمیز را با استفاده از الگوریتم SHA-256 هش کنید.
  2. بایت های هش را با یک رمز جابجایی EC با استفاده از کلید ناشر برای لیست کاربران PAIR رمزگذاری کنید.
  3. داده های رمزگذاری شده را با استفاده از رمزگذاری هگز یا Base64 رمزگذاری کنید.

الزامات MobileData

فیلد mobile_ids یک شی MobileData را با لیستی از شناسه های تلفن همراه پر کنید. شناسه های موبایل را هش نکنید.

قالب مهر زمان

اگر از قالب JSON برای فیلدهای Timestamp ، مانند timestamp و last_updated_timestamp Event استفاده می‌کنید، از قالب RFC 3339 استفاده کنید. در اینجا چند نمونه از زمان UTC در 8 اوت 2025 در ساعت 5:18:44.291 بعد از ظهر در قالب RFC 3339 و مناطق زمانی مختلف آورده شده است:

  • منطقه زمانی UTC: 2025-08-08T17:18:44.291Z
  • منطقه زمانی EDT، که در آن زمان 4 ساعت قبل از UTC بود: 2025-08-08T13:18:44.291-04:00
  • منطقه زمانی PDT، که در آن زمان 7 ساعت قبل از UTC بود: 2025-08-08T10:18:44.291-07:00
  • منطقه زمانی توکیو، ژاپن، که 9 ساعت جلوتر از UTC بود و ساعت تابستانی را رعایت نمی کرد: 2025-08-08T22:18:44.291+09:00

اگر از فرمت بافر پروتکل استفاده می کنید، seconds و در صورت تمایل، nanos هنگام ساخت Timestamp تنظیم کنید. در اینجا مقادیر seconds و nanos برای زمان UTC در 8 اوت 2025 در ساعت 5:18:44.291 بعد از ظهر آمده است:

  • seconds : 1754683124
  • nanos : 291000000

رمزگذاری

هنگام رمزگذاری داده ها موارد زیر را در نظر داشته باشید:

مراحل بعدی