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_ab_activity

取得有關A/B活動的詳細資訊。

擷取特定A/B測試的完整設定，包括體驗、位置、量度和目標定位規則。

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

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

工具： get_xt_activity

取得體驗鎖定目標(XT)活動的詳細資訊。

擷取特定XT活動的完整設定，包括對象體驗對應、位置和量度。

傳回：​完整的活動詳細資料，包括中繼資料、具有對象對應的體驗、位置和選件，以及目標和量度。

範例提示：「取得體驗鎖定目標活動12345的詳細資料」。

工具： get_abt_activity

取得有關Automated Personalization (AP)活動的詳細資訊。

傳回：​完整的活動詳細資料，包括中繼資料、體驗、位置和演演算法設定。

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

工具： create_ab_activity

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

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

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

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

工具： create_xt_activity

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

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

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

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

工具： update_ab_activity

更新現有的A/B活動。

使用讀取 — 修改 — 寫入模式：擷取目前狀態、合併您的變更、驗證並傳送更新。

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

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

工具： update_xt_activity

更新現有的體驗鎖定目標活動。

使用讀寫模式。

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

範例提示：「更新XT活動12345以新增行動訪客的體驗」。

工具： update_abt_activity

更新現有的Automated Personalization活動。

使用讀寫模式。

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

範例提示：「更新自動Personalization活動12345動以變更最佳化目標」。

工具： 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_ab_performance_report

取得A/B活動的效能報表。

擷取轉換率、提升度和信賴水準。

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

範例提示： 「顯示過去30天A/B測試12345的效能報告。」

工具： get_ab_orders_report

取得A/B活動的訂單/收入報表。

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

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

工具： get_xt_performance_report

取得體驗鎖定目標活動的效能報表。

傳回：​體驗層級的效能測量結果。

範例提示：「顯示我的體驗鎖定目標活動54321的效能」。

工具： get_xt_orders_report

取得體驗鎖定目標活動的訂單/收入報表。

傳回：​依據體驗的排序量度。

範例提示：「取得XT活動54321的訂單資料」。

工具： 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物件列出可用的範本和資源。

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