Adobe Target MCP服务器工具参考 target-mcp-tools-reference

工具： list_target_activities

列出具有服务器端过滤和排序的Adobe Target活动。

检索分页的活动列表。 所有筛选器都通过Target管理员API在服务器端应用。 服务器每页最多返回200个活动。

返回： JSON对象，带有activities （对象列表包括id、name、state、type、priority、modifiedAt、startsAt、endsAt）和total （总计数，可能会超过返回的页面大小）。

示例提示：“列出按最近修改排序的所有活动A/B测试。”

工具： get_activity

获取有关任何类型活动的详细信息。

检索特定活动的完整配置，自动检测该活动类型。 支持A/B测试、体验定位、Automated Personalization、自动分配、多变量测试和推荐活动。

返回：​完整的活动详细信息，包括元数据（名称、状态、优先级、日期）、体验、位置和选件、目标和量度，以及定位规则。

示例提示：“获取活动12345的详细信息”。

工具： create_ab_activity

创建新的A/B测试活动。

使用指定配置（包括体验、选件和定位）创建新的A/B测试。

返回：​创建的活动对象及其分配的ID。

示例提示：“创建名为‘主页主页主页主页主页主页测试’的A/B测试，该测试包含两个体验，分别测试主页主页主页主页主页上的不同主页图像。”

工具： create_xt_activity

创建新的体验定位(XT)活动。

创建一个XT活动，该活动根据定位规则向不同受众提供不同的体验。

返回：​创建的活动对象及其分配的ID。

示例提示：“创建一个名为‘地域Personalization’的体验定位活动，向来自不同地区的访客显示不同的内容。”

工具： update_activity

更新现有的A/B测试、体验定位或Automated Personalization活动。

使用读 — 修改 — 写模式：获取当前状态，合并更改，验证并发送更新。 支持A/B测试、体验定位和Automated Personalization活动；自动分配、多变量测试和推荐活动均为只读。 A/B测试和体验定位仅支持结构化goal、audience_ids和additional_metrics参数；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主页测试’。”

工具： update_activity_priority

更改活动优先级。

当多个活动针对同一位置时，优先级较高的活动优先。

返回：​更新的活动对象。

示例提示：“将活动12345的优先级设置为100。”

工具： add_activity_variant

向活动添加新体验/变体。

处理所有结构协调，包括创建选项、映射到位置和重新平衡流量。

返回：​更新的活动对象。

示例提示：“使用选件67890向A/B活动12345添加名为‘假日主题’的新变体。”

工具： update_traffic_split

更新变量之间的流量分配。

百分比的总和必须为100。

返回：​更新的活动对象。

示例提示：“将活动12345的流量分摊更改为控制占70%，变体A占30%。”

工具： update_variant_offer

更改特定变体的选件。

适用于基于表单的活动（使用offer_id）和VEC活动（使用modifications）。

返回：​更新的活动对象。

示例提示：“更新活动12345中的‘变体A’体验以使用选件99999。”

工具： remove_activity_variant

从活动中删除体验/变体。

删除体验，清除孤立的选项，并在剩余变体之间平均重新平衡流量。

返回：​更新的活动对象。

示例提示：“从A/B activity 12345中删除‘测试变体’体验”。

工具： 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内容选件。

返回：​创建的选件及其分配的ID。

示例提示：“使用促销横幅创建名为‘夏季促销横幅’的HTML优惠。”

工具： create_target_json_offer

创建新的JSON选件来交付结构化数据。

返回：​创建的选件及其分配的ID。

示例提示：“使用功能切换设置创建一个名为‘功能标志配置’的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

使用定位规则创建新受众。

返回：​创建的受众及其分配的ID。

示例提示：“创建名为‘来自加利福尼亚州的移动访客’的受众，目标为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、自动分配、多变量测试和推荐活动。

返回：​体验级别的量度（访客数、转化率、转化率）、提升度计算、统计置信水平和收入量度（如果已配置）。

示例提示：“给我显示过去30天内活动12345的性能报告。”

工具： get_activity_orders_report

获取任何类型活动的订单/收入报表。

支持A/B测试、体验定位、Automated Personalization、自动分配、多变量测试和推荐活动。

返回：​订单计数、收入和平均订单值（按体验）。

示例提示：“获取活动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租户中的所有响应令牌。

检索所有已配置的响应令牌，包括内置和自定义响应令牌。

无需参数。

返回：​响应令牌对象的JSON数组，状态为name、type和enabled。

示例提示：“列出所有响应令牌”。

工具： create_target_response_token

创建新的自定义响应令牌以在Target响应中收集其他数据。

返回：​创建的响应令牌对象。

示例提示：“创建名为‘campaign_id’的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)。 将list_target_criteria_by_type / get_target_criteria_by_type（或create_target_criteria / update_target_criteria）与criteria_type结合使用，以使用完整、特定于类型的配置。 每个系列的字段要求不同 — 请参阅Adobe 推荐API引用以了解完整的每种类型架构。

返回：​条件对象或带有offset、limit、total和list的分页列表。

示例提示：“列出此帐户中配置的所有推荐标准并总结正在使用的算法类型。”

工具： 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月底的‘背包帐篷’集合。”

工具： list_target_exclusions，get_target_exclusion，create_target_exclusion，update_target_exclusion

排除项会从推荐结果中删除匹配的实体。 排除项适用于整个帐户，并涵盖所有标准和活动。

返回：​排除对象。

示例提示：“当前是否配置了任何帐户范围的排除项，以及它们过滤了哪些内容？”

工具： get_target_entity，search_target_catalog

用于检查推荐产品/内容目录的只读工具。 没有通过MCP服务器为目录实体创建、更新或删除工具。

返回： get_target_entity返回实体的目录属性。 search_target_catalog在entities数组中返回匹配项。 query中的字段名称必须是为该租户配置的真实目录属性。

示例提示：“在目录中搜索库存低于1000的产品。”