Bonnes pratiques pour Dynamic Datastream Configurations

Utilisez ces pratiques lorsque vous concevez et utilisez des règles Dynamic Datastream Configuration. Ils vous aident à gérer les mécanismes de sécurisation système, à éviter les erreurs courantes et à maintenir des configurations faciles à comprendre et à résoudre les problèmes.

Conception de règle rule-design

Utiliser des flux de données distincts par source d’événement. Pensez à créer un flux de données pour Web SDK, un pour Mobile SDK et un pour l’API Server. Si vos données proviennent d’une autre source ou utilisent un autre schéma XDM, créez un flux de données distinct. Un flux de données dédié avec ses propres jeux de données correspondants améliore la traçabilité et simplifie la résolution des problèmes. Les règles de configuration des trains de données dynamiques gèrent ensuite le routage dans chaque train de données.

Simplifiez et aplatissez les règles. Les configurations de train de données dynamiques ne prennent pas en charge les expressions logiques imbriquées. Si votre logique nécessite l’imbrication, divisez-la en plusieurs règles aplaties. Des règles plus simples sont plus rapides à évaluer, plus faciles à auditer et moins susceptibles de produire des correspondances inattendues.

Utilisez eventType comme condition principale. eventType est le discriminateur le plus fiable et le plus performant pour les décisions de routage. Il est systématiquement renseigné sur les implémentations de Web SDK, Mobile SDK et de l’API du serveur et possède un ensemble de valeurs bien défini. Pratiquement tous les cas d’utilisation doivent commencer par une condition basée sur eventType, éventuellement combinée à des conditions secondaires.

Classer les règles par priorité : Consommable en premier, puis Exploitable, puis Analytique. Comme Edge Network utilise une évaluation first-match-wins, l’ordre de vos règles détermine le résultat pour les événements qui peuvent correspondre à plusieurs conditions.

Ordre recommandé :

Placer des règles consommables permet de s’assurer que Edge Network intercepte le trafic nuisible ou opérationnel avant de prendre des décisions de routage coûteuses telles que l’ingestion de profils ou la personnalisation entrante.

Concevez votre itinéraire par défaut de manière prudente. Configurez le jeu de données d’événement de Adobe Experience Platform par défaut du flux de données en un jeu de données non activé pour le profil. Les événements inattendus ou non classés arrivent ensuite dans le lac de données au lieu de gonfler votre banque de profils. Vous pouvez toujours ajouter une règle spécifique pour promouvoir un type d’événement récemment découvert dans le profil une fois que vous l’avez classé.

Stratégie du jeu de données dataset-strategy

Créer des jeux de données avant de configurer des règles. Tous les jeux de données cibles doivent exister avec le schéma correct avant de les référencer dans les configurations de routage. Après avoir validé vos règles à l’aide d’Assurance, activez le profil, configurez la conservation des données et mettez à jour votre connexion Customer Journey Analytics.

Pour obtenir des conseils sur la configuration de la conservation des données, consultez le ​ Guide de conservation des jeux de données des événements Experience ​.

Utilisez une convention de nommage cohérente. Des noms de jeux de données clairs facilitent l’identification de l’objectif de chaque jeu de données lors de la révision de votre configuration ou de la surveillance de l’ingestion. Un modèle recommandé :

Aligner votre connexion Customer Journey Analytics sur votre stratégie de jeu de données. Après avoir configuré Dynamic Datastream Configuration routage des règles et des événements vers des jeux de données distincts, mettez à jour votre connexion Customer Journey Analytics pour inclure uniquement les jeux de données qui doivent être utilisés dans les rapports. Excluez les jeux de données de quarantaine pour le trafic de robots et les événements système. Pour plus d’informations, consultez la documentation sur les connexions 🔗.

Pratiques opérationnelles operational

Compter 15 minutes pour que les modifications se propagent. Les modifications apportées à la configuration des flux de données, y compris les règles de Dynamic Datastream Configuration nouvelles ou mises à jour, prennent jusqu’à 15 minutes pour se propager dans Edge Network. Ne pas tester immédiatement après avoir enregistré les modifications. Patientez dans la fenêtre de propagation complète avant d’exécuter les sessions Assurance ou de comparer les volumes d’ingestion du jeu de données.

Supprimez les remplacements côté client avant d’activer les règles. Remplacements de la configuration des trains de données ont priorité sur les règles de Dynamic Datastream Configuration. Tout événement qui comporte un remplacement côté client contourne vos règles de manière silencieuse, sans erreur ni avertissement. Avant d’activer les règles, vérifiez l’implémentation de votre SDK web ou de Mobile SDK pour supprimer les edgeConfigOverrides des appels sendEvent et configure pour les événements que Dynamic Datastream Configurations devez gérer.

Surveiller après le déploiement. Après avoir activé les règles en production, surveillez les éléments suivants pour confirmer un comportement correct :

Étapes suivantes