伺服器端:實作Target

有關Adobe Target伺服器端傳送API、SDK和Target Recommendations API的資訊。

NOTE
如果您的實作在使用者端使用at.js和AppMeasurement,您應該使用下述的Target傳送API和伺服器端SDK。
如果您的實作使用Adobe Experience Platform Web SDK,您應該使用Adobe Experience Platform Edge Network伺服器API

下列程序會發生在 Target 的伺服器端實作中:

  1. 用戶端裝置會透過伺服器提出體驗的要求。
  2. 伺服器會將該要求傳送至 Target。
  3. Target 會將回應傳送回伺服器。
  4. 您的伺服器會決定要將哪個體驗提供給使用者端裝置以供其呈現。

體驗不需要顯示在瀏覽器中。 體驗可以透過語音助理或某些其他非視覺體驗或非瀏覽器型裝置,顯示在電子郵件或資訊站中。 由於伺服器位於用戶端與 Target 之間,如果您需要更多控制和安全性,或有要在伺服器上執行的複雜後端程序,這種類型的實施也是非常理想的選擇。

NOTE
首次訪客只能在使用者端上初始化。 無法在伺服器端初始化首次訪客​**。 這是因為ECID,其取決於協力廠商Demdex Cookie,因此需要透過訪客API.js在涉及瀏覽器的實施上進行初始化。

以下章節提供有關各種伺服器端API和SDK的詳細資訊:

伺服器端傳送 API

連結: 伺服器端傳送API

/rest/v1/delivery

透過Target傳遞API,您可以:

  • 跨Web (包括SPA)和行動裝置頻道以及非瀏覽器型IoT裝置(例如連線電視、資訊站或店內數位熒幕)提供體驗。
  • 從任何可進行HTTP/s呼叫的伺服器端平台或應用程式提供體驗。
  • 無論訪客使用哪些管道或裝置與您的業務互動,都可為訪客提供一致且個人化的體驗。
  • 快取伺服器上工作階段中訪客的體驗,以避免多個API呼叫,進而提高效能。
  • 從伺服器端順暢地與Adobe Experience Cloud產品(例如Adobe Analytics、Adobe Audience Manager (AAM)及Experience Cloud ID Service)整合。

伺服器端SDK

Adobe Target伺服器端SDK檔案可協助您在伺服器上以您選擇的語言實作Target。

透過Adobe Target的伺服器端SDK,您可以:

  • 在​ 幾乎零延遲 ​處執行並執行​功能標幟轉出​和​A/B實驗
  • 透過​ 網路 ​提供體驗,包括​ SPA ​和​行動裝置頻道,以及非瀏覽器型的​物聯網(IoT)裝置,例如連線電視、資訊站或店內數位熒幕。
  • 無論使用者與您的企業使用哪個管道或裝置,都將​ 機器學習(ML)驅動的個人化體驗 ​傳遞給使用者。
  • 從伺服器端順暢地整合Adobe Experience Cloud​產品,例如​Adobe AnalyticsAdobe Audience Manager​以及​Experience Cloud ID服務

請參閱快速入門頁面,瞭解如何透過裝置上決策執行簡單的功能標幟使用案例。

檢視我們的範例應用程式,享受樂趣和玩樂!

Target Recommendations API

連結: Target Recommendations APIAdobe Recommendations API總覽

Recommendations API可讓您以程式設計方式與Target個推薦伺服器互動。 這些API可與一系列應用程式棧疊整合,以執行您通常透過Target使用者介面執行的功能。

不含SDK的Platform Edge Network個API呼叫 platform-edge-api-user-agent

Adobe Experience Platform Web SDK和其他支援的SDK整合在呼叫Experience Platform Edge Network時,會在HTTP要求標頭中包含類似瀏覽器的User-Agent值。 使用公用Interact API (不含SDK)的伺服器端整合必須明確提供此標頭。

對於非SDK Interact API呼叫,請遵循下列需求:

  • 在HTTP要求標頭中包含有效的類似瀏覽器的User-Agent。 僅JSON要求內文中的訪客或使用者代理程式值不符合此整合模式的機器人偵測需求。
  • 請勿使用預留位置或非瀏覽器值,例如MyApp/1.0,這類值可能會導致機器人分類。
  • 公開SDK API呼叫不需要Edge名稱或SDK版本。 對於此案例,有效的User-Agent HTTP標頭是必要的元素。

當Target將請求分類為機器人流量時,個人化可能會失敗或看起來間歇性,因為類似Recommendations和自動鎖定目標等活動的設定檔查詢、區段評估和個人化內容都已隱藏,如下所述。

Adobe Experience Platform Web SDK 總覽中進一步瞭解如何使用SDK進行實作。

Interact API要求範例(標頭必須包含User-Agent):

POST https://edge.adobedc.net/ee/v2/interact?dataStreamId=YOUR_DATASTREAM_ID&requestId=YOUR_REQUEST_ID
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.5 Safari/605.1.15
Accept: */*
Content-Type: text/plain; charset=UTF-8
recommendation-more-help
target-dev-help-dev