currencyCode

18 marzo 2024
  • Argomenti:

Creato per:

  • Amministratore
  • Sviluppatore

Per i siti che utilizzano Commerce, le entrate e la valuta sono una parte importante di Analytics. Molti siti, soprattutto quelli che interessano più Paesi, utilizzano valute diverse. Utilizza la variabile currencyCode per assicurarti che le entrate siano attribuite alla valuta corretta.

La conversione della valuta utilizza la seguente logica su ogni hit. Questi passaggi si applicano ai valori delle entrate assegnati alla variabile products e tutti gli eventi elencati come “Valuta” negli Eventi di successo nelle impostazioni della suite di rapporti.

  • Se currencyCode non è definita, Adobe presuppone che tutti i valori di valuta siano la valuta della suite di rapporti. Consulta le Impostazioni account generali nelle Impostazioni della suite di rapporti per visualizzare la valuta della suite di rapporti.
  • Se currencyCode è definita e corrisponde alla valuta della suite di rapporti, non viene applicata alcuna conversione di valuta.
  • Se currencyCode è definita ed è diversa dalla valuta della suite di rapporti, Adobe applica una conversione della valuta in base al tasso di cambio del giorno corrente. Adobe collabora con XE per convertire la valuta ogni giorno. Tutti i valori memorizzati nella suite di rapporti si trovano nella valuta della suite di rapporti.
  • Se currencyCode è impostata su un valore non valido, l’intero hit viene eliminato causando la perdita di dati. Assicurati che questa variabile sia definita correttamente ogni volta che viene utilizzata.

Questa variabile non persiste negli hit. Assicurati che questa variabile sia definita in ogni pagina che include entrate o eventi di valuta che non corrispondono alla valuta predefinita della suite di rapporti.

NOTE
Anche se i codici di valuta possono cambiare tra le pagine, tutte le metriche di valuta in un singolo hit devono utilizzare la stessa valuta.

Quando si implementa questa variabile, deve essere utilizzato un punto come separatore di valuta per tutte le valute. Ad esempio, la corona svedese, che in genere visualizza un separatore con la virgola, deve essere modificata per utilizzare un punto nella variabile products e in tutti gli eventi di valuta. In Adobe nel reporting viene visualizzato il separatore di valuta corretto.

Codice valuta utilizzando il Web SDK

Il codice valuta è mappato alle seguenti variabili:

  • Oggetto XDM: xdm.commerce.order.currencyCode
  • Oggetto dati: data.__adobe.analytics.currencyCode o data.__adobe.analytics.cc

Codice valuta utilizzando l’estensione di Adobe Analytics

Il Codice valuta è un campo che si trova sotto il pannello a soffietto General durante la configurazione dell’estensione di Adobe Analytics.

  1. Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
  2. Fai clic sulla proprietà del tag desiderata.
  3. Vai alla scheda Extensions, quindi fai clic sul pulsante Configure in Adobe Analytics.
  4. Espandi il pannello a soffietto General, che mostra il campo Currency Code.

È possibile utilizzare un codice valuta predefinito o un codice valuta personalizzato. Se utilizzi un codice valuta personalizzato, assicurati che sia valido.

Codice valuta in Adobe Experience Platform Mobile SDK

Il codice valuta viene passato agli SDK di Adobe Experience Platform Mobile tramite variabili di dati di contesto nell’estensione di Adobe Analytics.

  1. Imposta il codice valuta in una variabile di dati contestuali durante trackState o trackAction.
  2. Crea una regola di elaborazione negli Strumenti di amministrazione di Adobe Analytics per la suite di rapporti. Imposta la regola per sovrascrivere la variabile Codice valuta.
  3. Trasferisci il codice valuta alla variabile products nella chiamata a trackState o a trackAction.

È possibile utilizzare un codice valuta predefinito o un codice valuta personalizzato. Se utilizzi un codice valuta personalizzato, assicurati che sia valido.