AudienceMember

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  },
  "googleUserIdData": {
    object (GoogleUserIdData)
  },
  "partnerProvidedIdData": {
    object (PartnerProvidedIdData)
  }
  // End of mutually exclusive fields.
}
שדות
destinationReferences[]

string

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

object (Consent)

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

object (UserData)

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

object (PairData)

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

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

object (MobileData)

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

object (UserIdData)

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

object (PpidData)

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

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

object (CompositeData)

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

object (GoogleUserIdData)

מזהי משתמשים מוצפנים ב-Google.
partnerProvidedIdData

object (PartnerProvidedIdData)

מזהים שסופקו על ידי שותף.
סוף השדות הבלעדיים.

PairData

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

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

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

string

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

MobileData

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

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

string

חובה. רשימת מזהי מכשירים ניידים (מזהה פרסום ב-Android, מזהה IDFA ב-iOS לרשימות משתמשים מסוג 'התאמה ללקוחות', מזהה פרסום ב-Android, מזהה IDFA ב-iOS, מזהה Xbox או Microsoft, מזהה Amazon Fire TV, מזהה Roku, מזהה מכשיר כללי לרשימות משתמשים בסיסיות). אפשר לספק עד 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".

GoogleUserIdData

נתונים של מזהי משתמשים ב-Google שמכילים מזהי משתמשים מוצפנים ב-Google. צריך לציין לפחות מזהה משתמש אחד ב-Google.

ייצוג JSON 
{
  "googleUserIds": [
    string
  ]
}
שדות
googleUserIds[]

string

חובה. רשימה של מזהי משתמשי Google מוצפנים.

PartnerProvidedIdData

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

ייצוג JSON 
{
  "partnerProvidedIds": [
    string
  ]
}
שדות
partnerProvidedIds[]

string

חובה. רשימת המזהים שסופקו על ידי השותף.