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 capacità 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 potrebbero interessare quando si integrano 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 consegne

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

Consultate Configurazioniavanzate.

Nota

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

Prerequisiti

Assicuratevi di disporre già dei seguenti elementi:

Nota

Se state eseguendo una versione precedente alla build 8640 di Adobe Campaign Classic, consultate 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 Integrazione in Adobe Campaign. Per effettuare ciò:

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

  2. Selezionate Strumenti > Avanzate > Importa pacchetto….

    chlimage_1-132

  3. Fate clic su Installa un pacchetto standard, quindi selezionate il pacchetto AEM Integrazione .

    chlimage_1-133

  4. Fate clic su Avanti, quindi su Avvia.

    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, consulta 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 Amministrazione > Piattaforma > Account ​esterni.

  2. Create un nuovo account esterno e selezionate il tipo di 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

    Verificate che l'indirizzo del server non termini in una barra finale. Ad esempio, immettete 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 utilizzabili 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 , verificate 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

Configuring 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 invece l'URL rivolto al pubblico, è possibile impostare l'URL ​pubblico nella seguente impostazione di configurazione in OSGi (AEM logo > Strumenti icona > Operazioni > Console Web > ConfigurazioneOSGiConfiguration> Integrazione ​**​** AEM 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 all’autore, quindi fare clic suAgente 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. Selezionate AEM logo > icona Strumenti > Distribuzione > Cloud Services, quindi Configura ora nella sezione Adobe Campaign.

    chlimage_1-140

  3. Per creare una nuova configurazione, immettete un Titolo e fate clic su Crea oppure scegliete 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. Selezionate Connect per Adobe Campaign e fate clic su OK.

    chlimage_1-141

    Nota

    Dopo aver creato il messaggio e-mail e averlopubblicato, è 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 aemserver 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, consultate Risoluzione dei problemi relativi all'integrazioneAEM/ 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.

Consultate Configurare l'esternalizzatore per istruzioni generali. Per l’integrazione con Adobe Campaign , accertatevi di configurare il server di pubblicazione https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImplnon puntando a localhost:4503 ma a un server raggiungibile dalla console Adobe Campaign .

Se indica localhost:4503 o 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 del destinatario (nms:destinatario). Per ulteriori informazioni, consultate la guida alla configurazione .

  1. Andate al nodo Amministrazione > Configurazione > Schemi di dati nella navigazione Adobe Campaign .

  2. Selezionate Nuovo.

    chlimage_1-144

  3. Nella finestra a comparsa, selezionate Estendi i dati nella tabella utilizzando uno schema di estensione e fate clic su Avanti.

    chlimage_1-145

  4. Immettete i diversi parametri dello schema esteso:

    • Schema: selezionate lo schema nms:seedMember . 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, consultare la guida allaconfigurazione.

  6. Salvare lo schema, quindi aggiornare la struttura database Adobe Campaign tramite il menu Strumenti > Avanzate > Aggiorna struttura 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 nms:destinatario dello schema denominata cus:Recipient 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 nms:seedMember dello schema 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 illustrato nella sezione Aggiunta di un campo di personalizzazione. Effettuate le seguenti operazioni:

  1. Copiate il campo che desiderate acquisire dallo schema nms:seedMember nello schema esteso (ad esempio,cus:seedMember ).

  2. Aggiungete l'attributo XML advanced="true" 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 l'elemento seguente:

    <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. Deselezionate la casella Visibile nei menu di personalizzazione e salvate le modifiche. Il blocco non viene più visualizzato nell'elenco dei blocchi di personalizzazione disponibili in Adobe Campaign.

    chlimage_1-147

Gestione dei dati dell'estensione di 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 . See Synchronizing content created in AEM with a delivery from Adobe Campaign.

chlimage_1-148

In questa pagina