Documentation

Paramètres de requête marketing manquants dans les requêtes principales d’AEMaaCS

Last update: Wed Apr 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Dans AEM as a Cloud Service, les paramètres de requête marketing tels que utm_*, cid et bid ne sont pas disponibles pour les servlets ou services principaux. Le réseau CDN supprime ces paramètres avant que les requêtes n’atteignent le Dispatcher ou AEM, ce qui a un impact sur la logique côté serveur qui repose sur ces paramètres pour le traitement commercial. Pour résoudre ce problème, mettez à jour la configuration du réseau CDN pour conserver les paramètres de requête marketing.

Description description

Environnement

  • Produit : Adobe Experience Manager as a Cloud Service - Sites
  • Portée : environnements créés en octobre 2023 ou après (comportement par défaut)

Problème/Symptômes

  • Les paramètres de requête liés au marketing et aux campagnes, tels que utm_source, cid et bid, apparaissent dans les requêtes de navigateur.
  • Ces paramètres de requête n’atteignent pas les servlets ou services principaux.
  • La logique côté serveur ne peut pas accéder aux valeurs des paramètres de requête marketing.

Résolution resolution

Pour résoudre ce problème, procédez comme suit :

  1. Ouvrez le fichier de configuration cdn.yaml pour l’environnement affecté.
  2. Recherchez la section relative à requestTransformations.
  3. Définissez l’indicateur de removeMarketingParams sur false sous requestTransformations.
  4. Enregistrez et validez la configuration mise à jour dans votre référentiel.
  5. Déployez le fichier cdn.yaml mis à jour à l’aide du pipeline de configuration de l’environnement.
  6. Une fois le déploiement terminé, vérifiez que les servlets et services principaux reçoivent les paramètres de requête marketing.

Remarques :

  • Ce comportement s’applique par défaut uniquement aux environnements créés en octobre 2023 ou ultérieurement. Les environnements plus anciens nécessitent une activation explicite.
  • Les scripts côté client exécutés dans les navigateurs continuent d’accéder aux paramètres de requête marketing, car la suppression se produit uniquement au niveau du réseau CDN.
  • Adobe recommande de gérer les paramètres marketing côté client ou de les transmettre par le biais du corps de la requête ou d’en-têtes personnalisés lorsque le traitement du serveur principal les nécessite.
  • Il n’existe aucune date d’application globale pour les environnements créés avant octobre 2023. Activez ce comportement manuellement si nécessaire.

Lecture connexe

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f