Esportazione di frammenti di esperienza in Adobe Target exporting-experience-fragments-to-adobe-target
Puoi esportare Frammenti esperienza, creati in Adobe Experience Manager (AEM), in Adobe Target (Target). Possono quindi essere utilizzate come offerte nelle attività di Target, per testare e personalizzare le esperienze su larga scala.
Sono disponibili tre opzioni di formato per esportare un frammento di esperienza in Adobe Target:
- HTML (predefinito): supporto per la distribuzione di contenuti web e ibridi
- JSON: supporto per la distribuzione di contenuti headless
- HTML e JSON
I Frammenti esperienza AEM possono essere esportati nell’area di lavoro predefinita in Adobe Target o in aree di lavoro definite dall’utente per Adobe Target. Questa operazione viene eseguita utilizzando Adobe Developer Console, per il quale AEM deve essere integrato con Adobe Target utilizzando IMS.
Prerequisiti prerequisites
Sono necessarie diverse azioni:
-
Devi integrare AEM con Adobe Target utilizzando IMS.
note note NOTE Le integrazioni IMS sono ora configurate con OAut S2S. Le configurazioni precedenti sono state create con credenziali JWT che ora sono soggette a deprecazione in Adobe Developer Console. -
I frammenti di esperienza vengono esportati dall'istanza di creazione dell'AEM, pertanto devi Configurare AEM Link Externalizer nell'istanza di authoring per garantire che tutti i riferimenti all'interno del frammento di esperienza siano esternalizzati per la distribuzione Web.
note note NOTE Per la riscrittura di collegamenti non coperti dall’impostazione predefinita, è disponibile il provider del rewriter di collegamento di Frammento esperienza. Con questo, è possibile sviluppare regole personalizzate per la tua istanza.
Aggiungere la configurazione cloud add-the-cloud-configuration
Prima di esportare un frammento, devi aggiungere la Configurazione cloud per Adobe Target al frammento o alla cartella. Questo consente anche di:
- specificare le opzioni di formato da utilizzare per l'esportazione
- selezionare un’area di lavoro di Target come destinazione
- selezionare un dominio esternalizzatore per riscrivere i riferimenti nel frammento di esperienza (facoltativo)
Le opzioni richieste possono essere selezionate in Proprietà pagina della cartella e/o del frammento richiesti; la specifica viene ereditata in base alle necessità.
-
Passa alla console Frammenti di esperienza.
-
Apri Proprietà pagina per la cartella o il frammento appropriato.
note note NOTE Se aggiungi la configurazione cloud alla cartella principale Frammento di esperienza, questa viene ereditata da tutti gli elementi secondari. Se aggiungi la configurazione cloud al frammento di esperienza stesso, questa viene ereditata da tutte le varianti. -
Seleziona la scheda Servizi cloud.
-
Sotto Configurazione servizio cloud, seleziona Adobe Target dall’elenco a discesa.
note note NOTE È possibile personalizzare il formato JSON di un’offerta Frammento di esperienza. A questo scopo, definisci un componente Frammento esperienza cliente e annota come esportare le sue proprietà nel modello Sling del componente. Consulta il componente core: Componenti core: Frammenti di esperienza Sotto Adobe Target seleziona:
- la configurazione appropriata
- l’opzione di formato richiesta
- un’area di lavoro Adobe Target
- se necessario, il dominio esternalizzatore
note caution CAUTION Il dominio esternalizzatore è facoltativo. Un esternalizzatore AEM è configurato quando desideri che il contenuto esportato punti a uno specifico dominio publish. Per ulteriori dettagli, vedere Configurazione di AEM Link Externalizer. Inoltre, i domini esternalizzatori sono rilevanti solo per il contenuto del Frammento di esperienza inviato a Target, e non per i metadati come Visualizza contenuto offerta. Ad esempio, per una cartella:
-
Salva e chiudi.
Esportazione di un frammento di esperienza in Adobe Target exporting-an-experience-fragment-to-adobe-target
Per esportare un frammento di esperienza da AEM a Target (dopo aver specificato la configurazione cloud):
-
Passa alla console Frammenti di esperienza.
-
Seleziona il frammento di esperienza da esportare in Target.
note note NOTE Deve essere una variante Web del frammento di esperienza. -
Fai clic su Esporta in Adobe Target.
note note NOTE Se il frammento di esperienza è già stato esportato, seleziona Aggiorna in Adobe Target. -
Fai clic su Esporta senza pubblicare o Publish come richiesto.
note note NOTE Selezionando Publish il frammento di esperienza viene pubblicato immediatamente e inviato a Target. -
Fare clic su OK nella finestra di conferma.
Il frammento di esperienza dovrebbe ora essere in Target.
note note NOTE Vari dettagli dell'esportazione sono visibili in Vista a elenco della console e Proprietà. note note NOTE Quando visualizzi un frammento di esperienza in Adobe Target, la data dell'ultima modifica visualizzata è la data dell’ultima modifica apportata al frammento in AEM, non la data dell’ultima esportazione del frammento in Adobe Target.
Utilizzo dei frammenti di esperienza in Adobe Target using-your-experience-fragments-in-adobe-target
Dopo aver eseguito le attività precedenti, il frammento di esperienza viene visualizzato nella pagina Offerte di Adobe Target. Consulta la documentazione specifica di Target per scoprire cosa puoi ottenere.
Eliminazione di un frammento di esperienza già esportato in Adobe Target deleting-an-experience-fragment-already-exported-to-adobe-target
L’eliminazione di un frammento di esperienza già esportato in Target può causare problemi se il frammento è già utilizzato in un’offerta in Adobe Target. L’eliminazione del frammento renderebbe l’offerta inutilizzabile mentre il contenuto del frammento è distribuito da AEM.
Per evitare tali situazioni:
-
Se il frammento di esperienza non è attualmente utilizzato in un’attività, AEM consente all’utente di eliminarlo senza un messaggio di avviso.
-
Se il frammento di esperienza è utilizzato da un’attività in Adobe Target, un messaggio di errore avvisa l’utente AEM delle possibili conseguenze che l’eliminazione del frammento avrà sull’attività.
Il messaggio di errore in AEM non impedisce all’utente di (forzare) eliminare il frammento di esperienza. Se il frammento di esperienza viene eliminato:
-
L’offerta Target con il frammento di esperienza AEM può mostrare un comportamento indesiderato
- L'offerta sarà probabilmente ancora visualizzata, poiché l'HTML del frammento di esperienza è stato inviato su Target
- Eventuali riferimenti nel frammento di esperienza potrebbero non funzionare correttamente se le risorse di riferimento sono state eliminate anche in AEM.
-
Qualsiasi ulteriore modifica al frammento di esperienza è impossibile in quanto non esiste più nel AEM.
-
Rimozione delle ClientLibs dai frammenti esperienza esportati in Target removing-clientlibs-from-fragments-exported-target
I frammenti di esperienza contengono tag HTML completi e tutte le librerie client (CSS/JS) necessarie per eseguire il rendering del frammento esattamente come è stato creato dall’autore del contenuto dei frammenti di esperienza. Questo è by-design.
Quando si utilizza un’offerta Frammento di esperienza con Adobe Target in una pagina consegnata dall’AEM, la pagina Target contiene già tutte le librerie client necessarie. Inoltre, nemmeno l'HTML estraneo nell'offerta Frammento di esperienza è necessario (vedi Considerazioni).
Di seguito è riportato uno pseudo esempio dell’html in un’offerta per frammenti di esperienza:
<!DOCTYPE>
<html>
<head>
<title>…</title>
<!-- all the client libraries (css/js) -->
…
</head>
<body>
<!--/* Actual XF Offer content would appear here... */-->
</body>
</html>
Ad alto livello, quando l’AEM esporta un frammento di esperienza in Adobe Target, lo fa utilizzando diversi selettori Sling aggiuntivi. Ad esempio, l'URL per il frammento di esperienza esportato potrebbe essere simile al seguente (avviso nocloudconfigs.atoffer):
- http://www.your-aem-instance.com/content/experience-fragments/my-offers/my-xf-offer.nocloudconfigs.atoffer.html
Il selettore nocloudconfigs è definito utilizzando HTL e può essere sovrapposto copiandolo da:
- /libs/cq/experience-fragments/components/xfpage/nocloudconfigs.html
Il selettore atoffer è applicato alla post-elaborazione utilizzando Sling Rewriter. Entrambi possono essere utilizzati per rimuovere le librerie client.
Esempio example
A tale scopo, illustriamo come eseguire questa operazione con nocloudconfigs.
Sovrapposizioni overlays
In questo esempio, le sovrapposizioni incluse rimuoveranno le librerie client e l'html estraneo. Si presume che tu abbia già creato il tipo di modello Frammento esperienza. I file necessari che devono essere copiati da /libs/cq/experience-fragments/components/xfpage/ includono:
nocloudconfigs.htmlhead.nocloudconfigs.htmlbody.nocloudconfigs.html
Sovrapposizioni tipo di modello template-type-overlays
Ai fini di questo esempio, consideriamo la seguente struttura:
Il contenuto di questi file è il seguente:
-
body.nocloudconfigs.html
-
head.nocloudconfigs.html
-
nocloudconfigs.html
data-sly-unwrap per rimuovere il tag body, è necessario nocloudconfigs.html.Considerazioni considerations
Se devi supportare sia i siti AEM che i siti non AEM utilizzando le Offerte di frammenti di esperienza in Adobe Target, devi creare due Frammenti di esperienza (due diversi tipi di modelli):
-
Uno con la sovrapposizione per rimuovere clientlibs/html aggiuntivo
-
Uno che non ha la sovrapposizione e quindi include le clientlibs richieste