Imagens interativas

Você pode facilmente fazer imagens estáticas avançadas e envolventes para os clientes, arrastando e soltando pontos de acesso "que podem ser comprados" em uma imagem. Os hotspots que podem ser comprados combinam informações adicionais sobre um produto ou serviço com um recurso direto de "Adicionar ao carrinho" ou "Comprar" no ponto de venda. Os clientes podem tocar nesses pontos de acesso e ser vinculados diretamente ao produto ou serviço, adicioná-lo a um carrinho de compras ou ser vinculados a uma página da Web. Experiências diretas como essas aumentam o envolvimento e a conversão do cliente em seu site.

Veja a seguir um banner que pode ser comprado com um pop-up do Quickview. Um usuário ativa o Quickview, tocando o círculo ou o "ponto de acesso" no modelo.

chlimage_1-368

Veja as imagens interativas em ação na página da Web acima acessando o seguinte:

https://experienceleague.adobe.com/tools/dynamic-media-demo/shoppable-banner/we-fashion-QVzoom/index2-shoppable.html?lang=pt-BR?lang=pt-BR

Veja como os banners de imagem interativos são criados

Assista a uma apresentação de 10 minutos e 33 segundos sobre como os banners de imagem interativos são criados. Você também aprenderá a visualizar, editar e fornecer banners de imagem interativos.

Início rápido: Imagens interativas

A seguinte descrição passo a passo do fluxo de trabalho foi criada para ajudar você a ativar e executar rapidamente com imagens interativas no AEM Assets.

Procure o cabeçalho Exemplo em algumas das tarefas de Início rápido. Ele contém um breve tutorial baseado no seguinte exemplo de página da Web que ainda não tem Imagens interativas adicionadas a ele:

https://experienceleague.adobe.com/tools/dynamic-media-demo/shoppable-banner/we-fashion/landing-0.html?lang=pt-BR?lang=pt-BR

O tutorial ajuda a ilustrar as etapas da integração de imagens interativas em seu próprio site.

Fluxo de trabalho Imagens interativas:

  1. (Opcional) Identificação de variáveis de ponto de acesso - Se você usar o AEM Assets e o Dynamic Media de forma independente, comece identificando as variáveis dinâmicas usadas na implementação existente do Quickview, para que você possa inserir dados de ponto de acesso ao criar a imagem interativa. Consulte (Opcional) Identificação de variáveis de ponto de acesso.

    No entanto, se você usar o AEM Sites ou AEM eCommerce, ou ambos, essa etapa não será necessária.

    Consulte Conceitos de comércio eletrônico no AEM Assets.

  2. (Opcional) Criação de uma predefinição do visualizador de Imagem interativa - Personalize a imagem gráfica usada para representar pontos de acesso. Não é necessário criar sua própria predefinição do visualizador de Imagem interativa se você pretende usar a predefinição do visualizador de Imagem interativa pronta para uso chamada Shoppable_Banner.

    Consulte (Opcional) Criação de uma predefinição do visualizador de Imagem interativa.

  3. Upload de um banner de imagem - Faça upload de banners de imagem que você deseja tornar interativos.

    Consulte Fazer upload de um banner de imagem.

  4. Adição de pontos de acesso a um banner de imagem - Adicione um ou mais pontos de acesso a um banner de imagem e associe cada um a uma ação, como um hiperlink, uma exibição rápida ou um Fragmento de experiência. Depois de adicionar pontos de acesso, você concluirá essa tarefa publicando a imagem interativa.

  5. Adicionar uma imagem interativa ao seu site ou ao seu site na AEM

(Opcional) Identificação de variáveis de ponto de acesso

OBSERVAÇÃO

Essa tarefa só será necessária se o seguinte for verdadeiro:

  • Você deseja adicionar interatividade à imagem, acionando para o Quickviews.
  • Sua implementação do AEM not usa uma estrutura de integração do eCommerce para inserir dados de produtos em AEM de qualquer solução de eCommerce, como IBM Websphere Commerce, Elastic Path, hybris ou Intershop. Consulte Conceitos de comércio eletrônico no AEM Assets.

Se a implementação do AEM usar o eCommerce, você poderá ignorar esta tarefa e prosseguir para a próxima tarefa.

Comece identificando as variáveis dinâmicas usadas pela implementação existente do Quickview, para que você possa inserir dados de pontos de acesso para criar a imagem interativa.

Ao adicionar pontos de acesso a uma imagem de banner no AEM Assets, é necessário atribuir uma SKU (Stock Keeping Unit; Unidade de manutenção de estoque); um identificador exclusivo para cada produto ou serviço distinto que você oferece) e variáveis adicionais opcionais para cada ponto de acesso. Essas variáveis de ponto de acesso são usadas posteriormente para corresponder pontos de acesso com conteúdo do Quickview.

É importante identificar corretamente o número e o tipo de variáveis a serem associadas aos dados do ponto de acesso. Cada ponto de acesso adicionado a uma imagem de banner deve ter informações suficientes para identificar inequivocamente o produto no sistema de back-end existente.

Há diferentes maneiras de identificar um conjunto de variáveis a serem usadas para dados de pontos de acesso.

Às vezes, pode ser suficiente consultar especialistas de TI responsáveis pela implementação atual do Quickview, pois eles provavelmente saberão qual é o conjunto mínimo de dados necessário para identificar o Quickview no sistema. No entanto, na maioria dos casos, também é possível simplesmente analisar o comportamento existente do código front-end.

A maioria das implementações do Quickview usa o seguinte paradigma:

  • O usuário ativa um elemento da interface do usuário no site. Por exemplo, clicar em um botão Quickview.
  • O site envia uma solicitação do Ajax para o backend para carregar os dados ou o conteúdo do Quickview, se necessário.
  • Os dados do Quickview são traduzidos para o conteúdo em preparação para renderização na página da Web.
  • Por fim, o código front-end renderiza visualmente esse conteúdo na tela.

A abordagem é visitar diferentes áreas do site existente onde o recurso Quickview é implementado, acionar o Quickview e capturar o URL Ajax enviado pela página da Web para carregar os dados ou o conteúdo do Quickview.

Normalmente, não há necessidade de usar ferramentas de depuração especializadas. Os navegadores modernos da Web apresentam inspetores da Web que fazem um trabalho adequado. A seguir estão alguns exemplos de navegadores da Web que incluem inspetores da Web:

  • Para ver todas as solicitações HTTP de saída no Google Chrome, pressione F12 para abrir o painel Ferramentas do desenvolvedor e clique na guia Rede.

    Em um Mac, pressione Command+Option+I para abrir o painel Ferramentas do desenvolvedor e clique na guia Rede.

  • No Firefox, é possível ativar o plug-in do Firebug pressionando F12 e usar a guia Rede ou usar a ferramenta Inspetor integrada e a guia Rede.

    Em um Mac, pressione Command+Option+I para abrir o painel Ferramentas do Desenvolvedor e clique na guia Inspetor.

Quando o monitoramento de rede estiver ativado no navegador, acione o Quickview na página.

Agora, encontre o URL do Ajax do Quickview no log de rede e copie o URL registrado para análise futura. Na maioria dos casos, quando você aciona o Quickview, há várias solicitações que são enviadas ao servidor. Normalmente, o URL de Ajax do Quickview é um dos primeiros na lista. Ela tem uma parte ou um caminho complexo da sequência de consulta e seu tipo MIME de resposta é text/html, text/xml ou text/javascript.

Durante esse processo, é importante visitar áreas diferentes de seu site, com categorias e tipos de produtos diferentes. O motivo é que os URLs do Quickview podem ter partes comuns para uma determinada categoria de site, mas são alteradas somente se você visitar uma área diferente do site.

No caso mais simples, a única parte variável no URL do Quickview é o SKU do produto. Nesse caso, o valor de SKU é o único dado necessário para adicionar pontos de acesso à imagem do banner.

No entanto, em casos complexos, o URL do Quickview tem elementos variáveis diferentes além do SKU, como ID da categoria, código de cor, código de tamanho e assim por diante. Nesses casos, cada elemento é uma variável separada na definição de dados do ponto de acesso no recurso de imagem interativa que pode ser comprada no AEM Assets.

Considere os exemplos a seguir de URLs do Quickview e suas variáveis de ponto de acesso resultantes:

SKU único, encontrado na string de consulta.

Os URLs do Quickview registrados incluem o seguinte:

  • https://server/json?productId=866558&source=100

  • https://server/json?productId=1196184&source=100

  • https://server/json?productId=1081492&source=100

  • https://server/json?productId=1898294&source=100

A única parte variável no URL é o valor do parâmetro da string de consulta productId= e é claramente um valor SKU. Portanto, nossos pontos de acesso precisam apenas de campos SKU preenchidos com valores como 866558, 1196184, 1081492, 1898294.

SKU único, encontrado no caminho do URL.

Os URLs do Quickview registrados incluem o seguinte:

  • https://server/product/6422350843

  • https://server/product/1607745002

  • https://server/product/0086724882

A parte variável está na última parte do caminho e se torna o valor SKU dos pontos de acesso: 6422350843, 1607745002, 0086724882.

SKU e ID de categoria na sequência de consulta.

Os URLs do Quickview registrados incluem o seguinte:

  • https://server/quickView/product/?category=1100004&prodId=305466

  • https://server/quickView/product/?category=1100004&prodId=310181

  • https://server/quickView/product/?category=1740148&prodId=308706

Nesse caso, há duas partes variáveis no URL. O SKU é armazenado no parâmetro prodId e na ID da categoria

categoryId

  • 305466categoryId1100004

  • 310181categoryId1100004

  • 308706categoryId1740148

Exemplo

Você pode aplicar a mesma abordagem usada nos três exemplos acima na página da Web de demonstração:

https://experienceleague.adobe.com/tools/dynamic-media-demo/shoppable-banner/we-fashion/landing-0.html?lang=pt-BR?lang=pt-BR

A página da Web de demonstração tem várias miniaturas de produto, cada uma com um botão Quickview rotulado Consulte Mais. Com a ferramenta de depuração do navegador da Web ainda ativada, clique em cada botão e observe os URLs do Quickview registrados. Depois de ativar as quatro visualizações rápidas de produto disponíveis na página, você tem a seguinte lista de solicitações do Quickview feitas ao back-end:

  • /datafeed/Men-Windbreaker.json
  • /datafeed/Men-SimpleHenley.json
  • /datafeed/Men-CamoPullover.json
  • /datafeed/Women-QuiltedDownJacket.json

Ao examinar essas chamadas de servidor, você verá que informações específicas do produto estão presentes somente no caminho da solicitação. Você também notará que a sequência de consulta não é usada e que há dois tipos distintos de partes de dados envolvidos:

  • O primeiro tipo é Homens ou Mulheres. Você pode chamar esta "categoria de produto".
  • O segundo tipo é o nome do produto, como CamoPulover. Você pode assumir que este é o SKU do produto.

Considerando essas informações, todo o URL do Quickview tem o seguinte padrão:

/datafeed/$categoryId$-$SKU$.json

Com base nessa análise, você usaria categoryId e SKU para pontos de acesso.

Agora você está pronto para fazer upload de um banner de imagem e adicionar pontos de acesso a ele usando o recurso de imagem interativa que pode ser comprado no AEM Assets.

(Opcional) Criação de uma predefinição do visualizador de Imagem interativa

Você pode optar por usar a predefinição padrão do visualizador de Imagem interativa e pronta para uso chamada Shoppable_Banner que vem com o AEM Assets. Ou você pode criar sua própria predefinição personalizada do visualizador para uso com imagens interativas.

Ao criar uma predefinição personalizada do visualizador de Imagem interativa, você pode determinar a aparência dos pontos de acesso no banner de imagem. Como parte da criação da predefinição do visualizador, você pode optar por usar um gráfico de ponto de acesso de uma galeria de imagens predefinidas.

Depois de salvar a predefinição do visualizador, ela é ativada automaticamente (ativada) na página de lista Predefinição do visualizador no AEM Assets. Essa funcionalidade significa que está visível no componente Mídia interativa e sempre que você exibe um ativo. No entanto, para fornecer um banner interativo com essa predefinição do visualizador, você também deve publicar sua predefinição do visualizador (isso é verdadeiro para predefinições do visualizador personalizadas ou predefinidas).

Para criar uma predefinição do visualizador de Imagem interativa:

  1. No painel à esquerda, toque em Ferramentas > Ativos > Predefinições do visualizador.

  2. Próximo ao canto superior direito da página, toque em Criar.

  3. Na caixa de diálogo New Viewer Preset, digite um nome para descrever a predefinição interativa do visualizador de banner.

    Este é o título que aparecerá na página de lista Predefinição do visualizador depois de salvar.

  4. No menu suspenso Rich Media Type, selecione Imagem interativa.

  5. Toque em Criar.

  6. Na página Editar predefinição do visualizador, toque na guia Aparência.

  7. Faça uma das seguintes opções:

    • Para fazer upload de sua própria imagem de ponto de acesso que deseja usar nas imagens, toque no ícone Seletor de ativo. Na página Selecionar conteúdo, navegue até a imagem do ponto de acesso que deseja usar, selecione-a e toque no ícone Marca de seleção no canto superior direito.
    • Para selecionar uma imagem de ponto de acesso predefinida, toque no ícone Galeria de pontos de acesso. Na paleta da galeria de pontos de acesso, toque na imagem do ponto de acesso que deseja usar.
  8. Próximo ao canto superior direito da página, toque em Salvar.

    Certifique-se de publicar a nova predefinição do visualizador.

    Consulte Predefinições Do Visualizador De Publicação Que Você Adicionou.

    Agora você está pronto para fazer upload de um banner de imagem.

Upload de um banner de imagem

Se você já tiver carregado as imagens que deseja usar, avance para a próxima etapa, Adicionar pontos de acesso a um banner de imagem.

Para fazer upload de um banner de imagem:

  1. Carregue banners de imagem que você deseja tornar interativos.

    Consulte Fazer upload de ativos.

    Agora você está pronto para adicionar pontos de acesso ao banner de imagem; consulte a próxima tarefa abaixo.

Adicionar pontos de acesso a um banner de imagem

Você pode adicionar pontos de acesso a um banner de imagem usando o editor na página Gerenciamento de pontos de acesso.

Ao adicionar pontos de acesso, você pode defini-los como uma exibição pop-up do Quickview, como um hiperlink ou um Fragmento de experiência.

Consulte Fragmentos de experiência.

OBSERVAÇÃO

Esteja ciente de que as ferramentas de compartilhamento de mídia social na Imagem interativa não são compatíveis quando você incorpora o visualizador a um Fragmento de experiência. Para contornar isso, você pode usar ou criar predefinições do visualizador que não tenham ferramentas de compartilhamento de redes sociais. Essas predefinições do visualizador permitem que você as incorpore com êxito aos Fragmentos de experiência.

​As ​opções Undoand Redooptions, próximo ao canto superior direito da página, são compatíveis durante a sessão de criação/edição atual.

Quando você terminar de criar a imagem interativa, poderá usar Preview para ver uma representação de como a imagem interativa aparecerá para os clientes.

Consulte (Opcional) Visualização de imagens interativas.

OBSERVAÇÃO

Quando você adiciona pontos de acesso a uma imagem em uma Imagem interativa ou em um Banner de carrossel, as informações do ponto de acesso são armazenadas no mesmo local de metadados (em relação ao local da imagem), independentemente de ser uma Imagem interativa ou um Banner de carrossel. Essa funcionalidade significa que você pode reutilizar facilmente a mesma imagem, juntamente com os dados de ponto de acesso definidos, em qualquer um dos visualizadores.

Esteja ciente, no entanto, de que os carrossel Banners suportam mapas de imagens em imagens que também podem conter pontos de acesso; uma Imagem interativa não. Lembre-se disso se você pretende criar uma Imagem interativa ou Banner de carrossel que usa a mesma imagem. Você pode criar Imagens interativas e Banners de carrossel usando cópias separadas da mesma imagem.

Consulte também Banners do carrossel.

OBSERVAÇÃO

Se você estiver editando imagens interativas com pontos de acesso e recortar a imagem, seus pontos de acesso serão removidos.

Para adicionar pontos de acesso a um banner de imagem:

  1. Na exibição Ativos, navegue até o banner de imagem que deseja tornar interativo.

  2. Faça uma das seguintes opções:

    • Passe o mouse sobre a imagem e toque em Selecionar (ícone de marca de seleção). Na barra de ferramentas, toque em Editar.
    • Passe o mouse sobre a imagem, em seguida, toque em Mais ações (ícone de três pontos) > Editar.
    • Toque na imagem para abri-la na página Exibição de detalhes. Na barra de ferramentas, toque em Editar.
  3. Próximo ao canto superior esquerdo da página, toque em Adicionar ponto de acesso (ícone de toque com o dedo) para abrir a página Gerenciamento de ponto de acesso.

  4. Próximo ao canto superior esquerdo da página, toque em Ponto de acesso.

  5. a. Próximo ao canto superior esquerdo da página Gerenciamento de ponto de acesso, toque em Ponto de acesso.
    b. Na imagem, toque em um local onde deseja que o ponto de acesso apareça. Se necessário, arraste o ponto de conexão para ajustar sua localização.
    c. Adicione pontos de acesso adicionais conforme necessário, repetindo as etapas a e b.
    d. (Opcional) Para excluir um ponto de acesso, selecione-o na imagem e toque em Excluir (ícone da lixeira) sob o cabeçalho Pontos de acesso.

  6. No campo de texto Name, digite o nome do ponto de acesso. Esse nome também aparece na lista suspensa Ponto de acesso selecionado.

  7. Faça uma das seguintes opções:

    • Toque em Quickview.

      • Se você for um cliente do AEM Sites ou eCommerce, toque no ícone Seletor de Produto (lupa) para abrir a página Selecionar Produto. Toque no produto que deseja usar e toque em Selecionar no canto superior direito da página para retornar à página Gerenciamento de ponto de acesso.

      • Se você for não um cliente do AEM Sites ou eCommerce

        • Consulte Identificação de variáveis de ponto de acesso; será necessário definir essas variáveis.
        • Em seguida, insira manualmente o valor de SKU. No campo de texto Valor SKU, digite o SKU do produto (unidade de manutenção de estoque), que é um identificador exclusivo para cada produto ou serviço distinto que você oferece. O valor de SKU inserido preenche automaticamente a parte variável do modelo do Quickview, de modo que o sistema saiba associar o ponto de acesso com um Quickview específico do SKU.
        • (Opcional) Se houver outras variáveis no Quickview que você precisa usar para identificar ainda mais um produto, toque em Adicionar variável genérica. No campo de texto, especifique uma variável adicional. Por exemplo, category=Mens é uma variável adicionada.
    • Toque em Hiperlink.

      • Se você for um cliente do AEM Sites, toque no ícone Seletor de site (pasta) para navegar até um URL. Observe que o método de vinculação baseado em URL não é possível se o conteúdo interativo tiver links com URLs relativos, especialmente links para páginas do AEM Sites.
      • Se você for um cliente independente, no campo de texto HREF, especifique o caminho do URL completo para uma página da Web vinculada.

      Certifique-se de especificar se deseja abrir o link em uma nova guia do navegador (padrão recomendado) ou na mesma guia.

      Consulte Trabalhar com seletores para obter mais informações.

    • Toque em Fragmento de experiência.

      • Se você for um cliente do AEM Sites, toque no ícone Pesquisar (lupa) para abrir a página Fragmento de experiência. Toque no Fragmento de experiência que deseja usar e toque em Selecionar no canto superior direito da página para retornar à página Gerenciamento de ponto de acesso.

        Consulte Fragmentos de experiência.

        OBSERVAÇÃO

        Esteja ciente de que as ferramentas de compartilhamento de mídia social na Imagem interativa não são compatíveis quando você incorpora o visualizador a um Fragmento de experiência. Para contornar isso, você pode usar ou criar predefinições do visualizador que não tenham ferramentas de compartilhamento de redes sociais. Essas predefinições do visualizador permitem que você as incorpore com êxito aos Fragmentos de experiência.

      • Especifique a largura e a altura do Fragmento de experiência como ele aparecerá no banner.

  8. Toque em Salvar para salvar seu trabalho e retornar à página Procurar.

  9. Publique a imagem interativa. A publicação permite que o banner seja entregue por meio da nuvem e também gera código incorporado se você precisar se integrar a um site de terceiros.

    Consulte Publicação de ativos.

    Após adicionar pontos de acesso e publicar a imagem interativa, você estará pronto para adicioná-la ao seu site existente.

    Consulte Integração de uma imagem interativa com seu site.

    OBSERVAÇÃO

    Se você estiver editando imagens interativas com pontos de acesso e recortar a imagem, seus pontos de acesso serão excluídos.

(Opcional) Visualização de imagens interativas

Você pode usar a Visualização para ver uma representação da aparência da imagem interativa para os clientes e testar os pontos de acesso da imagem para garantir que eles estejam se comportando conforme esperado.

Quando estiver satisfeito com a imagem interativa, você poderá publicá-la.
Consulte Incorporando o visualizador de vídeo ou imagem em uma página da Web.
Consulte Vincular URLs ao aplicativo Web. Observe que o método de vinculação baseado em URL não é possível se o conteúdo interativo tiver links com URLs relativos, especialmente links para páginas do AEM Sites.
Consulte Adicionar ativos Dynamic Media às páginas.

Para visualizar imagens interativas:

  1. Na exibição Ativos, navegue até uma imagem interativa existente que você criou e toque para abri-la na Visualização.
  2. Próximo ao canto superior esquerdo da página Visualização, na lista suspensa Conteúdo, toque em Visualizadores.
  3. Na lista Visualizadores, toque em Shoppable_Banner ou no nome da predefinição interativa do visualizador de imagens que você criou.
  4. Toque em pontos de acesso na imagem para testar suas ações associadas.

Publicação de ativos de imagem interativos

Consulte Publicação de ativos para obter detalhes sobre como publicar ativos de imagem interativos.

Integração de uma imagem interativa ao seu site

Após carregar uma imagem de banner, adicionar pontos de acesso à imagem e publicar a imagem interativa, você estará pronto para adicioná-la à página do site.

Se você for um cliente do AEM Sites, é possível adicionar a imagem interativa, arrastando o componente Mídia interativa para a página. Consulte Adicionar ativos Dynamic Media às páginas.

Se você for um cliente independente do AEM Assets, poderá adicionar manualmente a imagem interativa ao seu site, conforme descrito nesta seção.

  1. Copie o código incorporado da imagem interativa publicada.

    Consulte Incorporando o visualizador de vídeo ou imagem em uma página da Web.

  2. Adicione o código incorporado copiado no local desejado na página da Web.

    O código incorporado copiado é definido para um ambiente responsivo para que ele se ajuste automaticamente à área atribuída.

Exemplo

Usando o site de demonstração como exemplo:

https://experienceleague.adobe.com/tools/dynamic-media-demo/shoppable-banner/we-fashion/landing-0.html?lang=pt-BR?lang=pt-BR

Observe que a imagem dos três homens é uma tag IMG estática:

<img class="img-responsive" width="100%" title="Hero Image 2" alt="Hero Image 2" src="images/shoppable-banner.jpg">

A integração é tão simples como remover a tag IMG e substituí-la pelo código incorporado copiado do AEM Assets. Você pode ver o resultado no seguinte URL que mostra a imagem interativa que pode ser comprada na página com três pontos de acesso de círculo:

https://experienceleague.adobe.com/tools/dynamic-media-demo/shoppable-banner/we-fashion/landing-1.html?lang=pt-BR?lang=pt-BR

OBSERVAÇÃO

Como este ponto, os pontos de acesso na imagem interativa que pode ser comprada do site de demonstração são somente para fins de exibição; eles ainda não estão integrados às existentes do Quickviews.

Para aplicar um corte a uma imagem interativa que pode ser comprada para um ambiente responsivo, você pode incluir o atributo de configuração Imagem interativa ZoomView.iscommand no caminho, onde ZoomView é o componente a ser chamado e iscommand é o comando de veiculação de imagens de corte que você aplica.

Consulte Atributo de configuração ZoomView.iscommand.

Consulte comando de veiculação de imagens .

Agora você está pronto para integrar a imagem interativa com uma exibição rápida existente no seu site.

Integração de uma imagem interativa com uma exibição rápida existente

OBSERVAÇÃO

Essa tarefa só se aplica se você for um cliente independente do AEM Assets.

A última etapa desse processo é integrar a imagem interativa a uma implementação existente do Quickview em seu site. Não há solução para a integração que funcione para todos os casos. Cada implementação do Quickview é única e é necessária uma abordagem específica que provavelmente envolva a assistência de uma pessoa de TI front-end.

A implementação existente do Quickview normalmente representa uma cadeia de ações inter-relacionadas que ocorrem na página da Web na seguinte ordem:

  1. Um usuário aciona um elemento na interface do usuário do site.
  2. O código front-end obtém um URL do Quickview com base no elemento da interface do usuário acionado na etapa 1.
  3. O código de front-end envia uma solicitação Ajax usando o URL obtido na etapa 2.
  4. A lógica de back-end retorna os dados ou o conteúdo correspondentes do Quickview de volta ao código de front-end.
  5. O código front-end carrega os dados ou o conteúdo do Quickview.
  6. Opcionalmente, o código front-end converte os dados do Quickview carregados em uma representação HTML.
  7. O código front-end exibe uma caixa de diálogo ou painel modal e renderiza o conteúdo HTML na tela do usuário final.

Essas chamadas podem não representar chamadas de API públicas independentes que podem ser chamadas pela lógica da página da Web de uma etapa arbitrária. Em vez disso, é uma chamada encadeada em que cada próxima etapa está oculta na última fase (retorno de chamada) da etapa anterior.

Ao mesmo tempo em que a imagem interativa que pode ser comprada está substituindo a etapa 1 e parcialmente a etapa 2, quando um usuário clica em um ponto de acesso dentro da imagem que pode ser comprada, essa interação do usuário é tratada pelo visualizador. O visualizador retorna um evento para a página da Web que contém todos os dados de ponto de acesso adicionados anteriormente ao AEM Assets.

Nesse manipulador de evento, o código front-end faz o seguinte:

  • Escuta um evento emitido pela imagem interativa que pode ser comprada.
  • Constrói um URL do Quickview com base nos dados do ponto de acesso.
  • Aciona o processo de carregamento do Quickview a partir do back-end e renderização na tela para exibição.

O código incorporado retornado pelo AEM Assets já tem um manipulador de eventos pronto para uso no local, que é comentado, como visto no seguinte trecho de código destacado:

        var s7interactiveimageviewer = new s7viewers.InteractiveImage({
            "containerId" : "s7interactiveimage_div",
            "params" : { 
                "serverurl" : "https://aodmarketingna.assetsadobe.com/is/image",
                "contenturl" : "https://aodmarketingna.assetsadobe.com/", 
                "config" : "/etc/dam/presets/viewer/Shoppable_Media",
                "asset" : "/content/dam/mac/aodmarketingna/shoppable-banner/shoppable-banner.jpg" }
        })
        /* // Example of interactive image event for Quickview.
             s7interactiveimageviewer.setHandlers({ 
                "quickViewActivate": function(inData) {
                    var sku=inData.sku; //SKU for product ID
                    //To pass other parameter from the hotspot, you will need to add custom parameter during the hotspot setup as parameterName=value
                    loadQuickView(sku); //Replace this call with your Quickview plugin
                    //Please refer to your Quickviewer plugin for the Quickview call
                 }, 
             });
        */
        s7interactiveimageviewer.init();

Portanto, é necessário remover o comentário do código e substituir o corpo do manipulador de teste pelo código específico da página da Web em particular.

O processo de construção do URL do Quickview é basicamente oposto do processo usado para identificar variáveis de ponto de acesso abordadas anteriormente.

Consulte Identificação de variáveis de ponto de acesso.

Usando nossos exemplos de URL do Quickview anteriores, você pode ver, nos exemplos a seguir, como o URL do Quickview é construído em cada caso:

SKU único, encontrado na sequência de consulta

s7interactiveimageviewer.setHandlers({ "quickViewActivate": function(inData) { var quickViewUrl = "https://server/json?productId=" + inData.sku + "&amp;source=100"; }, });

SKU único, encontrado no caminho do URL

s7interactiveimageviewer.setHandlers({ "quickViewActivate": function(inData) { var quickViewUrl = "https://server/product/" + inData.sku; }, });

SKU e ID de categoria na sequência de consulta

s7interactiveimageviewer.setHandlers({ "quickViewActivate": function(inData) { var quickViewUrl = "https://server/quickView/product/?category=" + inData.categoryId + "&amp;prodId=" + inData.sku; }, });

A última etapa para acionar o URL do Quickview e ativar o painel do Quickview provavelmente requer a assistência de uma pessoa de TI front-end do seu departamento de TI. Eles têm o conhecimento de saber mais sobre como acionar com precisão a implementação do Quickview a partir da etapa adequada, tendo um URL Quickview pronto para uso.

Você pode ver como essas etapas são aplicadas ao site de demonstração para integrar totalmente uma imagem interativa que pode ser comprada com o código do Quickview. Anteriormente, a estrutura do URL do Quickview era identificada como a seguinte:

/datafeed/$categoryId$-$SKU$.json

Para reconstruir esse URL dentro do manipulador quickViewActivate, você pode usar os campos categoryId e SKU disponíveis no objeto inData passado para o manipulador pelo código do visualizador:

var sku=inData.sku;
var categoryId=inData.categoryId;
var quickViewUrl = "datafeed/" + categoryId + "-" + sku + ".json";

O site de demonstração está acionando a caixa de diálogo do Quickview usando uma chamada de função loadQuickView() simples. Essa função utiliza apenas um argumento, que é o URL dos dados do Quickview. Dessa forma, a última etapa necessária para integrar a imagem interativa que pode ser comprada é adicionar a seguinte linha de código ao manipulador quickViewActivate:

loadQuickView(quickViewUrl);

Este é o código-fonte completo:

 var s7interactiveimageviewer = new s7viewers.InteractiveImage({
  "containerId" : "s7interactiveimage_div",
  "params" : { 
   "serverurl" : "https://aodmarketingna.assetsadobe.com/is/image",
   "contenturl" : "https://aodmarketingna.assetsadobe.com/", 
   "config" : "/etc/dam/presets/viewer/Shoppable_Media",
   "asset" : "/content/dam/mac/aodmarketingna/shoppable-banner/shoppable-banner.jpg" }
 })
   s7interactiveimageviewer.setHandlers({ 
   "quickViewActivate": function(inData) {
     var sku=inData.sku;
     var categoryId=inData.categoryId;
    var quickViewUrl = "datafeed/" + categoryId + "-" + sku + ".json";
    loadQuickView(quickViewUrl);
    }, 
   });
 s7interactiveimageviewer.init();

O site de demonstração final com a imagem interativa totalmente integrada tem a seguinte aparência:

https://experienceleague.adobe.com/tools/dynamic-media-demo/shoppable-banner/we-fashion/landing-3.html?lang=pt-BR?lang=pt-BR

Uso do Quickviews para criar pop-ups personalizados

Consulte Criar pop-ups personalizados usando o Quickviews.

Nesta página