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, establece el campo de datos según el tipo de datos que contiene 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 userData todavía se admite, 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 miembros. Cada AudienceMember en una sola solicitud debe tener configurado el mismo tipo de datos de ID (compositeData, mobileData o userIdData):

Información de contacto

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

Datos de direcciones 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"
      }
    ]
  }
}

Datos de contacto y de 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"
      }
    ]
  }
}

Documentos de identidad digitales

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

IDs de usuario

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