Utilizzare Adobe Target e Web SDK per la personalizzazione

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

Le seguenti funzioni sono state testate e sono attualmente supportate in Target:

Web SDK schema di sistema

Il diagramma seguente consente di comprendere il flusso di lavoro di Target e Web SDK decisioni edge.

Abilitazione 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 Web SDK implementazione, installazione e attivazione di Firefox o Chrome Estensione VEC Helper.

Per ulteriori informazioni, consulta Estensione Helper per Compositore esperienza visivo nel Guida di Adobe Target.

Rendering di contenuti personalizzati

Consulta Rendering del contenuto di personalizzazione per ulteriori informazioni.

Pubblico in XDM

Quando definisci i tipi di pubblico per Target attività consegnate tramite Web SDK, XDM devono essere definiti e utilizzati. Dopo aver definito schemi, classi e gruppi di campi schema XDM, puoi creare un’ Target regola di pubblico definita dai dati XDM per il targeting. Entro Target, i dati XDM vengono visualizzati nel Audience Builder come parametro personalizzato. XDM viene serializzato utilizzando la notazione del punto (ad esempio, web.webPageDetails.name).

Se è stato Target Le attività con tipi di pubblico predefiniti che utilizzano parametri personalizzati o un profilo utente non vengono consegnate 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 nel Target Interfaccia utente che non richiede XDM:

Per ulteriori informazioni, consulta Categorie di pubblico nel Guida di Adobe Target.

Token di risposta

I token di risposta vengono utilizzati per inviare metadati a terze parti come Google o Facebook. I token di risposta vengono restituiti nel meta campo entro 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, devi abbonarti a alloy.sendEvent prometti, ripeti propositionsed estrarre i dettagli da items -> meta.

Ogni proposition ha un renderAttempted campo booleano che indica se proposition è stato sottoposto o meno a rendering. 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

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

Per aggiornare un Target profilo, assicurati che i dati del profilo vengano passati con quanto segue:

Tipico Web SDK il codice che utilizza questo comando si presenta come segue:

sendEventcon dati profilo

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

Come inviare attributi di profilo ad Adobe Target:

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

Richiedi consigli

Nella tabella seguente sono elencati 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"
      }
    }
  }
});

Debugging

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

Terminologia

Proposte: In entrata 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: Il campo di applicazione della decisione. In entrata Adobe Target, l'ambito è il mBox. Il mBox globale è il __view__ ambito.

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