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, procedi nel seguente modo:

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

2. In ogni AudienceMember nell' audienceMembers elenco, imposta il campo 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 i dati di contatto, imposta il campo userData su un UserData oggetto e aggiungi una voce separata nell' elenco userIdentifiers per ogni identificatore del membro del segmento di pubblico. Per i dati dell'indirizzo IP, aggiungi una IpData voce nell'ipData elenco 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 MobileData messaggio. 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 userIdData campo su un UserIdData messaggio, 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 Inviare i membri del segmento di pubblico.

Esempio di membri del segmento di pubblico

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