[Disponibilité limitée]{class="badge informative"}
Utiliser des données Adobe Experience Platform aep-data
Sur cette page : activez les jeux de données Adobe Experience Platform basés sur des enregistrements pour la recherche afin d’enrichir la personnalisation, la prise de décision et l’orchestration des parcours avec des données de référence et transactionnelles récupérées au moment de l’exécution dans Journey Optimizer.
Journey Optimizer vous permet d’utiliser les données d’Adobe Experience Platform avec les fonctionnalités de personnalisation, de prise de décision et d’orchestration de parcours. Pour ce faire, les jeux de données basés sur des enregistrements nécessaires à la personnalisation de la recherche doivent d’abord être activés pour le service de recherche, comme décrit ci-dessous.
Découvrez comment accéder aux jeux de données et comment les utiliser dans cette section : Commencer avec les jeux de données.
À lire absolument
Mécanismes de sécurisation et directives guidelines
Avant de commencer, consultez les restrictions et les directives suivantes :
-
Pas de DCP dans les jeux de données : les jeux de données activés pour la recherche ne doivent contenir aucune donnée à caractère personnel (DCP).
-
Risque de suppression : les jeux de données utilisés dans la personnalisation ne sont pas protégés contre la suppression. Vous devez effectuer le suivi des jeux de données utilisés pour vous assurer qu’ils ne sont pas supprimés.
-
Type de schéma : les jeux de données doivent être associés à un schéma qui n’est PAS de type Profil ou Événement.
-
Maintenir le bouton (bascule) de recherche activé : évitez d’activer et de désactiver les jeux de données de manière répétée. Cela peut entraîner un comportement d’indexation inattendu. La bonne pratique consiste à laisser le jeu de données activé tant que vous prévoyez de l’utiliser pour les recherches.
-
Région d’activation Edge : les jeux de données activés pour la recherche sont disponibles pour l’activation entrante basée sur Edge uniquement dans la région où réside le sandbox du jeu de données (par exemple, NLD2 ou VA7). Vous pouvez afficher la région du sandbox dans l’interface d’utilisation en regard du nom du sandbox.
-
Suppression d’un lot de données : la suppression d’un lot de données de votre jeu de données supprime complètement toutes les clés correspondantes du service de recherche. Par exemple :
Lot 1 : Sku1, Sku2, Sku3
Lot 2 : Sku1, Sku2, Sku3, Sku4, Sku5, Sku6
Lot 3 : Sku7, Sku8, Sku9, Sku10Si vous supprimez le lot 1, les Sku1, Sku2 et Sku3 sont supprimés du stockage de la recherche. Les données de recherche résultantes contiendront alors : Sku4, Sku5, Sku6, Sku7, Sku8, Sku9, Sku10.
Droit pour le service de recherche
Activer un jeu de données pour la recherche de données enable
Pour utiliser les données d’un jeu de données à des fins de personnalisation, vous devez l’activer pour la recherche.
Conditions préalables prerequisites-enable
Le schéma associé au jeu de données que vous souhaitez activer pour la recherche doit être de type Enregistrement. Le schéma NE doit PAS appartenir à une classe Profil ou Événement.
Une identité principale doit être définie pour le schéma.
Si aucun espace de noms personnalisé n’a été défini, assurez-vous que l’identité est un identifiant qui ne concerne pas une personne.
Activer le jeu de données pour la recherche dans l’interface de gestion des jeux de données
Dans l’interface d’utilisation de la gestion des jeux de données, utilisez le bouton (bascule) pour activer le jeu de données pour la recherche.
Méthode API
Suivez les instructions détaillées dans cette documentation pour configurer votre environnement afin d’envoyer des commandes d’API.
Conditions préalables
-
Les API Adobe Journey Optimizer et Adobe Experience Platform doivent être ajoutées au projet de développement.
-
Vous devez disposer de l’autorisation « Gérer des jeux de données » dans le cadre de votre rôle.
-
Le schéma sur lequel le jeu de données est basé doit contenir une identité principale pouvant servir de clé de recherche.
Structure de l’appel API
curl -s -XPATCH "https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}" \ -H "Authorization: Bearer ${ACCESS_TOKEN}" \ -H "x-api-key: ${API_KEY}" \ -H "x-gw-ims-org-id: ${IMS_ORG}" \ -H "x-sandbox-name: ${SANDBOX_NAME}"
Où :
- L’URL est
https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}. - L’ID du jeu de données est le jeu de données que vous souhaitez activer.
- L’action est Activer OU Désactiver.
- Le jeton d’accès peut être récupéré à partir de Developer Console.
- La clé d’API peut être récupérée à partir de Developer Console.
- L’ID d’organisation IMS est votre organisation Adobe.
- Le nom du sandbox est celui du sandbox dans lequel se trouve le jeu de données (c’est-à-dire prod, dev, etc.).
"error_code": "403003","message": "Api Key is invalid"Surveillance du jeu de données
Une fois qu’un jeu de données a été activé pour la recherche, vous pouvez consulter le statut de l’ingestion dans le service de recherche en accédant au menu Surveillance et en sélectionnant l’onglet Journey Optimizer.
Cet indicateur de processus permet de déterminer quand de nouveaux lots de données sont disponibles dans le service de recherche.
Étapes suivantes
Une fois qu’un jeu de données a été activé pour la recherche à l’aide d’un appel API, vous pouvez utiliser ses données dans les fonctionnalités de personnalisation et de prise de décision de Journey Optimizer. Pour plus d’informations, consultez les sections suivantes :
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to enable record-based Adobe Experience Platform datasets for the lookup service so their data can enrich personalization, Decisioning, and journey orchestration at runtime, including the entitlement guardrails.
Intents:
- Enable a record-based dataset for lookup using the dataset management toggle or the API.
- Meet the prerequisites (record-type schema, primary identity, non-person namespace).
- Review the lookup entitlement limits before designing a lookup strategy.
- Monitor lookup ingestion status.
- Use enabled data with personalization, Decisioning, and journey orchestration.
Glossary:
- Lookup service: the service that retrieves record-based dataset data at runtime for personalization, Decisioning, and journey orchestration (product-specific)
- Lookup dataset: a record-based dataset enabled for lookup (product-specific)
- Primary identity (lookup key): the identity, required on the schema, that acts as the lookup key (product-specific)
- Record-type schema: the required schema type for lookup — a schema that is NOT of Profile or Event class
- Edge activation region: the region (for example, NLD2 or VA7) where the dataset’s sandbox resides, for inbound edge-based activation (product-specific)
Guardrails:
- Enabled Lookup Datasets: maximum 10 per organization, combined across production and development sandboxes (default; if additional volumes are needed, contact your Adobe representative).
- Dataset Record Count: up to 2 million records per dataset, counted as the total across all batches (default; raisable by contacting your Adobe representative).
- Record Size: up to 2 KB per record (default maximum record size supported).
- Dataset Size: up to 4 GB per individual dataset; the record count and dataset size limits are independent guardrails and both must be satisfied (default; raisable by contacting your Adobe representative).
- Dataset Frequency Updates: up to 5 updates per day per dataset (default; raisable by contacting your Adobe representative).
- Datasets enabled for lookup should not contain any Personally Identifiable Information (PII).
- Datasets used in personalization are not protected from deletion; keep track of which datasets are in use.
- The schema must be record-type (NOT of Profile or Event class) and must have a primary identity defined; if a custom namespace is not defined, the identity must be a non-person identifier.
- Keep the lookup toggle on; repeatedly turning datasets on and off can lead to unexpected indexing behavior.
- Datasets enabled for lookup are available for inbound edge-based activation only in the region where the dataset’s sandbox resides.
- Removing a batch of data completely removes all matching keys from the lookup service.
- The data lookup capability is in Limited Availability.
Terminology:
- Canonical name: lookup service — variants: data lookup, enable for lookup
- API ACTION values:
enableORdisable - Do not confuse: a “lookup dataset” (record-type, NOT Profile or Event, not stored on the profile) ≠ a profile or event dataset (Profile or Event class)
- Do not confuse: enabling a dataset for “lookup” ≠ enabling a dataset for “Profile”
FAQ:
- Q: What schema type is required for a lookup dataset? — A record-type schema that is NOT of Profile or Event class, with a primary identity defined that can act as the lookup key.
- Q: How many datasets can I enable for lookup? — Up to 10 per organization, combined across production and development sandboxes; contact your Adobe representative for more.
- Q: What are the record and size limits? — Up to 2 million records and 4 GB per dataset, up to 2 KB per record, and up to 5 updates per day per dataset; the record count and dataset size are independent guardrails that must both be satisfied.
- Q: Can lookup datasets contain PII? — No; datasets enabled for lookup should not contain any Personally Identifiable Information.
- Q: What happens if I delete a batch of data? — All matching keys in that batch are completely removed from the lookup service.
- Q: Should I toggle lookup on and off frequently? — No; repeatedly turning datasets on and off can lead to unexpected indexing behavior, so keep the toggle on while the dataset is in use.