文件TargetTarget開發人員指南

初始化SDK

最後更新： 2025年5月5日
  • 主題：
  • APIs/SDKs

建立對象：

  • 經驗豐富
  • 開發人員

請依照​ 初始化SDK ​圖表中的步驟操作，以確保載入Adobe Target at.js JavaScript程式庫所需的所有必要工作皆以正確順序執行。

秘訣
按一下此主題中的影像可展開至全熒幕。

初始化SDK圖表

對於多頁應用程式，每當頁面重新載入，或訪客導覽至網站上的新頁面時，就會發生此流程。

注意
下圖中的步驟編號與下列區段相對應。 步驟編號沒有特定順序，也不會反映建立活動時在Target UI中採取的步驟順序。

初始化SDK圖表

按一下下列連結，導覽至所需的區段：

  • 1.1：載入訪客API SDK
  • 1.2：設定客戶ID
  • 1.3：設定自動頁面載入請求
  • 1.4：設定忽隱忽現處理
  • 1.5：設定資料對應
  • 1.6：促銷活動
  • 1.7：購物車型條件
  • 1.8：以人氣為準的標準
  • 1.9：以專案為基礎的條件
  • 1.10：以使用者為基礎的條件
  • 1.11：自訂條件
  • 1.12：提供包含規則中使用的屬性
  • 1.13：提供excludedIds
  • 1.14：傳遞entity.event.detailsOnly=true引數
  • 1.15：設定遠端資料對應
  • 1.16：載入at.js

1.1：載入訪客API SDK

此步驟有助於確保VisitorAPI.js程式庫已正確載入、設定和初始化。

查看詳細資料

載入訪客API SDK圖表

必要條件

  • 若要使用訪客ID/API服務，貴公司必須啟用Adobe Experience Cloud並擁有Organization ID。 如需詳細資訊，請參閱​ 身分識別服務說明 ​指南中的Experience Cloud需求：組織識別碼。
  • 您需要VisitorAPI.js檔案。 如果您已實作Adobe Analytics，則應該已有此檔案。 此檔案也可以透過Adobe Experience Platform 標籤副檔名新增，或是從Adobe Analytics代碼管理器下載。

設定並參考VisitorAPI.js

如需詳細資訊，請參閱實作Target的Experience Cloud服務。

讀數

  • Experience Cloud識別服務總覽
  • 關於ID服務
  • Cookie與Experience Cloud識別服務
  • Experience Cloud識別服務如何要求與設定ID
  • 瞭解ID同步和匹配率

動作

  • 將VisitorAPI.js檔案內嵌在您的網頁上。
  • 瞭解訪客ID/API服務🔗的可用設定。
  • 載入VisitorAPI.js檔案後，請使用Visitor.getInstance方法，以您需要的必要設定進行初始化。
  • 請熟悉可用的方法。

返回此頁面頂端的圖表。

1.2：設定客戶ID

此步驟可協助確保訪客的已知ID （CRM ID、使用者ID等）繫結至Adobe的匿名ID，以進行跨裝置個人化。

查看詳細資料

設定客戶ID

必要條件

  • 訪客的已知ID應在資料層中可用。

設定客戶ID
如需詳細資訊，請參閱setCustomerIDs。

讀數

  • mbox3rdPartyId的即時設定檔同步

動作

  • 使用visitor.setCustomerIDs設定訪客已知識別碼。

返回此頁面頂端的圖表。

1.3：設定自動頁面載入請求

此步驟可讓at.js擷取載入at.js JavaScript程式庫檔案時必須在頁面上呈現的所有體驗。

查看詳細資料

設定自動頁面載入要求

必要條件

  • 並非資料層中的所有資料都必須傳送至Target。 請洽詢您的業務團隊（數位行銷團隊），判斷哪些資料對於實驗、最佳化和個人化很有價值。 只有此資料應傳送至Target。
  • 確保您不會將任何個人識別資訊(PII)資料傳送至Target。

設定自動頁面載入要求

如需詳細資訊，請參閱 targetGlobalSettings()。

讀數

瞭解targetGlobalSettings()中的pageLoadEnabled設定。

動作

  • 修改window.targetGlobalSettings物件以啟用自動頁面載入要求。

返回此頁面頂端的圖表。

1.4：設定忽隱忽現處理

此步驟有助於確保在提供體驗時沒有頁面閃爍。

查看詳細資料

設定忽隱忽現的處理圖

必要條件

  • 與負責網頁效能的團隊討論使用at.js使用的預設方法控制忽隱忽現的利弊。 您可以搜尋可讓您使用自訂忽隱忽現處理解決方案的設計模式，例如載入器動畫。 如果您找不到模式，可以請求新的模式。

設定忽隱忽現處理

如需詳細資訊，請參閱 targetGlobalSettings()。

將bodyHidingEnabled設定為true會在頁面載入要求進行中時隱藏整個頁面內文。 如果您因任何原因（例如稍後資料尚未就緒）未啟用自動頁面載入要求，最好將此設定設為false。

如果您已停用bodyHidingEnabled，因為您不想引發APLR且想要稍後引發頁面要求，或您不需要忽隱忽現處理，則必須實作自己的忽隱忽現處理。 處理忽隱忽現的兩種方式：隱藏測試區段，或在測試區段上顯示引發器。

讀數

  • At.js 處理忽隱忽現情況的方式
  • 瞭解targetGlobalSettings()中的bodyHiddenStyle和bodyHidingEnabled物件。

動作

  • 修改window.targetGlobalSettings物件以設定bodyHiddenStyle和bodyHidingEnabled。

返回此頁面頂端的圖表。

1.5：設定資料對應

此步驟有助於確保已設定必須傳送至Target的所有資料。

查看詳細資料

資料對應圖表

必要條件

  • 資料層應準備好所有必須傳送給Target的資料。

  • Recommendations：擴充設定檔。

    • 傳遞entity.id以根據根據上次檢視產品的條件，擷取最近檢視條件與專案的資料。
    • 傳遞entity.id以根據最喜愛的類別來擷取熱門度條件的資料。
    • 如果自訂條件以該設定檔屬性為基礎，或用於任何條件中的包含規則篩選，請傳遞該設定檔屬性。

  • Recommendations：擷取產品資料。

    • 其他實體引數（保留和自訂）可傳遞以擷取或更新Recommendations中的產品目錄。
    • 也可以使用Target UI或API的實體摘要來更新產品目錄。

將資料對應至Target

如需詳細資訊，請參閱targetPageParams()。

讀數

  • targetPageParams()
  • 計劃和實作 Recommendations
  • 設定您的Recommendations目錄

動作

  • 使用targetPageParams()函式設定必須傳送至Target的所有必要資料。

返回此頁面頂端的圖表。

1.6：促銷活動

新增已升級的專案並控制它們在您Target Recommendations 設計中的位置。

查看詳細資料

可用選項

  • 依ID促銷
  • 依集合促銷
  • 依屬性促銷

需要實體引數

  • 使用「依屬性促銷」選項時，必須傳遞促銷中的專案屬性。

返回此頁面頂端的圖表。

1.7：購物車型條件

根據使用者的購物車內容提供建議。

查看詳細資料

可用的條件

  • People Who Viewed These, Viewed Those
  • People Who Viewed These, Bought Those
  • People Who Bought These, Bought Those

需要實體引數

  • cartIds

讀數

  • 購物車型

返回此頁面頂端的圖表。

1.8：以人氣為準的標準

根據您網站上的專案整體人氣或使用者最喜愛或檢視次數最多的類別、品牌、型別等內的專案人氣提供建議。

查看詳細資料

可用的條件

  • Most Viewed Across the Site
  • Most Viewed by Category
  • Most Viewed by Item Attribute
  • Top Sellers Across the Site
  • Top Sellers by Category
  • Top Sellers by Item Attribute
  • Top by Analytics Metric

需要實體引數

  • 如果條件是以目前專案或專案屬性為基礎，則為entity.categoryId或人氣的專案屬性。
  • 所有網站中檢視次數最多/銷售最多的專案，均不得傳遞任何專案。

讀數

  • 以熱門程度為基礎

返回此頁面頂端的圖表。

1.9：以專案為基礎的條件

根據找到使用者正在檢視或最近檢視的專案的類似專案提供建議。

查看詳細資料

可用的條件

  • People Who Viewed This, Viewed That
  • People Who Viewed This, Bought That
  • People Who Bought This, Bought That
  • Items with Similar Attributes

需要實體引數

  • entity.id或任何用作索引鍵的設定檔屬性

讀數

  • 以專案為基礎

返回此頁面頂端的圖表。

1.10：以使用者為基礎的條件

根據使用者的行為提供建議。

查看詳細資料

可用的條件

  • Recently Viewed Items
  • Recommended for You

需要實體引數

  • entity.id

讀數

  • 以使用者為基礎

返回此頁面頂端的圖表。

1.11：自訂條件

根據您上傳的自訂檔案提出建議。

查看詳細資料

可用的條件

  • Custom algorithm

需要實體引數

entity.id或用作自訂演演算法索引鍵的屬性

讀數

  • 自訂條件

返回此頁面頂端的圖表。

1.12：提供包含規則中使用的屬性

查看詳細資料

讀數

  • 使用動態和靜態包含規則

返回此頁面頂端的圖表。

1.13：提供excludedIds

傳遞要從建議中排除之實體的實體ID。 例如，您可以排除已在購物車中的項目。

查看詳細資料

讀數

  • 我可以動態排除實體嗎？

返回此頁面頂端的圖表。

1.14：傳遞entity.event.detailsOnly=true引數

使用實體屬性將產品或內容資訊傳遞至Target Recommendations。

查看詳細資料

讀數

  • 實體屬性

返回此頁面頂端的圖表。

1.15：設定遠端資料對應（遠端）

此步驟可確保已設定所有必須傳送至Target的資料。

查看詳細資料

遠端資料對應圖表

必要條件

  • 資料層應準備好所有必須傳送給Target的資料。

設定資料提供者

如需詳細資訊，請參閱資料提供者。

讀數

targetPageParams函式

動作

使用targetPageParams()函式設定必須傳送至Target的所有必要資料。

返回此頁面頂端的圖表。

1.16：載入at.js

此步驟會確保載入及初始化at.js JavaScript程式庫。

查看詳細資料

載入Adobe Target at.js圖表

必要條件

  • 下載或要求您的數位行銷團隊取得at.js 2.*x* JavaScript程式庫檔案。

讀數

  • Target的運作方式
  • at.js 如何運作
  • 不使用標籤管理程式實作 Target

動作

將at.js檔案內嵌於所有必須實驗、最佳化、個人化和資料收集的網頁上。

返回此頁面頂端的圖表。

繼續步驟2：設定資料彙集。

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3