File di dati di classificazione

L’importazione consente di caricare in massa i dati delle classificazioni nei rapporti di Analytics in un file. L’importazione richiede un formato di file specifico per il caricamento dei dati.

Per facilitare la creazione di file di dati validi, puoi scaricare un file modello che ti fornisce una struttura in cui incollare i dati delle classificazioni. Per ulteriori informazioni, consulta Scaricare il modello delle classificazioni.

Per ulteriori informazioni sui limiti dei caratteri nelle classificazioni, consulta Struttura generale dei file.

Struttura generale dei file

L’illustrazione seguente è un esempio di file di dati:

Un file di dati deve rispettare le seguenti regole di struttura:

  • Le classificazioni non possono avere un valore pari a 0 (zero).

  • Adobe consiglia di limitare a 30 il numero di colonne di importazione ed esportazione.

  • I file caricati devono utilizzare la codifica dei caratteri UTF-8 senza BOM.

  • È possibile incorporare caratteri speciali come tab, caratteri di nuova riga e virgolette all’interno di una cella a condizione che sia specificato il formato di file v2.1 e che la cella sia correttamente preceduta da caratteri di escape. I caratteri speciali includono:

    code language-text
    \t     tab character
    \r     form feed character
    \n    newline character
    "       double quote
    

    La virgola non è un carattere speciale.

  • Le classificazioni non possono contenere un accento circonflesso (^) poiché questo carattere è utilizzato per indicare una sottoclassificazione.

  • Presta attenzione quando utilizzi i trattini. Ad esempio, se utilizzi un trattino (-) in un termine Social, Social riconosce il trattino come operatore Not (il segno meno). Ad esempio, se specifichi fragrance-free come termine con l’importazione, Social riconosce il termine come fragrance minus free e raccoglie i post che menzionano fragrance ma non free.

  • I limiti di caratteri vengono applicati per classificare i dati dei rapporti. Ad esempio, se carichi un file di testo delle classificazioni per i prodotti (s.products) con nomi di prodotto che superano i 100 caratteri (byte), i prodotti non verranno visualizzati nei rapporti. I codici di tracciamento e tutte le variabili di conversione personalizzate (eVar) consentono 255 byte. Questo criterio si estende anche ai valori delle colonne di classificazione e sottoclassificazione, soggetti allo stesso limite di 255 byte.

  • File di dati delimitati da tabulazioni (crea il file modello utilizzando un’applicazione per fogli di calcolo o un editor di testo).

  • Un’estensione file .tab o .txt.

  • Il cancelletto (#) identifica la riga come un commento degli utenti. Adobe ignora le righe che iniziano con #.

  • Un doppio cancelletto seguito da SC (## SC) identifica la riga come un commento intestazione pre-elaborazione utilizzato nel reporting. Non eliminare queste righe.

  • Le esportazioni delle classificazioni possono avere chiavi duplicate a causa di caratteri di nuova riga nella chiave. In un’esportazione FTP o browser, questo può essere risolto attivando le virgolette per l’account FTP. In questo modo ciascuna chiave con caratteri di nuova riga verrà inserita tra virgolette.

  • La cella C1 nella prima riga del file di importazione contiene un identificatore di versione che determina il modo in cui le classificazioni gestiscono l’uso delle virgolette per la parte restante del file.

    • v2.0 ignora le virgolette e presuppone che siano parte delle chiavi e dei valori specificati. Ad esempio, considera questo valore: “Questo è “un valore””. v2.0 lo interpreterebbe letteralmente: “Questo è “un valore””.
    • v2.1 indica alle classificazioni di presumere che le virgolette siano parte della formattazione del file utilizzata nei file Excel. Quindi v2.1 formatta l’esempio precedente in questo modo: Questo è “un valore”.
    • Possono sorgere problemi quando v2.1 è specificato nel file, ma si desidera v2.0, ovvero quando le virgolette sono utilizzate in modi che non sono concessi nella formattazione Excel. Ad esempio, se disponi di un valore: “VP NO REPS” S/l Dress w/ Overlay. Con v2.1 questa viene considerata una formattazione errata (il valore deve essere racchiuso tra virgolette di apertura e chiusura e le virgolette che fanno parte del valore effettivo devono essere precedute da virgolette) e le classificazioni non funzioneranno oltre questo punto.
    • Effettua una delle seguenti operazioni: modifica il formato del file in v2.0 cambiando l’intestazione (cella C1) nei file caricati, OPPURE implementa correttamente le virgolette Excel in tutti i file.
  • La prima riga (senza commenti) del file di dati contiene le intestazioni di colonna utilizzate per identificare i dati di classificazione nella colonna. L’importazione richiede un formato specifico per le intestazioni di colonna. Per ulteriori informazioni, consulta Formato delle intestazioni di colonna.

  • Dopo la riga di intestazione in un file di dati sono riportate le righe di dati. Ognuna di esse deve contenere un campo dati per ogni intestazione di colonna.

  • Il file di dati supporta i seguenti codici di controllo utilizzati da Adobe per conferire struttura al file e importare correttamente i dati di classificazione:

CODICE DI CONTROLLO
DESCRIZIONE
<Nuova riga>
Il carattere di nuova riga è l’unico delimitatore tra righe/record di dati supportato nel file di dati. In genere, è necessario inserire questi caratteri solo quando si scrive un programma per generare automaticamente i file di dati.
~autogen~

Richiede che Adobe generi automaticamente un ID univoco per questo elemento.

Nel contesto delle campagne, questo valore di controllo indica ad Adobe di assegnare un identificatore a ogni elemento creativo. Consulta Chiave.

~periodo~
Indica che la colonna di dati rappresenta l’intervallo di date associato all’elemento. Consulta Data.
Campo vuoto
Rappresenta un valore NULL per il campo corrente. Utilizzalo se una particolare colonna di dati non si applica al record corrente.
Modificatori PER
Indica che la colonna di dati rappresenta un campo modificatore PER. Consulta Intestazioni dei modificatori PER.

Formato dell’intestazione di colonna

NOTE
Adobe consiglia di limitare a 30 il numero di colonne di importazione ed esportazione.

I file di classificazione supportano le seguenti intestazioni di colonna:

Chiave

Ogni valore deve essere univoco in tutto il sistema. Il valore in questo campo corrisponde a un valore assegnato alla variabile Analytics nel beacon JavaScript del sito web. I dati in questa colonna possono includere un codice di tracciamento autogen o qualsiasi altro codice di tracciamento univoco.

Intestazione della colonna di classificazione

NOTE
I valori nell’intestazione della colonna Classifications devono corrispondere esattamente alla convenzione di denominazione della classificazione, altrimenti l’importazione non riesce. Ad esempio, se l’amministratore modifica Campaigns in Internal Campaign Names nel Campaign Set-up Manager, l’intestazione della colonna del file dev’essere modificata di conseguenza. “Chiave” è un valore di classificazione riservato (intestazione). Le nuove classificazioni denominate “Chiave” non sono supportate.

Inoltre, il file di dati supporta le seguenti convenzioni di intestazione aggiuntive per identificare sottoclassificazioni e altre colonne di dati specializzate:

Intestazione delle sottoclassificazioni

Ad esempio, Campaigns^Owner è un’intestazione di colonna per la colonna contenente i valori Campaign Owner. Allo stesso modo, Creative Elements^Size è un’intestazione di colonna per la colonna contenente la sottoclassificazione Size della classificazione Creative Elements.

Intestazioni delle metriche di classificazione

Ad esempio, Campaigns^~Cost si riferisce alla metrica Cost nella classificazione Campaigns.

Intestazione del modificatore PER

Le intestazioni del Per Modifier sono identificate tramite l’aggiunta di ~per all’intestazione della metrica di classificazione. Ad esempio, se l’intestazione Metric è Campaigns^~Cost, l’intestazione del modificatore PER è Campaigns^~Cost~per. Adobe supporta le seguenti parole chiave per i PER Modifier:

Questi caratteri hanno un significato particolare in un file di dati. Laddove possibile, evita di usare queste parole nei nomi e nei dati degli attributi.

FISSO: valore fisso. Non eseguire operazioni di ridimensionamento.

GIORNO: moltiplica il valore per il numero di giorni nel rapporto.

ORDINE: moltiplica il valore per il numero di ordini per la riga nel rapporto.

CHECKOUT: moltiplica il valore per il numero di checkout per la riga nel rapporto.

UNITÀ: moltiplica il valore per il numero di unità per la riga nel rapporto.

ENTRATE: moltiplica il valore per l’importo delle entrate per la riga nel rapporto.

SCADD: moltiplica il valore per il numero di volte in cui l’evento Shopping Cart Add è stato chiamato per riga del rapporto.

SCREMOVE: moltiplica il valore per il numero di volte in cui l’evento Shopping Cart Remove è stato chiamato per riga del rapporto.

ISTANZA: moltiplica il valore per il numero di istanze per la riga nel rapporto.

CLIC: moltiplica il valore per il numero di clic per la riga nel report.

EVENTO: moltiplica il valore per il numero di volte in cui si è verificato l’evento personalizzato specificato per riga del rapporto.

Esempio: se la campagna A costa $ 10.000, la colonna Campaigns^~Cost contiene il valore 10000 e la colonna Campaigns^Costper contiene FIXED. Quando visualizzi il costo per la campagna A nei rapporti, vedrai $ 10.000 come costo fisso per la campagna A per l’intervallo di date.

Esempio: se la campagna B costa circa $ 2 per clic, la colonna Campaigns^~Cost contiene il valore 2 e la colonna Campaigns^Costper contiene CLICK. Quando nei rapporti viene visualizzato il costo per la campagna B, Adobe calcola in tempo reale (2 * [numero di clic]) per l’intervallo di date del rapporto. Questo consente di calcolare il costo totale in base al numero di clic eseguiti con la campagna B.

Data

Le date delle campagne sono in genere intervalli (date di inizio e di fine) associati a singole campagne. Le date sono visualizzate in formato AAAA/MM/GG. Ad esempio, 2013/06/15-2013/06/30.

Per ulteriori informazioni, consulta Classificazioni di conversione.

NOTE
Nella versione di manutenzione di Analytics del 10 maggio 2018, Adobe ha iniziato a limitare le funzionalità delle classificazioni numeriche e con data abilitata. Le classificazioni di questo tipo sono state rimosse dalle interfacce Admin e Importazione delle classificazioni. Non è possibile aggiungere nuove classificazioni numeriche e con data abilitata. Sarà comunque possibile gestire le classificazioni esistenti, aggiornandole o eliminandole tramite il flusso di lavoro di classificazione standard, e continuare a utilizzarle nei rapporti.

Utilizzo delle date in combinazione con le classifications section_966A07B228CD4643B258E73FB8BA150A

Le Classifications, possono essere utilizzate per assegnare intervalli di date alle campagne o ad altre classifications di conversione che consentono una misurazione più accurata delle campagne. Dopo aver specificato l’intervallo di date di un valore, qualsiasi valore corrispondente che si verifica al di fuori dell’intervallo di date non sarà classificato. Ciò consente di misurare le campagne utilizzando le date esatte in cui una campagna è stata attiva e non tutti gli hit che corrispondono alla campagna stessa. Per classificare un valore con un intervallo di date, è necessario soddisfare le condizioni seguenti:

  • La classification deve essere basata su una variabile di conversione.
  • La classification utilizzata deve essere impostata come numerica 2 o con data abilitata.
  • L’intervallo di date interessato deve contenere una data di inizio e (facoltativamente) una data di fine.

Per classificare le campagne in base all’intervallo di date:

IMPORTANT
Questa opzione non è disponibile per le suite di rapporti abilitate per la nuova architettura di classificazione.
  1. Accedi a Analytics e vai su Amministratore > Classificazioni.

  2. Fai clic sulla scheda Browser Export, verifica che le impostazioni della classificazione con data abilitata siano corrette e fai clic su Esporta file.

  3. Apri il file in Microsoft Excel o nell’editor di fogli di calcolo che preferisci.

  4. Una delle colonne termina con

    ^periodo, questa è la colonna in cui inserire l’intervallo di date.

  5. In questa colonna, inserisci l’intervallo di date di ciascun valore nel formato seguente:

    YYYY/MM/DD - YYYY/MM/DD. Assicurati di effettuare le seguenti operazioni:

    • Lascia uno spazio prima e dopo il trattino.
    • Utilizza un trattino (-) per separare gli intervalli, non un trattino breve o un trattino lungo.
    • Se il mese o il giorno sono composti da una sola cifra, assicurati che sia presente uno zero iniziale.
    • Assicurati che sia presente un intervallo di date di inizio, l’intervallo di date di fine è facoltativo.
  6. Salva il file e caricalo su Analytics da Amministratore | Classificazioni | Importa file.

NOTE
Un valore chiave specifico non può avere più di un intervallo di date.

Risoluzione di problemi relativi alle classificazioni

recommendation-more-help
46b8682c-fda6-4669-9355-1a44923e549e