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 אחד.

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

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