AudienceMember

Członek grupy odbiorców, na którym ma zostać wykonana operacja.

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

string

Opcjonalnie. Określa, do którego Destination ma zostać wysłany członek grupy odbiorców.

consent

object (Consent)

Opcjonalnie. Ustawienie zgody użytkownika.

Pole zbiorcze data. Typ danych identyfikujących, na których ma zostać wykonana operacja. data może mieć tylko jedną z tych wartości:
userData

object (UserData)

Dane przekazywane przez użytkownika, które go identyfikują.

pairData

object (PairData)

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

Ta funkcja jest dostępna tylko dla partnerów zajmujących się danymi.

mobileData

object (MobileData)

Dane identyfikujące urządzenia mobilne użytkownika.

userIdData

object (UserIdData)

Dane związane z unikalnymi identyfikatorami użytkownika określonymi przez reklamodawcę.

ppidData

object (PpidData)

Dane związane z identyfikatorami podawanymi przez wydawcę.

Ta funkcja jest dostępna tylko dla partnerów zajmujących się danymi.

compositeData

object (CompositeData)

Grupa wielu typów identyfikatorów.

PairData

PAIR dla grupy odbiorców. Wymagany jest co najmniej 1 identyfikator PAIR.

Ta funkcja jest dostępna tylko dla partnerów zajmujących się danymi.

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

string

Wymagane. Dane osobowe udostępniane przez Cleanroom, zaszyfrowane za pomocą algorytmu SHA256 i zaszyfrowane za pomocą szyfru przemiennego EC przy użyciu klucza wydawcy na potrzeby listy użytkowników PAIR. W jednym polu AudienceMember można podać maksymalnie 10 wartości pairIds.

MobileData

Identyfikatory mobilne dla grupy odbiorców. Wymagany jest co najmniej 1 identyfikator mobilny.

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

string

Wymagane. Lista identyfikatorów urządzeń mobilnych (identyfikator wyświetlania reklam/IDFA). W jednym polu AudienceMember można podać maksymalnie 10 wartości mobileIds.

UserIdData

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

Zapis JSON
{
  "userId": string
}
Pola
userId

string

Wymagane. Unikalny identyfikator użytkownika określony 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 zajmujących się danymi.

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

string

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

CompositeData

Dane złożone zawierające identyfikatory i powiązane dane użytkownika. Wymagane jest co najmniej 1 z tych pól: userData lub ipData.

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

object (UserData)

Opcjonalnie. Dane przekazywane przez użytkownika, które go identyfikują.

ipData[]

object (IpData)

Opcjonalnie. Dane adresu IP reprezentujące interakcję z klientem, które zostały użyte do utworzenia grupy odbiorców.

IpData

Informacje o adresie IP użytkownika. Aby zwiększyć współczynniki dopasowania w usłudze kierowanie na listę klientów, zalecamy uwzględnienie pól observeStartTime i observeEndTime.

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

string

Wymagane. Adres IP zarejestrowany w momencie interakcji z klientem. Akceptuje standardowe formaty ciągów znaków dla protokołów IPv4 i IPv6.

observeStartTime

string (Timestamp format)

Opcjonalnie. Czas pierwszej zarejestrowanej interakcji z tego adresu IP w ramach 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 ramach 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".