Manipulação de respostas de comando
Alguns comandos do SDK da Web podem retornar um objeto contendo dados potencialmente úteis para sua organização. Você pode escolher o que fazer com esses dados, se desejar. As respostas de comando são valiosas para propostas e destinos, pois exigem dados de Edge Network para funcionar com eficiência.
As respostas de comando usam JavaScript promessas, atuando como proxy para um valor que não é conhecido quando a promessa é criada. Depois que o valor é conhecido, a promessa é "resolvida" com o valor.
Manipular respostas de comando usando a extensão de tag do SDK da Web
Crie uma regra que assine o evento Enviar evento concluído como parte de uma regra.
- Faça logon em experience.adobe.com usando suas credenciais da Adobe ID.
- Navegue até Coleção de dados > Marcas.
- Selecione a propriedade de tag desejada.
- Navegue até Regras e selecione a regra desejada.
- Em Eventos, selecione um evento existente ou crie um evento.
- Defina o campo suspenso Extensão como Adobe Experience Platform Web SDK e defina o Tipo de Evento como Enviar evento concluído.
- Clique em Manter alterações e execute o fluxo de trabalho de publicação.
Você pode então incluir as ações Aplicar propostas ou Aplicar resposta a esta regra.
- Ao visualizar a regra criada ou editada acima, selecione uma ação existente ou crie uma ação.
- Defina o campo suspenso Extensão como Adobe Experience Platform Web SDK e defina o Tipo de Ação como Aplicar propostas ou Aplicar resposta, dependendo do comportamento desejado.
- Defina os campos desejados da ação e clique em Manter alterações.
Manipular respostas de comando usando a biblioteca JavaScript do SDK da Web
Use os métodos then
e catch
para determinar quando um comando é bem-sucedido ou falha. Você pode omitir then
ou catch
se as finalidades não forem importantes para a implementação.
alloy("sendEvent", {
"xdm": {
"commerce": {
"order": {
"purchaseID": "a8g784hjq1mnp3",
"purchaseOrderNumber": "VAU3123",
"currencyCode": "USD",
"priceTotal": 999.98
}
}
}
}).then(function(result) {
console.log("The sendEvent command succeeded.");
})
.catch(function(error) {
console.log("The sendEvent command failed.");
});
Todas as promessas retornadas dos comandos usam um objeto result
. Por exemplo, você pode obter informações da biblioteca do objeto result
usando o comando getLibraryInfo
:
alloy("getLibraryInfo")
.then(function(result) {
console.log(result.libraryInfo.version);
console.log(result.libraryInfo.commands);
console.log(result.libraryInfo.configs);
});
O conteúdo deste objeto result
depende de uma combinação de qual comando você usa e do consentimento do usuário. Se um usuário não tiver consentido com uma finalidade específica, o objeto de resposta conterá apenas informações que podem ser fornecidas no contexto do consentimento do usuário.