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)
  },
  "googleUserIdData": {
    object (GoogleUserIdData)
  },
  "partnerProvidedIdData": {
    object (PartnerProvidedIdData)
  }
  // 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 )

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

googleUserIdData

object ( GoogleUserIdData )

Зашифрованные идентификаторы пользователей Google.

partnerProvidedIdData

object ( PartnerProvidedIdData )

Идентификаторы, предоставленные партнерами.

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

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

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

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

string

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

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

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

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

string

Обязательно. Список идентификаторов мобильных устройств (рекламный идентификатор Android, IDFA для списков пользователей Customer Match и рекламный идентификатор Android, IDFA для iOS, идентификатор Xbox или Microsoft, идентификатор Amazon Fire TV, идентификатор Roku, универсальный идентификатор устройства для базовых списков пользователей). В одном объекте 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" .

GoogleUserIdData

Данные идентификаторов пользователей Google содержат зашифрованные идентификаторы пользователей Google. Требуется как минимум один идентификатор пользователя Google.

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

string

Обязательно. Список зашифрованных идентификаторов пользователей Google.

PartnerProvidedIdData

Данные, предоставленные партнером и содержащие идентификаторы, также предоставленные партнером. Необходимо наличие как минимум одного идентификатора, предоставленного партнером.

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

string

Обязательно. Список идентификаторов, предоставленных партнером.