Show Menu
ARGOMENTI×

Creazione di moduli di Adobe Campaign in AEM

AEM consente di creare e utilizzare i moduli che interagiscono con Adobe Campaign sul tuo sito web. Campi specifici possono essere immessi nei moduli e associati al database Adobe Campaign.
Puoi gestire nuove iscrizioni di contatti, annullamenti di iscrizioni e i dati del profilo utente, il tutto integrando i dati nel tuo database di Adobe Campaign.
Per utilizzare i moduli di Adobe Campaign in AEM, è necessario seguire questi passaggi, descritti in questo documento:
  1. Rendere disponibile un modello.
  2. Creare un modulo.
  3. Modificare il contenuto del modulo.
Sono disponibili tre tipi di moduli, specifici per Adobe Campaign, per impostazione predefinita:
  • Salvare un profilo
  • Iscriversi a un servizio
  • Annullare l’iscrizione a un servizio
Questi moduli definiscono un parametro URL che accetta la chiave principale crittografata di un profilo Adobe Campaign. In base a questo parametro URL, il modulo aggiorna i dati del profilo Adobe Campaign associato.
Anche se si creano i moduli in modo indipendente, in un caso di utilizzo tipico, generi un collegamento personalizzato a una pagina del modulo all'interno del contenuto della newsletter, in modo che i destinatari possano accedere al collegamento e modificare i dati del proprio profilo (per iscriversi, annullare l’iscrizione o aggiornare il profilo).
Il modulo si aggiorna automaticamente a seconda dell’utente. Per ulteriori informazioni, consulta Modifica del contenuto del modulo .

Rendere disponibile un modello

Prima di poter creare i moduli specifici di Adobe Campaign, è necessario rendere disponibili i diversi modelli nell'applicazione AEM.
To do this, see the Templates documentation .

Creazione di un modulo

Innanzitutto, verifica che la connessione tra le istanze di creazione e pubblicazione e Adobe Campaign funzioni correttamente. Consulta Integrazione con Adobe Campaign Standard o Integrazione con Adobe Campaign Classic .
Verifica che la proprietà acMapping sul nodo jcr:content della pagina sia impostata su mapRecipient o profilo quando usi rispettivamente Adobe Campaign Classic o Adobe Campaign Standard.
  1. In AEM, in Sites, spostati nella posizione in cui vuoi creare una nuova pagina.
  2. Create a page and select Adobe Campaign Classic Profile or Adobe Campaign Standard Profile and click Next .
    If the desired template is not available, see Template Availability .
  3. Nel campo Nome , immetti il nome della pagina. Deve essere un nome JCR valido.
  4. Nel campo Titolo , inserisci un titolo e fai clic su Crea .
  5. Apri la pagina e seleziona Apri proprietà , in Servizi cloud aggiungi la configurazione Adobe Campaign e fai clic sul segno di spunta per salvare le modifiche.
  6. Nella pagina, nel componente Inizio modulo , seleziona il tipo di modulo, Sottoscrizione, Cancella sottoscrizione, o Salva profilo . È consentito avere un solo tipo per modulo. Ora puoi modificare il contenuto del modulo .

Modifica del contenuto del modulo

I moduli dedicati ad Adobe Campaign hanno componenti specifici. Questi componenti dispongono di un’opzione per consentire di collegare ciascun campo del modulo a un campo del database di Adobe Campaign.
If the desired template is not available, see Making a template available .
Questa sezione contiene solo dettagli sui collegamenti specifici a Adobe Campaign. For more information on a more general overview of how to use forms in Adobe Experience Manager, see Editmode components .
  1. Seleziona Apri proprietà , nei servizi cloud aggiungi la configurazione Adobe Campaign e fai clic sul segno di spunta per salvare le modifiche.
  2. On the page, in the Form Start component, click the Configuration icon.
  3. Click the Advanced tab and select the type of form it is - Subscribe, Unsubscribe, or Save Profile and click OK. È consentito un solo tipo per modulo.
    • Adobe Campaign: Salva profilo : consente di creare o aggiornare un destinatario in Adobe Campaign (valore predefinito).
    • Adobe Campaign: iscrizione a servizi : consente di gestire le iscrizioni dei destinatari in Adobe Campaign.
    • Adobe Campaign: Annulla iscrizione a servizi : consente di annullare le iscrizioni dei destinatari in Adobe Campaign.
  4. È necessario disporre di un componente di Chiave principale crittografata per ogni modulo. Questo componente definisce quale parametro URL verrà utilizzato per accettare la chiave principale crittografata di un profilo Adobe Campaign. In Components (Componenti), in modo che solo i social media siano visibili.
  5. Drag the component Encrypted Primary Key to the form (anywhere) and click or tap the Configuration icon. Nella scheda Adobe Campaign , specifica un nome per il parametro URL. Tocca o fai clic sul segno di spunta per salvare le modifiche.
    I collegamenti generati a questo modulo devono utilizzare questo parametro URL e assegnargli la chiave principale crittografata di un profilo Adobe Campaign. La chiave principale crittografata deve essere correttamente codificata con l'URL (percentuale).
  6. Aggiungi i componenti del modulo secondo necessità, ad esempio un campo Testo, un campo Data, un campo Casella di selezione, un campo Opzione e così via. Per ulteriori informazioni su ogni componente vedi Componenti del modulo Adobe Campaign .
  7. Fai clic sull'icona Configurazione per aprire il componente. For example, in Text Field (Campaign) component, change the title and text.
    Fai clic su Adobe Campaign per mappare il campo modulo a una variabile di metadati di Adobe Campaign. Quando invii il modulo, il campo mappato viene aggiornato in Adobe Campaign. Nel selezionatore delle variabili sono disponibili solo campi con tipi corrispondenti (ad esempio, le variabili stringa per i campi di testo).
    You can add/remove fields that are displayed in the recipient table by following the instructions here: https://blogs.adobe.com/experiencedelivers/experience-management/aem-campaign-integration/
  8. Fai clic su Pubblica pagina . La pagina viene attivata sul tuo sito. È possibile visualizzarla accedendo al’'istanza di pubblicazione di AEM. Puoi inoltre verificare il funzionamento di un modulo .
    È necessario immettere permessi di lettura per gli utenti anonimi sul servizio cloud per utilizzare i moduli in pubblicazione. Tuttavia, possono esistere potenziali problemi di sicurezza quando si forniscono autorizzazioni di lettura a utenti anonimi, per attenuarli è consigliabile configurare il distributore.

Test di un modulo

Dopo aver creato un modulo e modificato il suo contenuto, potresti voler verificare che funzioni come previsto.
You must have an Encryted Primary Key component on each form. In Components (Componenti), in modo che solo i social media siano visibili.
Anche se in questa procedura si inserisce il numero EPK manualmente, in pratica gli utenti otterrebbero un collegamento a questa pagina (che sia per annullare l’iscrizione, iscriversi o aggiornare il profilo) all'interno di una newsletter. In base all'utente, l’EPK si aggiorna automaticamente.
To create that link, you use the variable Main resource identifier (Adobe Campaign Standard) or Encrypted identifier (Adobe Campaign Classic) (for example, in a Text & Personalization (Campaign) component), which links to the epk in Adobe Campaign.
Per eseguire questa operazione, è necessario ottenere manualmente l'EPK da un profilo Adobe Campaign e aggiungerlo all'URL:
  1. Per ottenere la chiave crittografata primaria (EPK) di un profilo Adobe Campaign:
    • In Adobe Campaign Standard - Navigate to Profiles and Audiences > Profiles , which lists the existing profiles. Make sure the table displays the Main Resource Identifier field in a column (This can be configured by clicking/tapping Configure list ). Copia l’identificatore della risorsa principale del profilo desiderato.
    • In Adobe Campaign Classic, go to Profiles and Targets > Recipients , which lists the existing profiles. Make sure the table displays the Encrypted identifier field in a column (This can be configured by right-clicking on an entry and selecting Configure list... ). Copia l’identificatore crittografato del profilo desiderato.
  2. In AEM, open the form page on the publish instance and append the EPK from step 1 as a URL parameter: use the same name that you previously defined in the EPK component when authoring the form (for example: ?epk=... )
  3. Ora puoi usare il modulo per modificare i dati e le iscrizioni associati al profilo Adobe Campaign collegato. Dopo aver modificato alcuni campi e inviato il modulo, puoi verificare in Adobe Campaign che siano stati aggiornati i dati relativi.
I dati nel database di Adobe Campaign vengono aggiornati quando viene convalidato un modulo.