初始化SDK

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

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

初始化SDK圖表 diagram

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

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

初始化SDK圖表 {width="600" modal="regular"}

按一下下列連結,導覽至所需的區段:

1.1:載入訪客API SDK load

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

查看詳細資料

載入訪客API SDK圖表 {width="400" modal="regular"}

必要條件

設定並參考VisitorAPI.js

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

讀數

動作

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

返回此頁面頂端的圖表。

1.2:設定客戶ID set

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

查看詳細資料

設定客戶ID {width="400" modal="regular"}

必要條件

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

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

讀數

動作

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

返回此頁面頂端的圖表。

1.3:設定自動頁面載入請求 automatic

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

查看詳細資料

設定自動頁面載入要求 {width="400" modal="regular"}

必要條件

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

設定自動頁面載入要求

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

讀數

瞭解targetGlobalSettings()中的pageLoadEnabled設定。

動作

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

返回此頁面頂端的圖表。

1.4:設定忽隱忽現處理 flicker

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

查看詳細資料

設定忽隱忽現的處理圖 {width="400" modal="regular"}

必要條件

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

設定忽隱忽現處理

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

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

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

讀數

動作

  • 修改window.targetGlobalSettings物件以設定bodyHiddenStylebodyHidingEnabled

返回此頁面頂端的圖表。

1.5:設定資料對應 data-mapping

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

查看詳細資料

資料對應圖表 {width="400" modal="regular"}

必要條件

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

  • Recommendations:擴充設定檔。

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

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

將資料對應至Target

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

讀數

動作

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

返回此頁面頂端的圖表。

1.6:促銷活動 promotion

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

查看詳細資料

可用選項

需要實體引數

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

返回此頁面頂端的圖表。

1.7:購物車型條件 cart

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

查看詳細資料

可用的條件

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

需要實體引數

  • cartIds

讀數

返回此頁面頂端的圖表。

1.8:以人氣為準的標準 popularity

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

查看詳細資料

可用的條件

  • 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:以專案為基礎的條件 item

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

查看詳細資料

可用的條件

  • 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:以使用者為基礎的條件 user

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

查看詳細資料

可用的條件

  • Recently Viewed Items
  • Recommended for You

需要實體引數

  • entity.id

讀數

返回此頁面頂端的圖表。

1.11:自訂條件 custom

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

查看詳細資料

可用的條件

  • Custom algorithm

需要實體引數

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

讀數

返回此頁面頂端的圖表。

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

查看詳細資料

讀數

返回此頁面頂端的圖表。

1.13:提供excludedIds exclude

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

查看詳細資料

讀數

返回此頁面頂端的圖表。

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

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

查看詳細資料

讀數

返回此頁面頂端的圖表。

1.15:設定遠端資料對應(遠端)

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

查看詳細資料

遠端資料對應圖表 {width="400" modal="regular"}

必要條件

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

設定資料提供者

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

讀數

targetPageParams函式

動作

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

返回此頁面頂端的圖表。

1.16:載入at.js web

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

查看詳細資料

載入Adobe Target at.js圖表 {width="400" modal="regular"}

必要條件

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

讀數

動作

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

返回此頁面頂端的圖表。

繼續步驟2:設定資料彙集

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