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, pour permettre 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

Le format imbriqué est autorisé, voir Vérifier le format des propriétés section

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

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

  
• Définir 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'utilisation.

Félicitations ! Vos Storage Settings 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 devez vraiment changer la valeur avec votre enrichment, n'oubliez pas de cocher l'option "override" dans votre configuration d'enrichment.

Cette fonctionnalité d'override peut aussi être appliquée aux valeurs de type array.

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 avertissement d'erreur 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. Cela 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é.

Avertissements Erreurs

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 uniquement une ou plusieurs clés extraites d'un Objet (exemple : items.product.price). Si vous enregistrez des clés simples, assurez-vous que l'événement de destination a déjà l'Objet défini. Sinon la clé seule n'enrichira rien. Le message d'avertissement contiendra le détail suivant : message : 'should merge object properties that do not exist in target'

Rapprochement de plusieurs Objets

Si vous stockez une propriété qui apparaît dans plusieurs objets, faites attention ! Notre mécanisme de correspondance est basé sur les ID. Par exemple, vous avez de nombreux items.product objects and you need to store items.product.brand property. Nous utiliserons le items.product.id as matching key to fill the different items.product objects. If there's no "ID" property inside your object, we will simply fed in the same order then it was stored. In this case, the following "warnings" details will be added to your enrichment message: 'No ID field found, falling back to index-based merge',

Utilisation de l'override

Soyez prudent lors de l'utilisation de l'option Override ! Le fait d'overrider un objet entier bloquera le "non-override" d'une clé unique 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 valeur 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 utiliser les filtres des Storage Settings ? Nous fournissons des 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 inférieurs !