DocumentazioneAEM 6.5Guida utente

Creazione di Adobe Campaign Forms nell’AEM creating-adobe-campaign-forms-in-aem

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente

AEM consente di creare e utilizzare moduli che interagiscono con Adobe Campaign sul sito web. Campi specifici possono essere inseriti nei moduli e mappati al database di Adobe Campaign.

Puoi gestire le sottoscrizioni di nuovi contatti, il loro annullamento e i dati del profilo utente, il tutto integrando i relativi dati nel database di Adobe Campaign.

Per utilizzare Adobe Campaign Forms nell’AEM, è necessario seguire questi passaggi, descritti in questo documento:

  1. Rendi disponibile un modello.
  2. Crea un modulo.
  3. Modifica il contenuto del modulo.

Per impostazione predefinita, sono disponibili tre tipi di moduli specifici di Adobe Campaign:

  • Salvare un profilo
  • Abbonati a un servizio
  • Annullare l’abbonamento a un servizio

Questi moduli definiscono un parametro URL che accetta la chiave primaria crittografata di un profilo Adobe Campaign. In base a questo parametro URL, il modulo aggiorna i dati del profilo Adobe Campaign associato.

Anche se questi moduli vengono creati in modo indipendente, in un caso d’uso tipico viene generato un collegamento personalizzato a una pagina di modulo all’interno del contenuto della newsletter, in modo che i destinatari possano aprire il collegamento e apportare modifiche ai dati del loro profilo (sia che si tratti dell’annullamento dell’abbonamento, dell’abbonamento o dell’aggiornamento del profilo).

Il modulo viene aggiornato automaticamente in base all’utente. Per ulteriori informazioni, vedere Modifica contenuto modulo.

Come rendere disponibile un modello making-a-template-available

Prima di poter creare moduli specifici per Adobe Campaign, è necessario rendere disponibili i diversi modelli nell’applicazione AEM.

A questo scopo, consulta la documentazione dei modelli.

Adobe Campaign Prima di tutto, verifica che la connessione tra le istanze di authoring e pubblicazione funzioni correttamente. Consulta Integrazione con Adobe Campaign Standard o Integrazione con Adobe Campaign 6.1.

NOTE
Assicurati che la proprietà acMapping nel nodo jcr:content della pagina sia impostata su mapRecipient o profile quando utilizzi rispettivamente Adobe Campaign 6.1.x o Adobe Campaign Standard

Creazione di un modulo creating-a-form

  1. Inizia in siteadmin.

  2. Scorrere la struttura ad albero per arrivare al punto in cui si desidera creare il modulo nel sito Web scelto.

  3. Seleziona Nuovo > Nuova pagina….

  4. Seleziona il modello Profilo Adobe Campaign (AC 6.1) o Profilo Adobe Campaign (ACS) e immetti le proprietà della pagina.

    note note
    NOTE
    Se il modello non è disponibile, vedere la sezione Come rendere disponibile un modello.

  5. Fai clic su Crea per creare il modulo.

    chlimage_1-187

    Puoi quindi modificare e configurare il contenuto del modulo.

Modifica del contenuto di un modulo editing-form-content

Forms dedicato ad Adobe Campaign dispone di componenti specifici. Questi componenti dispongono di un’opzione che consente di collegare ogni campo del modulo a un campo del database di Adobe Campaign.

NOTE
Se il modello desiderato non è disponibile, vedere Come rendere disponibile un modello.

Questa sezione descrive solo collegamenti specifici ad Adobe Campaign. Per ulteriori informazioni su una panoramica più generale sull'utilizzo dei moduli in Adobe Experience Manager, vedere Componenti Editmode.

  1. Passare al modulo da modificare.

  2. Nella casella degli strumenti, seleziona Pagina > Proprietà pagina…, quindi passa alla scheda Cloud Service della finestra popup.

  3. Aggiungere il servizio Adobe Campaign facendo clic su Aggiungi servizio e selezionando la configurazione corrispondente all'istanza Adobe Campaign nell'elenco a discesa del servizio. Questa configurazione viene eseguita durante la configurazione della connessione tra le istanze. Per ulteriori informazioni, vedere Connessione di AEM ad Adobe Campaign.

    note note
    NOTE
    Se necessario, sblocca la configurazione facendo clic sull’icona del lucchetto per poter aggiungere il servizio Adobe Campaign.

  4. Accedere ai parametri generali del modulo utilizzando il pulsante Modifica presente all'inizio del modulo. La scheda Modulo consente di selezionare una pagina di ringraziamento alla quale l'utente verrà reindirizzato dopo aver convalidato il modulo.

    Il modulo Avanzate ti consente di selezionare il tipo di modulo. Il campo Opzioni Post consente di scegliere tra tre tipi di moduli Adobe Campaign:

    • Adobe Campaign: Salva profilo: consente di creare o aggiornare un destinatario in Adobe Campaign (valore predefinito).
    • Adobe Campaign: Abbonati ai servizi: consente di gestire gli abbonamenti di un destinatario in Adobe Campaign.
    • Adobe Campaign: annulla abbonamento a servizi: consente di annullare gli abbonamenti di un destinatario in Adobe Campaign.

    Il campo Configurazione azione consente di specificare se si desidera creare o meno il profilo del destinatario nel database di Adobe Campaign, se non esiste ancora. A tale scopo, selezionare l'opzione Crea utente se non esistente.

  5. Aggiungere i componenti selezionati trascinandoli dalla casella degli strumenti e rilasciandoli nel modulo. Per ulteriori informazioni sui componenti specifici di Adobe Campaign disponibili, vedi Componenti modulo di Adobe.

    chlimage_1-188

  6. Configurare i campi aggiunti facendo doppio clic su di essi. La scheda Adobe Campaign ti consente di collegare il campo a un campo nella tabella dei destinatari di Adobe Campaign. Puoi anche specificare se il campo fa parte della chiave di riconciliazione, che consente di riconoscere i destinatari già presenti nel database di Adobe Campaign.

    note caution
    CAUTION
    Il Nome elemento deve essere diverso per ogni campo modulo. Se necessario, modificala.
    Ogni modulo deve contenere un componente Chiave primaria crittografata per gestire correttamente i destinatari nel database di Adobe Campaign.

  7. Attiva la pagina selezionando Pagina > Attiva pagina nella casella degli strumenti. La pagina viene attivata sul sito. Puoi visualizzarlo dalla tua istanza di pubblicazione AEM. I dati nel database di Adobe Campaign vengono aggiornati dopo la convalida di un modulo.

Verifica di un modulo testing-a-form

Dopo aver creato un modulo e averne modificato il contenuto, può essere opportuno verificare manualmente il funzionamento previsto.

NOTE
È necessario disporre di un componente Chiave primaria crittografata in ogni modulo. In Componenti, seleziona Adobe Campaign in modo che siano visibili solo i componenti.
Anche se in questa procedura si immette il numero epk manualmente, in pratica, gli utenti riceveranno un collegamento a questa pagina (se annullare l’abbonamento, abbonarsi o aggiornare il profilo) all’interno di una newsletter. In base all’utente, il pk si aggiorna automaticamente.
Per creare il collegamento, si utilizza la variabile Identificatore risorsa principale(Adobe Campaign Standard) o Identificatore crittografato (Adobe Campaign 6.1) (ad esempio, in un componente Text & Personalization (Campaign)), che collega al codice postale in Adobe Campaign.

A questo scopo, devi ottenere manualmente l’EPK di un profilo Adobe Campaign e quindi aggiungerlo all’URL:

  1. Per ottenere la chiave principale crittografata (EPK) di un profilo Adobe Campaign:

    • In Adobe Campaign Standard - Passa a Profili e tipi di pubblico > Profili, in cui sono elencati i profili esistenti. Accertati che nella tabella sia visualizzato il campo Identificatore risorsa principale in una colonna (per configurarlo, tocca o fai clic su Configura elenco). Copia l’identificatore della risorsa principale del profilo desiderato.
    • In Adobe Campaign 6.11, vai a Profili e destinazioni > Destinatari, in cui sono elencati i profili esistenti. Assicurarsi che nella tabella sia visualizzato il campo Identificatore crittografato in una colonna (per configurare questo campo, fare clic con il pulsante destro del mouse su una voce e selezionare Configura elenco…). Copia l’identificatore crittografato del profilo desiderato.

  2. In AEM, aprire la pagina del modulo nell'istanza di pubblicazione e aggiungere l'EPK del passaggio 1 come parametro URL: utilizzare lo stesso nome precedentemente definito nel componente EPK durante la creazione del modulo (ad esempio: ?epk=...)

  3. Il modulo può ora essere utilizzato per modificare i dati e le sottoscrizioni associati al profilo Adobe Campaign collegato. Dopo aver modificato alcuni campi e aver inviato il modulo, puoi verificare in Adobe Campaign che i dati appropriati siano stati aggiornati.

I dati nel database di Adobe Campaign vengono aggiornati dopo la convalida di un modulo.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2