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_property
sendEvent
.pageName
xdm.web.webPageDetails.name
xdm
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.gender
data.__adobe.target.profile.gender
data
e prefixados com profile.
para serem mapeados adequadamente.user.categoryId
data.__adobe.target.user.categoryId
data
.entity.id
data.__adobe.target.entity.id
OU
xdm.productListItems[0].SKU
data
ou mapeadas automaticamente a partir do primeiro item na matriz xdm.productListItems
se sua implementação usar esse grupo de campos.entity.categoryId
data.__adobe.target.entity.categoryId
data
.entity.customEntity
data.__adobe.target.entity.customEntity
data
.cartIds
data.__adobe.target.cartIds
excludedIds
data.__adobe.target.excludedIds
mbox3rdPartyId
xdm.identityMap
orderId
xdm.commerce.order.purchaseID
orderTotal
xdm.commerce.order.priceTotal
productPurchasedId
data.__adobe.target.productPurchasedId
OU
xdm.productListItems[0-n].SKU
mboxPageValue
data.__adobe.target.mboxPageValue
Parâ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:
{modal="regular"}
E inclua seu objeto XDM na sua ação de envio (vários objetos XDM podem ser mesclados):
{modal="regular"}
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
:
{modal="regular"}
E inclua seu objeto de dados em sua ação de envio (vários objetos podem ser mesclados):
{modal="regular"}
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
:
{modal="regular"}
E inclua seu objeto de dados em sua ação de envio (vários objetos podem ser mesclados):
{modal="regular"}
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
.
Exemplos de 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 os campos XDM:
{modal="regular"}
E inclua seu objeto XDM na sua ação de envio (vários objetos XDM podem ser mesclados):
{modal="regular"}
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 de dispositivos cruzados do Target 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
sendEvent
usando 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:
{modal="regular"}
O elemento de dados Mapa de identidade é usado para definir o campo Mapa de identidade no elemento de dados objeto XDM:
{modal="regular"}
O objeto XDM é então incluído na ação Enviar evento de uma regra:
{modal="regular"}
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:
{modal="regular"}
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
configure
para inicializar a biblioteca - Um comando
sendEvent
para 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.