AudienceMember

Odbiorca, który ma zostać poddany operacji.

Zapis 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.
}
Pola
destinationReferences[]

string

Opcjonalnie: Określa, na którą Destination ma zostać przekierowany odbiorca.
consent

object (Consent)

Opcjonalnie: Ustawienie zgody użytkownika.
Rodzaj danych identyfikacyjnych, na których ma zostać wykonane działanie. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
userData

object (UserData)

Dane przekazywane przez użytkowników, które identyfikują użytkownika.
pairData

object (PairData)

Identyfikatory dopasowywania danych o tożsamości użytkowników (PAIR).

Ta funkcja jest dostępna tylko dla partnerów ds. danych.
mobileData

object (MobileData)

dane identyfikujące urządzenia mobilne użytkownika;
userIdData

object (UserIdData)

Dane związane z unikalnymi identyfikatorami użytkownika zdefiniowanymi przez reklamodawcę.
ppidData

object (PpidData)

Dane związane z identyfikatorami podawanymi przez wydawców.

Ta funkcja jest dostępna tylko dla partnerów ds. danych.
compositeData

object (CompositeData)

Grupa wielu typów identyfikatorów.
googleUserIdData

object (GoogleUserIdData)

zaszyfrowane identyfikatory użytkowników Google;
partnerProvidedIdData

object (PartnerProvidedIdData)

Identyfikatory podawane przez partnera.
Koniec pól wykluczających się nawzajem.

PairData

Identyfikatory PAIR na liście odbiorców. Wymagany jest co najmniej 1 identyfikator PAIR.

Ta funkcja jest dostępna tylko dla partnerów ds. danych.

Zapis JSON 
{
  "pairIds": [
    string
  ]
}
Pola
pairIds[]

string

Wymagane. Dane umożliwiające identyfikację dostarczone przez usługę data clean room, zaszyfrowane algorytmem SHA256 i zaszyfrowane za pomocą przemiennego szyfru EC z użyciem klucza wydawcy na potrzeby listy użytkowników PAIR. W jednym elemencie AudienceMember można podać maksymalnie 10 wartości pairIds.

UserIdData

Dane identyfikatora użytkownika zawierające identyfikator użytkownika.

Zapis JSON 
{
  "userId": string
}
Pola
userId

string

Wymagane. Unikalny identyfikator użytkownika zdefiniowany przez reklamodawcę.

PpidData

Dane identyfikatorów podawanych przez wydawcę zawierające identyfikatory PPID. Wymagany jest co najmniej 1 identyfikator PPID.

Ta funkcja jest dostępna tylko dla partnerów ds. danych.

Zapis JSON 
{
  "ppids": [
    string
  ]
}
Pola
ppids[]

string

Wymagane. Lista identyfikatorów podawanych przez wydawców dla użytkownika.

CompositeData

Dane złożone zawierające identyfikatory i powiązane dane użytkownika. Trzeba określić co najmniej jedną z tych właściwości: userData lub ipData.

Zapis JSON 
{
  "userData": {
    object (UserData)
  },
  "ipData": [
    {
      object (IpData)
    }
  ]
}
Pola
userData

object (UserData)

Opcjonalnie: Dane przekazywane przez użytkowników, które identyfikują użytkownika.
ipData[]

object (IpData)

Opcjonalnie: Dane adresów IP reprezentujące interakcje klientów, które zostały użyte do utworzenia listy odbiorców.

IpData

Informacje o adresie IP użytkownika. Aby zwiększyć współczynniki dopasowania w przypadku kierowania na listę klientów, zalecamy uwzględnienie parametrów observeStartTime i observeEndTime.

Zapis JSON 
{
  "ipAddress": string,
  "observeStartTime": string,
  "observeEndTime": string
}
Pola
ipAddress

string

Wymagane. Adres IP zarejestrowany w momencie interakcji klienta. Akceptuje standardowe formaty ciągów znaków zarówno w przypadku protokołu IPv4, jak i IPv6.
observeStartTime

string (Timestamp format)

Opcjonalnie: Czas pierwszej zarejestrowanej interakcji z tego adresu IP w sesji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
observeEndTime

string (Timestamp format)

Opcjonalnie: Czas ostatniej zarejestrowanej interakcji z tego adresu IP w sesji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

GoogleUserIdData

Dane identyfikatora użytkownika Google zawierające zaszyfrowane identyfikatory użytkowników Google. Wymagany jest co najmniej 1 identyfikator użytkownika Google.

Zapis JSON 
{
  "googleUserIds": [
    string
  ]
}
Pola
googleUserIds[]

string

Wymagane. Lista zaszyfrowanych identyfikatorów użytkowników Google.

PartnerProvidedIdData

Dane podawane przez partnera zawierające identyfikatory podawane przez partnera. Wymagany jest co najmniej 1 identyfikator dostarczony przez partnera.

Zapis JSON 
{
  "partnerProvidedIds": [
    string
  ]
}
Pola
partnerProvidedIds[]

string

Wymagane. Lista identyfikatorów podanych przez partnera.