DocumentazioneExperience Cloud KCS

Parametri delle query di marketing mancanti nelle richieste back-end in AEMaaCS

Ultimo aggiornamento: 24 giugno 2026

In AEM as a Cloud Service, i parametri delle query di marketing come utm_*, cid e bid non sono disponibili per i servlet o i servizi di back-end. La rete CDN rimuove questi parametri prima che le richieste raggiungano Dispatcher o AEM, il che influisce sulla logica lato server che si basa su di essi per l’elaborazione aziendale. Per risolvere questo problema, aggiorna la configurazione CDN in modo da mantenere i parametri delle query di marketing.

Descrizione description

Ambiente

  • Prodotto: Adobe Experience Manager as a Cloud Service - Sites
  • Ambito: ambienti creati a ottobre 2023 o versione successiva (comportamento predefinito)

Problema/Sintomi

  • I parametri di query relativi al marketing e alla campagna come utm_source, cid e bid vengono visualizzati nelle richieste del browser.
  • Questi parametri di query non raggiungono i servlet o i servizi back-end.
  • La logica lato server non può accedere ai valori dei parametri delle query di marketing.

Risoluzione resolution

Per risolvere il problema, effettua le seguenti operazioni:

  1. Aprire il file di configurazione cdn.yaml per l’ambiente interessato.
  2. Individuare la sezione relativa a requestTransformations.
  3. Imposta il flag removeMarketingParams su false in requestTransformations.
  4. Salva e conferma nel tuo archivio la configurazione aggiornata.
  5. Distribuire il file cdn.yaml aggiornato utilizzando la pipeline di configurazione dell’ambiente.
  6. Al termine della distribuzione, verifica che i servlet e i servizi back-end ricevano i parametri della query di marketing.

Note:

  • Per impostazione predefinita, questo comportamento si applica solo agli ambienti creati a ottobre 2023 o versioni successive. Gli ambienti meno recenti richiedono un’abilitazione esplicita.
  • Gli script lato client in esecuzione nei browser continuano ad accedere ai parametri delle query di marketing perché la rimozione avviene solo a livello CDN.
  • Adobe consiglia di gestire i parametri di marketing sul lato client o di trasmetterli attraverso il corpo della richiesta o le intestazioni personalizzate quando necessario per l’elaborazione back-end.
  • Per gli ambienti creati prima di ottobre 2023 non esiste alcuna data di applicazione globale. Abilita questo comportamento manualmente quando necessario.

Lettura correlata

recommendation-more-help
experience-cloud-kcs-help-kbarticles