Visão geral da extensão de marcas Algolia

A extensão de Tags do Algolia permite que os profissionais de marketing configurem facilmente regras que enviam dados de interação do usuário para o Algolia, ajudando você a fornecer experiências de Pesquisa e Descoberta de IA mais personalizadas.

Essa extensão é alimentada por um recurso principal:

Pré-requisitos prerequisites

Você deve ter uma conta Algolia válida para usar esta extensão. Vá para a Algolia página de inscrição para criar uma conta caso ainda não tenha uma.

Coletar detalhes de configuração necessários configuration-details

Para conectar Algolia ao Adobe Experience Platform, você precisará das seguintes informações:

Instalar e configurar a extensão do Insights do Algolia install-configure

Para instalar a extensão do Algolia Insights, navegue até a Interface da Coleção de Dados e selecione Marcas na navegação à esquerda. Aqui, selecione uma propriedade à qual adicionar a extensão ou crie uma nova propriedade.

Depois de selecionar ou criar a propriedade desejada, selecione Extensões na navegação à esquerda e selecione a guia Catálogo. Procure o cartão Algolia Insights e selecione Instalar.

Na visualização de configuração exibida, você deve fornecer os seguintes detalhes:

Algolia tipos de ação de extensão do Insights action-types

O Algolia oferece suporte a um conjunto de eventos padrão predefinidos, cada um com contextos e propriedades específicas. As ações disponíveis na extensão Algolia estão alinhadas a esses tipos de evento, facilitando a categorização e configuração dos eventos que você envia para o Algolia com base em seus tipos.

Carregar Insights load-insights

Adicione a ação Carregar Insights à sua regra de marca sempre que fizer mais sentido para carregar Insights do Algolia com base no contexto da sua regra. Esta ação carrega a biblioteca search-insights.js na página.

Crie uma nova regra de tag ou abra uma existente. Defina as condições de acordo com suas necessidades e selecione Algolia como a Extensão e selecione Carregar Insights como o Tipo de Ação.

Clicado clicked

Adicione a ação Clicar à sua regra de marca para enviar eventos clicados para Algolia. Crie uma nova regra de tag ou abra uma existente. Defina as condições de acordo com suas necessidades e selecione Algolia como a Extensão e selecione Clicados como o Tipo de Ação.

Para obter mais informações sobre categorias de evento, consulte as IDs de objeto clicadas após a pesquisa
e guias de IDs de objeto clicado.

Convertido converted

Adicione a ação Convertido à sua regra de marcas para enviar eventos convertidos para Algolia. Crie uma nova regra de tag ou abra uma existente. Defina as condições de acordo com suas necessidades, selecione Algólia como a Extensão e selecione Convertidos como o Tipo de Ação.

Para obter mais informações sobre as categorias de evento, consulte os guias IDs de objeto convertido após a pesquisa e IDs de objeto convertido.

Adicionado ao carrinho added-to-cart

Adicione a ação Adicionado ao carrinho à sua regra de tag para enviar eventos adicionados ao carrinho para Algolia. Crie uma nova regra de tag ou abra uma existente. Defina as condições de acordo com suas necessidades e selecione Algolia como a Extensão e selecione Adicionado ao carrinho como o Tipo de Ação.

Para obter mais informações sobre as categorias de eventos, consulte os guias Adicionado às IDs de objeto do carrinho após a pesquisa e Adicionado às IDs de objeto do carrinho.

Comprado purchased

Adicione a ação Comprado à sua regra de marca para enviar eventos comprados para Algolia. Crie uma nova regra de tag ou abra uma existente. Defina as condições de acordo com suas necessidades, selecione Algólia como Extensão e Comprado como Tipo de Ação.

Para obter mais informações sobre categorias de evento, consulte as IDs de objeto compradas após a pesquisa
e guias de IDs de objeto comprado.

Exibido viewed

Adicione a ação Visualizado à sua regra de marca para enviar eventos comprados para Algolia. Crie uma nova regra de tag ou abra uma existente. Defina as condições de acordo com suas necessidades e selecione Algolia como a Extensão e Visualizada como o Tipo de Ação.

Para obter mais informações sobre o evento de exibição, consulte o guia IDs de objeto visualizadas.

Elementos de dados da extensão do Insights do Algolia data-elements

O Algolia oferece suporte a um conjunto de elementos de dados predefinidos, cada um com contextos e propriedades específicas. As seções a seguir descrevem os elementos de dados disponíveis na extensão do Insights do Algolia.

DataSet dataset

O Elemento de Dados DataSet recupera dados associados a elementos HTML, que são usados em Algolia ações.

Esse elemento de dados retorna:

{
  timestamp,
  queryID,
  indexName,
  objectIDs,
  positions
}

Um exemplo de HTML que contém um conjunto de dados:

<div data-indexname="acme_master_default_products" class="instant-search-comp__hits">
  <div class="hit-card"
    data-insights-object-id="${hit.objectID}"
    data-insights-position="${hit.__position}"
    data-insights-query-id="${hit.__queryID}">
    <h4 class="hit-name">...</h4>
  </div>
</div>

Sequência de consulta query-string

O Elemento de Dados da Cadeia de Caracteres de Consulta extrai dados da cadeia de caracteres de consulta da URL a serem usados em Algolia ações.

Esse elemento de dados retorna:

{
  timestamp,
  queryID,
  indexName,
  objectIDs
}

Um exemplo de HTML que contém parâmetros de consulta.

<a href="product.html?objectID=${hit.objectID}&queryID=${hit.__queryID}&indexName=${indexName}&position=${hit.position}">Read More</a>

Armazenamento storage

O Elemento de Dados de Armazenamento recupera dados do Armazenamento de Sessão para uso em ações Algolia.

Este elemento de dados recupera detalhes do evento do Armazenamento da sessão. Nenhuma configuração é necessária. Os dados são adicionados automaticamente durante a ação de evento click e removidos durante a ação de evento convert.

Esse elemento de dados retorna o que está armazenado no Armazenamento da sessão.

{
  timestamp,
  queryID,
  indexName,
  objectIDs
}

Clicado ou convertido após a pesquisa clicked-converted-after-search

Os eventos Clicados após a Pesquisa ou Convertidos após a Pesquisa exigem um queryId, e position também é necessário para Clicados após a Pesquisa. Estas propriedades estão disponíveis quando o sinalizador insights está habilitado nos parâmetros de consulta de Pesquisa Instantânea e/ou Preenchimento Automático. Consulte os seguintes recursos para saber como configurar o Insights para o seu site:

Próximas etapas next-steps

Este guia abordou como enviar dados para Algolia usando a extensão de tag Algolia Insights. Se você pretende enviar eventos do lado do servidor para o Algolia, agora é possível prosseguir para instalar e configurar a Conversions API extensão de encaminhamento de eventos.

Para obter mais informações sobre tags na Experience Platform, consulte a visão geral das tags.