‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

قالب‌بندی داده‌های کاربر

«میانای برنامه‌سازی کاربردی مدیر داده‌ها» از بارگذاری انواع مختلف داده‌های کاربر پشتیبانی می‌کند. الزامات قالب‌بندی، درهم‌سازی، و کدبندی را برای هر عنصر داده دنبال کنید تا داده‌هایتان باموفقیت دریافت و پردازش شود.

UserData: داده‌های ارائه‌شده توسط کاربر مثل نشانی ایمیل یا شماره تلفن.
IpData: داده‌های IP مانند نشانی IP و مُهرهای زمان مرتبط.
PairData: شناسه‌های تطبیق هویت تبلیغ‌کننده ناشر (PAIR).
MobileData: داده‌هایی که دستگاه همراه را شناسایی می‌کنند.

‫`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`
فاصله سفید	فاصله سفید اضافی در ابتدا، انتها، و میان متن را حذف کنید.
درهم‌سازی	بااستفاده از الگوریتم SHA-256 درهم‌سازی کنید. بایت‌های درهم‌سازی را بااستفاده از کدبندی هگز یا Base64 کدبندی کنید.

phone_number

قالب	`string` از قالب E.164 استفاده کنید. علامت به‌علاوه (`+`) و کد کشور را وارد کنید. همه نویسه‌های بعداز علامت به‌علاوه باید رقم باشند. برای مثال، شماره تلفن ایالات متحده `(800)555-0100` باید به قالب `+18005550100` درآید و عادی‌سازی شود.
فاصله سفید	فاصله سفید اضافی در ابتدا و انتهای متن را حذف کنید.
درهم‌سازی	بااستفاده از الگوریتم SHA-256 درهم‌سازی کنید. بایت‌های درهم‌سازی را بااستفاده از کدبندی هگز یا Base64 کدبندی کنید.

address

AddressInfo شیء

به AddressInfo مشخصات قالب مراجعه کنید.

قالب `AddressInfo`

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

AddressInfo

given_name

قالب	`string` به حروف کوچک تبدیل شود. پیشوندهایی مثل `Mrs.` را اضافه نکنید
فاصله سفید	فاصله سفید اضافی در ابتدا و انتهای متن را حذف کنید.
درهم‌سازی	بااستفاده از الگوریتم SHA-256 درهم‌سازی کنید. بایت‌های درهم‌سازی را بااستفاده از کدبندی هگز یا Base64 کدبندی کنید.

family_name

قالب	`string` به حروف کوچک تبدیل شود. پسوندهایی مثل `Jr.` را اضافه نکنید
فاصله سفید	فاصله سفید اضافی در ابتدا و انتهای متن را حذف کنید.
درهم‌سازی	بااستفاده از الگوریتم SHA-256 درهم‌سازی کنید. بایت‌های درهم‌سازی را بااستفاده از کدبندی هگز یا Base64 کدبندی کنید.

region_code

قالب	`string` کد دوحرفی ISO-3166-1 alpha-2.
فاصله سفید	فاصله سفید اضافی در ابتدا و انتهای متن را حذف کنید.
درهم‌سازی	‫`region_code` را درهم‌سازی نکنید.

postal_code

قالب	`string` کدهای پستی ایالات متحده و بین‌المللی مجاز هستند. برای نشانی‌های ایالات متحده، از ۵ رقم یا ۵ رقم به‌همراه افزونه ۴ رقمی استفاده کنید. استفاده از افزونه ۴ رقمی ممکن است نرخ مطابقت شما را بهبود دهد. برای همه کشورهای دیگر، از افزونه‌های کد پستی استفاده نکنید.
فاصله سفید	فاصله سفید اضافی در ابتدا و انتهای متن را حذف کنید.
درهم‌سازی	‫`postal_code` درهم‌سازی نشود.

address_line

قالب	`string` فقط برای Google Analytics استفاده می‌شود. خیابان و شماره نشانی کاربر. به حروف کوچک تبدیل شود. نویسه‌های نماد را بردارید.
فاصله سفید	فاصله سفید اضافی در ابتدا و انتهای متن را حذف کنید.
درهم‌سازی	بااستفاده از الگوریتم SHA-256 درهم‌سازی کنید. بایت‌های درهم‌سازی را بااستفاده از کدبندی هگز یا Base64 کدبندی کنید.

city

قالب	`string` فقط برای Google Analytics استفاده می‌شود. شهر نشانی کاربر. به حروف کوچک تبدیل شود. نویسه‌های نماد را بردارید.
فاصله سفید	فاصله سفید اضافی در ابتدا و انتهای متن را حذف کنید.
درهم‌سازی	‫`city` را درهم‌سازی نکنید.

administrative_area

قالب	`string` فقط برای Google Analytics استفاده می‌شود. منطقه اداری (ایالت یا استان) نشانی کاربر. از مخفف دوحرفی (برای مثال، `ca`) یا نام کامل (برای مثال، `california`) استفاده کنید. به حروف کوچک تبدیل شود. نویسه‌های نماد را بردارید.
فاصله سفید	فاصله سفید اضافی در ابتدا و انتهای متن را حذف کنید.
درهم‌سازی	‫`administrative_area` درهم‌سازی نشود.

‫`IpData` شرط لازم

شیء IpData دارای مشخصه‌های زیر است.

IpData

ip_address

قالب	`string` نشانی IPv4 یا IPv6. برای نشانی‌های IPv6، حروف بزرگ و کوچک تفاوتی ندارد (می‌توان از هر دو استفاده کرد).
فاصله سفید	فاصله سفید اضافی در ابتدا و انتهای متن را حذف کنید.
درهم‌سازی	‫`ip_address` را درهم‌سازی نکنید.

‫`PairData` شرط لازم

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

داده‌های «اطلاعات شخصی قابل‌شناسایی» ارائه‌شده از اتاق تمیز را بااستفاده از الگوریتم SHA-256 درهم‌سازی کنید.
بایت‌های درهم‌سازی را با یک رمزگذاری جابه‌جایی EC بااستفاده از کلید ناشر برای فهرست کاربران PAIR رمزگذاری کنید.
داده‌های رمزگذاری‌شده را بااستفاده از کدبندی هگز یا کدبندی Base64 کدبندی کنید.

‫`MobileData` شرط لازم

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

قالب مُهر زمان

اگر از قالب JSON برای فیلدهای Timestamp، مانند timestamp و last_updated_timestamp از Event استفاده می‌کنید، از قالب RFC 3339 استفاده کنید. در اینجا چند نمونه از زمان هماهنگ جهانی ۸ اوت ۲۰۲۵ ساعت ۵:۱۸:۴۴.۲۹۱ بعدازظهر در قالب RFC 3339 و مناطق زمانی مختلف آورده شده است:

منطقه زمانی UTC: 2025-08-08T17:18:44.291Z
منطقه زمانی EDT که در آن زمان ۴ ساعت از زمان UTC جلوتر بود: 2025-08-08T13:18:44.291-04:00
منطقه زمانی «زمان استاندارد اقیانوس آرام» که در آن زمان ۷ ساعت از «زمان هماهنگ جهانی» جلوتر بود: 2025-08-08T10:18:44.291-07:00
منطقه زمانی توکیو، ژاپن، که ۹ ساعت از زمان هماهنگ جهانی جلوتر است و ساعت تابستانی ندارد: 2025-08-08T22:18:44.291+09:00

اگر از قالب بافر پروتکل استفاده می‌کنید، هنگام ساختن Timestamp، seconds و درصورت تمایل nanos را تنظیم کنید. در اینجا seconds و nanos مقادیر برای زمان هماهنگ جهانی ۸ اوت ۲۰۲۵ ساعت ۱۷:۱۸:۴۴.۲۹۱ آمده است: