Usa Adobe Target e Web SDK per la personalizzazione

Adobe Experience Platform Web SDK può inviare ed eseguire il rendering di esperienze personalizzate gestite in Adobe Target al canale web. È possibile utilizzare un editor WYSIWYG, denominato Compositore esperienza visivo o un'interfaccia non visiva, Compositore esperienza basato su moduli, per creare, attivare e distribuire le attività e le esperienze di personalizzazione.

Le seguenti funzionalità sono state testate e sono attualmente supportate in Target:

Diagramma del sistema di Web SDK

Il diagramma seguente consente di comprendere il flusso di lavoro di Target e Web SDK Edge Decisioning.

Abilitazione di Adobe Target

Per abilitare Target, eseguire le operazioni seguenti:

Quindi, facoltativamente, puoi anche aggiungere le seguenti opzioni:

Utilizzo di Adobe Target VEC

Per utilizzare il Compositore esperienza visivo con un'implementazione Web SDK, installa e attiva l'estensione Firefox o Chrome VEC Helper.

Per ulteriori informazioni, consulta Estensione helper per Compositore esperienza visivo nella guida di Adobe Target.

Rendering di contenuti personalizzati

Per ulteriori informazioni, consulta Rendering del contenuto di personalizzazione.

Pubblico in XDM

Quando definisci i tipi di pubblico per le attività Target distribuite tramite Web SDK, è necessario definire e utilizzare XDM. Dopo aver definito schemi, classi e gruppi di campi dello schema XDM, puoi creare una regola di pubblico Target definita dai dati XDM per il targeting. All'interno di Target, i dati XDM vengono visualizzati nel Generatore di pubblico come parametro personalizzato. XDM viene serializzato utilizzando la notazione del punto (ad esempio, web.webPageDetails.name).

Se hai Target attività con tipi di pubblico predefiniti che utilizzano parametri personalizzati o un profilo utente, non vengono distribuite correttamente tramite l'SDK. Invece di utilizzare parametri personalizzati o il profilo utente, devi utilizzare XDM. Tuttavia, sono presenti campi di targeting del pubblico predefiniti supportati tramite Web SDK che non richiedono XDM. Questi campi sono disponibili nell'interfaccia utente di Target che non richiedono XDM:

Per ulteriori informazioni, consulta Categorie di pubblico nella guida di Adobe Target.

Token di risposta

I token di risposta vengono utilizzati per inviare metadati a terze parti come Google o Facebook. Vengono restituiti i token di risposta
nel campo meta in propositions -> items. Ecco un esempio:

{
  "id": "AT:eyJhY3Rpdml0eUlkIjoiMTI2NzM2IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
  "scope": "__view__",
  "scopeDetails": ...,
  "renderAttempted": true,
  "items": [
    {
      "id": "0",
      "schema": "https://ns.adobe.com/personalization/dom-action",
      "meta": {
        "experience.id": "0",
        "activity.id": "126736",
        "offer.name": "Default Content",
        "offer.id": "0"
      }
    }
  ]
}

Per raccogliere i token di risposta, è necessario sottoscrivere la promessa alloy.sendEvent, eseguire iterazioni in propositions ed estrarre i dettagli da items -> meta.

Ogni proposition ha un campo booleano renderAttempted che indica se è stato eseguito il rendering di proposition. Vedi l’esempio seguente:

alloy("sendEvent",
  {
    "renderDecisions": true,
    "decisionScopes": [
      "hero-container"
    ]
  }).then(result => {
    const { propositions } = result;

    // filter rendered propositions
    const renderedPropositions = propositions.filter(proposition => proposition.renderAttempted === true);

    // collect the item metadata that represents the response tokens
    const collectMetaData = (items) => {
      return items.filter(item => item.meta !== undefined).map(item => item.meta);
    }

    const pageLoadResponseTokens = renderedPropositions
      .map(proposition => collectMetaData(proposition.items))
      .filter(e => e.length > 0)
      .flatMap(e => e);
  });

Quando è abilitato il rendering automatico, l’array delle proposte contiene:

Al caricamento della pagina:

Alla visualizzazione - modifica (per le viste memorizzate nella cache):

Quando il rendering automatico è disattivato, l’array delle proposte contiene:

Al caricamento della pagina:

Alla visualizzazione - modifica (per le viste memorizzate nella cache):

Aggiornamento di profilo singolo

Web SDK consente di aggiornare il profilo al profilo Target e a Web SDK come evento esperienza.

Per aggiornare un profilo Target, assicurarsi che i dati del profilo vengano passati con:

Ritarda il salvataggio dei parametri di entità o profilo fino a quando il contenuto non viene visualizzato all'utente finale

Per ritardare la registrazione degli attributi nel profilo fino alla visualizzazione del contenuto, impostare data.adobe.target._save=false nella richiesta.

Ad esempio, il sito web contiene tre ambiti decisionali corrispondenti a tre collegamenti per categorie sul sito web (uomini, donne e bambini) e desideri tenere traccia della categoria che l’utente ha eventualmente visitato. Invia queste richieste con il flag __save impostato su false per evitare di rendere persistente la categoria al momento della richiesta del contenuto. Dopo aver visualizzato il contenuto, invia il payload corretto (inclusi eventToken e stateToken) per gli attributi corrispondenti da registrare.

L’esempio seguente invia un messaggio in stile trackEvent, esegue script di profilo, salva gli attributi e registra immediatamente l’evento.

alloy ( "sendEvent" , {
  renderDecisions : true,
  data : {
    __adobe : {
      target : {
        "profile.gender" : "female",
        "profile.age" : 30,
        "entity.name" : "T-shirt" ,
        "entity.id" : "1234" ,
        "track": {
          "scopes": [ "mbox1", "mbox2"],
          "type": "display|click|..."
        }
      }
    }
  }
} ) ;

sendEventcon dati profilo

alloy("sendEvent", {
   renderDecisions: true|false,
   xdm: { // Experience Event XDM data },
   data: { // Freeform data }
});

Come inviare gli attributi del profilo ad Adobe Target:

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "profile.gender": "female",
        "profile.age": 30
      }
    }
  }
});

Richiedi consigli

Nella tabella seguente sono elencati gli attributi Recommendations e se ciascuno di essi è supportato tramite Web SDK:

Come inviare attributi Recommendations ad Adobe Target:

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "entity.id": "123",
        "entity.genre": "Drama"
      }
    }
  }
});

Debug

mboxTrace e mboxDebug sono stati dichiarati obsoleti. Utilizza invece un metodo di debug Web SDK.

Terminologia

Proposte: In Adobe Target, le proposte sono correlate all'esperienza selezionata da un'attività.

Schema: Lo schema di una decisione è il tipo di offerta in Adobe Target.

Ambito: Ambito della decisione. In Adobe Target, l'ambito è l'mBox. La mBox globale è l'ambito __view__.

XDM: XDM viene serializzato in notazione punto e quindi inserito in Adobe Target come parametri mBox.