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, imposta il campo compositeData su un oggetto CompositeData e imposta il campo userData su un oggetto UserData. Aggiungi una voce separata nell'elenco userIdentifiers per ogni identificatore 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.

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):

Dati di contatto

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

ID mobile

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