Paramètres de stockage

Configuration des paramètres de stockage

Pour créer un nouveau storage, remplissez simplement tous les champs requis du formulaire

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

• Choisissez la/les Source(s) et l'Environnement

• Sélectionnez la catégorie de Consentement : Assurez la conformité avec les réglementations sur la confidentialité 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, permettant la sélection des propriétés. Dans certains cas, vous devrez peut-être stocker toutes les propriétés. Activez simplement le bouton en haut. Pour enregistrer votre sélection, cliquez simplement sur la croix de fermeture

• Définir une clé de correspondance : Cette clé unique doit être présente et identique à la fois dans l'événement à enrichir et dans l'événement à stocker.

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

  
• Définir la période de rétention : 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).

Félicitations ! Vos paramètres de Storage sont configurés ! N'oubliez pas d'enregistrer !

Astuces et conseils

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

Nativement, 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 vraiment besoin de 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 être appliquée aux valeurs de type tableau.

Vérifier le format des propriétés

Il n'est pas possible d'enrichir une propriété avec un type différent de celui attendu dans votre enrichment. Exemple basique : 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 un warning error au lieu d'une propriété enrichie. Vous pouvez l'identifier facilement, avec le message suivant dans "details": 'type error, number cannot replace a string'

Propriétés de Consentement

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

Erreurs d'avertissement

S'il y a une anomalie dans votre storage, vous pouvez 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", incluant des détails pour une compréhension facile

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

Cas spécifiques - Objets

Vous pouvez stocker un Objet entier, (exemple : items.product) mais vous pouvez aussi stocker seulement une ou plusieurs clés extraites d'un Objet (exemple : items.product.price). Si vous sauvegardez des clés individuelles, assurez-vous que l'événement de destination a déjà l'Objet défini. Sinon la clé individuelle 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 plusieurs Objets

Si vous stockez une propriété qui apparaît dans plusieurs objets, faites attention ! Notre mécanisme de matching est basé sur les ID. Par exemple, vous avez de nombreux items.product objects et vous avez besoin de stocker items.product.brand property. Nous utiliserons le items.product.id comme clé de correspondance pour remplir les différents items.product objects. S'il n'y a pas de propriété "ID" dans votre objet, nous l'alimenterons simplement dans le même ordre que celui dans lequel il a été stocké. Dans ce cas, le détail suivant "warnings" sera ajouté à votre enrichment message: 'No ID field found, falling back to index-based merge',

Usage de l'override

Faites attention lors de l'utilisation de l'option Override ! L'override d'un objet entier bloquera la non-suppression ("non-override") d'une clé individuelle Exemple d'une mauvaise pratique :

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

Les données de la items.product.color value sont écrasées parce que la deuxième ligne a la priorité.

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 sur vos destinations.

Même qualité d'enrichment, pour des frais réduits !