Questa documentazione descrive come integrare AEM con Adobe Campaign Classic, la soluzione locale. Se utilizzate Adobe Campaign Standard, consultate Integrazione con Adobe Campaign Standard per tali istruzioni.
Adobe Campaign consente di gestire i contenuti e i moduli per la distribuzione tramite e-mail direttamente in Adobe Experience Manager.
Per utilizzare entrambe le soluzioni insieme allo stesso tempo, è innanzitutto necessario configurarle per collegarsi tra loro. Ciò richiede passaggi di configurazione sia in Adobe Campaign che in Adobe Experience Manager. Questi passaggi sono descritti in dettaglio in questo documento.
Lavorare con Adobe Campaign in AEM include la possibilità di inviare e-mail tramite Adobe Campaign ed è descritto in Utilizzo Adobe Campaign. Include inoltre l'uso di moduli su AEM pagine per manipolare i dati.
Inoltre, i seguenti argomenti possono interessare l'integrazione di AEM con Adobe Campaign:
Se state estendendo l'integrazione con Adobe Campaign, potete visualizzare le pagine seguenti:
Questa sezione descrive un flusso di lavoro tipico tra AEM e Adobe Campaign durante la creazione di campagne e la distribuzione di contenuti.
Il flusso di lavoro tipico include quanto segue ed è descritto in dettaglio:
Si inizia a creare una campagna in qualsiasi momento. Prima di collegare i contenuti, AEM e CA sono indipendenti Ciò significa che gli addetti marketing possono iniziare a creare le proprie campagne e il targeting in Adobe Campaign, mentre gli autori dei contenuti stanno lavorando alla progettazione in AEM.
Prima di collegare il contenuto e creare un meccanismo di distribuzione, è necessario effettuare le seguenti operazioni:
In AEM
In Adobe Campaign
Dopo aver preparato il contenuto per il collegamento e la distribuzione, potete determinare esattamente come e dove collegare il contenuto.
Tutti questi passaggi sono completati in Adobe Campaign.
Se non avete mai AEM, potete trovare utili i seguenti collegamenti per comprendere AEM:
La configurazione di Adobe Campaign implica quanto segue:
Sono inoltre disponibili configurazioni avanzate, tra cui:
Vedere Configurazioni avanzate.
Per eseguire queste operazioni, è necessario avere il ruolo administration in Adobe Campaign.
Assicuratevi di disporre già dei seguenti elementi:
Se è in esecuzione una versione precedente alla build 8640 di Adobe Campaign Classic, consultare la documentazione di aggiornamento per ulteriori informazioni. È necessario aggiornare client e database alla stessa build.
Le operazioni descritte nelle sezioni Configurazione Adobe Campaign e Configurazione di Adobe Experience Manager sono necessarie per il corretto funzionamento delle funzionalità di integrazione tra AEM e Adobe Campaign.
È necessario installare il pacchetto AEM Integration in Adobe Campaign. Per effettuare ciò:
Passate all'istanza di Adobe Campaign con cui desiderate collegarvi a AEM.
Selezionare Strumenti > Avanzate > Importa pacchetto….
Fare clic su Installa un pacchetto standard, quindi selezionare il pacchetto AEM Integration.
Fare clic su Next, quindi su Start.
Questo pacchetto contiene l'operatore aemserver che verrà utilizzato per collegare il server AEM a Adobe Campaign.
Per impostazione predefinita, per questo operatore non è configurata alcuna zona di protezione. Per connettersi a Adobe Campaign tramite AEM, è necessario selezionarne uno.
Nel file serverConf.xml, l'attributo allowUserPassword della zona di protezione selezionata deve essere impostato su true per autorizzare AEM la connessione Adobe Campaign tramite login/password.
Consigliamo vivamente di creare una zona di sicurezza dedicata a AEM per evitare problemi di sicurezza. Per ulteriori informazioni, consultare la Guida all'installazione.
È necessario configurare un account esterno che consenta di collegare Adobe Campaign all'istanza AEM.
Per configurare un account AEM esterno:
Andate al nodo Administration > Platform > External Accounts.
Create un nuovo account esterno e selezionate il tipo AEM.
Immettete i parametri di accesso per l’istanza di authoring AEM: l'indirizzo del server e l'ID e la password utilizzati per connettersi a questa istanza. La password dell'account utente campaign-api è la stessa dell'utente remoto della campagna per cui avete impostato una password in AEM.
Assicurarsi che l'indirizzo del server non termini in una barra finale. Ad esempio, immettere https://yourserver:4502
anziché https://yourserver:4502/
Assicurarsi che la casella di controllo Abilitato sia selezionata.
L'opzione AEMResourceTypeFilter viene utilizzata per filtrare i tipi di risorse AEM che possono essere utilizzate in Adobe Campaign. Questo consente Adobe Campaign di recuperare AEM contenuti progettati specificamente per essere utilizzati solo Adobe Campaign.
Questa opzione deve essere preconfigurata; tuttavia, se modificate questa opzione, potrebbe causare un'integrazione non funzionante.
Per verificare che l'opzione AEMResourceTypeFilter sia configurata:
Vai a Piattaforma >Opzioni.
Nell'opzione AEMResourceTypeFilter, verificare che i percorsi siano corretti. Questo campo deve contenere il valore:
mcm/campaign/components/newsletter,mcm/campaign/components/campaign_newsletterpagina,mcm/neolane/components/newsletter
In alcuni casi, il valore è il seguente:
mcm/campaign/components/newsletter
Per configurare AEM, è necessario effettuare le seguenti operazioni:
Il contenuto creato dall’istanza di creazione AEM viene inviato per la prima volta all’istanza di pubblicazione. Per rendere disponibili le immagini della newsletter nell’istanza di pubblicazione e per i destinatari della newsletter, è necessario pubblicarle. L'agente di replica deve pertanto essere configurato per eseguire la replica dall'istanza di creazione AEM all'istanza di pubblicazione AEM.
Se non si desidera utilizzare l'URL di replica ma utilizzare l'URL rivolto al pubblico, è possibile impostare l' URL pubblico nella seguente impostazione di configurazione in OSGi (AEM logo > Strumenti icona > Operazioni > Console 10/>Configurazione OSGi > AEM Integrazione campagna - Configurazione ):
URL pubblico: com.day.cq.mcm.campaign.impl.IntegrationConfigImpl#aem.mcm.campaign.publicUrl
Questo passaggio è inoltre necessario per replicare alcune configurazioni dell’istanza di creazione nell’istanza di pubblicazione.
Per configurare la replica tra AEM istanze:
Nell'istanza di creazione, selezionare AEM logo> Icona Strumenti > Distribuzione > Replica > Agenti sull'autore, quindi fare clic su Agente predefinito.
Evitate di usare localhost (ossia una copia locale di AEM) per configurare l’integrazione con Adobe Campaign, a meno che l’istanza di pubblicazione e di creazione non si trovi entrambe sullo stesso computer.
Toccate o fate clic su Modifica, quindi selezionate la scheda Trasporto.
Configurate l'URI sostituendo localhost con l'indirizzo IP o l'indirizzo dell'istanza di pubblicazione AEM.
Prima di poter utilizzare AEM e Adobe Campaign insieme, è necessario stabilire il collegamento tra entrambe le soluzioni in modo che possano comunicare.
Connettiti all’istanza di authoring AEM.
Selezionare AEM logo > Icona Strumenti > Distribuzione > Cloud Services, quindi Configura ora nella sezione Adobe Campaign.
Per creare una nuova configurazione, immetti un Titolo e fai clic su Crea oppure scegli la configurazione esistente da collegare all'istanza di Adobe Campaign .
Modificate la configurazione in modo che corrisponda ai parametri dell’istanza di Adobe Campaign .
Selezionare Connetti a Adobe Campaign e fare clic su OK.
Dopo aver creato il messaggio e-mail e averlo pubblicato, è necessario ripubblicare la configurazione nell'istanza di pubblicazione.
Se la connessione non riesce, verificate quanto segue:
Inoltre, vedete Risoluzione dei problemi relativi all'integrazione AEM/ Adobe Campaign.
È necessario configurare l'esternalizzatore in AEM nell'istanza di creazione. L’esternalizzatore è un servizio OSGi che consente di trasformare un percorso di risorsa in un URL esterno e assoluto. Questo servizio fornisce una posizione centrale per configurare gli URL esterni e crearli.
Per istruzioni generali, vedere Configurare l'esternalizzatore. Per l'integrazione con Adobe Campaign , accertatevi di configurare il server di pubblicazione su https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImpl
non puntare a localhost:4503
ma a un server raggiungibile dalla console Adobe Campaign .
Se punta a localhost:4503
o a un altro server che Adobe Campaign non riesce a raggiungere, le immagini non verranno visualizzate nella console Adobe Campaign .
È inoltre possibile eseguire alcune configurazioni avanzate:
I campi e i blocchi disponibili per aggiungere personalizzazione al contenuto delle e-mail in AEM sono gestiti da Adobe Campaign.
Un elenco predefinito è fornito ma può essere modificato. Puoi anche aggiungere o nascondere campi e blocchi di personalizzazione.
Per aggiungere un nuovo campo di personalizzazione a quelli già disponibili, è necessario estendere schema Adobe Campaign nms:seedMember come segue:
Il campo che è necessario aggiungere deve essere già stato aggiunto tramite un'estensione dello schema destinatario (nms:destinatario). Per ulteriori informazioni, vedere la guida Configuration.
Andate al nodo Administration > Configuration > Data schemas nella navigazione Adobe Campaign .
Selezionare New.
Nella finestra a comparsa, selezionare Estendi i dati nella tabella utilizzando uno schema di estensione, quindi fare clic su Avanti.
Immettete i diversi parametri dello schema esteso:
Modificate il codice XML dello schema per specificare il campo da aggiungere. Per ulteriori informazioni sull'estensione degli schemi in Adobe Campaign, fare riferimento alla Guida alla configurazione.
Salvate lo schema, quindi aggiornate la struttura del database Adobe Campaign tramite il menu Strumenti > Avanzate > Aggiorna struttura del database nella console.
Disconnettetevi quindi di nuovo alla console Adobe Campaign per salvare le modifiche. Il nuovo campo viene ora visualizzato nell’elenco dei campi di personalizzazione disponibili in AEM.
Per aggiungere un campo Numero registrazione, è necessario disporre dei seguenti elementi:
<element desc="Recipient table (profiles)" img="nms:recipient.png" label="Recipients" labelSingular="Recipient" name="recipient">
<attribute dataPolicy="smartCase" desc="Recipient registration number"
label="Registration Number"
length="50" name="registrationNumber" type="string"/>
</element>
L'estensione dello schema nms:seedMember denominata cus:seedMember contiene:
<element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">
<element name="custom_nms_recipient">
<attribute name="registrationNumber"
template="cus:recipient:recipient/@registrationNumber"/>
</element>
</element>
Il campo Numero di registrazione fa ora parte dei campi di personalizzazione disponibili:
Per nascondere un campo di personalizzazione tra quelli già disponibili, è necessario estendere lo schema Adobe Campaign nms:seedMember come descritto nella sezione Aggiunta di un campo di personalizzazione. Effettuate le seguenti operazioni:
Copiare il campo che si desidera acquisire dallo schema nms:seedMember nello schema esteso (cus:seedMember ad esempio).
Aggiungete l'attributo advanced="true" XML al campo. Non viene più visualizzato nell’elenco dei campi di personalizzazione disponibili in AEM.
Ad esempio, per nascondere il campo Nome intermedio, lo schema cud:seedMember deve contenere il seguente elemento:
<element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">
<element name="custom_nms_recipient">
<attribute advanced="true" name="middleName"/>
</element>
</element>
Per disattivare un blocco di personalizzazione tra quelli disponibili:
Andate al nodo Risorse > Gestione campagna > Blocchi di personalizzazione nella navigazione Adobe Campaign.
Selezionate il blocco di personalizzazione da disattivare in AEM.
Deselezionare la casella di controllo Visibile nei menu di personalizzazione e salvare le modifiche. Il blocco non viene più visualizzato nell'elenco dei blocchi di personalizzazione disponibili in Adobe Campaign.
Puoi anche inserire dati di estensione di destinazione per la personalizzazione. I dati di estensione di destinazione (denominati anche "Dati di destinazione"), derivano dall'arricchimento o dall'aggiunta di dati in una query in un flusso di lavoro della campagna, ad esempio. Per ulteriori informazioni, consultare le sezioni Creazione di query e Arricchimento dei dati.
I dati nella destinazione sono disponibili solo se il contenuto AEM è sincronizzato con una distribuzione Adobe Campaign . Consultate Sincronizzazione del contenuto creato in AEM con una distribuzione Adobe Campaign.