Integrazione con Adobe Campaign Classic

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:

• Best practice per i modelli e-mail
• Risoluzione dei problemi relativi all'integrazione Adobe Campaign

Se state estendendo l'integrazione con Adobe Campaign, potete visualizzare le pagine seguenti:

• Creazione di estensioni personalizzate
• Creazione di mappature di moduli personalizzate

Flusso di lavoro AEM e integrazione Adobe Campaign

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:

1. Iniziate a creare la campagna (sia in Adobe Campaign che in AEM).
2. Prima di collegare il contenuto e la distribuzione, personalizzate i contenuti in AEM e create una distribuzione in Adobe Campaign.
3. Collegamento di contenuti e distribuzione in Adobe Campaign.

Iniziate a creare la campagna

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 contenuti e consegna

Prima di collegare il contenuto e creare un meccanismo di distribuzione, è necessario effettuare le seguenti operazioni:

In AEM

• Personalizzare utilizzando i campi di personalizzazione nel componente Testo e personalizzazione

In Adobe Campaign

• Creare una consegna di tipo aemContent

Collegamento di contenuti e impostazione della distribuzione

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.

1. Specificate quale istanza AEM utilizzare.
2. Sincronizzate il contenuto facendo clic sul pulsante Sincronizza.
3. Aprite il selettore del contenuto per selezionare il contenuto.

Se non avete mai AEM

Se non avete mai AEM, potete trovare utili i seguenti collegamenti per comprendere AEM:

• AEM iniziale
• Informazioni sugli agenti di replica
• Ricerca e utilizzo dei file di registro
• Introduzione alla piattaforma AEM

Configurazione Adobe Campaign

La configurazione di Adobe Campaign implica quanto segue:

1. Installazione del pacchetto di integrazione AEM in Adobe Campaign.
2. Configurazione di un account esterno.
3. Verifica della configurazione corretta di AEMResourceTypeFilter.

Sono inoltre disponibili configurazioni avanzate, tra cui:

• Gestione dei blocchi di contenuto
• Gestione dei campi di personalizzazione

Vedere Configurazioni avanzate.

Prerequisiti

Assicuratevi di disporre già dei seguenti elementi:

• Un’istanza di authoring AEM
• Un’istanza di pubblicazione AEM
• Un'istanza Adobe Campaign Classic, che include un client e un server
• Internet Explorer 11

Installazione del pacchetto di integrazione AEM

È necessario installare il pacchetto AEM Integration in Adobe Campaign. Per effettuare ciò:

1. Passate all'istanza di Adobe Campaign con cui desiderate collegarvi a AEM.

2. Selezionare Strumenti > Avanzate > Importa pacchetto….

   

3. Fare clic su Installa un pacchetto standard, quindi selezionare il pacchetto AEM Integration.

   

4. Fare clic su Next, quindi su Start.

   Questo pacchetto contiene l'operatore aemserver che verrà utilizzato per collegare il server AEM a Adobe Campaign.

   ATTENZIONE

   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.

   

Configurazione di un account esterno AEM

È necessario configurare un account esterno che consenta di collegare Adobe Campaign all'istanza AEM.

Per configurare un account AEM esterno:

1. Andate al nodo Administration > Platform > External Accounts.

2. Create un nuovo account esterno e selezionate il tipo AEM.

3. 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.

   NOTA

   Assicurarsi che l'indirizzo del server non termini in una barra finale. Ad esempio, immettere https://yourserver:4502 anziché https://yourserver:4502/

   

4. Assicurarsi che la casella di controllo Abilitato sia selezionata.

Verifica dell'opzione AEMResourceTypeFilter

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:

1. Vai a Piattaforma >Opzioni.

2. 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

   

Configurazione di Adobe Experience Manager

Per configurare AEM, è necessario effettuare le seguenti operazioni:

• Configurare la replica tra le istanze.
• Collegate AEM a Adobe Campaign tramite Cloud Services.
• Configurare l'esternalizzatore.

Configurazione della replica tra AEM istanze

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.

Questo passaggio è inoltre necessario per replicare alcune configurazioni dell’istanza di creazione nell’istanza di pubblicazione.

Per configurare la replica tra AEM istanze:

1. Nell'istanza di creazione, selezionare AEM logo> Icona Strumenti > Distribuzione > Replica > Agenti sull'autore, quindi fare clic su Agente predefinito.

   

   NOTA

   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.

2. Toccate o fate clic su Modifica, quindi selezionate la scheda Trasporto.

3. Configurate l'URI sostituendo localhost con l'indirizzo IP o l'indirizzo dell'istanza di pubblicazione AEM.

   

Collegamento AEM a Adobe Campaign

Prima di poter utilizzare AEM e Adobe Campaign insieme, è necessario stabilire il collegamento tra entrambe le soluzioni in modo che possano comunicare.

1. Connettiti all’istanza di authoring AEM.

2. Selezionare AEM logo > Icona Strumenti > Distribuzione > Cloud Services, quindi Configura ora nella sezione Adobe Campaign.

   

3. 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 .

4. Modificate la configurazione in modo che corrisponda ai parametri dell’istanza di Adobe Campaign .

   • Nome utente: aemserver, l'operatore del pacchetto di integrazione AEM Adobe Campaign utilizzato per stabilire il collegamento tra le due soluzioni.
   • Password: la password dell'operatore Adobe Campaign aemserver. Potrebbe essere necessario specificare nuovamente la password per questo operatore direttamente in Adobe Campaign.
   • Punto finale API: l’URL dell’istanza Adobe Campaign.

5. Selezionare Connetti a Adobe Campaign e fare clic su OK.

   

   NOTA

   Dopo aver creato il messaggio e-mail e averlo pubblicato, è necessario ripubblicare la configurazione nell'istanza di pubblicazione.

   

Inoltre, vedete Risoluzione dei problemi relativi all'integrazione AEM/ Adobe Campaign.

Configurazione dell'esternalizzatore

È 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.ExternalizerImplnon 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 .

Configurazioni avanzate

È inoltre possibile eseguire alcune configurazioni avanzate:

• Gestire campi e blocchi di personalizzazione.
• Disattiva un blocco di personalizzazione.
• Gestire i dati di estensione della destinazione.

Gestione di campi e blocchi di personalizzazione

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.

Aggiunta di un campo di personalizzazione

Per aggiungere un nuovo campo di personalizzazione a quelli già disponibili, è necessario estendere schema Adobe Campaign nms:seedMember come segue:

1. Andate al nodo Administration > Configuration > Data schemas nella navigazione Adobe Campaign .

2. Selezionare New.

   

3. Nella finestra a comparsa, selezionare Estendi i dati nella tabella utilizzando uno schema di estensione, quindi fare clic su Avanti.

   

4. Immettete i diversi parametri dello schema esteso:

   • Schema: selezionare nms: seedMemberschema. Gli altri campi della finestra vengono completati automaticamente.
   • Spazio dei nomi: personalizzare lo spazio nomi dello schema esteso.

5. 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.

6. Salvate lo schema, quindi aggiornate la struttura del database Adobe Campaign tramite il menu Strumenti > Avanzate > Aggiorna struttura del database nella console.

7. 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.

Esempio

Per aggiungere un campo Numero registrazione, è necessario disporre dei seguenti elementi:

• L'estensione dello schema nms:destinatario denominata cus:destinatario contiene:

<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:

Nascondere un campo di personalizzazione

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:

1. Copiare il campo che si desidera acquisire dallo schema nms:seedMember nello schema esteso (cus:seedMember ad esempio).

2. 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>
   

Disattivazione di un blocco di personalizzazione

Per disattivare un blocco di personalizzazione tra quelli disponibili:

1. Andate al nodo Risorse > Gestione campagna > Blocchi di personalizzazione nella navigazione Adobe Campaign.

2. Selezionate il blocco di personalizzazione da disattivare in AEM.

3. 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.

   

Gestione dei dati di estensione destinazione

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.