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客户端ID。 这可以在Adobe Developer Console的凭据详细信息部分找到。
    客户端密钥 输入您的Adobe客户端密钥。 这可以在Adobe Developer Console的凭据详细信息部分找到。
    技术帐户ID 输入您的Adobe技术帐户ID。 这可以在Adobe Developer Console的凭据详细信息部分找到。
    组织ID 输入您的Adobe组织ID。 这可以在Adobe Developer Console的凭据详细信息部分找到。
    Tenant

    要找到您的租户,请登录到Adobe Experience Cloud,打开Target,然后单击Target信息卡。 使用URL子域中所述的租户ID值。

    例如,如果您在登录到Adobe Target时的URL是<https://mycompany.experiencecloud.adobe.com/...>,则您的租户ID是“mycompany”。

    元范围 输入ent_marketing_sdk
    私钥

    输入在Adobe Developer Console中创建凭据时生成的私钥。

    要提取您的私钥或证书,请执行以下操作:

    1. 单击 提取

    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文档中的创建新的推荐选件

  • 选件JSON

    继续优惠字段

  • 选件内容

    继续优惠字段

  • 环境

    有关字段的详细信息,请参阅Adobe Target API文档中的创建环境

  • 受众

    有关字段的详细信息,请参阅Adobe Target API文档中的创建受众

  • AB活动

    有关字段的详细信息,请参阅Adobe Target API文档中的创建AB活动

  • XT活动

    继续XT活动字段

  • AP活动

    有关字段的详细信息,请参阅Adobe Target API文档中的创建AP活动

  • 响应令牌

    有关字段的详细信息,请参阅Adobe Target API文档中的创建响应令牌

XT活动字段
名称
输入或映射此活动的名称。 名称不能超过250个字符。
Options

对于要添加到活动的每个选项,单击 添加项 并填写以下字段:

  • 选项本地ID

    输入或映射用于跨API请求跟踪选项的字符串。

  • 名称

    输入或映射选项的名称。 名称不能超过250个字符。

  • 选件ID

  • 选择或映射与选项关联的选件。

位置

对于要添加到活动的每个Mbox,单击 添加项 并填写以下字段:

  • 受众ID

    对于要添加到Mbox的每个受众,单击 添加项 并选择受众ID。

  • 位置本地ID

    输入或映射用于跨API请求跟踪位置的字符串。

  • 名称

    输入或映射“位置”的名称。 名称不能超过250个字符。

体验

页面上提供内容选件的位置的列表。 位置包含以下内容:

  • 体验本地ID

    输入或映射体验的ID

  • 名称

    输入或映射体验的名称

  • Audience IDs

    对于要查看体验的每个受众,单击 添加项 并输入受众ID。

  • 访客百分比

    输入或映射分配给体验的访客百分比

量度
第三方ID
输入或映射ID以标识此活动。 您可以选择此ID。 此ID不得与其他活动相同,并且不得超过250个字符。
开始于
YYYY-MM-DD hh:mm:ss.z格式输入或映射启动活动的日期和时间。
结束于
YYYY-MM-DD hh:mm:ss.z格式输入或映射结束活动的日期和时间。
状态

输入或映射活动的状态。

  • 已批准

  • 已停用

  • 已暂停

  • 已保存

  • 已删除

优先级
输入一个用于定义活动优先级的数字。 数字越大,优先级越高。 此值必须介于0和999之间。 默认值为5。
自动分配流量

启用此选项以自动分配流量。 自动分配会向更成功的体验发送更多流量。

选择或映射用于判断哪些体验更成功的评估标准。

Workspace
输入或映射与活动关联的工作区
属性ID
对于要添加到活动的每个属性,单击 添加项 并选择或映射属性的ID。
报表受众

对于要添加到活动的每个报表受众,单击添加项目并输入以下信息:

  • 报告受众本地ID

    输入或映射用于跨API请求跟踪报表受众的字符串。

  • 受众ID

    输入或映射要在报表中使用的区段

  • 度量本地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字段结合使用可将响应分页。

例如,要查看响应的第三页,当每个页面有十个响应时,请将Offset设置为20,将Maximum number of returned结果设置为10。

限制

输入或映射您希望模块在每个方案执行周期内返回的最大记录数。 将此字段与Offset字段结合使用可将响应分页。

例如,要查看响应的第三页,当每个页面有十个响应时,请将Offset设置为20,将Maximum number of returned结果设置为10。

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