Integrazione con Adobe Campaign Classic

NOTA

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:

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:

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.

NOTA

Per eseguire queste operazioni, è necessario avere il ruolo administration in Adobe Campaign.

Prerequisiti

Assicuratevi di disporre già dei seguenti elementi:

NOTA

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.

ATTENZIONE

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.

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

    chlimage_1-132

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

    chlimage_1-133

  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.

    chlimage_1-134

Configurazione di un account esterno AEM

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

NOTA
  • Durante l'installazione del pacchetto AEM Integration, viene creato un account AEM esterno. È possibile configurare la connessione all'istanza AEM da essa oppure crearne una nuova.
  • In AEM, accertatevi di impostare la password per l’utente remoto della campagna. È necessario impostare questa password per collegarsi Adobe Campaign con AEM. Accedete come amministratore e nella console di amministrazione utente, cercate l'utente remoto della campagna e fate clic su Imposta password.

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/

    chlimage_1-135 chlimage_1-136

  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

    chlimage_1-137

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.

NOTA

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:

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

    chlimage_1-138

    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.

    chlimage_1-139

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.

    chlimage_1-140

  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.

    chlimage_1-141

    NOTA

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

    chlimage_1-142

NOTA

Se la connessione non riesce, verificate quanto segue:

  • È possibile che si verifichi un problema relativo al certificato quando si utilizza una connessione protetta a un'istanza Adobe Campaign (https). Sarà necessario aggiungere il certificato istanza Adobe Campaign al file cacerts del JDK dell'istanza AEM.
  • È necessario configurare un'area di protezione per l' operatore server in Adobe Campaign. Inoltre, nel file serverConf.xml, l'attributo allowUserPassword della zona di protezione deve essere impostato su true per autorizzare AEM connessione a Adobe Campaign utilizzando la modalità login/password.

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 .

chlimage_1-143

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:

ATTENZIONE

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.

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

  2. Selezionare New.

    chlimage_1-144

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

    chlimage_1-145

  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:

chlimage_1-146

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.

    chlimage_1-147

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.

NOTA

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.

chlimage_1-148

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free