Introdução ao desenvolvimento de extensões

OBSERVAÇÃO

A Adobe Experience Platform Launch está sendo reformulada como um conjunto de tecnologias de coleta de dados no Experience Platform. Essas alterações serão implementadas em toda a documentação do produto nas próximas semanas. Consulte o seguinte document para obter uma referência consolidada das alterações de terminologia.

Para você poder começar a trabalhar e criar extensões, vamos usar a ferramenta de andaimes de código aberto, fornecida pelos engenheiros do Adobe Experience Platform Launch para criar os arquivos necessários e a estrutura de arquivos para o pacote de extensão. Assim, tudo o que você ainda precisa fazer é a parte valiosa: na verdade, criar o código.

Pré-requisitos

Configuração de extensão

Crie um diretório em que seus arquivos de extensão ficarão ativos.

mkdir example && cd example

Este guia utiliza a ferramenta de andaime de extensão para criar a estrutura de extensão inicial para que os desenvolvedores possam começar a criar código rapidamente. Esse processo pode ser feito manualmente sem a ferramenta de andaime, se desejado.

Execute a ferramenta de andaime.

npx @adobe/reactor-scaffold

A ferramenta de andaime solicitará algumas opções de configuração iniciais da seguinte maneira:

  • Nome de exibição: o nome visível da extensão
  • Versão: a versão da extensão
  • Descrição: uma breve descrição da finalidade da extensão
  • Autor: o nome do autor da extensão

A ferramenta de andaime fornecerá opções para a construção da estrutura de extensão:

  • Visualização da configuração de extensão: a visualização, o arquivo HTML, por meio do qual uma extensão coleta configurações globais de um usuário.
  • Tipos de evento: define uma atividade para observação. Por exemplo, saiba quando um usuário faz a rolagem rapidamente ou quando um usuário interagiu com um elemento da página. Eventos podem ser utilizados em regras para executar ações.
  • Tipos de condição: os tipos de condição avaliam se algo é verdadeiro ou falso.
    Por exemplo, isso pode retornar se o navegador do usuário é o Chrome, se ele está usando um iPad ou se o usuário está em um domínio específico.
  • Tipos de ação: a ação a ser executada quando ocorrer um evento. Por exemplo, enviar um beacon de análise, mostrar uma oferta, salvar um cookie ou abrir um bate-papo de suporte.
  • Tipos de elementos de dados: um tipo de elemento de dados recupera dados. Esses dados podem estar no armazenamento local, em um cookie, em um elemento DOM ou em um local personalizado.
  • Módulos compartilhados: um módulo compartilhado é um mecanismo pelo qual as extensões podem se comunicar com outras extensões.
  • Visualizações: cada tipo de evento, condição, ação ou elemento de dados pode fornecer uma visualização que permite ao usuário fornecer configurações.
OBSERVAÇÃO
  • As execuções subsequentes da ferramenta de andaime vão ignorar a configuração inicial.
  • É possível adicionar mais de um de cada evento, condição e ação.
  • Apenas uma visualização de configuração pode existir.

Nesta página