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

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

פורמט של AddressInfo

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

AddressInfo
given_name
פורמט
string
המרת הטקסט לאותיות קטנות.
אל תוסיפו תחיליות כמו Mrs.
רווח לבן הסרת רווחים לבנים בתחילת הטקסט או בסופו.
גיבוב (hashing) מבצעים גיבוב באמצעות אלגוריתם SHA-256. מקודדים את בייטי הגיבוב באמצעות קידוד הקסדצימלי או קידוד Base64.
family_name
פורמט
string
המרת הטקסט לאותיות קטנות.
אל תוסיפו סיומות כמו Jr.
רווח לבן הסרת רווחים לבנים בתחילת הטקסט או בסופו.
גיבוב (hashing) מבצעים גיבוב באמצעות אלגוריתם SHA-256. מקודדים את בייטי הגיבוב באמצעות קידוד הקסדצימלי או קידוד Base64.
region_code
פורמט
string
קוד בן שני תווים בפורמט ISO-3166-1 alpha-2.
רווח לבן הסרת רווחים לבנים בתחילת הטקסט או בסופו.
גיבוב (hashing) אין לבצע גיבוב של region_code.
postal_code
פורמט
string
אפשר להזין מיקוד של ארה"ב וגם של מדינות אחרות.
בכתובות בארה"ב, צריך להשתמש במיקוד בן 5 ספרות או במיקוד בן 5 ספרות ואחריו תוסף בן 4 ספרות. שימוש בתוספת של 4 ספרות עשוי לשפר את אחוז הלקוחות לטירגוט.
לכל שאר המדינות, אין להשתמש בתוספות למיקוד.
רווח לבן הסרת רווחים לבנים בתחילת הטקסט או בסופו.
גיבוב (hashing) לא להשתמש בגיבוב (hash) של postal_code.
address_line
פורמט
string
הפרמטר הזה משמש רק ל-Google Analytics.
הרחוב ומספר הבית של המשתמש.
המרת הטקסט לאותיות קטנות.
להסיר תווים של סמלים.
רווח לבן הסרת רווחים לבנים בתחילת הטקסט או בסופו.
גיבוב (hashing) מבצעים גיבוב באמצעות אלגוריתם SHA-256. מקודדים את בייטי הגיבוב באמצעות קידוד הקסדצימלי או קידוד Base64.
city
פורמט
string
הפרמטר הזה משמש רק ל-Google Analytics.
העיר שמופיעה בכתובת של המשתמש.
המרת הטקסט לאותיות קטנות.
להסיר תווים של סמלים.
רווח לבן הסרת רווחים לבנים בתחילת הטקסט או בסופו.
גיבוב (hashing) לא להשתמש בגיבוב (hash) של 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 שסופקו בחדר הנקי באמצעות אלגוריתם SHA-256.
  2. מצפינים את בייטים הגיבוב באמצעות צופן EC קומוטטיבי, תוך שימוש במפתח של בעל התוכן הדיגיטלי עבור רשימת המשתמשים להתאמה.
  3. מקודדים את הנתונים המוצפנים באמצעות קידוד הקסדצימלי או קידוד Base64.

MobileData דרישות

מאכלסים את השדה mobile_ids של אובייקט MobileData ברשימה של מזהים לנייד. אין לבצע גיבוב של מזהי מכשירים ניידים.

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

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

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

  • seconds: 1754683124
  • nanos: 291000000

קידוד

כשמקודדים נתונים, חשוב לזכור את הדברים הבאים:

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