DocumentazioneJourney OptimizerGuida di Journey Optimizer

Utilizzare campi modulo modificabili in esperienze basate su codice code-based-form-fields

Last update: Mon Aug 25 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Esperto
  • Utente

Per una maggiore flessibilità e un maggiore controllo sulle esperienze basate su codice, Journey Optimizer consente al team di sviluppo di creare modelli di contenuto JSON o HTML contenenti specifici campi modificabili predefiniti.

Durante la creazione di un’esperienza basata su codice, gli esperti di marketing non tecnici possono quindi modificare direttamente questi campi nell’interfaccia, senza dover nemmeno aprire l’editor di personalizzazione o toccare altri elementi di codice nel loro percorso o campagna.

Questa funzionalità offre un’esperienza semplificata per gli utenti di marketing, consentendo al contempo agli sviluppatori un maggiore controllo sul contenuto del codice, con conseguente minore spazio per gli errori.

Comprendere la sintassi del campo modulo form-field-syntax

Per rendere modificabili parti di un payload di codice HTML o JSON, è necessario utilizzare una sintassi specifica nell’editor di espressioni. Ciò comporta la dichiarazione di una variabile con un valore predefinito che gli utenti possono ignorare dopo aver applicato il modello di contenuto alla propria esperienza basata su codice.

Si supponga, ad esempio, di voler creare un modello di contenuto da applicare alle esperienze basate su codice e di consentire agli utenti di personalizzare un colore specifico utilizzato in posizioni diverse, ad esempio cornici o colori di sfondo dei pulsanti.

Quando crei il modello di contenuto, devi dichiarare una variabile con un ID univoco, ad esempio "color", e chiamarla nelle posizioni desiderate nel contenuto in cui desideri applicare questo colore.

Quando si applica il modello di contenuto al proprio contenuto, gli utenti potranno personalizzare il colore utilizzato ovunque si faccia riferimento alla variabile.

Aggiungere campi modificabili ai modelli di contenuto HTML o JSON add-editable-fields

Per rendere modificabile parte del codice JSON o HTML, inizia creando un modello di contenuto esperienza basato su codice in cui puoi definire campi modulo specifici.

NOTE
Questo passaggio viene in genere eseguito da un utente sviluppatore.

➡️ Scopri come aggiungere campi modificabili ai modelli di esperienza basati su codice in questo video

  1. Crea un modello di contenuto e seleziona il canale esperienza basata su codice. Scopri come creare i modelli

  2. Seleziona la modalità di authoring: HTML o JSON.

    note caution
    CAUTION
    La modifica della modalità di authoring comporterà la perdita di tutto il codice corrente. Le esperienze basate su codice basate su questo modello devono utilizzare la stessa modalità di authoring.

  3. Apri l'editor di personalizzazione per modificare il contenuto del codice.

  4. Per definire un campo modulo modificabile, passa al menu Funzioni helper nel riquadro di navigazione a sinistra e aggiungi l'attributo inline. La sintassi per dichiarare e chiamare la variabile viene aggiunta automaticamente nel contenuto.

    {width="85%"}

  5. Sostituire "name" con un ID univoco per identificare il campo modificabile. Ad esempio, immetti "imgURL".

    note note
    NOTE
    L’ID del campo deve essere univoco e non può contenere spazi. Questo ID deve essere utilizzato ovunque nel contenuto in cui desideri visualizzare il valore della variabile.

  6. Adatta la sintassi in base alle tue esigenze aggiungendo i parametri descritti nella tabella seguente:

    table 0-row-3 1-row-3 2-row-3
    Azione Parametro Esempio
    Dichiara un campo modificabile con un valore predefinito. Quando aggiungi il modello al contenuto, questo valore predefinito verrà utilizzato se non lo personalizzi. Aggiungi il valore predefinito tra i tag in linea. {{#inline "editableFieldID"}}default_value{{/inline}}
    Definisci una etichetta per il campo modificabile. Questa etichetta verrà visualizzata nell’editor di codice quando si modificano i campi del modello. name="title" {{#inline "editableFieldID" name="title"}}default_value{{/inline}}

  7. Fai clic su Anteprima campi modulo per verificare come verranno visualizzati i campi del modulo modificabili nelle esperienze basate su codice che applicano questo modello.

    {width="85%"}

  8. Utilizza la sintassi {{{name}}} nel codice in ogni posizione in cui desideri visualizzare il valore del campo modificabile. Sostituisci name con l'ID univoco del campo definito in precedenza.

    {width="85%"}

  9. Procedi in modo simile per aggiungere altri campi modificabili, racchiudendoli ciascuno con i tag {{#inline}} e {{/inline}}.

  10. Modifica il resto del codice in base alle esigenze, inclusi gli ID corrispondenti ai campi modificabili definiti. Scopri come

  11. Salva il modello.

Utilizzare i criteri di decisione nei moduli campo modificabili decision-policy-in-form-fields

Quando crei un modello di contenuto di esperienza basato su codice, puoi utilizzare un criterio decisionale per sfruttare le offerte nei campi modificabili del modulo.

  1. Crea un modello di esperienza basato su codice come descritto sopra.

  2. Fai clic su Aggiungi criterio di decisione utilizzando l'icona Mostra criterio di decisione nella barra a destra della schermata dell'edizione oppure nell'editor espressioni dalla sezione Criterio di decisione nel menu a sinistra.

    Scopri come creare un criterio di decisione in questa sezione.

  3. Fare clic sul pulsante Inserisci criterio. Viene aggiunto il codice corrispondente al criterio di decisione.

  4. Dopo il tag {{#each}}, inserisci il codice corrispondente ai campi modulo modificabili che desideri aggiungere, utilizzando la sintassi inline descritta sopra. Sostituisci "name" con un ID univoco per identificare il campo modificabile. In questo esempio, utilizza "title".

    {width="90%"}

  5. Fai clic su Anteprima campi modulo per verificare come verranno visualizzati i campi del modulo modificabili nelle esperienze basate su codice che applicano questo modello.

    {width="70%"}

  6. Inserire il resto del codice sopra il tag {{/each}}. Utilizza la sintassi {{{name}}} nel codice in ogni posizione in cui desideri visualizzare il valore del campo modificabile. In questo esempio, sostituire name con "title".

    {width="85%"}

  7. Salva il modello.

Esempi di codice code-examples

Di seguito sono riportati alcuni esempi di modelli JSON e HTML, alcuni dei quali includono i criteri di decisione.

Modello JSON:

{{#inline "title" name="Title"}}Best gear for winter is here for you!{{/inline}}
{{#inline "description" name="Description"}}Add description{{/inline}}
{{#inline "imgURL" name="Image Link"}}Add link{{/inline}}
{{#inline "number_of_items" name="Number of items"}}23{{/inline}}

{
  "title": "{{{title}}}",
  "description": "{{{description}}}",
  "imageUrl": "{{{imgURL}}}",
  "number_of_items": {{{number_of_items}}},
  "code": "DEFAULT"
}
NOTE
Quando si fa riferimento ai campi in linea nel payload JSON:
  • I campi di tipo stringa devono essere racchiusi tra virgolette.
  • I numeri interi o i numeri booleani NON devono essere racchiusi tra virgolette doppie. (Vedi il campo number_of_items nell'esempio precedente.)

Modello JSON con decisioning:

{
"offer": [
{{#each decisionPolicy.fff709b7-7fef-4e4e-83d7-594fbcf196c1.items as |item|}}
{{#inline "title" name="Title"}}{{item._mobiledx.Title1}}{{/inline}} {{#inline "description" name="Description"}}{{item._mobiledx.Title2}}{{/inline}} {{#inline "imgURL" name="Image Link"}}https://luma.enablementadobe.com/content/luma/us/en/experience/warming-up/_jcr_content/root/hero_image.coreimg.jpeg{{/inline}}

{
"title": "{{{title}}}",
"description": "{{{description}}}",
"imageUrl": "{{{imgURL}}}",
"link": "https://lumaenablement.adobe.com/web/luma/home", "code": "DEFAULT"
},
{{/each}}
]
}
NOTE
I campi in linea per i quali si desidera utilizzare elementi decisionali devono essere inseriti all'interno del blocco dei criteri di decisione, tra i tag {{#each}} e {{/each}}.

Modello HTML:

{{#inline "title" name="Title"}}Please enter title here{{/inline}}
{{#inline "imgSrc" name="Image link"}}{{/inline}}

<div class="TopRibbon__content"><img style="padding: 5px 10px;" class="TopRibbon__image" src="{{{imgSrc}}}" />{{{title}}}</div>
<style> .theme-luma .TopRibbon { background-color: #200098; }</style>

Modello HTML con decisioning:

{{#each decisionPolicy.f112884a-5654-43ad-9d6d-dbd32ae23ee6.items as |item|}}
{{#inline "title" name="Title"}}Title is: {{item._mobiledx.Title1}}{{/inline}}

<div class="TopRibbon__content"><img style="padding: 5px 10px;" class="TopRibbon__image" src="{{item._mobiledx.HeroBannerImage.sourceURL}}" />{{{title}}}</div>
<style> .theme-luma .TopRibbon { background-color: #200098; }</style>

{{/each}}

Modificare i campi modulo in un’esperienza basata su codice edit-form-fields

Dopo aver creato il modello di contenuto contenente campi modulo modificabili predefiniti, è possibile creare un’esperienza basata su codice utilizzando questo modello di contenuto.

Potrai modificare facilmente i campi modulo da un percorso di esperienza o da una campagna basata su codice, senza aprire l’editor di personalizzazione.

NOTE
Questo passaggio viene in genere eseguito da un utente esperto di marketing.

  1. Dall’attività di percorso o dalla schermata di edizione della campagna, seleziona il modello di contenuto contenente i campi del modulo modificabili. Scopri come utilizzare i modelli di contenuto

    {width="60%"}

    note caution
    CAUTION
    I modelli disponibili per la scelta hanno l’ambito HTML o JSON in base alla configurazione del canale selezionata in precedenza. Vengono visualizzati solo i modelli compatibili.

  2. I campi predefiniti nel modello di contenuto selezionato sono disponibili nel riquadro di destra.

  3. Dalla sezione Campi modulo modificabili è possibile:

    • Modifica ogni valore direttamente all’interno dei campi modificabili, senza aprire l’editor di codice.

    {width="60%"}

    • Fai clic sull'icona di personalizzazione per modificare ogni campo utilizzando l'editor di codice.

    {width="70%"}

    note note
    NOTE
    In entrambi i casi, puoi modificare un solo campo alla volta e non il resto del contenuto dell’esperienza basato sul codice.

  4. Se un criterio di decisione è stato aggiunto al modello di contenuto, include tutti gli attributi disponibili nello schema del catalogo offerte. Puoi modificare l’elemento di decisione in linea o utilizzando l’editor di espressioni.

  5. Per modificare il resto del codice, fai clic sul pulsante Modifica codice e aggiorna il contenuto completo dell'esperienza basata sul codice, inclusi i campi del modulo modificabili. Ulteriori informazioni

Video introduttivo video

Scopri come aggiungere campi modificabili ai modelli di contenuto del canale di esperienza basati su codice.

https://video.tv.adobe.com/v/3463999/?learn=on&enablevpops&captions=ita
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76