Algolia标记扩展概述

Algolia Tags扩展使营销人员能够轻松设置规则以将用户交互数据发送到Algolia，从而帮助您提供更加个性化的AI搜索和发现体验。

此扩展由一项关键功能提供支持：

先决条件 prerequisites

您必须拥有有效的Algolia帐户才能使用此扩展。 转到Algolia 注册页面创建帐户（如果尚未创建）。

收集所需的配置详细信息 configuration-details

要将Algolia与Adobe Experience Platform连接，您需要以下信息：

安装和配置Algolia Insights扩展 install-configure

要安装Algolia Insights扩展，请导航到Data Collection UI，然后从左侧导航中选择​Tags。 在此处，选择要将扩展添加到的资产，或改为创建新资产。

选择或创建所需的属性后，在左侧导航中选择​Extensions，然后选择​ Catalog ​选项卡。 搜索Algolia分析卡，然后选择​Install。

在显示的配置视图中，必须提供以下详细信息：

Algolia Insights扩展操作类型 action-types

Algolia支持一组预定义的标准事件，每个事件都具有特定的上下文和属性。 Algolia扩展中可用的操作与这些事件类型一致，从而可轻松根据发送给Algolia的事件类型分类和配置这些事件。

加载分析 load-insights

根据规则的上下文将​ Load Insights ​操作添加到最适合加载Algolia分析的标记规则中。 此操作将search-insights.js库加载到页面上。

创建新标记规则或打开现有标记规则。 根据您的要求定义条件，然后选择​ Algolia ​作为Extension，选择​ Load Insights ​作为Action Type。

已单击 clicked

将​ Click ​操作添加到您的标记规则以将点击事件发送到Algolia。 创建新标记规则或打开现有标记规则。 根据您的要求定义条件，然后选择​ Algolia ​作为Extension，选择​ Clicked ​作为Action Type。

有关事件类别的详细信息，请参阅搜索后的点击对象ID
和已单击对象ID参考线。

已转换 converted

将​ Converted ​操作添加到您的标记规则以将转换的事件发送到Algolia。 创建新标记规则或打开现有标记规则。 根据您的要求定义条件，然后选择​ Algolia ​作为Extension，选择​ Converted ​作为Action Type。

有关事件类别的详细信息，请参阅搜索转换后的对象ID和转换后的对象ID指南。

已添加到购物车 added-to-cart

将​ Added to Cart ​操作添加到您的标记规则，以将添加到购物车事件的内容发送至Algolia。 创建新标记规则或打开现有标记规则。 根据您的要求定义条件，然后选择​ Algolia ​作为Extension，选择​ Added to cart ​作为Action Type。

有关事件类别的详细信息，请参阅在搜索后添加到购物车对象ID和添加到购物车对象ID指南。

已购买 purchased

将​ Purchased ​操作添加到您的标记规则以将已购买的事件发送到Algolia。 创建新标记规则或打开现有标记规则。 根据您的要求定义条件，然后选择​ Algolia ​作为Extension，选择​ Purchased ​作为Action Type。

有关事件类别的详细信息，请参阅搜索后的购买对象ID
和已购买对象ID指南。

已查看 viewed

将​ Viewed ​操作添加到您的标记规则以将已购买的事件发送到Algolia。 创建新标记规则或打开现有标记规则。 根据您的要求定义条件，然后选择​ Algolia ​作为Extension，选择​ Viewed ​作为Action Type。

有关查看事件的详细信息，请参阅已查看对象ID指南。

Algolia个Insights扩展数据元素 data-elements

Algolia支持一组预定义的数据元素，每个元素都具有特定的上下文和属性。 以下部分介绍了Algolia Insights扩展中可用的数据元素。

数据集 dataset

数据集数据元素检索与HTML元素关联的数据，然后这些数据用于Algolia操作。 此数据元素会自动将检索到的事件数据存储在浏览器存储中，以供以后使用（例如在转化或购买事件中）。

常规配置：

Commerce配置（可选）：

覆盖（可选）：

这些字段允许您覆盖从HTML数据集属性检索数据的默认行为。

此数据元素返回：

{
  timestamp,
  queryID,
  indexName,
  objectIDs,
  positions,
  objectData,  // Optional: commerce data if price is provided
  currency,    // Optional: if provided
  recordID
}

包含数据集的HTML示例：

<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>

查询字符串 query-string

查询字符串数据元素从Algolia操作中使用的URL查询字符串中提取数据。

此数据元素返回：

{
  timestamp,
  queryID,
  indexName,
  objectIDs,
  positions
}

包含查询参数的HTML示例：

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

存储 storage

存储数据元素从浏览器会话存储中检索数据以用于Algolia操作。 此数据元素还可用于使用其他商业信息补充存储的数据。

此数据元素检索之前存储在会话存储中的事件详细信息（通常在点击事件期间由数据集数据元素存储）。 除非明确禁用数据删除，否则数据将在转换事件期间自动删除。

覆盖（可选）：

此数据元素返回会话存储中存储的内容，包括任何增强的商务数据：

{
  timestamp,
  queryID,
  indexName,
  objectIDs,
  positions,      // If available from original event
  objectData,     // Optional: commerce data if price is provided
  currency,       // Optional: if provided
  recordID
}

搜索后已单击或已转换 clicked-converted-after-search

搜索​ 后点击的 ​或搜索​ 后转换的 ​事件需要queryID，搜索positions后点击的​也需要。 在InstantSearch和/或自动完成查询参数中启用insights标志时，这些属性可用。 请参阅以下资源，了解如何为网站配置Insights：

后续步骤 next-steps

本指南介绍了如何使用Algolia标记扩展将数据发送到Algolia Insights。 如果您还计划向Algolia发送服务器端事件，则现在可以继续安装和配置Conversions API 事件转发扩展。

有关Experience Platform中标记的详细信息，请参阅标记概述。