Enviar parâmetros para o Target usando o SDK da Web da plataforma
As implementações do Target diferem entre os sites devido à arquitetura do site, aos requisitos comerciais e aos recursos usados. A maioria das implementações do Target inclui transmitir vários parâmetros para informações contextuais, públicos-alvo e recomendações de conteúdo.
Vamos usar uma página simples de detalhes do produto e uma página de confirmação de pedido para demonstrar as diferenças entre as bibliotecas ao transmitir parâmetros para o Target.
Considere os dois exemplos de páginas a seguir que usam at.js:
| code language-html |
|---|
|
| code language-html |
|---|
|
Resumo de mapeamento de parâmetros
Os parâmetros do Target para essas páginas são enviados de forma diferente usando o SDK da Web da plataforma. Há várias maneiras de enviar parâmetros para o Target usando a at.js:
- Definir com a função
targetPageParams()para o evento de carregamento de página (usado nos exemplos desta página) - Definir com a função
targetPageParamsAll()para todas as solicitações do Target na página - Enviar parâmetros diretamente com a função
getOffer()para um único local - Enviar parâmetros diretamente com a função
getOffers()para um ou mais locais
O SDK da Web da Platform fornece uma única maneira consistente de enviar dados sem a necessidade de funções adicionais. Todos os parâmetros devem ser passados na carga com o comando sendEvent e se enquadram em duas categorias:
- Mapeado automaticamente do objeto
xdm - Passado manualmente usando o objeto
data.__adobe.target
A tabela abaixo descreve como os parâmetros de exemplo seriam remapeados usando o SDK da Web da plataforma:
at_propertysendEvent.pageNamexdm.web.webPageDetails.namexdm e estar em conformidade com um esquema usando a classe XDM ExperienceEvent. Os parâmetros da mbox não podem ser passados como parte do objeto data.profile.genderdata.__adobe.target.profile.genderdata e prefixados com profile. para serem mapeados adequadamente.user.categoryIddata.__adobe.target.user.categoryIddata.entity.iddata.__adobe.target.entity.idOU
xdm.productListItems[0].SKUdata ou mapeadas automaticamente a partir do primeiro item na matriz xdm.productListItems se sua implementação usar esse grupo de campos.entity.categoryIddata.__adobe.target.entity.categoryIddata.entity.customEntitydata.__adobe.target.entity.customEntitydata.cartIdsdata.__adobe.target.cartIdsexcludedIdsdata.__adobe.target.excludedIdsmbox3rdPartyIdxdm.identityMaporderIdxdm.commerce.order.purchaseIDorderTotalxdm.commerce.order.priceTotalproductPurchasedIddata.__adobe.target.productPurchasedIdOU
xdm.productListItems[0-n].SKUmboxPageValuedata.__adobe.target.mboxPageValueParâmetros personalizados
Parâmetros de mbox personalizados devem ser passados como dados XDM com o comando sendEvent. É importante garantir que o esquema XDM inclua todos os campos necessários para a implementação do Target.
Exemplo de at.js usando targetPageParams():
targetPageParams = function() {
return {
"pageName": "product detail"
};
};
Exemplos de JavaScript do SDK da Web da plataforma usando o comando sendEvent:
| code language-javascript |
|---|
|
Nas marcas, primeiro use um elemento de dados objeto XDM para mapear para o campo XDM:
E inclua seu objeto XDM na sua ação de envio (vários objetos XDM podem ser mesclados):
xdm, você precisa atualizar quaisquer públicos-alvo, atividades ou scripts de perfil que referenciem esses parâmetros da mbox usando seus novos nomes. Consulte a página Atualizar públicos-alvo e scripts de perfil do Target para compatibilidade com o SDK da Web da plataforma deste tutorial para obter mais informações.Parâmetros do perfil
Os parâmetros do perfil de destino devem ser passados sob o objeto data.__adobe.target na carga do comando sendEvent do SDK da Web da plataforma.
Semelhante ao at.js, todos os parâmetros de perfil também devem ter o prefixo profile. para que o valor seja armazenado corretamente como um atributo de perfil de Destino persistente. O parâmetro reservado user.categoryId para o recurso de Afinidade de Categoria do Target tem o prefixo user..
Exemplo de at.js usando targetPageParams():
targetPageParams = function() {
return {
"profile.gender": "male",
"user.categoryId": "clothing"
};
};
Exemplos de SDK da Web da plataforma usando o comando sendEvent:
| code language-javascript |
|---|
|
Nas marcas, primeiro crie um elemento de dados para definir o objeto data.__adobe.target:
E inclua seu objeto de dados em sua ação de envio (vários objetos podem ser mesclados):
Parâmetros de entidade
Parâmetros de entidade são usados para transmitir dados comportamentais e informações de catálogo complementares para o Target Recommendations. Todos os parâmetros de entidade suportados pela at.js também são suportados pelo SDK da Web da plataforma. Semelhante aos parâmetros de perfil, todos os parâmetros de entidade devem ser passados sob o objeto data.__adobe.target na carga do comando sendEvent do SDK da Web da plataforma.
Os parâmetros de entidade para um item específico devem ter o prefixo entity. para a captura adequada de dados. Os parâmetros cartIds e excludedIds reservados para algoritmos de recomendações não devem ter o prefixo e o valor de cada um deles deve conter uma lista separada por vírgulas de IDs de entidade.
Exemplo de at.js usando targetPageParams():
targetPageParams = function() {
return {
"entity.id": "SKU-00001-LARGE",
"entity.categoryId": "clothing,shirts",
"entity.customEntity": "some value",
"cartIds": "SKU-00002,SKU-00003",
"excludedIds": "SKU-00001-SMALL"
};
};
Exemplos de SDK da Web da plataforma usando o comando sendEvent:
| code language-javascript |
|---|
|
Nas marcas, primeiro crie um elemento de dados para definir o objeto data.__adobe.target:
E inclua seu objeto de dados em sua ação de envio (vários objetos podem ser mesclados):
commerce for usado e a matriz productListItems for incluída na carga XDM, o primeiro valor SKU nessa matriz será mapeado para entity.id para fins de incremento de uma exibição de produto.Parâmetros de compra
Os parâmetros de compra são passados em uma página de confirmação de pedido após um pedido bem-sucedido e são usados para metas de conversão e otimização do Target. Com uma implementação do SDK da Web da Platform, esses parâmetros e são mapeados automaticamente a partir de dados XDM transmitidos como parte do grupo de campos commerce.
Exemplo de at.js usando targetPageParams():
targetPageParams = function() {
return {
"orderId": "ABC123",
"productPurchasedId": "SKU-00002,SKU-00003"
"orderTotal": 1337.89
};
};
As informações de compra são passadas para o Target quando o grupo de campos commerce tem purchases.value definido como 1. A ID do pedido e o total do pedido são mapeados automaticamente a partir do objeto order. Se a matriz productListItems estiver presente, os valores SKU serão usados para productPurchasedId.
Exemplo de SDK da Web da plataforma usando sendEvent:
| code language-javascript |
|---|
|
Nas tags, primeiro use um elemento de dados objeto XDM para mapear para os campos XDM necessários (consulte o exemplo do JavaScript) e o escopo personalizado opcional:
E inclua seu objeto XDM na sua ação de envio (vários objetos XDM podem ser mesclados):
_experience.decisioning.propositionEventType deve ser definido com display: 1 para que a chamada seja usada para incrementar uma métrica do Target.orderConfirmPage, preencha a matriz _experience.decisioning.propositions com um escopo personalizado, como no exemplo acima.productPurchasedId também pode ser passado como uma lista separada por vírgulas de IDs de entidade sob o objeto data.ID do cliente (mbox3rdPartyId)
O Target permite a sincronização de perfis entre dispositivos e sistemas usando uma única ID de cliente. Com a at.js, isso pode ser definido como mbox3rdPartyId na solicitação do Target ou como a primeira ID do cliente enviada para o Serviço de identidade Experience Cloud. Ao contrário da at.js, uma implementação do SDK da Web da Platform permite especificar qual ID de cliente usar como o mbox3rdPartyId, se houver várias. Por exemplo, se sua empresa tiver uma ID de cliente global e IDs de cliente separadas para diferentes linhas de negócios, você poderá configurar qual ID do Target deve usar.
Há algumas etapas para configurar a sincronização de ID para casos de uso entre dispositivos e Atributos do cliente:
- Crie um namespace de identidade para a ID do cliente na tela Identidades da Coleção de Dados ou da Plataforma
- Verifique se o alias nos Atributos do cliente corresponde ao símbolo de identidade do seu namespace
- Especifique o símbolo de identidade como o Namespace de ID de Terceiros de Destino na configuração de Destino da sequência de dados
- Executar um comando
sendEventusando o grupo de camposidentityMap
Exemplo de at.js usando targetPageParams():
targetPageParams = function() {
return {
"mbox3rdPartyId": "TT8675309"
};
};
Exemplos de SDK da Web da plataforma usando o comando sendEvent:
| code language-javascript |
|---|
|
O valor ID, Estado autenticado e Namespace foram capturados em um elemento de dados Mapa de identidade:
O elemento de dados Mapa de identidade é usado para definir o campo Mapa de identidade no elemento de dados objeto XDM:
O objeto XDM é então incluído na ação Enviar evento de uma regra:
No serviço Adobe Target da sua sequência de dados, certifique-se de definir o Namespace de ID de terceiros de destino para o mesmo namespace usado no elemento de dados Mapa de identidade:
Exemplo de SDK da Web da Platform
Agora que você entende como os diferentes parâmetros do Target são mapeados usando o SDK da Web da Platform, nossas duas páginas de exemplo podem ser migradas da at.js para o SDK da Web da Platform, como mostrado abaixo. As páginas de exemplo incluem o seguinte:
- Trecho pré-ocultação do Target para uma implementação de biblioteca assíncrona
- O código base do SDK da Web da plataforma
- A biblioteca de JavaScript do SDK da Web da Platform
- Um comando
configurepara inicializar a biblioteca - Um comando
sendEventpara enviar dados e solicitar que o conteúdo do Target seja renderizado
| code language-html |
|---|
|
| code language-html |
|---|
|
Em seguida, saiba como rastrear eventos de conversão do Target com o SDK da Web da plataforma.