AudienceMember

Odbiorca, który ma być 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 wykluczają się nawzajem. 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 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 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 dla odbiorców. Wymagany jest co najmniej 1 identyfikator PAIR.

Ta funkcja jest dostępna tylko dla partnerów 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 szyfrem przemiennym EC przy użyciu klucza wydawcy na potrzeby listy użytkowników PAIR. W jednym elemencie AudienceMember można podać maksymalnie 10 elementów pairIds.

MobileData

Identyfikatory mobilne 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 na urządzeniach z Androidem, identyfikator IDFA w iOS w przypadku list użytkowników kierowanych na podstawie kierowania na listę klientów oraz identyfikator wyświetlania reklam na urządzeniach z Androidem, identyfikator IDFA w iOS, identyfikator Xbox lub Microsoft, identyfikator Amazon Fire TV, identyfikator Roku, ogólny identyfikator urządzenia w przypadku podstawowych list użytkowników). W jednym elemencie AudienceMember można podać maksymalnie 10 elementów mobileIds.

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 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 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 z klientem. 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 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 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 podane przez partnera zawierające identyfikatory podane 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.