Adobe Experience Platform Web SDK O pode entregar e renderizar experiências personalizadas gerenciadas no Adobe Target para o canal da Web. Você pode usar um editor WYSIWYG, chamado de Visual Experience Composer (VEC), ou uma interface não visual, a variável Experience Composer baseado em formulário, para criar, ativar e entregar suas atividades e experiências de personalização.
O Documentação do Adobe Target O inclui tópicos que contêm informações específicas para o SDK da Web da plataforma, pois estão relacionados aos recursos e funcionalidades do Target.
Os seguintes recursos foram testados e atualmente são compatíveis com o Target:
O diagrama a seguir ajuda você a entender o fluxo de trabalho do Target e Platform Web SDK decisão de borda.
Chame | Detalhes |
---|---|
1 | O dispositivo carrega o Platform Web SDK. O Platform Web SDK envia uma solicitação para a rede de borda com dados XDM, a ID do ambiente do datastreams, parâmetros transmitidos e a ID do cliente (opcional). A página (ou contêineres) é pré-oculta. |
2 | A rede de borda envia a solicitação aos serviços de borda para enriquecê-la com a ID do visitante, o consentimento e outras informações de contexto do visitante, como localização geográfica e nomes amigáveis ao dispositivo. |
3 | A rede de borda envia a solicitação de personalização enriquecida para o Target com a ID do visitante e os parâmetros transmitidos. |
4 | Os scripts de perfil executam e, em seguida, fazem o feed Target armazenamento de perfil. O armazenamento de perfil busca segmentos do Biblioteca de público-alvo (por exemplo, segmentos compartilhados de Adobe Analytics, Adobe Audience Manager, o Adobe Experience Platform). |
5 | Com base nos parâmetros de solicitação de URL e dados de perfil, Target determina quais atividades e experiências serão exibidas para o visitante na exibição de página atual e para futuras exibições pré-buscadas. Target em seguida, envia isso de volta para a rede de borda. |
6 | a. A rede de borda envia a resposta de personalização de volta para a página, incluindo, opcionalmente, valores de perfil para personalização adicional. O conteúdo personalizado na página atual é revelado o mais rápido possível sem cintilação do conteúdo padrão. b. O conteúdo personalizado para 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. A rede de borda envia a ID do visitante e outros valores em cookies, como consentimento, ID da sessão, identidade, verificação de cookie, personalização e assim por diante. |
7 | A rede de borda avança Analytics para Target (A4T) detalhes (metadados de atividade, experiência e conversão) para a Analytics borda. |
Para ativar Target, faça o seguinte:
renderDecisions
aos seus eventos.Em seguida, opcionalmente, também é possível 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 eventos.Para usar o VEC com um Platform Web SDK implementação, instalar e ativar a variável Firefox ou Cromo Extensão do VEC Helper.
Para obter mais informações, consulte Extensão de assistente do Visual Experience Composer no Guia do Adobe Target.
Consulte Renderização do conteúdo de personalização para obter mais informações.
Ao definir públicos para Target atividades fornecidas por meio da variável Platform Web SDK, XDM deve ser definida e usada. Após definir esquemas, classes e grupos de campos de esquema XDM, você pode criar um Target regra de público-alvo definida pelos dados XDM para direcionamento. Within Target, os dados XDM são exibidos na variável Construtor de público-alvo como parâmetro personalizado. O XDM é serializado usando a notação de pontos (por exemplo, web.webPageDetails.name
).
Se tiver Target atividades com públicos-alvo predefinidos que usam parâmetros personalizados ou um perfil de usuário, elas não são entregues corretamente por meio do 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-alvo prontos para uso com o suporte do Platform Web SDK que não exigem XDM. Esses campos estão disponíveis na variável Target Interface do usuário que não requer XDM:
Para obter mais informações, consulte Categorias para públicos no Guia do Adobe Target.
Os tokens de resposta são usados principalmente para enviar metadados a terceiros, como Google, Facebook etc. Os tokens de resposta são retornados no meta
no campo propositions
-> items
. Esta é 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 alloy.sendEvent
promessa, repita propositions
e extrair os detalhes de items
-> meta
. Cada proposition
tem um renderAttempted
campo booleano indicando 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 é ativada, a matriz de propostas contém:
propositions
com renderAttempted
sinalizador definido como false
renderAttempted
sinalizador definido como true
renderAttempted
sinalizador definido como true
renderAttempted
sinalizador definido como true
Quando a renderização automática está desativada, a matriz de propostas contém:
propositions
com renderAttempted
sinalizador definido como false
renderAttempted
sinalizador definido como false
renderAttempted
sinalizador definido como false
renderAttempted
sinalizador definido como false
O Platform Web SDK permite atualizar o perfil para a Target e à Platform Web SDK como um evento de experiência.
Para atualizar uma Target , certifique-se de que os dados do perfil sejam transmitidos com o seguinte:
“data {“
“__adobe.target”
“profile.”
por exemplo, como abaixoChave | Tipo | Descrição |
---|---|---|
renderDecisions |
Booleano | Instrui o componente de personalização se ele deve interpretar ações DOM |
decisionScopes |
Matriz <String> |
Uma lista de escopos para recuperar decisões de |
xdm |
Objeto | Dados formatados no XDM que chegam ao SDK da Web da plataforma como um evento de experiência |
data |
Objeto | Pares de chave/valor arbitrários enviados para Target na classe de destino. |
Típica Platform Web SDK o código que usa esse comando é semelhante ao seguinte:
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
}
}
}
});
A tabela a seguir lista Recommendations e se cada um é compatível com o Platform Web SDK:
Categoria | Atributo | Status de suporte |
---|---|---|
Recommendations - Atributos de entidade padrão | entity.id | Suportado |
entity.name | Suportado | |
entity.categoryId | Suportado | |
entity.pageUrl | Suportado | |
entity.thumbnailUrl | Suportado | |
entity.message | Suportado | |
entity.value | Suportado | |
entity.inventory | Suportado | |
entity.brand | Suportado | |
entity.margin | Suportado | |
entity.event.detailsOnly | Suportado | |
Recommendations - Atributos de entidade personalizados | entity.yourCustomAttributeName | Suportado |
Recommendations - Parâmetros de mbox/página reservados | excludedIds | Suportado |
cartIds | Suportado | |
productPurchasedId | Suportado | |
Página ou categoria do item para afinidade de categorias | user.categoryId | Suportado |
Como enviar atributos do Recommendations para o Adobe Target:
alloy("sendEvent", {
renderDecisions: true,
data: {
__adobe: {
target: {
"entity.id": "123",
"entity.genre": "Drama"
}
}
}
});
mboxTrace e mboxDebug foram descontinuadas. Use Platform Web SDK depuração.
Propostas: Em Target, as apresentações estão correlacionadas à experiência selecionada em uma Atividade.
Esquema: O schema de uma decisão é o tipo de oferta em Target.
Âmbito de aplicação: O âmbito da decisão. Em Target, o escopo é a mBox. A mBox global é a __view__
escopo.
XDM: O XDM é serializado em notação de pontos e, em seguida, colocado em Target como parâmetros mBox.