Integrazione con Adobe Campaign Classic integrating-with-adobe-campaign-classic
Adobe Campaign ti consente di gestire i contenuti e i moduli delle e-mail di consegna direttamente in Adobe Experience Manager.
Per utilizzare entrambe le soluzioni contemporaneamente, è necessario prima configurarle per la connessione reciproca. Ciò comporta passaggi di configurazione sia in Adobe Campaign che in Adobe Experience Manager. Questi passaggi sono descritti in dettaglio in questo documento.
L’utilizzo di Adobe Campaign in AEM include la possibilità di inviare e-mail tramite Adobe Campaign ed è descritto in Utilizzo di Adobe Campaign. Include inoltre l’uso di moduli su AEM pagine per manipolare i dati.
Inoltre, i seguenti argomenti possono essere di interesse per l'integrazione di AEM con Adobe Campaign:
Se estendi l’integrazione con Adobe Campaign, potresti voler vedere le pagine seguenti:
Flusso di lavoro di integrazione di AEM e Adobe Campaign aem-and-adobe-campaign-integration-workflow
Questa sezione descrive un flusso di lavoro tipico tra AEM e Adobe Campaign per la creazione di campagne e la distribuzione di contenuti.
Il flusso di lavoro tipico include quanto segue ed è descritto in dettaglio:
- Inizia a creare la tua campagna (sia in Adobe Campaign che in AEM).
- Prima di collegare contenuti e consegne, personalizza i contenuti in AEM e crea una consegna in Adobe Campaign.
- Collega contenuti e consegne in Adobe Campaign.
Inizia a creare la tua campagna start-building-your-campaign
Si inizia a creare una campagna in qualsiasi momento. Prima di collegare i contenuti, AEM e AC sono indipendenti Ciò significa che gli esperti di marketing possono iniziare a creare le campagne e il targeting in Adobe Campaign, mentre i creatori di contenuti stanno lavorando alla progettazione in AEM.
Prima di collegare contenuti e consegne before-linking-content-and-delivery
Prima di collegare il contenuto e creare un meccanismo di consegna, devi effettuare le seguenti operazioni:
In AEM
- Personalizza utilizzando i campi di personalizzazione nella sezione Testo e personalizzazione component
In Adobe Campaign
- Creare una consegna di tipo aemContent
Collegamento del contenuto e impostazione della consegna linking-content-and-setting-delivery
Dopo aver preparato il contenuto per il collegamento e la consegna, puoi determinare esattamente come e dove collegare il contenuto.
Tutti questi passaggi sono completati in Adobe Campaign.
- Specifica AEM'istanza da utilizzare.
- Sincronizza il contenuto facendo clic sul pulsante Sincronizza.
- Apri il selettore dei contenuti per scegliere il contenuto.
Se sei nuovo a AEM if-you-are-new-to-aem
Se hai poca esperienza con AEM, puoi trovare i seguenti collegamenti utili per comprendere AEM:
Configurazione di Adobe Campaign configuring-adobe-campaign
La configurazione di Adobe Campaign prevede quanto segue:
- Installazione del pacchetto di integrazione AEM in Adobe Campaign.
- Configurazione di un account esterno.
- Verifica che AEMResourceTypeFilter sia configurato correttamente.
Inoltre, puoi effettuare configurazioni avanzate, tra cui:
- Gestione dei blocchi di contenuto
- Gestione dei campi di personalizzazione
Vedi Configurazioni avanzate.
Prerequisiti prerequisites
Assicurati di avere in precedenza i seguenti elementi:
- Un’istanza di authoring AEM
- Un’istanza di pubblicazione AEM
- Un'istanza Adobe Campaign Classic - compreso un client e un server
- Internet Explorer 11
Installazione del pacchetto di integrazione AEM installing-the-aem-integration-package
È necessario installare Integrazione AEM in Adobe Campaign. Per effettuare questo collegamento:
-
Vai all'istanza Adobe Campaign con cui desideri effettuare il collegamento a AEM.
-
Seleziona Strumenti > Avanzate > Importa pacchetto….
-
Fai clic su Installare un pacchetto standard, quindi seleziona la Integrazione AEM pacchetto.
-
Fai clic su Successivo e quindi Inizio.
Questo pacchetto contiene aemserver che verrà utilizzato per collegare il server AEM ad Adobe Campaign.
note caution CAUTION Per impostazione predefinita, per questo operatore non è configurata alcuna zona di protezione. Per connettersi ad Adobe Campaign tramite AEM, devi selezionarne una. In serverConf.xml file, allowUserPassword l'attributo della zona di sicurezza selezionata deve essere impostato su true per autorizzare AEM a collegare 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 sezione Guida all’installazione.
Configurazione di un account esterno AEM configuring-an-aem-external-account
Devi configurare un account esterno che ti consenta di collegare Adobe Campaign all’istanza AEM.
- Quando installi Integrazione AEM pacchetto, viene creato un account AEM esterno. Puoi configurare la connessione all’istanza AEM da essa oppure crearne una nuova.
- In AEM, accertati di impostare la password per l’utente remoto della campagna. Devi impostare questa password per collegare Adobe Campaign a AEM. Accedi come amministratore e, nella console di amministrazione utente, cerca l’utente remoto della campagna e fai clic su Imposta password.
Per configurare un account AEM esterno:
-
Vai a Amministrazione > Piattaforma > Account esterni nodo.
-
Crea un nuovo account esterno e seleziona la AEM digitare.
-
Immetti i parametri di accesso per la tua istanza di authoring AEM: l'indirizzo del server, nonché 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 hai impostato una password in AEM.
note note NOTE Assicurati che l'indirizzo del server funzioni not finisce in una barra finale. Ad esempio, immetti https://yourserver:4502
anzichéhttps://yourserver:4502/
-
Assicurati che il Abilitato casella di controllo selezionata.
Verifica dell'opzione AEMResourceTypeFilter verifying-the-aemresourcetypefilter-option
La AEMResourceTypeFilter viene utilizzata per filtrare i tipi di risorse AEM che possono essere utilizzate in Adobe Campaign. Questo consente ad Adobe Campaign di recuperare AEM contenuti appositamente progettati per essere utilizzati solo in Adobe Campaign.
Questa opzione deve essere preconfigurata; tuttavia, se modifichi questa opzione, potrebbe causare un’integrazione non funzionante.
Per verificare la AEMResourceTypeFilter è configurata:
-
Vai a Piattaforma >Opzioni.
-
In AEMResourceTypeFilter controlla che i percorsi siano corretti. Questo campo deve contenere il valore:
mcm/campaign/components/newsletter,mcm/campaign/components/campaign_newsletterpage,mcm/neolane/components/newsletter
In alcuni casi, il valore è il seguente:
mcm/campaign/components/newsletter
Configurazione di Adobe Experience Manager configuring-adobe-experience-manager
Per configurare AEM, è necessario effettuare le seguenti operazioni:
- Configura la replica tra le istanze.
- Collega AEM ad Adobe Campaign tramite Cloud Services.
- Configura l'esternalizzatore.
Configurazione della replica tra istanze AEM configuring-replication-between-aem-instances
Il contenuto creato dall’istanza di authoring AEM viene inviato per la prima volta all’istanza di pubblicazione. Devi pubblicare affinché le immagini nella newsletter siano disponibili nell’istanza di pubblicazione e nei destinatari della newsletter. L’agente di replica deve pertanto essere configurato per replicare dall’istanza di authoring AEM all’istanza di pubblicazione AEM.
URL pubblico: com.day.cq.mcm.campaign.impl.IntegrationConfigImpl#aem.mcm.campaign.publicUrl
Questo passaggio è necessario anche per replicare alcune configurazioni di istanze di authoring nell’istanza di pubblicazione.
Per configurare la replica tra istanze AEM:
-
Dall’istanza di authoring, seleziona Logo AEM> Strumenti icona > Distribuzione > Replica > Agenti sull'autore, quindi fai clic su Agente predefinito.
note note NOTE Evita di utilizzare localhost (ovvero una copia locale di AEM) durante la configurazione dell’integrazione con Adobe Campaign, a meno che l’istanza di pubblicazione e authoring non si trovi entrambi sullo stesso computer. -
Tocca o fai clic su Modifica quindi seleziona la Trasporti scheda .
-
Configura l’URI sostituendo localhost con l’indirizzo IP o l’indirizzo dell’istanza di pubblicazione AEM.
Collegamento AEM ad Adobe Campaign connecting-aem-to-adobe-campaign
Prima di poter utilizzare AEM e Adobe Campaign insieme, è necessario stabilire il collegamento tra entrambe le soluzioni in modo che possano comunicare.
-
Collegati all’istanza di authoring AEM.
-
Seleziona Logo AEM > Strumenti icona > Distribuzione > Cloud Services, quindi Configura ora nella sezione Adobe Campaign .
-
Crea una nuova configurazione immettendo un Titolo e fai clic su Crea oppure scegli la configurazione esistente da collegare alla tua istanza Adobe Campaign.
-
Modifica la configurazione in modo che corrisponda ai parametri dell’istanza Adobe Campaign.
- Nome utente: aemserver, l’operatore del pacchetto di integrazione di Adobe Campaign AEM utilizzato per stabilire il collegamento tra le due soluzioni.
- Password: Password dell'operatore aemserver Adobe Campaign. Potrebbe essere necessario specificare nuovamente la password per questo operatore direttamente in Adobe Campaign.
- Punto finale API: URL dell’istanza di Adobe Campaign.
-
Seleziona Connettersi ad Adobe Campaign e fai clic su OK.
note note NOTE Dopo crea l’e-mail e pubblicala, devi ripubblicare la configurazione nell’istanza di pubblicazione.
- È possibile che si verifichi un problema di certificato quando si utilizza una connessione sicura a un'istanza Adobe Campaign (https). Dovrai aggiungere il certificato dell’istanza Adobe Campaign al cactus file del JDK dell'istanza AEM.
- È necessario configurare un'area di protezione per il operatore aemserver in Adobe Campaign. Inoltre, nella serverConf.xml file, allowUserPassword l'attributo della zona di sicurezza deve essere impostato su true per autorizzare AEM connessione ad Adobe Campaign utilizzando la modalità login/password.
Inoltre, vedi Risoluzione dei problemi relativi all’integrazione AEM/Adobe Campaign.
Configurazione dell’esternalizzatore configuring-the-externalizer
Devi configurare l'esternalizzatore in AEM sull’istanza di authoring. 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 generarli.
Vedi Configurare l’esternalizzatore per istruzioni generali. Per l’integrazione con Adobe Campaign, accertati di configurare il server di pubblicazione in https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImpl
non indicare localhost:4503
ma a un server raggiungibile dalla console Adobe Campaign.
Se indica localhost:4503
Per un altro server che Adobe Campaign non è in grado di raggiungere, le immagini non verranno visualizzate nella console Adobe Campaign.
Configurazioni avanzate advanced-configurations
Puoi anche eseguire alcune configurazioni avanzate, ovvero:
- Gestisci campi e blocchi di personalizzazione.
- Disattiva un blocco di personalizzazione.
- Gestisci i dati dell'estensione target.
Gestione di campi e blocchi di personalizzazione managing-personalization-fields-and-blocks
I campi e i blocchi disponibili per aggiungere personalizzazioni al contenuto delle e-mail in AEM sono gestiti da Adobe Campaign.
Viene fornito un elenco predefinito ma è possibile modificarlo. Puoi anche aggiungere o nascondere campi e blocchi di personalizzazione.
Aggiunta di un campo di personalizzazione adding-a-personalization-field
Per aggiungere un nuovo campo di personalizzazione a quelli già disponibili, devi estendere Adobe Campaign nms:seedMember schema come segue:
-
Vai a Amministrazione > Configurazione > Schemi di dati nella navigazione Adobe Campaign.
-
Seleziona Nuovo.
-
Nella finestra a comparsa, seleziona Estendi i dati nella tabella utilizzando uno schema di estensione e fai clic su Successivo.
-
Immetti i diversi parametri dello schema esteso:
- Schema: seleziona la nms:seedMember schema. Gli altri campi della finestra vengono completati automaticamente.
- Namespace: personalizzare lo spazio dei nomi dello schema esteso.
-
Modificare il codice XML dello schema per specificare il campo da aggiungere. Per ulteriori informazioni sull’estensione degli schemi in Adobe Campaign, consulta la Guida alla configurazione.
-
Salva lo schema, quindi aggiorna la struttura del database Adobe Campaign tramite la Strumenti > Avanzate > Aggiorna struttura del database nella console.
-
Per salvare le modifiche, disconnettiti e riconnettiti alla console Adobe Campaign. Il nuovo campo viene ora visualizzato nell’elenco dei campi di personalizzazione disponibili in AEM.
Esempio example
Per aggiungere una Numero di registrazione è necessario disporre dei seguenti elementi:
- La nms:recipient estensione 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>
La nms:seedMember estensione 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>
La Numero di registrazione Il campo è ora parte dei campi di personalizzazione disponibili:
Nascondere un campo di personalizzazione hiding-a-personalization-field
Per nascondere un campo di personalizzazione tra quelli già disponibili, devi estendere l’Adobe Campaign nms:seedMember schema come descritto in Aggiunta di un campo di personalizzazione sezione . Applica i seguenti passaggi:
-
Copia il campo che desideri rimuovere dal nms:seedMember schema nello schema esteso (cus:seedMember ad esempio).
-
Aggiungi il advanced="true" Attributo XML al campo. Non viene più visualizzato nell’elenco dei campi di personalizzazione disponibili in AEM.
Ad esempio, per nascondere il Nome centrale campo cud:seedMember Lo schema deve contenere l'elemento seguente:
code language-xml <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 deactivating-a-personalization-block
Per disattivare un blocco di personalizzazione tra quelli disponibili:
-
Vai a Risorse > Campaign Management > Blocchi di personalizzazione nella navigazione Adobe Campaign.
-
Seleziona il blocco di personalizzazione da disattivare in AEM.
-
Elimina Visibile nei menu di personalizzazione seleziona e salva le modifiche. Il blocco non viene più visualizzato nell’elenco dei blocchi di personalizzazione disponibili in Adobe Campaign.
Gestione dei dati dell’estensione di destinazione managing-target-extension-data
Puoi anche inserire i dati dell’estensione di destinazione per la personalizzazione. I dati di estensione Target (denominati anche "Dati di Target") derivano, ad esempio, dall’arricchimento o dall’aggiunta di dati in una query in un flusso di lavoro della campagna. Per ulteriori informazioni, consulta la Creazione di query e Arricchimento dei dati sezioni.