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

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

الزامات UserData

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

UserIdentifier
email_address
قالب
string
تبدیل به حروف کوچک
فضای خالی فضای سفید پیشرو، انتهایی و میانی را کوتاه کنید.
هش کردن هش با استفاده از الگوریتم SHA-256 . بایت های هش را با استفاده از رمزگذاری هگز یا Base64 رمزگذاری کنید.
phone_number
قالب
string
از فرمت E.164 استفاده کنید.
علامت مثبت ( + ) و کد کشور را وارد کنید.
فضای خالی فضای سفید پیشرو و انتهایی را کوتاه کنید.
هش کردن هش با استفاده از الگوریتم 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 استفاده کنید.

اگر از فرمت بافر پروتکل استفاده می کنید، seconds و در صورت تمایل، nanos هنگام ساخت Timestamp تنظیم کنید.

مراحل بعدی