Documentazione Campaign Documentazione di Campaign Classic v7

Migrare all’API Adobe Analytics 2.0 analytics-2-migration

Ultimo aggiornamento: 11 agosto 2026

Si applica a:
Campaign Classic v7

Le API di Adobe Analytics 1.4 stanno per raggiungere la fine del ciclo di vita. Il connettore Web Analytics che collega l’istanza Campaign ad Adobe Analytics si basa su queste API, pertanto devi eseguire l’aggiornamento a una build che utilizza le nuove API Analytics 2.0 per mantenere l’integrazione in esecuzione.

CAUTION

L'aggiornamento reimporta i due flussi di lavoro tecnici incorporati che alimentano il connettore, webAnalyticsSendMetrics e webAnalyticsGetWebEvents (consulta il riferimento ai flussi di lavoro di Web Analytics per le operazioni di ciascuno di essi). Eventuali personalizzazioni apportate sopra questi flussi di lavoro vengono sovrascritte dalla reimportazione. Evita di modificare direttamente questi flussi di lavoro incorporati: crea la personalizzazione in un flusso di lavoro personalizzato separato, in modo che gli aggiornamenti futuri non la sovrascrivano. L’aggiornamento aggiorna anche i file integrati di Analytics JavaScript: se uno dei flussi di lavoro personalizzati fa riferimento a tali file, questi verranno interrotti e dovranno essere adattati al nuovo codice.

Sei interessato? are-you-impacted

Sei interessato se la tua istanza utilizza l’account esterno Web Analytics per uno dei seguenti elementi:

Invio di indicatori e attributi della campagna e-mail ad Adobe Analytics come metriche.
Invio dei dati di classificazione ad Adobe Analytics.
Il flusso di remarketing (identificazione dei contatti convertiti dopo una campagna).
Un account esterno Web Analytics che intendi configurare per la prima volta.

Non sei sicuro di quale di queste ti riguardi? Controlla quali dei flussi di lavoro tecnici sopra riportati sono attivi nell’istanza e controlla la configurazione dell’account esterno Web Analytics in Administration > Platform > External accounts (consulta Account esterno di Web Analytics).

Come effettuare la migrazione how-to-migrate

Se ti trovi in un’istanza ospitata da Adobe, Adobe gestisce automaticamente il provisioning SFTP, l’inserimento di IP nell’elenco Consentiti e la configurazione delle chiavi nell’ambito dell’aggiornamento. Devi convalidare i tuoi casi d’uso solo una volta che la nuova build è attiva.

Se ti trovi in una distribuzione on-premise o ibrida, completa i passaggi seguenti.

Aggiorna l’ambiente Campaign a una build che includa le modifiche di Adobe Analytics 2.0. Puoi verificare da quale build esegui Help > About… (consulta come controllare la versione di Campaign).
Esamina quali dei casi d’uso sopra riportati si applicano alla tua istanza, poiché da essa dipende il passaggio successivo.

Se utilizzi il flusso di remarketing, il flusso di lavoro webAnalyticsFindConverted richiede un canale SFTP dedicato per scambiare dati con Adobe Analytics 2.0. Impostare come segue; in caso contrario, andare al passaggio successivo.

Esegui il provisioning di un server SFTP per l’istanza utilizzando l’autenticazione basata su chiave, seguendo le best practice per il server SFTP che avresti applicato a qualsiasi altra integrazione SFTP esterna. Adobe fornisce uno script di configurazione SFTP di esempio per aiutarti a iniziare.

Registra i dettagli di connessione del server in Adobe Analytics eseguendo lo script consegnato con la nuova build:

code language-none
`nlserver javascript -instance:<instance_name> -arg:host=<sftp_host_url>#user=<sftp_user> -file <path_to_the_file>/aaremarketingLocation.js`

Esempio:

code language-none
`nlserver javascript -instance:test_mkt_stage2 -arg:host=test-mkt-stage1.campaign.adobe.com#user=test -file ./nl6/datakit/nms/eng/js/aaremarketingLocation.js`

Inserisci nell’elenco Consentiti Adobe Analytics sul server SFTP, poiché le esportazioni di remarketing vengono avviate solo da un set fisso di intervalli IP di Adobe:
- Cerca gli indirizzi IP correnti della raccolta dati di Adobe Analytics e aggiungili all’elenco consentiti del tuo server SFTP. Le esportazioni di Analytics basate su FTP (inclusi i feed di dati) provengono solo da indirizzi IPv4 nelle aree di Londra, Oregon e Singapore.
- Recupera la chiave pubblica di Adobe Analytics e aggiungila al file authorized_keys sul tuo server SFTP in modo che Analytics possa eseguire l’autenticazione.

Abilita il flag di funzione FEATUREFLAG_USE_ANALYTICS_20_API nell’istanza creando o impostando longvalue dell’opzione su 1 in xtkOption, in Administration> Platform >Options nella struttura di Campaign Explorer. Questo passaggio è obbligatorio indipendentemente dal caso d’uso applicabile in precedenza.
Convalida la migrazione esercitando ogni caso d’uso che si applica alla tua istanza (invia una campagna di test, verifica che gli indicatori arrivino in Analytics e conferma i dati di remarketing, se applicabile) prima di disattivare qualsiasi connettività precedente.

Configurazione di un nuovo account esterno di Web Analytics setting-up-a-new-web-analytics-external-account

Ciò si applica sia che l’istanza sia ospitata da Adobe che on-premise/ibrida.

Se stai configurando l’account esterno Web Analytics per la prima volta anziché migrarne uno esistente, segui i passaggi per la configurazione dell’account esterno e la guida introduttiva del connettore.

Poiché Analytics 2.0 introduce una nuova gestione delle classificazioni, è necessario creare anche un set di classificazione in Adobe Analytics prima che l’account esterno possa raccogliere i dati di classificazione della suite di rapporti. Questo è un nuovo passaggio: crealo dopo aver configurato le variabili di conversione e gli eventi di successo e prima di configurare l’account esterno in Campaign.

Per creare il set di classificazione:

Dalla barra dei menu superiore di Adobe Analytics, seleziona Components > Classification sets, quindi fai clic su New.
Nella finestra di dialogo Add New Classification Set:
- Immetti Name per il set di classificazione.
- Imposta Type su Primary.
- In Job notifications, scegli gli utenti a cui inviare la notifica relativa al completamento o al fallimento dei processi del set di classificazione e fornisci gli indirizzi e-mail corrispondenti.
- In Subscriptions, seleziona la suite di rapporti e la variabile di conversione create per il nome della campagna interna nel passaggio precedente.
Fai clic su Save.

Questo set di classificazione verrà individuato automaticamente da Campaign al momento della configurazione dell’account esterno nel passaggio successivo. Per ulteriori informazioni sui set di classificazione, consulta la documentazione di Adobe Analytics.

Hai bisogno di aiuto? need-help

Se riscontri problemi durante la migrazione, contatta l’Assistenza clienti Adobe.

recommendation-more-help

campaign-classic-help