AudienceMember

חבר הקהל שעליו רוצים לבצע את הפעולה.

ייצוג ב-JSON 
{
  "destinationReferences": [
    string
  ],
  "consent": {
    object (Consent)
  },

  // Union field data can be only one of the following:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  }
  // End of list of possible types for union field data.
}
שדות
destinationReferences[]

string

אופציונלי. הגדרת הDestination שאליו יועבר חבר הקהל.
consent

object (Consent)

אופציונלי. הגדרת ההסכמה של המשתמש.
שדה איחוד data. סוג הנתונים המזהים שרוצים לבצע לגביהם פעולה. הערך data יכול להיות רק אחד מהבאים:
userData

object (UserData)

פרטים שהמשתמשים סיפקו ומזהים את המשתמש.
pairData

object (PairData)

מזהים של התאמה בין נתוני המשתמשים של בעלי תוכן דיגיטלי לנתוני לקוחות של מפרסמים (PAIR).

התכונה הזו זמינה רק לשותפי נתונים.
mobileData

object (MobileData)

נתונים שמזהים את המכשירים הניידים של המשתמש.
userIdData

object (UserIdData)

נתונים שקשורים למזהים ייחודיים של משתמש, כפי שהוגדרו על ידי המפרסם.
ppidData

object (PpidData)

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

התכונה הזו זמינה רק לשותפי נתונים.
compositeData

object (CompositeData)

קבוצה של כמה סוגי מזהים.

PairData

מזהי PAIR של הקהל. צריך לציין לפחות מזהה זוג אחד.

התכונה הזו זמינה רק לשותפי נתונים.

ייצוג ב-JSON 
{
  "pairIds": [
    string
  ]
}
שדות
pairIds[]

string

חובה. נתונים של פרטים אישיים מזהים (PII) שסופקו על ידי Cleanroom, עברו גיבוב באמצעות SHA256 והוצפנו באמצעות צופן קומוטטיבי של EC עם מפתח של בעל האתר עבור רשימת המשתמשים של PAIR. אפשר לספק עד 10 pairIds ב-AudienceMember אחד.

MobileData

מזהים לנייד של הקהל. צריך לציין לפחות מזהה אחד לנייד.

ייצוג ב-JSON 
{
  "mobileIds": [
    string
  ]
}
שדות
mobileIds[]

string

חובה. הרשימה של מזהי מכשירים ניידים (מזהה פרסום/IDFA). אפשר לספק עד 10 mobileIds ב-AudienceMember אחד.

UserIdData

נתוני User-ID שמכילים את מזהה המשתמש.

ייצוג ב-JSON 
{
  "userId": string
}
שדות
userId

string

חובה. מזהה ייחודי של משתמש, כפי שהוגדר על ידי המפרסם.

PpidData

נתונים של מזהים שניתנו על ידי בעל התוכן הדיגיטלי (PPID). צריך להזין לפחות מספר PPID אחד.

התכונה הזו זמינה רק לשותפי נתונים.

ייצוג ב-JSON 
{
  "ppids": [
    string
  ]
}
שדות
ppids[]

string

חובה. רשימת המזהים שבעל התוכן הדיגיטלי סיפק לגבי משתמש.

CompositeData

נתונים מורכבים שכוללים מזהים ונתונים משויכים של משתמש. חובה למלא לפחות אחד מהשדות userData או ipData.

ייצוג ב-JSON 
{
  "userData": {
    object (UserData)
  },
  "ipData": [
    {
      object (IpData)
    }
  ]
}
שדות
userData

object (UserData)

אופציונלי. פרטים שהמשתמשים סיפקו ומזהים את המשתמש.
ipData[]

object (IpData)

אופציונלי. נתוני כתובות IP שמייצגים אינטראקציה של לקוחות, שמשמשים ליצירת הקהל.

IpData

מידע על כתובת ה-IP של משתמש. מומלץ לכלול את הפרמטרים observeStartTime ו-observeEndTime כדי לשפר את שיעורי ההתאמה של התכונה 'התאמה ללקוחות'.

ייצוג ב-JSON 
{
  "ipAddress": string,
  "observeStartTime": string,
  "observeEndTime": string
}
שדות
ipAddress

string

חובה. כתובת ה-IP שתועדה בזמן האינטראקציה עם הלקוח. הפונקציה מקבלת פורמטים סטנדרטיים של מחרוזות גם ל-IPv4 וגם ל-IPv6.
observeStartTime

string (Timestamp format)

אופציונלי. מועד האינטראקציה הראשון שנרשם מכתובת ה-IP הזו בסשן.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
observeEndTime

string (Timestamp format)

אופציונלי. המועד האחרון שבו תועדה אינטראקציה מכתובת ה-IP הזו בסשן.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".