Ingestion par lots partielle

L’ingestion par lots partielle permet d’ingérer des données contenant des erreurs jusqu’à un certain seuil. Grâce à cette fonctionnalité, les utilisateurs peuvent ingérer toutes leurs données correctes dans Adobe Experience Platform, alors que toutes leurs données incorrectes sont traitées par lots séparément, avec des détails sur les raisons de leur non-validité.

Ce document fournit un tutoriel pour la gestion de l’ingestion par lots partielle.

Prise en main

Ce tutoriel nécessite une connaissance pratique des différents services Adobe Experience Platform impliqués dans l’ingestion par lots partielle. Avant de commencer ce tutoriel, veuillez consulter la documentation relative aux services suivants :

  • Ingestion par lots Platform : méthode d’ingestion et de stockage de données de fichiers, par exemple de type CSV et Parquet, dans
  • Experience Data Model (XDM) : cadre normalisé selon lequel Platform organise les données de l’expérience client.

Les sections suivantes apportent des informations supplémentaires dont vous aurez besoin pour passer avec succès des appels à Platform API.

Lecture d’exemples d’appels API

Ce guide fournit des exemples d’appels API pour démontrer comment formater vos requêtes. Il s’agit notamment de chemins d’accès, d’en-têtes requis et de payloads de requêtes correctement formatés. L’exemple JSON renvoyé dans les réponses de l’API est également fourni. Pour plus d’informations sur les conventions utilisées dans la documentation pour les exemples d’appels d’API, voir la section concernant la lecture d’exemples d’appels d’API dans le guide de dépannage Experience Platform.

Collecte des valeurs des en-têtes requis

Pour lancer des appels aux API Platform, vous devez d’abord suivre le tutoriel d’authentification. Le tutoriel d’authentification fournit les valeurs de chacun des en-têtes requis dans tous les appels d’API Experience Platform, comme indiqué ci-dessous :

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key : {API_KEY}
  • x-gw-ims-org-id : {ORG_ID}

Dans Experience Platform, toutes les ressources sont isolées dans des environnements de test virtuels spécifiques. Toutes les requêtes envoyées aux API Platform nécessitent un en-tête spécifiant le nom de l’environnement de test dans lequel l’opération sera effectuée :

  • x-sandbox-name : {SANDBOX_NAME}
REMARQUE

Pour plus d’informations sur les environnements de test dans Platform, consultez la documentation de présentation des environnements de test.

Activation d’un lot pour l’ingestion par lots partielle dans l’API

REMARQUE

Cette section décrit l’activation d’un lot pour l’ingestion par lots partielle à l’aide de l’API. Pour plus d’informations sur l’utilisation de l’interface utilisateur, veuillez lire la section Activation d’un lot pour l’ingestion par lots partielle dans l’interface utilisateur étape .

Vous pouvez créer un nouveau lot avec l’ingestion partielle activée.

Pour créer un nouveau lot, suivez les étapes de la section guide de développement de l’ingestion par lots. Une fois que vous avez atteint le Créer un lot ajoutez le champ suivant dans le corps de la requête :

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}
Propriété Description
enableErrorDiagnostics Indicateur qui autorise Platform pour générer des messages d’erreur détaillés sur votre lot.
partialIngestionPercent Pourcentage d’erreurs acceptables avant le rejet de l’ensemble du lot. Ainsi, dans cet exemple, un maximum de 5 % du lot peut être des erreurs, avant l’échec.

Activation d’un lot pour l’ingestion par lots partielle dans l’interface utilisateur

REMARQUE

Cette section décrit l’activation d’un lot pour l’ingestion par lots partielle à l’aide de l’interface utilisateur. Si vous avez déjà activé un lot pour l’ingestion par lots partielle à l’aide de l’API, vous pouvez passer à la section suivante.

Pour activer un lot en vue d’une ingestion partielle par le biais de l’option Platform Dans l’interface utilisateur, vous pouvez créer un nouveau lot par le biais des connexions source, créer un nouveau lot dans un jeu de données existant ou créer un nouveau lot par le biais de l’optionMappage du fichier CSV au flux XDM".

Création d’une connexion source

Pour créer une connexion source, procédez comme indiqué dans la section Présentation des sources. Une fois que vous avez atteint le Détails du flux de données , notez la Ingestion partielle et Diagnostics d’erreur champs.

Le bouton Ingestion partielle vous permet d’activer ou de désactiver l’utilisation de l’ingestion par lots partielle.

Le Diagnostics d’erreur le bouton bascule n’apparaît que lorsque la fonction Ingestion partielle est désactivé. Cette fonctionnalité permet Platform pour générer des messages d’erreur détaillés sur vos lots ingérés. Si la variable Ingestion partielle est activé, des diagnostics d’erreur améliorés sont automatiquement appliqués.

Le seuil d’erreur vous permet de définir le pourcentage d’erreurs acceptables avant le rejet de l’ensemble du lot. Par défaut, cette valeur est définie sur 5 %.

Utiliser un jeu de données existant

Pour utiliser un jeu de données existant, commencez par sélectionner un jeu de données. La barre latérale droite contient des informations sur le jeu de données.

Le bouton Ingestion partielle vous permet d’activer ou de désactiver l’utilisation de l’ingestion par lots partielle.

Le Diagnostics d’erreur le bouton bascule n’apparaît que lorsque la fonction Ingestion partielle est désactivé. Cette fonctionnalité permet Platform pour générer des messages d’erreur détaillés sur vos lots ingérés. Si la variable Ingestion partielle est activé, des diagnostics d’erreur améliorés sont automatiquement appliqués.

Le seuil d’erreur vous permet de définir le pourcentage d’erreurs acceptables avant le rejet de l’ensemble du lot. Par défaut, cette valeur est définie sur 5 %.

Désormais, vous pouvez transférer des données à l’aide du Ajouter des données et il sera ingéré à l’aide de l’ingestion partielle.

Utilisez leMappage du fichier CSV au schéma XDMFlux "

Pour utiliser leMappage du fichier CSV au schéma XDM", suivez les étapes répertoriées dans la section Mappage d’un tutoriel sur les fichiers CSV. Une fois que vous avez atteint le Ajouter des données , notez la Ingestion partielle et Diagnostics d’erreur champs.

Le bouton Ingestion partielle vous permet d’activer ou de désactiver l’utilisation de l’ingestion par lots partielle.

Le Diagnostics d’erreur le bouton bascule n’apparaît que lorsque la fonction Ingestion partielle est désactivé. Cette fonctionnalité permet Platform pour générer des messages d’erreur détaillés sur vos lots ingérés. Si la variable Ingestion partielle est activé, des diagnostics d’erreur améliorés sont automatiquement appliqués.

Seuil d'erreurs vous permet de définir le pourcentage d’erreurs acceptables avant l’échec de l’ensemble du lot. Par défaut, cette valeur est définie sur 5 %.

Étapes suivantes

Ce tutoriel explique comment créer ou modifier un jeu de données pour activer l’ingestion par lots partielle. Pour plus d’informations sur l’ingestion par lots, consultez le guide de développement de l’ingestion par lots.

Pour plus d’informations sur la surveillance des erreurs d’ingestion partielle, veuillez lire la section guide de diagnostic des erreurs d’ingestion par lots.

Sur cette page