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

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

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

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

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

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

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

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

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

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

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

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

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

Электронные удостоверения личности

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