Show Menu
ARGOMENTI×

Estensione Adobe Target v2

Utilizza questo riferimento per informazioni sulle opzioni disponibili quando utilizzi questa estensione per creare una regola.

Configura l'estensione Adobe Target v2

L'estensione Adobe Target richiede At.js 2.x.
Se l'estensione Adobe Target non è ancora installata, apri la proprietà, quindi fai clic su Extensions > Catalog , passa il puntatore del mouse sull'estensione di Target e fai clic su Install .
Per configurare l'estensione, apri la scheda Extensions, passa il puntatore sull'estensione e fai clic su Configure .

Impostazioni at.js

Tutte le impostazioni at.js, a eccezione del Timeout, vengono recuperate automaticamente dalla configurazione at.js nell'interfaccia utente di Target. L'estensione recupera le impostazioni dall'interfaccia utente di Target quando viene aggiunta per la prima volta, pertanto tutte le impostazioni devono essere gestite nell'interfaccia di Launch se sono necessari aggiornamenti aggiuntivi.
Sono disponibili le seguenti configurazioni:

Codice client

Il codice client è l'identificatore account di Target. Questo valore dovrebbe essere quasi sempre lasciato come predefinito.
Può essere modificato tramite elementi di dati.

ID organizzazione

Questo ID collega l'implementazione al tuo account Adobe Experience Cloud. Questo valore dovrebbe essere quasi sempre lasciato come predefinito.
Può essere modificato tramite elementi di dati.

Dominio server

Il dominio in cui vengono inviate le richieste Target. Questo valore dovrebbe essere quasi sempre lasciato come predefinito.

Consenso RGPD

Quando abilitato, Adobe Target fornisce funzionalità opt-in per supportare la strategia di gestione del consenso. La funzionalità opt-in consente ai clienti di controllare come e quando viene attivato il tag di Target. Per ulteriori informazioni sul consenso di Adobe, consulta Privacy e Regolamento generale sulla protezione dei dati (GDPR) .

Timeout (ms)

Se la risposta di Target non viene ricevuta entro il periodo definito, la richiesta scade e viene visualizzato il contenuto predefinito. Durante la sessione del visitatore vengono ripetuti ulteriori tentativi di richiesta. Il valore predefinito è 3000 ms, che potrebbe essere diverso dal Timeout configurato nell'interfaccia utente di Target.
Per ulteriori informazioni sul funzionamento dell'impostazione Timeout, consulta la guida di Adobe Target .

Tipi di azione dell'estensione Target

In questa sezione sono descritti i tipi di azione disponibili nell'estensione Target.
L'estensione Target fornisce le seguenti azioni nella sezione Then di una regola:

Load Target

Aggiungi questa azione alla regola Launch in cui si consiglia di caricare Target nel contesto della regola. Questo carica la libreria at.js nella pagina. Nella maggior parte delle implementazioni, Target deve essere caricato su ogni pagina del sito.
Non è necessaria alcuna configurazione.

Aggiungi parametri a All Requests

Aggiungi parametri a tutte le richieste di Target. L'azione Load Target deve essere utilizzata in precedenza.
  1. Specifica il nome e il valore del parametro che desideri aggiungere.
  2. Fai clic sull'icona Add per aggiungere altri parametri.

Aggiungi parametri alla Page Load Request

Aggiungi parametri solo alle richieste di caricamento della pagina. L'azione Load Target deve essere utilizzata in precedenza.
  1. Specifica il nome e il valore del parametro che desideri aggiungere.
  2. Fai clic sull'icona Add per aggiungere altri parametri.

Avvia Page Load Request

Avvia una richiesta Target al caricamento della pagina. L'azione Load Target deve essere utilizzata in precedenza.
Specifica se abilitare nascondi corpo in modo da prevenire instabilità e lo stile utilizzato per nascondere l'elemento del corpo.
Sono disponibili le seguenti opzioni:
  • Nascondi corpo: puoi abilitare o disabilitare questa impostazione. Il valore predefinito è Enabled: ciò significa che HTML BODY è nascosta.
  • Stile corpo nascosto: il valore predefinito è body. Questo valore può essere modificato in uno diverso, ad esempio body.
Per ulteriori informazioni, consulta la documentazione online di Target .

Attiva visualizzazione

Attiva una visualizzazione per le Single Page Applications.
  1. Specifica il nome della visualizzazione da attivare.
  2. Specifica se l'attivazione della visualizzazione deve essere attribuita a un'impression per il reporting controllando la casella di controllo Page. Se la visualizzazione è correlata a un componente nuovamente sottoposto a rendering e non attribuisce a un'impression per il reporting, lascia la casella di controllo Page deselezionata.
Per ulteriori informazioni sull’attivazione di una visualizzazione, consulta la triggerView() .

Implementazione di base di Adobe Target

Una volta installata l'estensione Target, crea almeno una regola per distribuita correttamente. Devi innanzitutto caricare la libreria Target (at.js), specificare i parametri che desideri utilizzare con la richiesta di caricamento della pagina e attivare la richiesta di caricamento della pagina.
Una regola Target con questa implementazione di base si presenta così:
Dopo aver salvato questa regola, devi aggiungerla a una libreria e generarla/distribuirla in modo da poter testare il comportamento.

Estensione Adobe Target con implementazione asincrona

Launch può essere distribuito in modo asincrono. Se carichi la libreria Launch in modo asincrono con Target al suo interno, anche Target verrà caricato in modo asincrono. Si tratta di uno scenario completamente supportato, ma bisogna fare una valutazione aggiuntiva.
In implementazioni asincrone, la pagina può terminare il rendering del contenuto predefinito prima che la libreria di Target sia completamente caricata e abbia eseguito lo scambio di contenuto. Questo può causare il cosiddetto "sfarfallio" in cui il contenuto predefinito viene visualizzato brevemente prima di essere sostituito dal contenuto personalizzato specificato da Target. Se desideri evitare questo sfarfallio, consigliamo di utilizzare un frammento pre-hiding e di caricare il bundle Launch in modo asincrono per evitare sfarfallii del contenuto.
Di seguito sono riportati alcuni aspetti da tenere presenti quando si utilizza il frammento pre-hiding:
  • Il frammento deve essere aggiunto prima di caricare il codice di incorporamento dell'intestazione Launch.
  • Questo codice non può essere gestito da Launch, pertanto deve essere aggiunto direttamente alla pagina.
  • La pagina viene visualizzata quando si verifica il primo degli eventi seguenti:
    • Quando è stata ricevuta la risposta di caricamento della pagina
    • Quando la richiesta di caricamento della pagina scade
    • Quando lo stesso frammento scade
  • L'azione "Fire Page Load Request" deve essere utilizzata in tutte le pagine che utilizzano il frammento pre-hiding per ridurne la durata.
Il frammento di codice pre-hiding è il seguente e può essere ridotto. Le opzioni configurabili sono alla fine:
;(function(win, doc, style, timeout) {
  var STYLE_ID = 'at-body-style';

  function getParent() {
    return doc.getElementsByTagName('head')[0];
  }

  function addStyle(parent, id, def) {
    if (!parent) {
      return;
    }

    var style = doc.createElement('style');
    style.id = id;
    style.innerHTML = def;
    parent.appendChild(style);
  }

  function removeStyle(parent, id) {
    if (!parent) {
      return;
    }

    var style = doc.getElementById(id);

    if (!style) {
      return;
    }

    parent.removeChild(style);
  }

  addStyle(getParent(), STYLE_ID, style);
  setTimeout(function() {
    removeStyle(getParent(), STYLE_ID);
  }, timeout);
}(window, document, "body {opacity: 0 !important}", 3000));

Per impostazione predefinita, il frammento nasconde l'intera sezione HTML BODY. In alcuni casi, puoi voler nascondere solo alcuni elementi HTML e non l'intera pagina. Per farlo, puoi personalizzare il parametro di stile. Sostituiscilo con un elemento che nasconde solo determinate aree della pagina.
Ad esempio, se hai due aree identificate dagli ID container-1 e container-2, puoi sostituire lo stile come segue:
#container-1, #container-2 {opacity: 0 !important}

invece del codice di default:
body {opacity: 0 !important}

Per impostazione predefinita, il frammento scade a 3000 ms o 3 secondi. Questo valore può essere personalizzato.