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 l'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, imposta il compositeData campo su un CompositeData oggetto e imposta il relativo userData campo su un UserData oggetto. 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 l'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.

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

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

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

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