Tipos de ação
Após configurar a extensão de tag do SDK da Web da Adobe Experience Platform, você deve configurar seus tipos de ação.
Esta página descreve os tipos de ação compatíveis com a extensão de tag do SDK da Web da Adobe Experience Platform.
Aplicar resposta apply-response
Use o tipo de ação Aplicar resposta quando desejar executar várias ações com base em uma resposta do Edge Network. Normalmente, esse tipo de ação é usado em implantações híbridas em que o servidor faz uma chamada inicial para o Edge Network, em seguida, esse tipo de ação recebe a resposta dessa chamada e inicializa o SDK da Web no navegador.
O uso desse tipo de ação pode reduzir os tempos de carregamento do cliente para casos de uso de personalização híbrida.
Esse tipo de ação oferece suporte às seguintes opções de configuração:
- Instância: selecione a instância do SDK da Web que você está usando.
- Cabeçalhos de resposta: selecione o elemento de dados que retorna um objeto contendo as chaves do cabeçalho e os valores retornados da chamada do servidor Edge Network.
- Corpo da resposta: selecione o elemento de dados que retorna o objeto que contém a carga JSON fornecida pela resposta Edge Network.
- Renderizar decisões de personalização visual: habilite esta opção para renderizar automaticamente o conteúdo de personalização fornecido pelo Edge Network e pré-ocultar o conteúdo para evitar cintilação.
Enviar evento send-event
Envia um evento para o Adobe Experience Platform para que o Adobe Experience Platform possa coletar os dados enviados e agir de acordo com essas informações. Selecione uma instância (se você tiver mais de uma). Todos os dados que deseja enviar podem ser enviados no campo Dados XDM. Use um objeto JSON que esteja em conformidade com a estrutura do esquema XDM. Este objeto pode ser criado na sua página ou através de um Código personalizado Elemento de dados.
Há alguns outros campos no tipo de ação Enviar evento que também podem ser úteis, dependendo da implementação. Observe que todos esses campos são opcionais.
- Tipo: esse campo permite especificar um tipo de evento que será gravado no esquema XDM. Consulte
type
no comandosendEvent
para obter mais informações. - Dados: dados que não correspondem a um esquema XDM podem ser enviados usando este campo. Este campo é útil se você estiver tentando atualizar um perfil do Adobe Target ou enviar atributos do Target Recommendations. Consulte
data
no comandosendEvent
para obter mais informações. - ID do conjunto de dados: Se você precisar enviar dados para um conjunto de dados diferente daquele especificado na sua sequência de dados, poderá especificar essa ID do conjunto de dados aqui.
- Documento será descarregado: Se você quiser garantir que os eventos cheguem ao servidor mesmo que o usuário saia da página, marque a caixa de seleção Documento será descarregado. Isso permite que os eventos alcancem o servidor, mas as respostas são ignoradas.
- Renderizar decisões de personalização visual: se você quiser renderizar conteúdo personalizado em sua página, marque a caixa de seleção Renderizar decisões de personalização visual. Você também pode especificar escopos de decisão e/ou superfícies, se necessário. Consulte a documentação de personalização para obter mais informações sobre renderização de conteúdo personalizado.
Definir consentimento set-consent
Após receber o consentimento do usuário, esse consentimento deve ser comunicado ao SDK da Web da Adobe Experience Platform usando o tipo de ação "Definir consentimento". Atualmente, há suporte para dois tipos de padrões: "Adobe" e "IAB TCF". Consulte Suporte às preferências de consentimento do cliente. Ao usar a versão 2.0 do Adobe, somente um valor de elemento de dados é compatível. Será necessário criar um elemento de dados que resolva para o objeto de consentimento.
Nesta ação, você também recebe um campo opcional para incluir um Mapa de identidade, de modo que as identidades possam ser sincronizadas assim que o consentimento for recebido. A sincronização é útil quando o consentimento é configurado como "Pendente" ou "Fora", pois a chamada de consentimento provavelmente é a primeira chamada a ser acionada.
Atualizar variável update-variable
Use esta ação para modificar um objeto XDM como resultado de um evento. Esta ação destina-se a criar um objeto que pode ser referenciado posteriormente de uma ação Enviar evento, para registrar o objeto XDM do evento.
Para usar este tipo de ação, você deve ter definido um elemento de dados variável. Depois que você escolher um elemento de dados variável para modificar, será exibido um editor semelhante ao editor do elemento de dados objeto XDM.
O esquema XDM usado para o editor é o esquema selecionado no elemento de dados variável. Você pode definir uma ou mais propriedades do objeto clicando em uma das propriedades na árvore à esquerda e modificando o valor à direita. Por exemplo, na captura de tela abaixo, a propriedade productionBy está sendo definida como o elemento de dados "Produced by data element".
Há algumas diferenças entre o editor na ação de atualização de variáveis e o editor no elemento de dados do objeto XDM. Primeiro, a ação atualizar variável tem um item de nível raiz rotulado como "xdm". Se você clicar nesse item, poderá especificar um elemento de dados a ser usado para definir o objeto inteiro. Segundo, a ação de atualização da variável tem caixas de seleção para limpar os dados do objeto xdm. Clique em uma das propriedades à esquerda e marque a caixa de seleção à direita para limpar o valor. Isso limpará o valor atual antes de definir quaisquer valores na variável.
Enviar evento de mídia send-media-event
Envia um evento de mídia para o Adobe Experience Platform e/ou Adobe Analytics. Essa ação é útil ao rastrear eventos de mídia no site. Selecione uma instância (se você tiver mais de uma). A ação requer um playerId
que representa um identificador exclusivo para uma sessão de mídia rastreada. Também requer uma Qualidade de experiência e um elemento de dados playhead
ao iniciar uma sessão de mídia.
O tipo de ação Enviar evento de mídia dá suporte às seguintes propriedades:
- Instância: a instância do SDK da Web que está sendo usada.
- Tipo de evento de mídia: o tipo de evento de mídia que está sendo rastreado.
- ID do player: o identificador exclusivo da sessão de mídia.
- Indicador de reprodução: a posição atual da reprodução de mídia, em segundos.
- Detalhes da sessão de mídia: Ao enviar um evento de início de mídia, os detalhes da sessão de mídia necessários devem ser especificados.
- Detalhes do capítulo: nesta seção, você pode especificar os detalhes do capítulo ao enviar um evento de mídia de início de capítulo.
- Detalhes do Advertising: ao enviar um evento
AdBreakStart
, você deve especificar os detalhes de publicidade necessários. - Detalhes do pod do Advertising: detalhes sobre o pod de publicidade ao enviar um evento
AdStart
. - Detalhes do erro: detalhes sobre o erro de reprodução que está sendo rastreado.
- Detalhes da atualização de estado: o estado do player que está sendo atualizado.
- Metadados personalizados: os metadados personalizados sobre o evento de mídia que está sendo rastreado.
- Qualidade de experiência: a qualidade de mídia dos dados de experiência que estão sendo rastreados.
Obter o Media Analytics Tracker get-media-analytics-tracker
Essa ação é usada para obter a API herdada do Media Analytics. Ao configurar a ação e um nome de objeto é fornecido, a API herdada do Media Analytics será exportada para esse objeto de janela. Se nenhum for fornecido, ele será exportado para window.Media
como a biblioteca Media JS atual faz.
Redirecionar com identidade redirect-with-identity
Use esse tipo de ação para compartilhar identidades da página atual com outros domínios. Esta ação foi projetada para ser usada com um tipo de evento click e uma condição de comparação de valor. Consulte anexar identidade à URL usando a extensão SDK da Web para obter mais informações sobre como usar este tipo de ação.
Próximas etapas next-steps
Depois de ler este artigo, você terá que entender melhor como configurar suas ações. Em seguida, leia sobre como configurar seus tipos de elementos de dados.