Groupe de champs Contenus et Préférences

Contenus et Préférences est un groupe de champs standard pour la XDM Individual Profile classe qui capture les informations de consentement et de préférence pour un client individuel.

Structure du groupe de champs structure

Le groupe de champs Contenus et Préférences fournit un champ de type objet unique, consents, pour capturer les informations de consentement et de préférence. Ce champ étend le type de données Consentement pour la confidentialité, Personalization et préférences marketing, supprimant le champ adID et ajoutant un champ de mappage idSpecific.

Le fichier JSON suivant illustre un exemple du type de données que le groupe de champs Contenus et Préférences peut traiter. Pour plus d’informations sur l’utilisation de la plupart des champs fournis par le groupe de champs, consultez le guide sur le type de données Contenus et Préférences. Les sous-sections ci-dessous portent sur les attributs uniques que le groupe de champs ajoute au type de données.

{
  "consents": {
    "collect": {
      "val": "VI"
    },
    "share": {
      "val": "y"
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "y"
      },
      "email": {
        "val": "y"
      }
    },
    "idSpecific": {
      "ECID": {
        "37784337855396895622558625508046772577": {
          "adID": {
            "val": "n",
          },
          "share": {
            "val": "n"
          },
          "marketing": {
            "push": {
              "val": "n",
              "time": "2020-09-30T01:02:33+00:00",
              "reason": "not relevant"
            }
          }
        }
      },
      "email": {
        "john@xyz.com": {
          "marketing": {
            "email": {
              "val": "y"
            }
          }
        }
      }
    },
    "metadata": {
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}

idSpecific

idSpecific peut être utilisé lorsqu’un consentement ou une préférence spécifique ne s’applique pas universellement à un client, mais est limité à un seul appareil ou à un seul identifiant. Par exemple, un client peut refuser de recevoir des emails à une adresse, tout en autorisant éventuellement l’envoi d’emails à une autre.

Chaque clé de l’objet idSpecific représente un espace de noms d’identité spécifique reconnu par Adobe Experience Platform Identity Service. Bien que vous puissiez définir vos propres espaces de noms personnalisés pour classer différents identifiants, il est recommandé d’utiliser l’un des espaces de noms standard fournis par Identity Service pour réduire les tailles de stockage pour Real-Time Customer Profile. Pour plus d’informations sur les espaces de noms d’identité, consultez la présentation des espaces de noms d’identité dans la documentation Identity Service.

Les clés de chaque objet d’espace de noms représentent les valeurs d’identité uniques pour lesquelles le client a défini des préférences. Chaque valeur d’identité peut contenir un ensemble complet de consentements et de préférences, formaté de la même manière que consents.

"idSpecific": {
  "email": {
    "jdoe@example.com": {
      "marketing": {
        "email": {
          "val": "n"
        }
      }
    }
  },
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}

Dans les objets marketing fournis dans la section idSpecific, les champs any et preferred ne sont pas pris en charge. Ces champs ne peuvent être configurés qu’au niveau de l’utilisateur. En outre, les préférences marketing idSpecific pour email, sms et push ne prennent pas en charge les champs subscriptions.

Il existe également un consentement qui ne peut être fourni que dans la section idSpecific : adID. Ce champ est traité dans la sous-section ci-dessous.

adID

Le consentement adID représente le consentement du client pour savoir si un ID d’annonceur (IDFA ou GAID) peut être utilisé pour lier le client à travers les applications de cet appareil. Cette valeur ne peut être configurée que sous l’espace de noms d’identité ECID de la section idSpecific et ne peut pas être définie pour d’autres espaces de noms ou au niveau de l’utilisateur pour ce groupe de champs.

"idSpecific": {
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}

Ingestion de données à l’aide du groupe de champs ingest

Pour utiliser le groupe de champs Contenus et Préférences afin d’ingérer des données de consentement de vos clients, vous devez créer un jeu de données basé sur un schéma qui contient ce groupe de champs.

Consultez le tutoriel sur la création d’un schéma dans l’interface utilisateur pour savoir comment attribuer des groupes de champs à des champs. Une fois que vous avez créé un schéma contenant un champ avec le groupe de champs Contenus et Préférences, reportez-vous à la section sur la création d’un jeu de données du guide de l’utilisateur du jeu de données, en suivant les étapes de création d’un jeu de données avec un schéma existant.

Gestion des modifications du consentement et des préférences

Lorsqu’un client modifie ses consentements ou ses préférences sur votre site web, ces modifications doivent être collectées et appliquées immédiatement à l’aide du SDK Web Adobe Experience Platform. Si un client choisit de ne pas participer à la collecte de données, toute collecte de données doit immédiatement cesser. Si un client s’exclut de la personnalisation, aucune personnalisation ne doit être présente sur la page suivante qu’il consulte.

Étapes suivantes

Ce document couvrait la structure et l’utilisation du groupe de champs Contenus et Préférences. Pour plus d’informations sur les autres champs fournis par le groupe de champs, consultez le document sur le type de données Consentement pour la confidentialité, Personalization et préférences marketing.