Uso Adobe Target e Web SDK para personalização
Adobe Experience Platform Web SDK podem fornecer e renderizar experiências personalizadas gerenciadas no Adobe Target ao canal da web. Você pode usar um editor WYSIWYG, chamado de Visual Experience Composer (VEC), ou uma interface não visual, o Experience Composer baseado em formulário, para criar, ativar e entregar suas atividades e experiências de personalização.
Os seguintes recursos foram testados e são atualmente compatíveis com o Target:
Web SDK diagrama do sistema
O diagrama a seguir ajuda a entender o fluxo de trabalho do Target e Web SDK edge decisioning.
b. O conteúdo personalizado de exibições que são mostradas como resultado das ações do usuário em um Aplicativo de página única (SPA) é armazenado em cache para que possa ser aplicado instantaneamente, sem uma chamada de servidor adicional, quando as exibições forem acionadas.
c. O Edge Network envia a ID do visitante e outros valores em cookies, como consentimento, ID da sessão, identidade, verificação de cookie e personalização.
Ativando Adobe Target
Para habilitar Target, faça o seguinte:
- Ativar Target no seu sequência de dados com o código de cliente apropriado.
- Adicione o
renderDecisions
aos seus eventos.
Em seguida, opcionalmente, você também pode adicionar as seguintes opções:
decisionScopes
: recupere atividades específicas (úteis para atividades criadas com o compositor baseado em formulário) adicionando essa opção aos seus eventos.- Pré-ocultação de trecho: ocultar apenas determinadas partes da página.
Uso do VEC do Adobe Target
Para usar o VEC com uma Web SDK implementação, instale e ative o Firefox ou Cromo Extensão do VEC Helper.
Para obter mais informações, consulte Extensão auxiliar do Visual Experience Composer no Guia do Adobe Target.
Renderização de conteúdo personalizado
Consulte Renderização do conteúdo de personalização para obter mais informações.
Públicos-alvo no XDM
Ao definir públicos-alvo para seus Target atividades que são entregues por meio do Web SDK, XDM devem ser definidas e usadas. Depois de definir esquemas XDM, classes e grupos de campos de esquema, você pode criar um Target regra de público-alvo definida pelos dados XDM para direcionamento. Dentro de Target, os dados XDM são exibidos no Audience Builder como um parâmetro personalizado. O XDM é serializado usando notação de pontos (por exemplo, web.webPageDetails.name
).
Se você tiver Target atividades com públicos predefinidos que usam parâmetros personalizados ou um perfil de usuário não são entregues corretamente pelo SDK. Em vez de usar parâmetros personalizados ou o perfil do usuário, você deve usar o XDM. No entanto, há campos de direcionamento de público prontos para uso compatíveis por meio do Web SDK que não exigem XDM. Esses campos estão disponíveis no Target Interface do usuário que não requer XDM:
- Biblioteca do Target
- Geografia
- Rede
- Sistema operacional
- Páginas do site
- Navegador
- Fontes de Tráfego
- Intervalo de tempo
Para obter mais informações, consulte Categorias para públicos no Guia do Adobe Target.
Tokens de resposta
Os tokens de resposta são usados para enviar metadados a terceiros, como Google ou Facebook. Os tokens de resposta são retornados no meta
campo dentro de propositions
-> items
. Aqui está uma amostra:
{
"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"
}
}
]
}
Para coletar os tokens de resposta, é necessário assinar o alloy.sendEvent
promessa, iterar até propositions
e extraia os detalhes de items
-> meta
.
A cada proposition
tem um renderAttempted
campo booleano que indica se a variável proposition
foi renderizado ou não. Consulte a amostra abaixo:
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 a renderização automática está ativada, a matriz de apresentações contém:
No carregamento da página:
- Compositor baseado em formulário
propositions
comrenderAttempted
sinalizador definido comofalse
- Proposições baseadas no Visual Experience Composer com
renderAttempted
sinalizador definido comotrue
- Proposições baseadas no Visual Experience Composer para uma exibição de aplicativo de página única com
renderAttempted
sinalizador definido comotrue
Em Exibição - alterar (para exibições em cache):
- Proposições baseadas no Visual Experience Composer para uma exibição de aplicativo de página única com
renderAttempted
sinalizador definido comotrue
Quando a renderização automática está desativada, a matriz de apresentações contém:
No carregamento da página:
- Form-based Composerbaseado em
propositions
comrenderAttempted
sinalizador definido comofalse
- Visual Experience Composerapresentações com base em
renderAttempted
sinalizador definido comofalse
- Visual Experience Composerpropostas com base em para uma visualização de Aplicativo de página única com
renderAttempted
sinalizador definido comofalse
Em Exibição - alterar (para exibições em cache):
- Proposições baseadas no Visual Experience Composer para uma exibição de aplicativo de página única com
renderAttempted
sinalizador definido comofalse
Atualização de perfil único
A variável Web SDK permite atualizar o perfil para a variável Target e para o Web SDK como um evento de experiência.
Para atualizar uma Target , verifique se os dados do perfil foram transmitidos com o seguinte:
- Em
"data {"
- Em
"__adobe.target"
- Prefixo
"profile."
renderDecisions
decisionScopes
<String>
xdm
data
Atrasar o salvamento dos parâmetros de Perfil ou de entidade até que o conteúdo tenha sido exibido para o usuário final
Para atrasar a gravação de atributos no perfil até que o conteúdo tenha sido exibido, defina data.adobe.target._save=false
em sua solicitação.
Por exemplo, seu site contém três escopos de decisão correspondentes a três links de categoria no site (Homens, Mulheres e Crianças) e você deseja rastrear a categoria que o usuário eventualmente visitou. Enviar essas solicitações com o __save
sinalizador definido como false
para evitar a persistência da categoria no momento em que o conteúdo é solicitado. Depois que o conteúdo for visualizado, envie a carga útil correta (incluindo a eventToken
e stateToken
) para que os atributos correspondentes sejam registrados.
O exemplo abaixo envia uma mensagem de estilo trackEvent, executa scripts de perfil, salva atributos e registra imediatamente o 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|..."
}
}
}
}
} ) ;
__save
diretiva for omitida, salvar os atributos de perfil e entidade ocorrerá imediatamente, como se a solicitação tivesse sido executada, mesmo se o restante da solicitação for uma pré-busca de personalização. A variável __save
A diretiva só é relevante para atributos de perfil e entidade. Se o objeto de rastreamento estiver presente, a variável __save
diretiva é ignorada. Os dados são salvos imediatamente e a notificação é registrada.sendEvent
com dados de perfil
alloy("sendEvent", {
renderDecisions: true|false,
xdm: { // Experience Event XDM data },
data: { // Freeform data }
});
Como enviar atributos de perfil para o Adobe Target:
alloy("sendEvent", {
"renderDecisions": true,
"data": {
"__adobe": {
"target": {
"profile.gender": "female",
"profile.age": 30
}
}
}
});
Solicitar recomendações
A tabela a seguir lista Recommendations atributos e se cada um é compatível por meio da variável Web SDK:
Como enviar atributos do Recommendations para o Adobe Target:
alloy("sendEvent", {
"renderDecisions": true,
"data": {
"__adobe": {
"target": {
"entity.id": "123",
"entity.genre": "Drama"
}
}
}
});
Depuração
mboxTrace e mboxDebug foram descontinuados. Use um método de Depuração do SDK da Web em vez disso.
Terminologia
Apresentações: Entrada Adobe Target, as apresentações se correlacionam com a experiência selecionada em uma Atividade.
Esquema: O schema de uma decisão é o tipo de oferta em Adobe Target.
Escopo: O escopo da decisão. Entrada Adobe Target, o escopo é a mBox. A mBox global é a __view__
âmbito de aplicação.
XDM: O XDM é serializado em notação de pontos e, em seguida, colocado em Adobe Target como parâmetros mBox.