AudienceMember

Участника аудитории, которому будет проведена операция.

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.
}
Поля
destinationReferences[]

string

Необязательный параметр. Определяет, в какое Destination следует направить участника аудитории.

consent

object ( Consent )

Необязательно. Настройки согласия пользователя.

data поля объединения. Тип идентификационных данных, с которыми необходимо выполнить операцию. data могут быть только одним из следующих типов:
userData

object ( UserData )

Данные, предоставленные пользователем, позволяющие идентифицировать пользователя.

pairData

object ( PairData )

Идентификаторы PAIR (Publisher Advertiser Identity Reconciliation) .

Эта функция доступна только партнерам по передаче данных.

mobileData

object ( MobileData )

Данные, идентифицирующие мобильные устройства пользователя.

userIdData

object ( UserIdData )

Данные, относящиеся к уникальным идентификаторам пользователя, определенным рекламодателем.

ppidData

object ( PpidData )

Данные, относящиеся к идентификаторам, предоставленным издателем.

Эта функция доступна только партнерам по передаче данных.

compositeData

object ( CompositeData )

Группа из нескольких типов идентификаторов.

Парные данные

Идентификаторы пар (PAIR ID) для аудитории. Требуется как минимум один идентификатор пары.

Эта функция доступна только партнерам по передаче данных.

JSON-представление
{
  "pairIds": [
    string
  ]
}
Поля
pairIds[]

string

Обязательно. Персональные данные, предоставленные в чистой комнате, хешированные с помощью SHA256 и зашифрованные коммутативным шифром EC с использованием ключа издателя для списка пользователей PAIR . В одном объекте AudienceMember может быть указано не более 10 pairIds .

Мобильные данные

Идентификаторы мобильных телефонов для аудитории. Требуется как минимум один идентификатор мобильного телефона.

JSON-представление
{
  "mobileIds": [
    string
  ]
}
Поля
mobileIds[]

string

Обязательно. Список идентификаторов мобильных устройств (идентификатор рекламы/IDFA). В одном объекте AudienceMember можно указать не более 10 mobileIds .

UserIdData

Данные идентификатора пользователя, содержащие идентификатор пользователя.

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" .