Documentazione Experience Platform Guida di Experience Data Model (XDM)

Dettagli sull’iscrizione al segmento gruppo di campi schema

Last update: Mon Dec 18 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Schemas

Creato per:

Developer

NOTE

I nomi di diversi gruppi di campi dello schema sono stati modificati. Vedi il documento su aggiornamenti nome gruppo di campi per ulteriori informazioni.

Dettagli sull’iscrizione al segmento è un gruppo di campi di schema standard per XDM Individual Profile classe. Il gruppo di campi fornisce un singolo campo mappa che acquisisce informazioni relative all’iscrizione al segmento, tra cui i segmenti a cui appartiene l’individuo, la data dell’ultima qualifica e fino a quando l’iscrizione è valida.

WARNING

Mentre il segmentMembership deve essere aggiunto manualmente allo schema del profilo utilizzando questo gruppo di campi, non tentare di compilare o aggiornare manualmente questo campo. Il sistema aggiorna automaticamente segmentMembership mappa ciascun profilo durante l’esecuzione dei processi di segmentazione.

{width="400"}

Proprietà

Tipo di dati

Descrizione

segmentMembership

Mappa

Oggetto mappa che descrive le appartenenze del singolo segmento. La struttura di questo oggetto è descritta in dettaglio di seguito.

Di seguito è riportato un esempio segmentMembership mappa che il sistema ha popolato per un particolare profilo. Le appartenenze ai segmenti sono ordinate per spazio dei nomi, come indicato dalle chiavi a livello di radice dell’oggetto. A sua volta, le singole chiavi sotto ogni spazio dei nomi rappresentano gli ID dei segmenti di cui il profilo è membro. Ogni oggetto segmento contiene diversi sottocampi che forniscono ulteriori dettagli sull’appartenenza:

{
  "xdm:segmentMembership": {
    "AAM": {
      "04a81716-43d6-4e7a-a49c-f1d8b3129ba9": {
        "xdm:version": "15",
        "xdm:lastQualificationTime": "2018-04-26T15:52:25+00:00",
        "xdm:validUntil": "2019-04-26T15:52:25+00:00",
        "xdm:status": "realized",
        "xdm:payload": {
          "xdm:payloadBooleanValue": true,
          "xdm:payloadType": "boolean"
        }
      },
      "53cba6b2-a23b-454a-8069-fc41308f1c0f": {
        "xdm:version": "3",
        "xdm:lastQualificationTime": "2018-04-26T15:52:25+00:00",
        "xdm:validUntil": "2018-04-27T15:52:25+00:00",
        "xdm:status": "realized",
        "xdm:payload": {
          "xdm:payloadPropensityValue": 0.5,
          "xdm:payloadType": "propensity"
        }
      }
    },
    "Email": {
      "abcd@adobe.com": {
        "xdm:version": "1",
        "xdm:lastQualificationTime": "2017-09-26T15:52:25+00:00",
        "xdm:validUntil": "2017-12-26T15:52:25+00:00",
        "xdm:status": "exited"
      }
    }
  }
}

Proprietà

Descrizione

xdm:version

Versione del segmento per il quale il profilo è qualificato.

xdm:lastQualificationTime

Un timestamp dell’ultima volta che questo profilo si è qualificato per il segmento.

xdm:validUntil

Un timestamp indicante quando l’appartenenza al segmento non deve più essere considerata valida. Per i tipi di pubblico esterni, se questo campo non è impostato, l’iscrizione al segmento verrà mantenuta solo per 30 giorni dalla lastQualificationTime.

xdm:status

Campo stringa che indica se l’appartenenza al segmento è stata realizzata come parte della richiesta corrente. Sono accettati i seguenti valori:

realized: il profilo è idoneo per il segmento.
exited: il profilo sta uscendo dal segmento come parte della richiesta corrente.

xdm:payload

Alcune appartenenze a segmenti includono un payload che descrive valori aggiuntivi direttamente correlati all’appartenenza. Per ogni appartenenza è possibile fornire un solo payload di un determinato tipo. xdm:payloadType indica il tipo di payload (boolean, number, propensity, o string), mentre la relativa proprietà di pari livello fornisce il valore per il tipo di payload.

NOTE

Qualsiasi appartenenza a un segmento presente in exited per più di 30 giorni, in base al lastQualificationTime, sarà soggetto a cancellazione.

Per ulteriori dettagli sul gruppo di campi, consulta l’archivio XDM pubblico:

recommendation-more-help

62e9ffd9-1c74-4cef-8f47-0d00af32fc07