עיצוב של נתוני משתמשים

‫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
רווח לבן מסירים רווחים לבנים בהתחלה, בסוף ובאמצע.
גיבוב (hashing) מבצעים גיבוב באמצעות אלגוריתם SHA-256 ומקודדים את בייטי הגיבוב.
phone_number
פורמט
string
צריך להשתמש בפורמט E.164.
צריך לכלול את סימן הפלוס (+) ואת קוד המדינה. כל התווים אחרי סימן הפלוס חייבים להיות ספרות.
לדוגמה, מספר הטלפון בארה"ב (800)555-0100 צריך להיות בפורמט +18005550100.
רווח לבן מסירים רווחים לבנים בהתחלה ובסוף.
גיבוב (hashing) מבצעים גיבוב באמצעות אלגוריתם SHA-256 ומקודדים את בייטי הגיבוב.
address
AddressInfo אובייקט

פורמט של AddressInfo

כדי ליצור את המאפיין address של UserIdentifier, צריך לפעול לפי הנחיות הפורמט הבאות.

AddressInfo
given_name
פורמט
string
ממירים לאותיות קטנות.
אין לכלול תחיליות כמו Mrs.
רווח לבן מסירים רווחים לבנים בהתחלה ובסוף.
גיבוב (hashing) מבצעים גיבוב באמצעות אלגוריתם SHA-256 ומקודדים את בייטי הגיבוב.
family_name
פורמט
string
ממירים לאותיות קטנות.
אל תוסיפו סיומות כמו Jr.
רווח לבן מסירים רווחים לבנים בהתחלה ובסוף.
גיבוב (hashing) מבצעים גיבוב באמצעות אלגוריתם SHA-256 ומקודדים את בייטי הגיבוב.
region_code
פורמט
string
קוד ISO-3166-1 alpha-2 בן שני תווים.
רווח לבן מסירים רווחים לבנים בהתחלה ובסוף.
גיבוב (hashing) אין לגבב את region_code.
postal_code
פורמט
string
אפשר להשתמש במיקוד של ארה"ב וגם של מדינות אחרות.
בכתובות בארה"ב, צריך להשתמש ב-5 ספרות או ב-5 ספרות ואחריהן סיומת של 4 ספרות. שימוש בתוספת של 4 ספרות עשוי לשפר את אחוז הלקוחות לטירגוט.
בכל שאר המדינות, אל תשתמשו בתוספות למיקוד.
רווח לבן מסירים רווחים לבנים בהתחלה ובסוף.
גיבוב (hashing) אין לגבב את postal_code.
address_line
פורמט
string
משמש רק ל-Google Analytics.
הרחוב ומספר הבית של המשתמש.
ממירים לאותיות קטנות.
הסירו תווים של סמלים.
רווח לבן מסירים רווחים לבנים בהתחלה ובסוף.
גיבוב (hashing) מבצעים גיבוב באמצעות אלגוריתם SHA-256 ומקודדים את בייטי הגיבוב.
city
פורמט
string
משמש רק ל-Google Analytics.
העיר שמופיעה בכתובת של המשתמש.
ממירים לאותיות קטנות.
הסירו תווים של סמלים.
רווח לבן מסירים רווחים לבנים בהתחלה ובסוף.
גיבוב (hashing) אין לגבב את city.
administrative_area
פורמט
string
משמש רק ל-Google Analytics.
האזור המנהלי (מדינה או מחוז) שמופיע בכתובת של המשתמש.
אפשר להשתמש בקיצור של שתי אותיות (לדוגמה, ca) או בשם המלא (לדוגמה, california).
ממירים לאותיות קטנות.
הסירו תווים של סמלים.
רווח לבן מסירים רווחים לבנים בהתחלה ובסוף.
גיבוב (hashing) אין לגבב את administrative_area.

IpData דרישות

לאובייקט IpData יש את המאפיינים הבאים.

IpData
ip_address
פורמט
string
כתובת IPv4 או IPv6.
בכתובות IPv6, לא משנה אם משתמשים באותיות רישיות או קטנות.
רווח לבן מסירים רווחים לבנים בהתחלה ובסוף.
גיבוב (hashing) אין לגבב את ip_address.

PairData דרישות

מאכלסים את השדה pair_ids של אובייקט PairData ברשימה של מזהים. כדי להגדיר את הפורמט של כל רכיב ברשימה, פועלים לפי השלבים הבאים:

  1. מגבבים את הפרטים האישיים המזהים (PII) שסופקו על ידי ה-Cleanroom באמצעות אלגוריתם SHA-256.

  2. מצפינים את בייטי הגיבוב באמצעות צופן חילופי של EC, בעזרת מפתח בעל האפליקציה של רשימת המשתמשים ב-PAIR.

  3. מקודדים את הנתונים המוצפנים באמצעות קידוד הקסדצימלי או Base64.

MobileData דרישות

מאכלסים את השדה mobile_ids של אובייקט MobileData ברשימה של Mobile ID (mID). אל תגבבו מזהים של מכשירים ניידים.

פורמט חותמת הזמן

אם משתמשים בפורמט JSON בשדות Timestamp, כמו timestamp ו-last_updated_timestamp של Event, צריך להשתמש בפורמט RFC 3339. הנה כמה דוגמאות לזמן UTC של 8 באוגוסט 2025 בשעה 17: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

  • אזור הזמן של טוקיו, יפן, שמקדים את UTC ב-9 שעות ואין בו שעון קיץ: 2025-08-08T22:18:44.291+09:00

אם משתמשים בפורמט של מאגר אחסון לפרוטוקולים, צריך להגדיר את seconds ואת nanos (אופציונלי) כשיוצרים את Timestamp. אלה הערכים של seconds ו-nanos לפי שעון UTC ב-8 באוגוסט 2025 בשעה 17:18:44.291:

  • seconds: 1754683124

  • nanos: 291000000

קידוד

דרישות הקידוד משתנות בהתאם לאופן שבו אתם מצפינים את נתוני המשתמשים:

תהליכי עבודה של קידוד

  • נתוני משתמשים לא מוצפנים: מקודדים את בייטי הגיבוב של SHA-256 באמצעות קידוד הקסדצימלי (hex) או קידוד Base64.

  • נתוני משתמשים מוצפנים: אם אתם מצפינים את נתוני המשתמשים, אתם צריכים לקודד ב-Base64 את בייטי הגיבוב הגולמיים לפני ההצפנה. אי אפשר להשתמש בקידוד הקסדצימלי לגיבוב שלפני ההצפנה. לאחר מכן אפשר לקודד את המידע המוצפן שנוצר באמצעות קידוד הקסדצימלי או Base64.

הקודם
הגדרת יעדים וכותרות
הבא
הצפנת נתוני משתמשים