Как загрузить участников в аудиторию

Чтобы добавить пользователей в аудиторию на основе списка электронных адресов, отправьте запрос IngestAudienceMembersRequest.

Чтобы настроить и отправить запрос, выполните следующие действия:

1. Задайте для поля termsOfService сообщение TermsOfService, в котором для поля customerMatchTermsOfServiceStatus задано значение ACCEPTED, чтобы подтвердить, что operatingAccount принял Условия использования списков электронных адресов.

2. В каждом элементе AudienceMember списка audienceMembers задайте поле данных в зависимости от типа данных, содержащихся в загрузке:

   • Если загружаемые данные содержат контактную информацию, IP-адреса или и то, и другое, задайте для поля compositeData объект CompositeData. Для контактной информации задайте в поле userData объект UserData и добавьте отдельную запись в список userIdentifiers для каждого идентификатора участника аудитории. Для данных об IP-адресах добавьте запись IpData в список ipData для каждого IP-адреса участника аудитории.

     Хотя userData по-прежнему поддерживается, мы рекомендуем использовать compositeData для подготовки интеграции к будущим улучшениям. Подробнее о составных данных…

   • Если загрузка содержит идентификаторы мобильных устройств, задайте для поля mobileData сообщение MobileData. Добавьте отдельную запись в список mobileIds для каждого электронного удостоверения участника аудитории.

   • Если загрузка содержит идентификаторы пользователей, задайте для поля userIdData сообщение UserIdData и укажите в поле userId идентификатор пользователя для участника аудитории.

3. Отправьте данные о списках электронных адресов, следуя инструкциям в разделе Как отправлять данные об участниках аудитории.

Примеры участников аудитории

В примерах ниже показано, как структурировать объект AudienceMember для каждого типа данных участников. Для каждого объекта AudienceMember в одном запросе должен быть задан один и тот же тип данных идентификатора (compositeData, mobileData или userIdData).

Контактная информация

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    }
  }
}

Данные об IP-адресах

{
  "compositeData": {
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

Контактные данные и IP-адреса

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    },
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

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

{
  "mobileData": {
    "mobileIds": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}

идентификаторы пользователей;

{
  "userIdData": {
    "userId": "user_987654321"
  }
}