Cloud Connector擴充功能概觀

注意

Adobe Experience Platform Launch在Adobe Experience Platform中已重新命名為一套資料收集技術。 因此,產品檔案中已推出數個術語變更。 有關術語更改的綜合參考,請參閱以下document

Cloud Connector事件轉送擴充功能可讓您建立自訂HTTP要求,將資料傳送至目的地或從目的地擷取資料。 Cloud Connector 擴充功能就像 Adobe Experience Platform Edge Network 的郵差一樣,可將資料傳送至尚未具備專屬擴充功能的端點。

您可參閱此參考文件,了解使用此擴充功能建立規則時可使用哪些選項。

Cloud Connector 擴充功能動作類型

本節說明 Adobe Experience Platform Cloud Connector 擴充功能中可供使用的「傳送資料」動作類型。

要求類型

若要選取端點所需的請求類型,請在請求類型下拉式清單中選取適當的類型。

方法 說明
GET 要求呈現指定的資源。使用 GET 的要求應當只會擷取資料。
POST 將實體提交至指定資源,通常會造成伺服器狀態改變或產生副作用。
PUT 以要求裝載取代目標資源當下的所有呈現方式。
PATCH 對資源進行部分修改。
DELETE 刪除指定的資源。

端點 URL

在「要求類型」下拉式選單旁的文字欄位中,輸入您要傳送資料的端點 URL。

查詢參數、標頭和內文設定

您可使用「查詢參數」、「標頭」和「內文資料元素」等索引標籤,控制要傳送給指定端點的資料。

查詢參數

為您要以查詢字串參數形式傳送的每個索引鍵/值組定義索引鍵和值。若要手動輸入資料元素,請使用大括弧資料元素Token化來進行事件轉送。 若要以索引鍵或值的形式參照資料元素「siteSection」的值,請輸入 {{siteSection}}。或者,您也可以從下拉式選單中選取先前建立的資料元素。

要添加更多查詢參數,請選擇​添加其他

標頭

為您要以標頭傳送的每個索引鍵/值組定義索引鍵和值。若要手動輸入資料元素,請使用大括弧資料元素Token化來進行事件轉送。 若要以索引鍵或值的形式參照資料元素「pageName」的值,請輸入 {{pageName}}。或者,您也可以從下拉式選單中選取先前建立的資料元素。

若要新增更多標題,請選取「新增其他」。

預先定義的標頭如下表所示。不僅限使用下列標頭,您也可以視需求新增專屬的自訂標頭,以便使用。

注意

如需下列標頭的詳細資訊,請參閱 https://developer.mozilla.org/zh-TW/docs/Web/HTTP/Headers

標頭 說明
A-IM
Accept
Accept-Charset
Accept-Encoding
Accept-Language
Accept-Datetime 由使用者代理程式傳送,表示想存取原始資源的過去狀態。為此,針對原始資源 TimeGate 所發送的 HTTP 要求中會傳送 Accept-Datetime 標頭,其值表示所需原始資源過去狀態的日期時間。
Access-Control-Request-Headers 瀏覽器在發出預檢要求時使用,讓伺服器知道用戶端提出實際要求時,可能會傳送哪些 HTTP 標頭
Access-Control-Request-Method 瀏覽器在發出預檢要求時使用,讓伺服器知道用戶端提出實際要求時可能會使用哪種 HTTP 方法。此標頭為必填項目,因為預檢要求一概都是 OPTION,且不使用與實際要求相同的方法。
Authorization 包含向伺服器驗證使用者代理程式的認證。
Cache-Control 要求和回應中快取機制的指示詞。
Connection 控制當前的交易完成後,網路連線是否維持開啟狀態。
Content-Length 資源大小,以位元組十進位值表示。
Content-Type 表示資源的媒介類型。
Cookie 包含伺服器先前以 Set-Cookie 標頭傳送及儲存的 HTTP Cookie
Date 一般 HTTP 標頭會包含產生訊息的日期和時間。
DNT 表示使用者的追蹤偏好設定。
Expect 表示伺服器必須滿足才能正確處理要求的期望。
Forwarded 包含來自反向 Proxy 伺服器的資訊,但在要求路徑涉及 Proxy 時,資訊遭到更改或遺失。
From 包含真人使用者的網際網路電子郵件地址,發出要求的使用者代理程式由該使用者控制。
Host 指定要求預計抵達的伺服器主機和連接埠號碼。
If-Match
If-Modified-Since
If-None-Match
If-Range
If-Unmodified-Since
Max-Forwards
Origin
Pragma 實作專用標頭,可能會在要求回應鏈的任何位置產生多種效果,功用是與未有 Cache-Control 標頭的 HTTP/1.0 快取回溯相容。
Proxy-Authorization
Range 表示伺服器應傳回的文件部分。
Referer 上一個網頁的網址,使用者在此點選連結,前往當前所要求存取的頁面。
TE 指定使用者代理程式願意接受的傳輸編碼(較直觀的名稱為 Accept-Transfer-Encoding)。
Upgrade Upgrade」標頭欄位的相關 RFC 文件為 RFC 7230 第 6.7 節。該標準建立了在當前用戶端、伺服器、傳輸通訊協定連線上升級或改用其他通訊協定的規則。例如,只要伺服器決定認可並實作「Upgrade」標頭欄位,此標頭即可標準允許用戶端從 HTTP 1.1 變更為 HTTP 2.0。雙方均不需接受「Upgrade」標頭欄位中指定的條款。用戶端和伺服器標頭皆可適用。如果指定「Upgrade」標頭欄位,傳送者必須指定「upgrade」選項以傳送「Connection」標頭欄位。
User-Agent 包含特徵字串,供同級的網路通訊協定識別發出要求的軟體使用者代理程式,了解其應用程式類型、作業系統、軟體廠商或軟體版本等詳細資訊。
Via 由正向和反向 Proxy 新增,可顯示於要求標頭和回應標頭中。
Warning 潛在問題的一般警告資訊。
X-CSRF-Token
X-Requested-With

Body as JSON

為您要在要求內文中傳送的每個索引鍵/值組定義索引鍵和值。若要手動輸入資料元素,請使用大括弧資料元素Token化來進行事件轉送。 若要以索引鍵或值的形式參照資料元素「appSection」的值,請輸入 {{appSection}}。或者,您也可以從下拉式選單中選取先前建立的資料元素。

要添加其他鍵值對,請選擇​添加其他

Body as Raw

為您要在要求內文中傳送的每個索引鍵/值組定義索引鍵和值。若要手動輸入資料元素,請使用大括弧資料元素Token化來進行事件轉送。 若要以索引鍵或值的形式參照資料元素「appSection」的值,請輸入 {{appSection}}。或者,您也可以從下拉式選單中選取先前建立的資料元素。您可以新增一或多個資料元素。

進階

事件轉送中的規則內動作會依序執行。 某些情況下,您或許可以從外部來源擷取不在用戶端傳入事件上的資料,然後接受此回應,並在單一規則內的後續動作中轉換資料或將資料傳送至最終目的地。進階區段中的「儲存要求回應」會啟用此功能。

若要從端點儲存回應內文,請核取「儲存請求回應​」方塊,並在文字欄位中定義回應索引鍵。

如果您已將回應索引鍵定義為「productDetails」,請在資料元素中參照此資料,接著在同一規則的後續動作中參照此資料元素。若要建立參照「productDetail」的資料元素,請建立「path」類型的資料元素,並輸入以下路徑:

arc.ruleStash.[EXTENSION-NAME-HERE].responses.[RESPONSE-KEY-HERE] 

arc.ruleStash.adobe-cloud-connector.reponses.productDetails 

本頁內容