文件Experience Platform標記

Algolia事件轉送擴充功能概觀 overview

Last update: Thu Dec 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員

使用Algolia提供快速、相關和個人化的搜尋體驗。 透過AI支援的最佳化，您可以增強搜尋結果和推薦，以協助使用者快速找到他們需要的產品、內容或資訊。

使用Algolia事件轉寄延伸功能，透過Algolia將使用者行為事件傳送至Insights API。 此行為資料可啟用AI支援的建議、個人化體驗和智慧型搜尋功能。

先決條件 prerequisites

在安裝擴充功能之前，請確定您有Algolia帳戶可以存取Insights API。 如果您沒有帳戶，請註冊並啟用API的存取權。

也請確定您瞭解如何使用Algolia Insights API。 如需如何傳送事件的概述，請參閱使用Insights API傳送事件。

從您的Algolia帳戶儀表板收集下列值：

  • Application ID
  • Search API Key
  • Index Name

安裝擴充功能 install

若要安裝Algolia擴充功能，請遵循下列步驟：

在​ Data Collection ​中導覽至Adobe Experience Platform。 選取 Extensions 索引標籤。

開啟​ Catalog ​並找到​ Algolia Event Forwarding ​擴充功能，然後選取​Install。

Adobe Experience Platform中Algolia Event Forwarding擴充功能的安裝程式

設定擴充功能 configure-extension

若要設定Algolia事件轉送擴充功能，請瀏覽至​ Extensions ​標籤，選取​ Algolia ​擴充功能，然後選取​Configure。

在Adobe Experience Platform中設定Algolia事件轉送擴充功能的 設定畫面

屬性
說明
Application ID
輸入Application IDAPI金鑰區段下的Algolia Dashboard中的。
Search API Key
輸入Search API KeyAPI金鑰區段下的Algolia Dashboard中的。
Index Name
輸入包含產品或內容的Index Name。 此索引會作為預設值使用。

Algolia個事件轉寄擴充功能動作型別 action-types

Algolia事件轉送擴充功能提供可在規則的​ Then ​區段中使用的單一動作型別：

傳送事件 send-event

設定​ Send event ​動作以將事件轉送至Algolia：

選取​Rules > Add Rule​或選取現有規則。 在規則的​ Then ​部分中，新增動作並選取​Extension： Algolia事件轉送> Action Type： Send Events。

Algolia事件轉送擴充功能中[傳送事件]動作的設定。

實作Algolia事件欄位群組 algolia-field-group

在使用Algolia事件轉送擴充功能之前，請確定您已將Algolia事件欄位群組新增到結構描述。 這是透過Experience Platform提供的標準欄位群組之一。

Algolia事件欄位群組設定

將Algolia事件欄位群組新增至您的結構描述 add-algolia-field-group

若要新增Algolia事件欄位群組：

瀏覽至​ Schemas ​並選取​Browse。

新增結構描述或更新您用來傳送網頁事件的現有結構描述，並將滑鼠游標停留在​ Add ​圖示上。 在搜尋方塊中輸入​ Algolia ​以縮小結果範圍。

選取​ Algolia事件詳細資料 ​欄位群組> Add field group​按鈕> Save。

Experience Platform中的 Algolia設定檔欄位群組設定

使用Data Collection標籤對應及傳送資料

Algolia事件轉送擴充功能可與​ Adobe Experience Platform Web SDK ​搭配使用，以將資料從您的網站傳送至Algolia。 這是透過建立標籤屬性、將資料對應至XDM物件，以及設定傳送事件的規則來完成。

步驟1：使用網頁SDK建立標籤屬性

  1. 建立標籤屬性。
  2. 安裝Adobe Experience Platform Web SDK擴充功能。
  3. 使用此擴充功能將資料從HTML對應至​ Algolia事件 ​欄位群組。

對應至Algoria事件欄位群組的HTML資料集範例

步驟2：建立XDM對應的資料元素

  1. 使用Data Element建立​Adobe Experience Platform Web SDK。
  2. 選取​ XDM object ​作為資料元素型別。
  3. 將您的資料對應至適當的XDM欄位，確保已填入Algolia特定欄位。

步驟3：建立規則以傳送事件

  1. 在您的標籤屬性中建立新規則。
  2. 新增必要的事件觸發器，例如頁面載入或按一下事件。
  3. 使用​ Adobe Experience Platform Web SDK ​新增動作。
  4. 選取​ Send event ​作為動作型別。
  5. 設定動作以使用您的XDM資料元素。

在Algolia事件轉送擴充功能中設定規則動作的範例

步驟4：發佈和測試

  1. 將規則和擴充功能變更發佈至您的目標環境。
  2. 使用Adobe Experience Platform Debugger驗證資料已傳送至Adobe Experience Platform並轉送至Algolia。

設定規則以使用Algolia擴充功能傳送事件

驗證Algolia中的事件

設定Algolia事件轉送擴充功能後，您可以依照下列步驟確認事件是否正確傳送及接收：

導覽至您的Algolia儀表板並移至​Data Sources > Events > Debugger。

選取符合從Algolia的事件轉送延伸傳送之事件的事件，並確認事件中存在預期的資料。

驗證Algoria偵錯工具中的事件

常見實作案例

使用Algolia事件轉送延伸功能，針對各種使用案例擷取並傳送使用者互動資料，增強搜尋相關性和個人化。

追蹤產品或內容檢視

使用擴充功能來追蹤使用者檢視產品或內容頁面的時間，協助Algolia瞭解使用者興趣。

追蹤轉換事件

追蹤購物車新增事件、購買和其他轉換事件，以最佳化Algolia的AI支援建議。

疑難排解

如果您在實作Algolia事件轉送擴充功能時遇到問題，請考慮下列疑難排解步驟：

事件未出現在Algolia中

如果事件未出現在Algolia中，請檢查下列專案：

  • 驗證API認證：確定​ Application ID ​和​ API Key ​符合您Algolia儀表板中的值。
  • 檢查事件偵錯工具：使用Algolia事件偵錯工具確認是否收到事件。 如果沒有，請確認事件轉送規則設定。
  • 檢查XDM對應：確定Algolia結構描述中的所有必要欄位在XDM物件中都已正確對應。

不正確的事件資料

  • 確定您的XDM物件資料元素已正確對應至Algolia結構描述，以及所有必要欄位。
  • 確認事件引數符合Algolia的Insights API檔案中列出的預期格式和結構。

後續步驟

本指南說明如何使用Algolia將資料傳送至Algolia Event Forwarding Extension。 如需Adobe Experience Platform中事件轉送功能的詳細資訊，請閱讀事件轉送概觀。

如需如何使用Experience Platform Debugger和「事件轉送監視」工具對實作進行偵錯的詳細資訊，請閱讀Adobe Experience Platform Debugger概觀和監視事件轉送中的活動。

其他資源

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743