Caricare membri in un segmento di pubblico

Carica i membri in un segmento di pubblico Customer Match inviando un IngestAudienceMembersRequest.

Per configurare e inviare la richiesta, completa i seguenti passaggi:

1. Imposta il campo termsOfService su un messaggio TermsOfService con customerMatchTermsOfServiceStatus impostato su ACCEPTED per confermare che operatingAccount ha accettato i Termini di servizio di Customer Match.

2. In ogni AudienceMember nell'elenco audienceMembers, imposta il campo di dati in base al tipo di dati contenuti nel caricamento:

   • Se il caricamento contiene dati di contatto, dati dell'indirizzo IP o entrambi, imposta il campo compositeData su un oggetto CompositeData. Per le informazioni di contatto, imposta il campo userData su un oggetto UserData e aggiungi una voce separata nell'elenco userIdentifiers per ogni identificatore del membro del segmento di pubblico. Per i dati degli indirizzi IP, aggiungi una voce IpData nell'elenco ipData per ogni indirizzo IP del membro del segmento di pubblico.

     Anche se userData è ancora supportato, ti consigliamo di utilizzare compositeData per assicurarti che la tua integrazione sia pronta per i miglioramenti futuri. Per maggiori dettagli, consulta Dati compositi.

   • Se il caricamento contiene identità digitali, imposta il campo mobileData su un messaggio MobileData. Aggiungi una voce separata nell'elenco mobileIds per ogni identità digitale del membro del segmento di pubblico.

   • Se il caricamento contiene ID utente, imposta il campo userIdData su un messaggio UserIdData e imposta il campo userId sull'ID utente del membro del segmento di pubblico.

3. Invia i dati Customer Match seguendo i passaggi descritti in Invia i membri del segmento di pubblico.

Membri del segmento di pubblico di esempio

I seguenti esempi mostrano come strutturare un oggetto AudienceMember per ogni tipo di dati dei membri. Ogni AudienceMember in una singola richiesta deve avere lo stesso tipo di dati ID impostato (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"
  }
}