The Data Manager API supports uploading multiple types of user data. Follow the formatting, hashing, and encoding requirements for each data element so that your data is received and processed successfully.
یک شیء UserData مجموعهای از اشیاء UserIdentifier است. هر UserIdentifier دقیقاً یکی از ویژگیهای جدول زیر را دارد.
| شناسه کاربری |
|---|
email_address | | قالب | string - به حروف کوچک تبدیل کنید.
- اگر آدرس ایمیل دارای دامنه
gmail.com یا googlemail.com است: - تمام نقطهها (
. ) قبل از نماد @ را حذف کنید. - علامت جمع (
+ ) را از قسمت محلی (local-part) حذف کنید و تمام کاراکترهای بعد از آن را نیز حذف کنید. - مثال:
cloudy.sanfrancisco+shopping@gmail.com → cloudysanfrancisco@gmail.com
- اگر آدرس ایمیل دامنهای غیر از
gmail.com یا googlemail.com دارد، نقطهها یا علامتهای بعلاوه را حذف نکنید. - مثال:
user.name+NYC@Example.com → user.name+nyc@example.com
| | فضای سفید | فاصلههای خالیِ ابتدا، انتهای و وسط را حذف کنید. | | هش کردن | با استفاده از الگوریتم SHA-256 هش کنید. بایتهای هش را با استفاده از کدگذاری هگز یا Base64 رمزگذاری کنید. |
|
phone_number | | قالب | string علامت جمع ( + ) و کد کشور را وارد کنید. تمام کاراکترهای بعد از علامت جمع باید عدد باشند. برای مثال، شماره تلفن ایالات متحده (800)555-0100 باید به صورت +18005550100 قالببندی و نرمالسازی شود. | | فضای سفید | فاصلههای خالیِ ابتدا و انتهای متن را حذف کنید. | | هش کردن | با استفاده از الگوریتم SHA-256 هش کنید. بایتهای هش را با استفاده از کدگذاری هگز یا Base64 رمزگذاری کنید. |
|
address | |
از دستورالعملهای قالببندی زیر برای ساخت ویژگی address یک UserIdentifier استفاده کنید.
| اطلاعات آدرس |
|---|
given_name | | قالب | string به حروف کوچک تبدیل کنید. پیشوندهایی مانند Mrs. را وارد نکنید. | | فضای سفید | فاصلههای خالیِ ابتدا و انتهای متن را حذف کنید. | | هش کردن | با استفاده از الگوریتم SHA-256 هش کنید. بایتهای هش را با استفاده از کدگذاری هگز یا Base64 رمزگذاری کنید. |
|
family_name | | قالب | string به حروف کوچک تبدیل کنید. پسوندهایی مانند Jr. را وارد نکنید. | | فضای سفید | فاصلههای خالیِ ابتدا و انتهای متن را حذف کنید. | | هش کردن | با استفاده از الگوریتم SHA-256 هش کنید. بایتهای هش را با استفاده از کدگذاری هگز یا Base64 رمزگذاری کنید. |
|
region_code | | قالب | string | | فضای سفید | فاصلههای خالیِ ابتدا و انتهای متن را حذف کنید. | | هش کردن | region_code هش نکنید. |
|
postal_code | | قالب | string کد پستی و پستی ایالات متحده و بینالمللی هر دو مجاز هستند. برای آدرسهای ایالات متحده، از ۵ رقم یا ۵ رقم و به دنبال آن یک شماره داخلی ۴ رقمی استفاده کنید. استفاده از یک شماره داخلی ۴ رقمی ممکن است نرخ تطابق شما را بهبود بخشد. برای سایر کشورها، از پسوندهای کد پستی استفاده نکنید. | | فضای سفید | فاصلههای خالیِ ابتدا و انتهای متن را حذف کنید. | | هش کردن | postal_code هش نکنید. |
|
address_line | | قالب | string فقط برای گوگل آنالیتیکس استفاده میشود. خیابان و شماره آدرس کاربر. به حروف کوچک تبدیل کنید. حذف کاراکترهای نماد. | | فضای سفید | فاصلههای خالیِ ابتدا و انتهای متن را حذف کنید. | | هش کردن | با استفاده از الگوریتم SHA-256 هش کنید. بایتهای هش را با استفاده از کدگذاری هگز یا Base64 رمزگذاری کنید. |
|
city | | قالب | string فقط برای گوگل آنالیتیکس استفاده میشود. شهر آدرس کاربر. به حروف کوچک تبدیل کنید. حذف کاراکترهای نماد. | | فضای سفید | فاصلههای خالیِ ابتدا و انتهای متن را حذف کنید. | | هش کردن | city هش نکن. |
|
administrative_area | | قالب | string فقط برای گوگل آنالیتیکس استفاده میشود. منطقه اداری (ایالت یا استان) آدرس کاربر. یا از مخفف دو حرفی (مثلاً ca ) یا از نام کامل (مثلاً california ) استفاده کنید. به حروف کوچک تبدیل کنید. حذف کاراکترهای نماد. | | فضای سفید | فاصلههای خالیِ ابتدا و انتهای متن را حذف کنید. | | هش کردن | administrative_area را هش نکنید. |
|
یک شیء IpData دارای ویژگیهای زیر است.
| آیپیدیتا |
|---|
ip_address | | قالب | string آدرس IPv4 یا IPv6. برای آدرسهای IPv6، حروف کوچک و بزرگ اهمیتی ندارند (میتوان از حروف بزرگ یا کوچک استفاده کرد). | | فضای سفید | فاصلههای خالیِ ابتدا و انتهای متن را حذف کنید. | | هش کردن | ip_address هش نکنید. |
|
فیلد pair_ids از یک شیء PairData را با لیستی از شناسهها پر کنید. هر عنصر در لیست را با استفاده از مراحل زیر قالببندی کنید:
- دادههای PII ارائه شده توسط اتاق تمیز را با استفاده از الگوریتم SHA-256 هش کنید.
- بایتهای هش را با یک رمز جابجایی EC و با استفاده از کلید ناشر برای لیست کاربران PAIR رمزگذاری کنید.
- دادههای رمزگذاری شده را با استفاده از کدگذاری هگز یا Base64 رمزگذاری کنید.
فیلد mobile_ids از شیء MobileData را با لیستی از شناسههای تلفن همراه پر کنید. شناسههای تلفن همراه را هش نکنید.
If using the JSON format for Timestamp fields, like timestamp and last_updated_timestamp of Event , use the RFC 3339 format. Here are some examples of the UTC time of August 8, 2025 at 5:18:44.291 PM in the RFC 3339 format and different time zones:
- منطقه زمانی 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
If using the protocol buffer format, set the seconds and, optionally, the nanos when constructing the Timestamp . Here are the seconds and nanos values for the UTC time of August 8, 2025 at 5:18:44.291 PM:
-
seconds : 1754683124 -
nanos : 291000000
رمزگذاری
هنگام کدگذاری دادهها، نکات زیر را در نظر داشته باشید:
- هنگام استفاده از کدگذاری هگزادسیمال (hexadecimal)، حروف کوچک و بزرگ خروجی کدگذاری اهمیتی ندارند.
- هنگام استفاده از کدگذاری Base64، بزرگی یا کوچکی خروجی کدگذاری اهمیت دارد .
