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
  • Amministratore
  • Sviluppatore

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.

Creazione di un modulo creating-a-form

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

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

  1. In AEM, in Sites, individua il punto in cui desideri creare una pagina.

  2. Crea una pagina e seleziona Profilo Adobe Campaign Classic o Profilo Adobe Campaign Standard, quindi fai clic su Avanti.

    chlimage_1-43

    note note
    NOTE
    Se il modello desiderato non è disponibile, vedere Disponibilità modello.

  3. Nel campo Name, aggiungi il nome della pagina. Deve essere un nome JCR valido.

  4. Nel campo Titolo immettere un titolo e fare clic su Crea.

  5. Apri la pagina e seleziona Apri proprietà; in Cloud Service aggiungi la configurazione Adobe Campaign e seleziona il segno di spunta per salvare le modifiche.

    chlimage_1-44

  6. Nel componente Inizio modulo della pagina selezionare il tipo di modulo: Sottoscrivi, Annulla sottoscrizione, o Salva profilo. È possibile specificare un solo tipo per modulo. È ora possibile modificare 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. Seleziona Apri proprietà e in Cloud Service aggiungi la configurazione Adobe Campaign e seleziona il segno di spunta per salvare le modifiche.

    chlimage_1-45

  2. Nel componente Inizio modulo della pagina fare clic sull'icona Configurazione.

    chlimage_1-46

  3. Fare clic sulla scheda Avanzate e selezionare il tipo di modulo corrispondente - Sottoscrivi, Annulla sottoscrizione, o Salva profilo, quindi fare clic su OK. È possibile avere un solo tipo per modulo.

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

  4. È necessario disporre di un componente Chiave primaria crittografata in ogni modulo. Questo componente definisce quale parametro URL viene utilizzato per accettare la chiave primaria crittografata di un profilo Adobe Campaign. In Componenti, seleziona Adobe Campaign in modo che siano visibili solo i componenti.

  5. Trascina il componente Chiave primaria crittografata nel modulo (ovunque) e fai clic sull'icona Configurazione. Nella scheda Adobe Campaign, specifica un nome qualsiasi per il parametro URL. 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 primaria crittografata di un profilo Adobe Campaign. La chiave primaria crittografata deve essere correttamente codificata nell'URL (percentuale).

    chlimage_1-47

  6. Aggiungere al modulo i componenti necessari, ad esempio un campo di testo, un campo di data, un campo casella di controllo, un campo di opzione e così via. Per ulteriori informazioni su ciascun componente, vedere Componenti di Adobe Campaign Form.

  7. Fai clic sull’icona Configurazione per aprire il componente. Ad esempio, nel componente Campo di testo (Campaign), modifica il titolo e il testo.

    Fai clic su Adobe Campaign per mappare il campo modulo a una variabile di metadati Adobe Campaign. Quando invii il modulo, il campo mappato viene aggiornato in Adobe Campaign. Nel selettore delle variabili sono disponibili solo i campi con tipi corrispondenti (ad esempio, le variabili stringa per i campi di testo).

    chlimage_1-48

    note note
    NOTE
    È possibile aggiungere o rimuovere i campi visualizzati nella tabella dei destinatari seguendo le istruzioni disponibili: https://blogs.adobe.com/experiencedelivers/experience-management/aem-campaign-integration/

  8. Fare clic su Pagina Publish. La pagina viene attivata sul sito. Puoi visualizzarlo dalla tua istanza di pubblicazione AEM. È inoltre possibile testare un modulo.

    note caution
    CAUTION
    È necessario fornire autorizzazioni di lettura all’utente anonimo sul servizio cloud per utilizzare i moduli al momento della pubblicazione. Tuttavia, stai attento ai potenziali problemi di sicurezza legati alla fornitura di autorizzazioni di lettura all’utente anonimo e assicurati di attenuarli, ad esempio, configurando il dispatcher.

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 Classic) (ad esempio, in un componente Text & Personalization (Campaign)), che collega all'epk 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 Classic, 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