Utilizzo di Adobe Target con Platform Web SDK

Adobe Experience Platform Web SDK può fornire ed eseguire il rendering di esperienze personalizzate gestite in Adobe Target sul canale web. Puoi 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 tue attività e esperienze di personalizzazione.

IMPORTANTE

La documentazione di Adobe Target include argomenti contenenti informazioni specifiche sull’SDK per web di Platform in relazione alle funzioni e alle funzionalità di Target.

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

Platform Web SDK diagramma di sistema

Il diagramma seguente ti aiuta a comprendere il flusso di lavoro delle Target e Platform Web SDK decisioni edge.

Diagramma delle decisioni edge di Adobe Target con Platform Web SDK

Chiamata Dettagli
1 Il dispositivo carica il Platform Web SDK. Il Platform Web SDK invia una richiesta alla rete perimetrale con dati XDM, l’ID ambiente Datastreams, i parametri passati e l’ID cliente (facoltativo). La pagina (o i contenitori) è prenascosta.
2 La rete perimetrale invia la richiesta ai servizi perimetrali per arricchirla con l’ID visitatore, il consenso e altre informazioni contestuali, come la geolocalizzazione e i nomi descrittivi dei dispositivi.
3 La rete perimetrale invia la richiesta di personalizzazione arricchita al server Edge Target con l’ID visitatore e i parametri passati.
4 Gli script di profilo vengono eseguiti e quindi inseriti nell’archivio dei profili Target. L’archiviazione dei profili recupera i segmenti dalla Libreria tipi di pubblico (ad esempio, i segmenti condivisi da Adobe Analytics, Adobe Audience Manager, Adobe Experience Platform).
5 In base ai parametri di richiesta URL e ai dati di profilo, Target determina quali attività ed esperienze visualizzare per il visitatore per la visualizzazione della pagina corrente e per le visualizzazioni preacquisite future. Target quindi invia nuovamente questo messaggio alla rete perimetrale.
6 a) La rete perimetrale invia nuovamente la risposta di personalizzazione alla pagina, includendo facoltativamente i valori di profilo per ulteriore personalizzazione. Il contenuto personalizzato sulla pagina corrente viene mostrato il più rapidamente possibile senza che venga visualizzato momentaneamente il contenuto predefinito.
b) Il contenuto personalizzato per le visualizzazioni mostrate come risultato delle azioni dell’utente in un’applicazione a pagina singola (SPA) viene memorizzato nella cache in modo che possa essere applicato immediatamente senza una chiamata al server aggiuntiva quando vengono attivate le visualizzazioni.
c. La rete perimetrale invia l’ID visitatore e altri valori nei cookie, come il consenso, l’ID sessione, l’identità, il controllo dei cookie, la personalizzazione e così via.
7 La rete perimetrale inoltra i dettagli Analytics for Target (A4T) (attività, esperienza e metadati di conversione) al server Edge Analytics.

Abilitazione di Adobe Target

Per abilitare Target, procedi come segue:

  1. Abilita Target nel tuo datastream con il codice client appropriato.
  2. Aggiungi l’opzione renderDecisions agli eventi.

Quindi, facoltativamente, puoi anche aggiungere le seguenti opzioni:

  • decisionScopes: Recupera attività specifiche (utile per le attività create con il compositore basato su moduli) aggiungendo questa opzione agli eventi.
  • Anteprima del frammento: Nasconde solo alcune parti della pagina.

Utilizzo del Compositore esperienza visivo di Adobe Target

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

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

Rendering di contenuti personalizzati

Per ulteriori informazioni, consulta Rendering del contenuto di personalizzazione .

Tipi di pubblico in XDM

Quando definisci i tipi di pubblico per le attività Target fornite tramite Platform Web SDK, devi definire e utilizzare XDM. Dopo aver definito schemi, classi e gruppi di campi di 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 in Audience Builder come parametro personalizzato. L’XDM viene serializzato utilizzando la notazione del punto (ad esempio, web.webPageDetails.name).

Se disponi di attività Target con tipi di pubblico predefiniti che utilizzano parametri personalizzati o un profilo utente, queste non vengono consegnate correttamente tramite l’SDK. Invece di utilizzare parametri personalizzati o il profilo utente, devi invece utilizzare XDM. Tuttavia, esistono campi di targeting del pubblico preconfigurati supportati tramite Platform Web SDK che non richiedono XDM. Questi campi sono disponibili nell’ interfaccia utente Target che non richiede XDM:

  • Libreria di Target
  • Geo
  • Rete
  • Operating System
  • Pagine del sito
  • Browser
  • Origini del traffico
  • Intervallo temporale

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

Token di risposta

I token di risposta sono utilizzati principalmente per inviare metadati a terze parti come Google, Facebook, ecc. Vengono restituiti token di risposta
nel campo meta all'interno di 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 alla promessa alloy.sendEvent, ripeti attraverso propositions
ed estrarre i dettagli da items -> meta. Ogni proposition ha un campo booleano renderAttempted
che indica se è stato eseguito o meno il rendering di proposition. Vedi il campione 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 il rendering automatico è abilitato, la matrice delle proposizioni contiene:

Al caricamento della pagina:

  • Compositore basato su moduli propositions con il flag renderAttempted impostato su false
  • Proposizioni basate su Compositore esperienza visivo con il flag renderAttempted impostato su true
  • Proposte basate su Compositore esperienza visivo per una visualizzazione di applicazione a pagina singola con il flag renderAttempted impostato su true

On View - change (sulla visualizzazione in cache):

  • Proposte basate su Compositore esperienza visivo per una visualizzazione di applicazione a pagina singola con il flag renderAttempted impostato su true

Quando il rendering automatico è disabilitato, la matrice delle proposizioni contiene:

Al caricamento della pagina:

  • Compositore basato su moduli propositions con il flag renderAttempted impostato su false
  • Proposizioni basate su Compositore esperienza visivo con il flag renderAttempted impostato su false
  • Proposte basate su Compositore esperienza visivo per una visualizzazione di applicazione a pagina singola con il flag renderAttempted impostato su false

On View - change (sulla visualizzazione in cache):

  • Proposte basate su Compositore esperienza visivo per una visualizzazione di applicazione a pagina singola con il flag renderAttempted impostato su false

Aggiornamento di un singolo profilo

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

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

  • Sotto “data {“
  • Sotto “__adobe.target”
  • Prefisso “profile.” ad esempio come segue
Chiave Tipo Descrizione
renderDecisions Booleano Indica al componente di personalizzazione se deve interpretare le azioni DOM
decisionScopes Array <String> Elenco di ambiti per i quali recuperare le decisioni
xdm Oggetto Dati formattati in XDM che arrivano nell’SDK per web di Platform come evento di esperienza
data Oggetto Coppie arbitrarie chiave/valore inviate alle soluzioni Target sotto la classe target.

Il codice Platform Web SDK tipico che utilizza questo comando è simile al seguente:

sendEventcon dati di 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 Platform Web SDK:

Categoria Attributo Stato del supporto
Recommendations - Attributi di entità predefiniti entity.id Supportati
entity.name Supportati
entity.categoryId Supportati
entity.pageUrl Supportati
entity.thumbnailUrl Supportati
entity.message Supportati
entity.value Supportati
entity.inventory Supportati
entity.brand Supportati
entity.margin Supportati
entity.event.detailsOnly Supportati
Recommendations - Attributi di entità personalizzati entity.yourCustomAttributeName Supportati
Recommendations - Parametri mbox/pagina riservati excludedIds Supportati
cartIds Supportati
productPurchasedId Supportati
Pagina o categoria di elementi per affinità tra categorie user.categoryId Supportati

Come inviare gli attributi di Recommendations ad Adobe Target:

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

Eseguire il debug di

mboxTrace e mboxDebug sono stati dichiarati obsoleti. Utilizzare Platform Web SDK debugging.

Terminologia

Proposizioni: in Target, le proposizioni sono correlate all’esperienza selezionata da un’attività.

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

Ambito di applicazione: ambito di applicazione della decisione. In Target, l'ambito è mBox. L'mBox globale è l'ambito __view__.

XDM: XDM viene serializzato nella notazione del punto e quindi inserito Target come parametri mBox.

In questa pagina