Cómo subir miembros a un público

Sube miembros a un público de Segmentación por clientes enviando una solicitud IngestAudienceMembersRequest.

Para configurar y enviar la solicitud, completa los siguientes pasos:

1. Establece el campo termsOfService en un mensaje TermsOfService con customerMatchTermsOfServiceStatus establecido en ACCEPTED para confirmar que el operatingAccount aceptó las Condiciones del Servicio de Segmentación por clientes.

2. En cada AudienceMember de la lista audienceMembers, configura el campo de datos según el tipo de datos que contenga la carga:

   • Si la carga contiene información de contacto, datos de direcciones IP o ambos, establece el campo compositeData en un objeto CompositeData. En el caso de la información de contacto, establece su campo userData en un objeto UserData y agrega una entrada independiente en la lista userIdentifiers para cada identificador del miembro del público. En el caso de los datos de direcciones IP, agrega una entrada IpData en la lista ipData para cada dirección IP del miembro del público.

     Si bien aún se admite userData, te recomendamos que uses compositeData para asegurarte de que tu integración esté preparada para futuras mejoras. Consulta Datos compuestos para obtener más detalles.

   • Si la carga contiene IDs de dispositivos móviles, establece el campo mobileData en un mensaje MobileData. Agrega una entrada independiente en la lista mobileIds para cada ID de dispositivo móvil del miembro del público.

   • Si la carga contiene IDs de usuario, establece el campo userIdData en un mensaje UserIdData y establece su campo userId en el ID de usuario del miembro del público.

3. Envía datos de Segmentación por clientes siguiendo los pasos que se indican en Envía miembros del público.

Miembros del público de muestra

En los siguientes ejemplos, se muestra cómo estructurar un objeto AudienceMember para cada tipo de datos de miembro. Cada AudienceMember en una sola solicitud debe tener configurado el mismo tipo de datos de ID (compositeData, mobileData o userIdData):

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

{
  "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"
      }
    ]
  }
}

{
  "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"
  }
}