Adobe Target MCP伺服器工具參考 target-mcp-tools-reference

工具： list_target_activities

列出Adobe Target個具有伺服器端篩選和排序的活動。

擷取活動的分頁清單。 所有篩選器都是由Target Admin API在伺服器端套用。 伺服器每頁最多可傳回200個活動。

傳回： JSON物件具有activities （物件清單包括id、name、state、type、priority、modifiedAt、startsAt、endsAt）和total （總計數，可能會超過傳回的頁面大小）。

範例提示：「列出所有依最近修改排序的作用中A/B測試」。

工具： get_activity

取得任何型別活動的詳細資訊。

擷取特定活動的完整設定，自動偵測活動型別。 支援A/B測試、體驗鎖定目標、Automated Personalization、自動分配、多變數測試和Recommendations活動。

傳回：​完整的活動詳細資料，包括中繼資料（名稱、狀態、優先順序、日期）、體驗、位置和選件、目標和量度，以及目標規則。

範例提示：「取得活動12345的詳細資料」。

工具： create_ab_activity

建立新的A/B測試活動。

使用指定的組態（包括體驗、選件和鎖定目標）建立新的A/B測試。

傳回：​已建立的活動物件及其指派的識別碼。

範例提示： 「建立名為’Homepage Hero Test’的A/B測試，其中包含兩個體驗，測試homepage-hero mbox上的不同主圖影像。」

工具： create_xt_activity

建立新的體驗鎖定目標(XT)活動。

建立XT活動，此活動會根據鎖定目標規則將不同的體驗提供給不同的對象。

傳回：​已建立的活動物件及其指派的識別碼。

範例提示： 「建立稱為『地理Personalization』的體驗鎖定目標活動，對來自不同地區的訪客顯示不同的內容。」

工具： update_activity

更新現有的A/B測試、體驗鎖定目標或Automated Personalization活動。

使用讀取 — 修改 — 寫入模式：擷取目前狀態、合併您的變更、驗證並傳送更新。 支援A/B測試、體驗鎖定目標和Automated Personalization活動；自動分配、多變數測試和Recommendations活動為唯讀。 結構化goal、audience_ids和additional_metrics引數僅支援A/B測試和體驗鎖定目標；Automated Personalization活動接受純欄位合併更新。

傳回：​更新的活動物件。

範例提示：「更新活動12345以將流量分配變更為70/30」。

工具： update_activity_schedule

更新活動的開始和結束日期。

更新活動的排程，而不修改其他設定。

傳回：​排程更新的確認。

範例提示：「更新A/B活動12345動從5月1日到5月31日執行的排程」。

工具： update_activity_state

變更活動狀態（啟動、停用或暫停）。

傳回：​更新的活動狀態。

範例提示：「啟動活動12345」或「暫停首頁主圖測試」。

工具： update_activity_name

重新命名活動。

只更新名稱，不修改完整設定。

傳回：​更新的活動物件。

範例提示：「將活動12345重新命名為’Summer Campaign Hero Test’。」

工具： update_activity_priority

變更活動優先順序。

當多個活動鎖定相同位置時，優先順序較高的活動優先。

傳回：​更新的活動物件。

範例提示：「將活動12345的優先順序設為100。」

工具： add_activity_variant

將新的體驗/變體新增至活動。

處理所有結構協調，包括建立選項、對應至位置以及重新平衡流量。

傳回：​更新的活動物件。

範例提示：「使用選件67890則12345新增名為’Holiday Theme’的新變體至A/B活動。」

工具： update_traffic_split

更新變體間的流量分配。

百分比總和必須剛好為100。

傳回：​更新的活動物件。

範例提示：「將活動12345的流量分割變更為70%控制項和30%變體A。」

工具： update_variant_offer

變更特定變體的選件。

適用於表單式活動（使用offer_id）和VEC活動（使用modifications）。

傳回：​更新的活動物件。

範例提示：「更新活動12345中的「變體A」體驗，以使用選件99999。」

工具： remove_activity_variant

從活動中移除體驗/變體。

移除體驗、清除孤立的選項，以及在其餘變體間平均重新平衡流量。

傳回：​更新的活動物件。

範例提示：「從A/B活動12345動移除’Test Variant’體驗」。

工具： list_target_offers

列出您Target租使用者中的所有優惠。

擷取具有選擇性篩選功能的內容選件分頁清單。

傳回：​具有offers的JSON物件（物件清單，包括id、name、type、content、modifiedAt）和total。

範例提示：「列出所有JSON選件」。

工具： get_target_offer

取得特定優惠方案的詳細資訊。

傳回：​完整優惠詳細資料，包括id、name、type、content、workspace和modifiedAt。

範例提示：「取得優惠67890動的詳細資料」。

工具： create_target_offer

建立新的HTML內容選件。

傳回：​已建立的選件及其指派的識別碼。

範例提示： 「使用促銷橫幅建立名為’Summer Sale Banner’的HTML優惠。」

工具： create_target_json_offer

建立新的JSON選件來傳遞結構化資料。

傳回：​已建立的選件及其指派的識別碼。

範例提示： 「使用功能切換設定建立名為’Feature Flags Config’的JSON選件。」

工具： update_target_offer

更新現有優惠方案。

傳回：​更新的選件物件。

範例提示：「使用新的促銷內容更新優惠67890案」。

工具： list_target_audiences

列出您Target租使用者中的所有對象。

傳回：​具有audiences的JSON物件（物件清單，包括id、name、description、origin、modifiedAt）和total。

範例提示：「列出所有對象」。

工具： get_target_audience

取得對象詳細資料，包括目標定位規則。

擷取特定對象的完整設定，包括其鎖定目標規則和條件。

傳回：​完整的對象詳細資料，包括id、name、description、origin、目標定位規則和相關聯的活動計數。

範例提示： 「取得對象12345的詳細資料，並顯示其目標規則。」

工具： create_target_audience

使用鎖定目標規則建立新的對象。

傳回：​已建立的對象及其指派的識別碼。

範例提示： 「在CA中建立名為『來自加州的行動訪客』以行動使用者為目標的對象。」

工具： list_target_mboxes

列出您Target租使用者中的所有mbox。

傳回：​具有mboxes的JSON物件（物件清單，包括name、status、lastRequestTime）和total。

範例提示：「列出所有包含’homepage’的mbox」。

工具： get_target_mbox

取得特定mbox的詳細資訊。

傳回： Mbox詳細資料，包括name、status以及使用mbox的活動清單。

範例提示：「取得mbox 'homepage-hero’的詳細資料」。

工具： list_target_mbox_profile_attributes

列出所有可用於鎖定目標的mbox設定檔屬性。

不需要引數。

傳回：​設定檔屬性物件的JSON陣列。

範例提示： 「哪些設定檔屬性可用於目標定位？」

工具： list_target_properties

列出您Target租使用者中的所有屬性。

屬性可組織活動並控制存取。

不需要引數。

傳回：​屬性物件清單，包括id、name、description和channel。

範例提示：「列出所有Target屬性」。

工具： get_activity_performance_report

取得任何型別活動的效能報表。

擷取轉換率、提升度和信賴水準。 支援A/B測試、體驗鎖定目標、Automated Personalization、自動分配、多變數測試和Recommendations活動。

傳回：​體驗層級量度（訪客、轉換、轉換率）、提升度計算、統計信賴度及收入量度（如果已設定）。

範例提示： 「顯示過去30天活動12345動的執行報告。」

工具： get_activity_orders_report

取得任何型別活動的訂單/收入報表。

支援A/B測試、體驗鎖定目標、Automated Personalization、自動分配、多變數測試和Recommendations活動。

傳回：​訂單計數、收入，以及體驗的平均訂單值。

範例提示：「取得活動12345的訂單報表」。

工具： get_activity_report_by_name

依名稱搜尋活動並取得其效能報表。

當您知道活動名稱但不知道其ID時，這很有用。

傳回：​活動詳細資料和績效測量結果。

範例提示： 「取得我的『首頁主圖測試』活動的效能報告」。

工具： get_a4t_report

擷取Target活動的Analytics for Target (A4T)報告。

驗證活動的A4T設定，然後對Adobe Analytics執行GraphQL查詢以擷取Analytics端量度。 僅適用於已設定A4T報告的活動。

傳回：​活動的分析端量度，包括直接從Adobe Analytics取得的訪客計數、轉換、收入和體驗提升度。

範例提示：「提取A4T報告供我的簽出最佳化測試使用，並彙總Analytics端的轉換資料」。

工具： preview_activity

產生Target活動的瀏覽器QA預覽URL。

建立可點按的預覽連結，強制顯示特定體驗，略過對象鎖定目標規則。 適用於A/B、XT和Automated Personalization活動。

傳回：​活動資訊（名稱、型別、狀態）、每個體驗的預覽URL，以及體驗名稱和索引。

範例提示： 「產生活動12345動的預覽URL，以便我測試瀏覽器中的每一個體驗。」

工具： list_target_response_tokens

列出您Target租使用者中的所有回應Token。

擷取所有已設定的回應Token，包括內建和自訂。

不需要引數。

傳回：​回應權杖物件的JSON陣列，狀態為name、type和enabled。

範例提示：「列出所有回應Token」。

工具： create_target_response_token

建立新的自訂回應Token，以在Target個回應中收集其他資料。

傳回：​已建立的回應Token物件。

範例提示：「建立名為’campaign_id’的自訂回應Token，型別為ACTIVITY。」

工具： get_target_revisions

取得資源型別的稽核記錄。

擷取使用作者選擇性篩選對Target資源所做的變更。

傳回：​包含時間戳記、使用者和變更說明的修訂歷程記錄。

範例提示： 「顯示活動變更的稽核記錄」。

工具： get_target_entity_revisions

依照ID取得特定實體的所有修訂版本。

傳回：​指定實體所有修訂的JSON陣列。

範例提示： 「顯示活動12345的所有變更。」

工具： list_target_templates

列出可用於建立活動和優惠方案的MCP資源和範本。

不需要引數。

傳回： JSON物件列出可用的範本和資源。

範例提示： 「哪些範本可用於建立活動？」

工具： list_target_criteria，get_target_criteria，list_target_criteria_by_type，get_target_criteria_by_type，create_target_criteria，update_target_criteria

條件即為一種規則，用來根據預先決定的一組訪客行為決定要建議的專案。 條件已分組為9個型別系列： category、custom、item、cart、popularity、profileattribute、recent、sequence、userhistory。

list_target_criteria和get_target_criteria傳回最少的、跨系列條件中繼資料(id、name、criteriaTitle、criteriaGroup)。 搭配criteria_type使用list_target_criteria_by_type / get_target_criteria_by_type （或create_target_criteria / update_target_criteria）以使用完整、型別特定的組態。 每個系列的欄位需求不同 — 如需完整的每種型別結構描述，請參閱Adobe Recommendations API參考。

傳回：​條件物件或具有offset、limit、total和list的分頁清單。

範例提示：「列出此帳戶中設定的所有Recommendations條件，並摘要使用中的演演算法型別。」

工具： list_target_collections，get_target_collection，create_target_collection，update_target_collection

集合會依相符規則將目錄實體分組，以用於條件和促銷活動。

傳回：​集合物件，包括id、name、description、rules和上次修改的中繼資料。

範例提示： 「我有哪些集合，以及它們篩選了哪些目錄屬性？」

工具： list_target_designs，get_target_design，create_target_design，update_target_design

設計是Velocity或HTML範本，可控制建議實體的呈現方式。

傳回：​設計物件，包括id、name、script和type。

範例提示： 「我為Recommendations設定了哪些設計和集合？」

工具： list_target_promotions，get_target_promotion，create_target_promotion，update_target_promotion

促銷活動會強制特定實體加入建議結果，使其優先於條件和備用建議。

傳回：​推進物件。

範例提示： 「建立外部促銷活動，在8月底之前使用’Backpacking Tents’集合。」

工具： list_target_exclusions，get_target_exclusion，create_target_exclusion，update_target_exclusion

排除專案會從建議結果中移除相符的實體。 排除專案會套用至整個帳戶，並涵蓋所有條件和活動。

傳回：​排除物件。

範例提示： 「目前是否已設定任何全帳戶排除專案，以及這些專案會篩選哪些專案？」

工具： get_target_entity，search_target_catalog

檢查Recommendations產品/內容目錄的唯讀工具。 沒有透過MCP伺服器建立、更新或刪除目錄實體的工具。

傳回： get_target_entity傳回實體的目錄屬性。 search_target_catalog在entities陣列中傳回符合專案。 query中的欄位名稱必須為租使用者設定的實際目錄屬性。

範例提示：「搜尋目錄中的存貨低於1000的產品。」