Adobe Target模組

在Adobe Workfront Fusion案例中,您可以自動化使用Adobe Target的工作流程,並將其連線至多個協力廠商應用程式和服務。 Adobe Target模組可讓您建立、讀取、更新或刪除記錄、列出特定型別的所有記錄、根據您指定的條件搜尋記錄,或執行對Adobe Target API的自訂API呼叫。

如果您需要有關建立案例的指示,請參閱建立案例

如需模組的相關資訊,請參閱 Adobe Workfront Fusion🔗中的模組。

存取需求

您必須具有下列存取權才能使用本文中的功能:

Adobe Workfront 計畫*
Pro或更高版本
Adobe Workfront 授權*
計畫,工作
Adobe Workfront Fusion 授權**

目前授權需求:無Workfront Fusion授權需求。

舊版授權需求:Workfront Fusion for Work Automation and Integration

產品

目前產品需求:如果您有Select或Prime Adobe Workfront計畫,貴組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。 Workfront Fusion包含在Ultimate Workfront計畫中。

舊版產品需求:您的組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。

若要瞭解您擁有的計畫、授權型別或存取權,請連絡您的Workfront管理員。

如需Adobe Workfront Fusion授權的相關資訊,請參閱Adobe Workfront Fusion 授權

先決條件

使用Adobe Target聯結器之前,您必須確定符合下列先決條件:

  • 您必須擁有使用中的Adobe Target帳戶。

Adobe Target API資訊

Adobe Target聯結器會使用以下專案:

API標籤
v1.7.33

建立與Adobe Target的連線

IMPORTANT
2024年6月3日之後建立的連線需要Adobe Target伺服器對伺服器連線。
  • 現有的服務帳戶連線將持續運作到2025年1月。 您必須在2024年1月前,將服務帳戶連線取代為Adobe Target伺服器對伺服器連線。
  • 您必須是組織的開發人員才能建立Adobe Target伺服器對伺服器連線。 開發人員角色是在Adobe Admin Console中設定。

若要為您的Adobe Target模組建立連線:

  1. 按一下[連線]方塊旁的​ 新增

  2. 填寫下列欄位:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 layout-auto html-authored no-header
    連線名稱 輸入此連線的名稱。
    連線型別

    選擇您要建立服務帳戶連線還是Adobe Target伺服器對伺服器連線。

    重要: 2024年6月3日之後建立的連線需要Adobe Target伺服器對伺服器連線。 現有的服務帳戶連線將持續運作到2025年1月。 您必須在2024年1月前,將服務帳戶連線取代為Adobe Target伺服器對伺服器連線。

    環境 選取您要連線到生產或非生產環境。
    型別 選取您要連線到服務帳戶還是個人帳戶。
    使用者端ID 輸入您的Adobe使用者端識別碼。 這可以在Adobe Developer Console的認證詳細資料區段中找到。
    使用者端密碼 輸入您的Adobe使用者端密碼。 這可以在Adobe Developer Console的認證詳細資料區段中找到。
    技術帳戶ID 輸入您的Adobe技術帳戶ID。 這可以在Adobe Developer Console的認證詳細資料區段中找到。
    組織ID 輸入您的Adobe組織識別碼。 這可以在Adobe Developer Console的認證詳細資料區段中找到。
    租使用者

    若要尋找您的租使用者,請登入Adobe Experience Cloud,開啟Target,然後按一下Target卡片。 使用URL子網域中所述的租使用者ID值。

    例如,如果您在登入Adobe Target時的URL是<https://mycompany.experiencecloud.adobe.com/...>,則您的租使用者ID是"mycompany"。

    中繼範圍 輸入ent_marketing_sdk
    私密金鑰

    輸入在Adobe Developer Console中建立認證時產生的私密金鑰。

    若要擷取您的私密金鑰或憑證:

    1. 按一下 Extract

    2. 選取要解壓縮的檔案型別。

    3. 選取包含私密金鑰或憑證的檔案。

    4. 輸入檔案的密碼。

    5. 按一下 儲存 以擷取檔案並返回連線設定。

  3. 按一下​ 繼續 ​以儲存連線並返回模組。

Adobe Target模組及其欄位

當您設定Adobe Target模組時,Workfront Fusion會顯示下列欄位。 除了這些欄位以外,可能還會顯示其他Adobe Target欄位,視您在應用程式或服務中的存取層級等因素而定。 模組中的粗體標題表示必填欄位。

如果您在欄位或函式上方看到對應按鈕,則可以使用它來設定該欄位的變數和函式。 如需詳細資訊,請參閱在 Adobe Workfront Fusion中將資訊從一個模組對應到另一個模組。

動作

建立記錄

此動作模組會建立AB或XT活動、選件或對象。

Connection
如需建立Adobe Target連線的說明,請參閱本文中的建立與Adobe Target的連線。
記錄型別

選取您要建立的記錄型別。

  • 屬性

    如需欄位的詳細資訊,請參閱Adobe Target API檔案中的建立屬性

  • 優惠建議

    如需欄位的詳細資訊,請參閱Adobe Target API檔案中的建立新的RECS選件

  • 選件JSON

    繼續選件欄位

  • 選件內容

    繼續選件欄位

  • 環境

    如需欄位的詳細資訊,請參閱Adobe Target API檔案中的建立環境

  • 對象

    如需欄位的詳細資訊,請參閱Adobe Target API檔案中的建立對象

  • AB活動

    如需欄位的詳細資訊,請參閱Adobe Target API檔案中的建立AB活動

  • XT活動

    繼續XT活動欄位

  • AP活動

    如需欄位的詳細資訊,請參閱Adobe Target API檔案中的建立AP活動

  • 回應Token

    如需欄位的詳細資訊,請參閱Adobe Target API檔案中的建立回應Token

XT活動欄位
名稱
輸入或對應此活動的名稱。 名稱不能超過250個字元。
Options

針對您想要新增至活動的每個選項,按一下 新增專案 並填入下列欄位:

  • 選項本機識別碼

    輸入或對應要用於跨API請求追蹤選項的字串。

  • 名稱

    輸入或對映選項的名稱。 名稱不得超過250個字元。

  • 選件ID

  • 選取或對應與選項相關聯的優惠。

位置

針對您要新增至活動的每個Mbox,按一下 新增專案 並填寫下列欄位:

  • 對象ID

    針對您想要新增至Mbox的每個對象,按一下 新增專案 並選取對象ID。

  • 位置本機識別碼

    輸入或對應要用來跨API請求追蹤位置的字串。

  • 名稱

    輸入或對應「位置」的名稱。 名稱不得超過250個字元。

體驗

頁面上提供內容選件的位置清單。 位置包含以下內容:

  • 體驗本機識別碼

    輸入或對映體驗的ID

  • 名稱

    輸入或對映體驗的名稱

  • Audience IDs

    針對您想要檢視體驗的每個對象,按一下 新增專案 並輸入對象ID。

  • 訪客百分比

    輸入或對映分配至體驗的訪客百分比

Metrics
第三方ID
輸入或對應ID以識別此活動。 您可以選擇此ID。 此ID不得與其他活動相同,且不得超過250個字元。
開始於
輸入或對應開始活動的日期和時間,格式為YYYY-MM-DD hh:mm:ss.z
結尾為
輸入或對應結束活動的日期和時間,格式為YYYY-MM-DD hh:mm:ss.z
狀態

輸入或對映活動的狀態。

  • 已核准

  • 已停用

  • 已暫停

  • 已儲存

  • 已刪除

優先順序
輸入定義活動優先順序的數字。 數字越大,優先順序越高。 此值必須介於0到999之間。 預設值為5。
自動分配流量

啟用此選項以自動分配流量。 自動分配會將更多流量傳送到更成功的體驗。

選取或對應評估標準,以判斷哪個體驗更成功。

Workspace
輸入或對應與活動相關聯的工作區
屬性ID
針對您想要新增至活動的每個屬性,按一下 新增專案,然後選取或對應屬性的識別碼。
報表受眾

針對您想要新增至活動的每個報表對象,按一下新增專案並輸入下列資訊:

  • 報表對象本機識別碼

    輸入或對應字串,用於跨API請求追蹤報表對象。

  • 對象ID

    輸入或對應要在報告中使用的區段

  • 量度本機識別碼

    輸入或對應字串,用於跨API請求追蹤量度。

選件欄位
名稱
輸入或對應此活動的名稱。 名稱不能超過250個字元。
內容
輸入或對應要向使用者顯示的優惠方案內容。
Workspace
輸入或對應與選件相關聯之工作區的ID。 如果保留為空白,選件會與帳戶的預設工作區相關聯。 此功能僅適用於Target個Premium帳戶。
Workspace
輸入或對應此優惠方案的修改日期和時間。

進行自訂API呼叫

此模組會對Adobe Target API發出自訂API呼叫。

Connection
如需建立Adobe Target連線的說明,請參閱本文中的建立與Adobe Target的連線。
Target基底URL
輸入或對應您的Target基底URL。
路徑
輸入相對於{baseURL}/
方法

選取設定API呼叫所需的HTTP要求方法。 如需詳細資訊,請參閱Adobe Workfront Fusion中的HTTP要求方法。

Headers

以標準JSON物件的形式新增請求的標頭。

例如, {"Content-type":"application/json"}

Workfront Fusion 自動新增授權標頭和x-api-key標頭。

查詢字串
輸入請求查詢字串。
Body

以標準JSON物件的形式新增API呼叫的內文內容。

注意:

在JSON中使用條件陳述式(例如if)時,請將引號放在條件陳述式之外。

刪除記錄

此動作模組會刪除單一AB活動、XT活動、選件或對象。

Connection
如需建立Adobe Target連線的說明,請參閱本文中的建立與Adobe Target的連線。
記錄型別
選取您要刪除的記錄型別。
記錄ID
輸入或對應您要刪除之記錄的ID。

讀取記錄

此動作模組會擷取單一活動、選件、對象、屬性或報表的資料。

Connection
如需建立Adobe Target連線的說明,請參閱本文中的建立與Adobe Target的連線。
記錄型別
選取您要讀取的記錄型別。
記錄ID
輸入或對應您要讀取之記錄的ID。

更新記錄

此動作模組會更新Target中的記錄。

Connection
如需建立Adobe Target連線的說明,請參閱本文中的建立與Adobe Target的連線。
記錄型別
選取您要更新的記錄型別。
欄位名稱

選取您要更新的欄位。 欄位顯示如下。

如需欄位的詳細資訊,請參閱Adobe Target API檔案

搜尋

取得記錄

此搜尋模組會擷取所選型別的記錄清單。

Connection
如需建立Adobe Target連線的說明,請參閱本文中的建立與Adobe Target的連線。
記錄型別
選取您要更新的記錄型別。
排序依據
針對您要排序的每個欄位,按一下 新增專案,然後選取欄位以及傳回的結果應該遞增還是遞減。
開始於

輸入您要擷取記錄的最早日期。

如需支援的日期和時間格式清單,請參閱在Adobe Workfront Fusion中鍵入強制。

結尾為

輸入您要擷取記錄的最晚日期。

如需支援的日期和時間格式清單,請參閱在Adobe Workfront Fusion中鍵入強制。

搜尋

此搜尋模組會根據您指定的條件搜尋活動、選件或對象。

Connection
如需建立Adobe Target連線的說明,請參閱本文中的建立與Adobe Target的連線。
記錄型別
選取您要更新的記錄型別。
排序依據
針對您要排序的每個欄位,按一下 新增專案,然後選取欄位以及傳回的結果應該遞增還是遞減。
搜尋條件
針對您要設定的每個規則,選取欄位、運運算元和值。 按一下 Add AND rule 以建立其他規則。
位移

輸入您希望模組傳回的第一個回應編號。 第一個傳回回回的回應有0的位移。 將此欄位與Maximum number of returned results欄位搭配使用,可將回應分頁。

例如,若要檢視回應的第三個頁面,當每個頁面有10個回應時,請將Offset設為20,並將Maximum number of returned設為10。

限制

輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。 將此欄位與Offset欄位搭配使用,可將回應分頁。

例如,若要檢視回應的第三個頁面,當每個頁面有10個回應時,請將Offset設為20,並將Maximum number of returned設為10。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43