Cómo subir miembros a un público

Envía un IngestAudienceMembersRequest para subir miembros a un público de la Segmentación por clientes.

Para configurar y enviar la solicitud, sigue estos pasos:

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

2. En cada AudienceMember de la lista audienceMembers, establece 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. Para la información de contacto, establece su userData campo en un UserData objeto y agrega una entrada independiente en la lista userIdentifiers para cada identificador del miembro del público. Para los datos de direcciones IP, agrega una IpData entrada en la ipData lista para cada dirección IP del miembro del público.

     Si bien userData aún es compatible, te recomendamos usar compositeData para asegurarte de que tu integración esté preparada para futuras mejoras. Consulta Datos compuestos datos para obtener más información.

   • Si la carga contiene IDs de dispositivos móviles, establece el mobileData campo en un MobileData mensaje. 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 userIdData campo en un UserIdData mensaje, y establece su userId campo en el ID de usuario del miembro del público.

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

Ejemplo de miembros del público

En los siguientes ejemplos, se muestra cómo estructurar un AudienceMember objeto para cada tipo de datos de miembros. Cada AudienceMember de una sola solicitud debe tener el mismo tipo de conjunto 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"
  }
}