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 audienceMembers lista, establece el campo de datos según el tipo de datos que contiene la carga:

   • Si la carga contiene información de contacto, establece el compositeData campo en un CompositeData objeto, y establece su userData campo en un UserData objeto. Agrega una entrada independiente en la lista userIdentifiers para cada identificador del miembro del público.

     Si bien userData aún es compatible, 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 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.

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 miembro. Cada AudienceMember de una sola solicitud debe tener el mismo tipo de conjunto de datos de ID (compositeData, mobileData):

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

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