Utilizzare frammenti dinamici dynamic-fragments

In questa pagina: scopri come utilizzare la risoluzione dei frammenti dinamici in Adobe Journey Optimizer per selezionare il frammento pubblicato da inserire in un messaggio in fase di esecuzione, in base agli attributi di profilo, alle ricerche di set di dati o ai dati contestuali passati al momento dell’invio.

Adobe Journey Optimizer supporta la risoluzione frammento dinamico in fase di esecuzione, consentendo di selezionare il frammento pubblicato inserito in un messaggio in base agli attributi di profilo, alle ricerche di set di dati o ai dati contestuali passati al momento dell’invio. Ciò consente di ottenere contenuti altamente personalizzati senza duplicare la logica di campagna o di percorso.

Panoramica overview

Frammenti statici sono incorporati in un messaggio in fase di progettazione. Lo stesso frammento viene utilizzato per ogni destinatario. I frammenti dinamici risolvono l’ID frammento in fase di esecuzione per destinatario, il che significa che profili diversi possono ricevere blocchi di contenuto completamente diversi all’interno della stessa campagna o dello stesso percorso.

Gli ID frammento dinamico possono provenire da tre origini:

Prerequisiti prerequisites

Prima di utilizzare i frammenti dinamici, verifica che siano presenti gli elementi seguenti:

Passaggio 1: creare e pubblicare il frammento create-fragment

Prima di fare riferimento a un frammento in modo dinamico, è necessario pubblicarlo in Journey Optimizer.

Passaggio 2: creare il messaggio con un riferimento a un frammento dinamico author-message

Nell’editor di personalizzazione, inserisci il segnaposto del frammento dinamico utilizzando la sintassi seguente:

{{fragment id=dynamic_fragment_id}}

L’identificatore dynamic_fragment_id è un nome di variabile. Il relativo valore deve essere risolto prima che venga eseguita la ricerca del frammento. Puoi risolverlo utilizzando un’espressione di ricerca del set di dati, un attributo di profilo o dati contestuali.

Risolvere da una ricerca di set di dati resolve-from-dataset

Se l’ID frammento è memorizzato in un set di dati di AEP (ad esempio, una tabella di mappatura stile-frammento), utilizza la funzione helper datasetLookup per risolverlo:

{{
  {datasetLookup datasetId="<your-dataset-id>" key=profile.style attribute="fragmentId"}
}}

{{fragment id=dynamic_fragment_id}}

In questo esempio, il set di dati contiene righe con chiave da un valore di stile (ad esempio style1). Per un determinato profilo, la ricerca recupera il valore di colonna fragmentId corrispondente e lo assegna a dynamic_fragment_id, che viene quindi utilizzato per risolvere il frammento.

Risolvi da dati contestuali resolve-from-context

Se l’ID frammento viene fornito al momento dell’invio come parte del contesto della richiesta API, fai riferimento a esso utilizzando lo spazio dei nomi context:

{{fragment id=context.audiencePayload.fragmentId}}

Il percorso context.audiencePayload è il prefisso richiesto per tutti gli attributi originati da un file di pubblico CSV o passati tramite il contesto della richiesta API. Il nome di colonna dal file CSV (ad esempio, fragmentId) segue il prefisso.

Risolvi da un attributo di profilo resolve-from-profile

Se l’ID frammento è memorizzato come attributo di profilo in Adobe Experience Platform, fai riferimento direttamente a esso:

{{fragment id=profile.mi.fragmentId}}

Passaggio 3: configurare il set di dati per l’approccio di ricerca configure-dataset

Se utilizzi l’approccio di ricerca dei set di dati, aggiorna lo schema e i dati del set di dati in modo che riportino l’ID del frammento.

Struttura di esempio del set di dati:

Passaggio 4: trasmettere i dati contestuali al momento dell’invio pass-context-data

Se stai risolvendo l’ID frammento dai dati contestuali (ad esempio, da un file di consigli del pubblico CSV), passa l’ID frammento nella richiesta API sotto il prefisso di contesto richiesto.

Quando utilizzi l’API di verifica della campagna, includi l’ID frammento nell’oggetto context:

{
  "recipients": [
    {
      "userId": "<profile-email>",
      "namespace": "email"
    }
  ],
  "inChannelData": {
    "channel": "email",
    "emailAddresses": ["<delivery-address>"]
  },
  "context": {
    "audiencePayload": {
      "fragmentId": "<published-fragment-id>",
      "systemSource": "<optional-system-value>"
    }
  }
}

Il prefisso context.audiencePayload è obbligatorio. Gli attributi nidificati sotto questa chiave vengono mappati direttamente alle colonne nel file del pubblico CSV durante l’esecuzione della campagna live.

Passaggio 5: verifica e convalida proof-validate

Prima di attivare la campagna, utilizza l’API di verifica della campagna per verificare che il frammento dinamico si risolve correttamente e che l’output dell’e-mail sottoposto a rendering sia come previsto.

Per ulteriori informazioni sull’API di Campaign, consulta la documentazione delle API di Journey Optimizer.

Guardrail e limitazioni guardrails

Quando si utilizzano frammenti dinamici, si applicano le seguenti limitazioni:

Ulteriori guardrail applicabili ai frammenti sono disponibili in questa sezione.

Gestione degli errori error-handling

Se un frammento dinamico non viene risolto in fase di runtime, viene generato un evento di esclusione per il profilo interessato. Attualmente, tutti gli errori di rendering dei frammenti sono classificati come un singolo tipo di errore aperto.

Per eseguire il debug degli errori di risoluzione dei frammenti: