Algolia標籤擴充功能概觀

Algolia標籤擴充功能可讓行銷人員輕鬆設定規則，將使用者互動資料傳送至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的事件。

載入Insights load-insights

將​ Load Insights ​動作新增至您的標籤規則，只要是根據您規則的內容載入Algolia深入分析最合理。 此動作會將search-insights.js程式庫載入頁面上。

建立新標籤規則或開啟現有標籤規則。 根據您的需求定義條件，然後選取​ Algolia ​作為Extension，並選取​ Load Insights ​作為Action Type。

已點按 clicked

將​ Click ​動作新增至您的標籤規則，以將點選事件傳送至Algolia。 建立新標籤規則或開啟現有標籤規則。 根據您的需求定義條件，然後選取​ Algolia ​作為Extension，並選取​ Clicked ​作為Action Type。

如需事件類別的詳細資訊，請參閱搜尋後的點選物件識別碼
和已點按物件識別碼參考線。

已轉換 converted

將​ Converted ​動作新增至您的標籤規則，以將轉換的事件傳送至Algolia。 建立新標籤規則或開啟現有標籤規則。 根據您的需求定義條件，然後選取​ Algolia ​作為Extension，並選取​ Converted ​作為Action Type。

如需事件類別的詳細資訊，請參閱搜尋後的轉換的物件識別碼和轉換的物件識別碼指南。

已新增至購物車 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
和已購買的物件識別碼參考線。

已檢視 viewed

將​ Viewed ​動作新增至您的標籤規則，以將已購買的事件傳送至Algolia。 建立新標籤規則或開啟現有標籤規則。 根據您的需求定義條件，然後選取​ Algolia ​作為Extension，並選取​ Viewed ​作為Action Type。

如需檢視事件的詳細資訊，請參閱已檢視物件識別碼指南。

Algolia個Insights延伸資料元素 data-elements

Algolia支援一組預先定義的資料元素，每個元素都有特定的內容和屬性。 以下章節說明Algolia Insights擴充功能中可用的資料元素。

資料集 dataset

DataSet Data Element會擷取與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

查詢字串資料元素會從URL查詢字串擷取資料，以用於Algolia動作。

此資料元素會傳回：

{
  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動作。 此資料元素也可用來以其他商業資訊來增強已儲存的資料。

此資料元素會擷取先前儲存在工作階段存放區中的事件詳細資料（通常是由點選事件期間的DataSet資料元素所儲存）。 除非明確停用移除，否則資料會在轉換事件期間自動移除。

覆寫（選擇性）：

此資料元素會傳回工作階段存放區中儲存的內容，包括任何增強的商務資料：

{
  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和/或Autocomplete查詢引數中啟用insights旗標時，這些屬性即可使用。 請參閱下列資源，瞭解如何設定網站的Insights：

後續步驟 next-steps

本指南說明如何使用Algolia標籤延伸將資料傳送至Algolia Insights。 如果您也打算將伺服器端事件傳送至Algolia，您現在可以繼續安裝並設定Conversions API 事件轉送擴充功能。

如需Experience Platform標籤的詳細資訊，請參閱標籤總覽。