Paramètres de stockage

Configuration des paramètres de Storage

Pour créer un nouveau storage, il suffit de remplir tous les champs requis du formulaire

• Nommez votre storage : donnez un nom clair à votre storage

• Choisissez la ou les Source(s) et l’environnement

• Sélectionnez la catégorie de Consent : Assurez la conformité avec les réglementations sur la protection des données.

• Sélectionnez l’événement : Choisissez à partir de quel événement vous souhaitez stocker les propriétés

• Sélectionnez les propriétés : Choisissez les propriétés dont vous avez besoin pour votre enrichment. Cliquez sur "Add/Edit Properties"

Un panneau latéral apparaîtra afin de permettre la sélection des propriétés. Dans certains cas, vous devrez peut-être stocker toutes les propriétés. Il suffit d’activer le bouton du haut. Pour enregistrer votre sélection, cliquez simplement sur la croix de fermeture

Le format imbriqué est autorisé, voir Vérifier le format des Properties section

• Définissez une Matching Key : Cette clé unique doit être présente et identique à la fois sur l’événement à enrichir et sur l’événement à stocker.

• Ajouter des filtres (optionnel) : si nécessaire, vous pouvez définir certains filtres pour stocker des événements selon des conditions spécifiques\

  
• Définissez la période de conservation : La durée de stockage est la période pendant laquelle les événements stockés sont conservés dans notre base de données (maximum 730 jours autorisés).

Afin d’éviter un impact inattendu sur la consommation de votre crédit, vous devriez choisir une durée correspondant à votre cas d’usage.

Félicitations ! Vos Storage Settings sont configurés ! N’oubliez pas de Save !

Astuces et conseils

Vérifiez si la propriété existe déjà

Par défaut, un Storage Settings n’enrichira pas une propriété si elle existe déjà dans l’événement à enrichir. Si la propriété existe déjà, mais que vous avez réellement besoin d’en changer la valeur avec votre enrichment, n’oubliez pas de cocher l’option "override" dans votre configuration d’enrichment.

Cette fonctionnalité d’override peut également s’appliquer aux valeurs de tableaux.

Vérifier le format des Properties

Il n’est pas possible d’enrichir une propriété avec un type différent de celui attendu par défaut dans votre enrichment. Exemple de base : Envoyer une valeur Number pour enrichir une propriété de type String storage > "items.product.quantity": 2 >> enrich >> "items.product.color": N/A Cela ne fonctionnera pas, vous obtiendrez une erreur d’avertissement au lieu d’une propriété enrichie. Vous pouvez l’identifier facilement grâce au message suivant dans "details" : 'type error, number cannot replace a string'

Propriétés de Consent

Évitez tout enrichment de la user.consent_categories property. Cela concerne le choix juridique de l’utilisateur concernant la collecte/le suivi des données personnelles. Enrichir cette propriété peut créer un risque de non-conformité.

Warnings Errors

S’il y a une anomalie dans votre storage, vous pourrez voir une propriété "warnings" dans le Live Event Inspector.

Située dans l’événement qui aurait dû être enrichi, si l’enrichment ne s’applique pas comme prévu, vous verrez cette propriété "warnings", avec des détails pour une meilleure compréhension

            warnings: [
                {
                    type: 'enrichment',
                    step: 'saveHit',
                    path: 'event.items',
                    detail: {
                        message: 'type error, object cannot replace array',
                    },
                },
            ],

Cas spécifiques - Objects

Vous pouvez stocker un Object entier (exemple : items.product) mais vous pouvez aussi stocker uniquement une ou plusieurs clé(s) extraites d’un Object (exemple : items.product.price). Si vous enregistrez des clés uniques, assurez-vous que l’événement de destination a déjà l’Object défini. Sinon, la clé unique n’enrichira rien. Le message d’avertissement contiendra le détail suivant : message : 'should merge object properties that do not exist in target'

Réconciliation de Multiple Objects

Si vous stockez une propriété présente dans plusieurs objects, soyez prudent ! Notre mécanisme d’appariement est basé sur les ID. Par exemple, vous avez de nombreux items.product objects et vous devez stocker la propriété items.product.brand . Nous utiliserons le items.product.id comme Matching Key pour remplir les différents items.product objects. S’il n’y a pas de propriété "ID" dans votre object, nous alimenterons simplement dans le même ordre que celui dans lequel il a été stocké. Dans ce cas, les détails "warnings" suivants seront ajoutés à votre enrichment message: 'No ID field found, falling back to index-based merge',

Utilisation de l’override

Soyez prudent lorsque vous utilisez l’option Override ! Remplacer un Object entier bloquera le "non-override" d’une seule clé Exemple de mauvaise pratique :

items.product.color << override: false >> items.product.defaultColor items << override: true >> items

Les données de la items.product.color value sont remplacées car la deuxième ligne est prioritaire.

Bonne pratique : utilisation des filtres

Bien sûr, les filtres définis dans vos destinations seront appliqués. Alors pourquoi devriez-vous utiliser les filtres des Storage Settings ? Nous fournissons les filtres à ce niveau simplement pour vous faire économiser des frais de Storage (consommation de crédit), et pour simplifier le traitement dans vos destinations.

La même qualité d’enrichment, pour moins de frais !