Tipos de ação

Last update: Wed Aug 07 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

Desenvolvedor

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 apresentações apply-propositions

O tipo de ação Aplicar apresentações permite renderizar apresentações em aplicativos de página única sem incrementar métricas.

Esse tipo de ação é útil ao trabalhar com aplicativos de página única em que partes da página são renderizadas novamente, substituindo potencialmente qualquer personalização já aplicada à página.

Você pode usar esse tipo de ação para vários casos de uso, como:

Renderizar ofertas de HTML de mbox. Proposições solicitadas explicitamente por um escopo ou superfície de uma ação Enviar evento não são renderizadas automaticamente. Você pode usar o tipo de ação Aplicar propostas para informar ao SDK da Web onde renderizá-las especificando os metadados da proposta.
Renderizar as ofertas para uma exibição em um aplicativo de página única. Ao renderizar um evento de alteração de exibição, se os dados de análise ainda não estiverem prontos, você poderá usar a ação Aplicar propostas para renderizar as propostas de exibição na parte superior da página. Consulte eventos de início e fim de página (Segunda exibição de página - Opção 2) para obter mais detalhes. Para usar isso, insira um Nome da exibição no formulário.
Renderizar novamente as apresentações. Quando o site usa uma estrutura como o React para renderizar o conteúdo novamente, talvez seja necessário reaplicar a personalização. Nesses casos, você pode usar o tipo de ação Aplicar propostas para fazer isso.

Esse tipo de ação não enviará um evento de exibição para apresentações renderizadas. Ele rastreará as apresentações renderizadas para que elas possam ser incluídas nas chamadas Enviar evento subsequentes.

Interface do usuário de Marcas de Plataforma mostrando o tipo de ação Aplicar Apresentações.

Esse tipo de ação é compatível com os seguintes campos:

Propositions: uma matriz de objetos de proposta que você deseja renderizar novamente.
Nome da exibição: o nome da exibição a ser renderizada.
Metadados de apresentação: um objeto que determina como as ofertas de HTML podem ser aplicadas. Essas informações podem ser fornecidas por meio do formulário ou por meio de um elemento de dados. Ele contém as seguintes propriedades:
- Escopo
- Seletor
- Tipo de ação

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.

Imagem da interface do usuário do Experience Platform mostrando o tipo de ação Aplicar resposta.

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.

Avaliar conjuntos de regras evaluate-rulesets

Esse tipo de ação aciona manualmente a avaliação do conjunto de regras. Os conjuntos de regras são retornados pelo Adobe Journey Optimizer para oferecer suporte a recursos como mensagens no navegador.

Imagem da interface do usuário do Experience Platform mostrando o tipo de ação de resposta Avaliar conjuntos de regras.

Esse tipo de ação é compatível com as seguintes opções:

Renderizar decisões de personalização visual: habilite essa opção para renderizar decisões de personalização visual para os itens do conjunto de regras correspondentes.
Contexto de decisão: é um mapa de valores chave usado ao avaliar conjuntos de regras do Adobe Journey Optimizer para decisão no dispositivo. Você pode fornecer o contexto de decisão manualmente ou por meio de um elemento de dados.

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.

Imagem da interface do usuário da plataforma mostrando o tipo de ação Obter Media Analytics Tracker.

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.

Enviar evento send-event

Envia um evento para o Experience Platform para que a Platform possa coletar os dados enviados e agir de acordo com essas informações. 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.

O tipo de ação Enviar Evento dá suporte aos campos e configurações descritos abaixo. Todos esses campos são opcionais.

Configurações de instância instance

Use o seletor Instância para escolher a instância do SDK da Web que você deseja configurar. Se você tiver apenas uma instância, ela será pré-selecionada.

Imagem da Interface do Usuário de Marcas da Plataforma mostrando as configurações da instância para o tipo de ação Enviar Evento.

Instância: selecione a instância do SDK da Web que você deseja configurar. Se você tiver apenas uma instância, ela será pré-selecionada.

Usar eventos guiados: habilite esta opção para preencher ou ocultar automaticamente determinados campos para habilitar um caso de uso específico. Habilitar essa opção aciona a exibição das seguintes configurações.

Solicitar personalização: este evento deve ser chamado na parte superior da página. Quando selecionado, esse evento define os seguintes campos:
- Tipo: Busca de Apresentação de Decisão
- Enviar automaticamente um evento de exibição: false
- Para renderizar automaticamente a personalização neste caso, habilite a opção Renderizar decisões de personalização visual.
Coletar análises: este evento deve ser chamado na parte inferior da página. Quando selecionado, esse evento define os seguintes campos:
- Incluir propostas renderizadas: true
- As configurações do Personalization estão ocultas

note note
NOTE
Os eventos guiados estão relacionados a eventos de início e fim de página.

Dados data

Imagem da Interface do Usuário de Marcas da Plataforma mostrando as configurações do elemento de dados para o tipo de ação Enviar Evento.

Tipo: este campo permite especificar um tipo de evento que será gravado no esquema XDM. Consulte type no comando sendEvent para obter mais informações.
XDM:
Dados: use este campo para enviar dados que não correspondam a um esquema XDM. Este campo é útil se você estiver tentando atualizar um perfil do Adobe Target ou enviar atributos do Target Recommendations. Consulte data no comando sendEvent para obter mais informações.
Incluir propostas renderizadas: habilite esta opção para incluir todas as propostas que foram renderizadas, mas um evento de exibição não foi enviado. Use isso em conjunto com Enviar automaticamente um evento de exibição desabilitado. Esta configuração atualiza o campo XDM _experience.decisioning com informações sobre as propostas renderizadas.
Documento será descarregado: habilite esta opção para garantir que os eventos cheguem ao servidor mesmo se o usuário sair da página. Isso permite que os eventos alcancem o servidor, mas as respostas são ignoradas.
ID de Mesclagem: Este campo está obsoleto. Isso preencherá o campo XDM eventMergeId.

Personalização personalization

Imagem da Interface do Usuário de Marcas da Plataforma mostrando as configurações do Personalization para o tipo de ação Enviar Evento.

Escopos: selecione os escopos (Adobe Target mboxes) que você deseja solicitar explicitamente da personalização. Você pode inserir os escopos manualmente ou fornecendo um elemento de dados.
Superfícies: defina as superfícies da Web que estão disponíveis na página para personalização. Consulte a documentação do Adobe Journey Optimizer para obter mais detalhes.
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.
Solicitar personalização padrão: use esta seção para controlar se o escopo de toda a página (mbox global) e a superfície padrão (superfície da web com base na URL atual) são solicitados. Por padrão, isso é solicitado automaticamente durante a primeira chamada sendEvent do carregamento da página. Você pode escolher entre as seguintes opções:
- Automático: este é o comportamento padrão. Somente solicite a personalização padrão quando ainda não tiver sido solicitada. Isso corresponde a requestDefaultPersonalization não definido no comando do SDK da Web.
- Habilitado: solicitar explicitamente o escopo de página e a superfície padrão. Isso atualiza o cache de visualização do SPA. Isso corresponde a requestDefaultPersonalization definido como true.
- Desabilitado: suprimir explicitamente a solicitação para o escopo de página e a superfície padrão. Isso corresponde a requestDefaultPersonalization definido como false.
Contexto de decisão: é um mapa de valores chave usado ao avaliar conjuntos de regras do Adobe Journey Optimizer para decisão no dispositivo. Você pode fornecer o contexto de decisão manualmente ou por meio de um elemento de dados.

Substituições de configuração da sequência de dados datastream-overrides

As substituições de sequência de dados permitem definir configurações adicionais para suas sequências de dados, que são transmitidas para a rede de borda por meio do SDK da Web.

Isso ajuda a acionar comportamentos de sequência de dados diferentes dos padrão, sem criar uma nova sequência de dados ou modificar as configurações existentes. Consulte a documentação em configurando substituições de sequência de dados para obter mais detalhes.

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.

Imagem da interface do usuário da plataforma mostrando a tela de evento de envio 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.

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.

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.

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743