DocumentationExperience PlatformGuide de modèle de données d’expérience (XDM)

Détails sur l’appartenance à un segment groupe de champs de schéma

Last update: Sat Feb 01 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur
NOTE
Les noms de plusieurs groupes de champs de schéma ont changé. Pour plus d’informations, consultez le document sur les mises à jour des noms de groupes de champs.

Détails de l’appartenance à un segment est un groupe de champs de schéma standard pour la XDM Individual Profile classe. Le groupe de champs fournit un champ de mappage unique qui recueille des informations sur l’appartenance au segment, notamment les segments auxquels appartient la personne, l’heure de la dernière qualification et la date de validité de l’abonnement.

WARNING
Bien que le champ segmentMembership doive être ajouté manuellement à votre schéma de profil à l’aide de ce groupe de champs, vous ne devez pas tenter de renseigner ou de mettre à jour manuellement ce champ. Le système met automatiquement à jour la carte des segmentMembership pour chaque profil au fur et à mesure que les tâches de segmentation sont effectuées.

segmentation des profils {width="400"}

Propriété
Type de données
Description
segmentMembership
Carte
Objet map qui décrit les appartenances à un segment de l’individu. La structure de cet objet est décrite en détail ci-dessous.

Voici un exemple segmentMembership mappage que le système a renseigné pour un profil particulier. Les appartenances aux segments sont triées par espace de noms, comme indiqué par les clés de niveau racine de l’objet . De même, les clés individuelles sous chaque espace de noms représentent les identifiants des segments dont le profil est membre. Chaque objet de segment contient plusieurs sous-champs qui fournissent des détails supplémentaires sur l’appartenance :

{
  "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"
      }
    }
  }
}
Propriété
Description
xdm:version
Version du segment pour lequel ce profil s’est qualifié.
xdm:lastQualificationTime
Date et heure de la dernière qualification de ce profil pour le segment.
xdm:validUntil
Date et heure auxquelles l’appartenance à un segment ne doit plus être considérée comme valide. Pour les audiences externes, si ce champ n’est pas défini, l’appartenance à un segment n’est conservée que pendant 30 jours à compter de la lastQualificationTime.
xdm:status

Un champ de chaîne qui indique si l’appartenance à un segment a été réalisée dans le cadre de la requête actuelle. Les valeurs suivantes sont acceptées :

  • realized : le profil est qualifié pour le segment.
  • exited : le profil quitte le segment dans le cadre de la requête actuelle.
xdm:payload
Certains abonnements de segment incluent une payload qui décrit des valeurs supplémentaires directement liées à l’abonnement. Une seule payload d’un type donné peut être fournie pour chaque abonnement. xdm:payloadType indique le type de payload (boolean, number, propensity ou string), tandis que sa propriété frère fournit la valeur pour le type de payload.
NOTE
Toute appartenance à un segment avec le statut exited pendant plus de 30 jours, selon le lastQualificationTime, peut être supprimée.

Pour plus d’informations sur le groupe de champs , consultez le référentiel XDM public :

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07