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_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测试。

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

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

工具： create_xt_activity

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

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

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

示例提示：“创建一个名为‘地域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主页测试’。”

工具： 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_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租户中的所有响应令牌。

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

无需参数。

返回：​响应令牌对象的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对象列出了可用的模板和资源。

示例提示：“哪些模板可用于创建活动？”