Tipos de ação para extensões da Web
No contexto de tags de coleção de dados, uma ação é algo que é executado depois que um evento de regra ocorre e todas as condições são aprovadas na avaliação.
Por exemplo, uma extensão pode fornecer um tipo de ação "mostrar o bate-papo de suporte", que pode exibir uma caixa de diálogo de bate-papo de suporte para ajudar usuários que estejam com dificuldades ao fazer check-out.
Este documento aborda como definir tipos de ação para uma extensão da Web no Adobe Experience Platform.
Os tipos de ação geralmente consistem no seguinte:
- Uma visualização mostrada na interface do usuário do Experience Platform e na interface da Coleção de dados que permite aos usuários modificar as configurações da ação.
- Um módulo de biblioteca emitido na biblioteca de tempo de execução de tag para interpretar as configurações e executar uma ação.
module.exports = function(settings) {
alert('Thanks for visiting our site!');
};
Por exemplo, para tornar a mensagem configurável pelo usuário da Adobe Experience Platform, é possível permitir que o usuário insira e salve uma mensagem no objeto de configurações. O objeto tem esta aparência:
{
"message": "Thank you for being one of our VIP members!"
}
Para operar na mensagem definida pelo usuário, seu módulo precisará ser alterado para:
module.exports = function(settings) {
alert(settings.message);
}
Dados do evento contextuais
Um segundo argumento teria que ser passado para o módulo que contém as informações contextuais sobre o evento que aciona a regra. Pode ser benéfico em certos casos e pode ser acessado da seguinte forma:
module.exports = function(settings, event) {
// event contains information regarding the event that fired the rule
};
O objeto event
deve conter as seguintes propriedades:
$type
youtube.play
.$rule
Um objeto que contém informações sobre a regra em execução no momento. O objeto deve conter as seguintes subpropriedades:
id
: a ID da regra em execução no momento.name
: o nome da regra em execução no momento.
Como alternativa, a extensão que fornece o tipo de evento que acionou a regra pode adicionar outras informações úteis a esse objeto event
.