文档 Commerce 客户管理

[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

Audience Activation

Last update: Thu Oct 09 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
客户
配置
个性化

创建对象：

有经验的
管理员
用户

Audience Activation扩展允许您在Adobe Commerce中激活Real-Time CDP受众，以便在购物车中创建独特优惠。这些优惠和奖励包括常见的电子商务促销技术，如 购买2 get 1 free、面向该客户的英雄横幅，以及通过各种优惠修改的产品定价。在Real-Time CDP中构建的受众基于来自各种企业系统的数据，例如企业资源规划(ERP)、客户关系管理(CRM)、销售点和营销系统。由于客户区段信息会不断刷新，因此在您商店中购物时，客户可能会与区段相关联或取消关联。

您可以在Luma店面或Headless店面中激活受众。在Luma店面中，受众信息（区段成员资格）存储在Commerce端的Cookie中。在Headless店面中，受众信息作为名为aep-segments-membership的参数传递到GraphQL API标头。

发行说明

此部分包含有关Audience Activation扩展更新的信息，其中包括：

— 新功能
— 修复和改进
— 已知问题

请参阅即将发布的版本，了解版本计划和支持。

请参阅开发人员文档，以了解产品兼容性。

支持的服务更新

以下发行说明介绍了与Audience Activation使用的扩展相关的功能更改和修复。

支持的服务更新

2023年8月15日

— 更新了Real-Time CDP受众仪表板以简化筛选。

2023年6月27日

— 在magento/module-data-services-graphql包中添加了对PHP 8.2的支持。

2023年5月30日

— 更新了Real-Time CDP受众功能板，使其包含对Adobe Commerce实例中的活动受众进行排序、搜索和过滤的功能。

2.4.0

[兼容性]{class="badge informative" title="兼容性"} Adobe Commerce版本2.4.4及更高版本

2025年3月24日

— 添加了PHP 8.4支持。

2.3.1

[兼容性]{class="badge informative" title="兼容性"} Adobe Commerce版本2.4.4及更高版本

2024年11月12日

— 修复了在筛选可供选择的Real-Time CDP受众时出现的问题。

2.3.0

[兼容性]{class="badge informative" title="兼容性"} Adobe Commerce版本2.4.4及更高版本

2024年7月29日

— 添加了命令行语法，因此您可以测试凭据以确定是否需要更新凭据以从Adobe Experience Platform提取受众数据。

2.2.0

[兼容性]{class="badge informative" title="兼容性"} Adobe Commerce版本2.4.4及更高版本

2024年6月12日

受众通知了 - 相关产品规则的GA版本。

2.1.1

[兼容性]{class="badge informative" title="兼容性"} Adobe Commerce版本2.4.4及更高版本

2024年4月4日

— 添加了对PHP 8.3的支持。

2.2.0-beta1

[兼容性]{class="badge informative" title="兼容性"} Adobe Commerce版本2.4.4及更高版本

2024年2月16日

— 如果您正在参与测试版，请确保您的composer.json文件在根级别具有以下内容： "minimum-stability": "beta"。
- (Beta)已添加根据受众信息创建相关产品规则的功能。

2.1.0

[兼容性]{class="badge informative" title="兼容性"} Adobe Commerce版本2.4.4及更高版本

2024年1月24日

— 更新了Real-Time CDP受众仪表板以包含包含受众的网站，并指定将哪些动态块和购物车价格规则配置为使用这些受众。

2.0.1

[兼容性]{class="badge informative" title="兼容性"} Adobe Commerce版本2.4.4及更高版本

2023年11月16日

— 改进的稳定性。

2.0.0

[兼容性]{class="badge informative" title="兼容性"} Adobe Commerce版本2.4.4及更高版本

2023年10月10日

— 在您配置 Audience Activation扩展时添加了对OAuth 2.0的支持。
— 改进的稳定性。

1.2.0

[兼容性]{class="badge informative" title="兼容性"} Adobe Commerce版本2.4.4及更高版本

2023年8月15日

— 更新了UI组件版本。

1.1.0

2023年5月30日

[兼容性]{class="badge informative" title="兼容性"} Adobe Commerce版本2.4.4及更高版本

— 在Headless店面中添加了动态块的支持。

1.0.1

2023年5月11日

[兼容性]{class="badge informative" title="兼容性"} Adobe Commerce版本2.4.4及更高版本

— 修复了动态块或购物车价格规则未应用于店面的问题。
— 修复了在商户尝试创建或更新动态块时，未配置的Audience Activation扩展安装导致错误的问题。

1.0.0

2023年3月31日

[兼容性]{class="badge informative" title="兼容性"} Adobe Commerce版本2.4.4及更高版本

— 一般可用性版本

实现

以下任务适用于Luma和headless店面实施。要在Adobe Commerce中激活受众，您必须：

安装Adobe Commerce版本2.4.4或更高版本
在Real-Time CDP中将激活Adobe Commerce作为目标
在管理员中安装 Audience Activation扩展
在管理员中配置 Audience Activation扩展

安装扩展

从Audience Activationmarketplace安装扩展，或运行以下命令：

composer require magento/audiences

配置扩展

安装Audience Activation扩展后，您必须登录Commerce管理员并完成以下操作：

在 管理员 侧边栏上，转到 System > Services>Commerce Services Connector。
登录到您的Adobe帐户并选择您的组织ID。
在 管理员 侧边栏上，转到 System > Services>Data Connection。

在 Datastream ID 字段中，将您在激活 Adobe Commerce时创建的数据流的ID粘贴为Real-Time CDP中的目标。

此数据流将数据从您的Commerce网站发送到Real-Time CDP，以确定购物者是否属于受众。如果您尚未创建数据流，请在Experience Platform中创建数据流，将其添加到Real-Time CDP中的Commerce目标以及管理员中的 Data Connection扩展。

note note
NOTE
指定数据流ID时，您可以将其关联到扩展中的特定网站Data Connection。如果您的Commerce商店有多个网站，请在Real-Time CDP中为每个网站创建一个目标，并为每个网站使用不同的数据流ID。

在 管理员 侧边栏上，转到 Stores > Settings>Configuration。
展开 Services 并选择 Data Connection。
添加服务帐户和凭据详细信息。

在Commerce中的何处使用Real-Time CDP受众

启用Audience Activation扩展后，您可以：

TIP

有关如何将Commerce数据导出到Real-Time CDP、构建受众然后将该受众激活到Commerce的完整端到端用例，请参阅使用 Commerce 事件数据在Real-Time CDP中创建受众。

Real-Time CDP受众功能板

您可以使用Real-Time CDP Audiences仪表板在Adobe Commerce实例中查看可用于个性化的所有活动受众。

要访问 Real-Time CDP受众 仪表板，请转到 管理员 侧栏，然后转到 Customers > Real-time CDP Audience。

Real-Time CDP受众信息板 {width="700" modal="regular"}

仪表板包含以下字段：

列

描述

Hide filters

可让您显示或隐藏可应用于功能板的任何筛选器。目前，您可以应用的唯一过滤器是Last updated。通过此过滤器，您可以根据受众的上次更新时间为其选择日期范围。

Search

允许您在Commerce实例中搜索活动受众。

Name

在Real-Time CDP中提供给受众的名称。

Origin

指示受众的来源，如Experience Platform。

Websites

指示将哪些网站配置为使用受众。

Dynamic Blocks

指示将哪些动态块配置为使用受众。

Cart Price Rules

指示将哪些购物车价格规则配置为使用受众。

Related Product Rules

指示将哪些相关产品规则配置为使用受众。

Last updated

指示在Real-Time CDP中修改受众的时间。

Sync now

从Real-Time CDP中检索新的或更新受众。

Customize table

允许您显示或隐藏Origin、Websites、Dynamic Blocks、Cart Price Rules和Last updated列。

Headless支持

您可以在headless Adobe Commerce实例(如AEM和PWA)中激活受众，以根据受众显示购物车价格规则、相关产品规则或动态块。

购物车价格规则和相关产品规则

对于购物车价格规则和相关产品规则，Headless店面通过Commerce integration framework (CIF)与Experience Platform通信。该框架提供了一个使用GraphQL实现的服务器端API。受众信息（例如购物者的区段）通过名为aep-segments-membership的GraphQL标头参数传递到Commerce。

整体架构如下：

将数据从Headless Storefront发送到后端 {width="700" modal="regular"}

在您安装和配置扩展后，Experience Platform Web SDK将以区段成员资格的形式包含受众信息。

要从SDK捕获这些区段成员资格，请参阅此代码片段。

在检索区段后，您可以在GraphQL标题中将这些区段传递到Commerce。例如：

curl 'http://magento.config/graphql' -H 'Authorization: Bearer abc123' -H 'aep-segments-membership: urlencoded_list_of_segments' -H 'Content-Type: application/json' --data-binary '{"query":"query {\ncustomer {\nfirstname\nlastname\nemail\n}\n}"}'

动态块

对于动态块，GraphQL dynamicBlocks查询可以包含audience_id输入属性。如果在audience_id查询中指定了一个或多个dynamicBlocks值，它将返回分配给这些受众的动态块列表。

使用示例

以下查询返回与多个受众ID关联的所有动态块。

请求：

{
  dynamicBlocks(input:
  {
    type: SPECIFIED
    audience_id: {
      in: [
        "cd29a789-9be8-40ad-a1ef-640c33b3742e"
        "92c3e14d-c72b-40d0-96b7-b96801dcc135"
      ]
    }
  })
  {
    items {
      uid
      audience_id
      content {
        html
      }
    }
    page_info {
      current_page
      page_size
      total_pages
    }
    total_count
  }
}

响应：

{
  "data": {
    "dynamicBlocks": {
      "items": [
        {
          "uid": "MQ==",
          "audience_id": [
            "cd29a789-9be8-40ad-a1ef-640c33b3742e"
          ],
          "content": {
            "html": "<h2><strong>SAVE 20%</strong></h2>\r\n<p>(some restrictions apply)</p>\r\n<p>&nbsp;</p>"
          }
        },
        {
          "uid": "Mg==",
          "audience_id": [
            "cd29a789-9be8-40ad-a1ef-640c33b3742e",
            "92c3e14d-c72b-40d0-96b7-b96801dcc135"
          ],
          "content": {
            "html": "<p><img src=\"{{media url=&quot;wysiwyg/save20.png&quot;}}\" alt=\"save 20% red\"></p>"
          }
        }
      ],
      "page_info": {
        "current_page": 1,
        "page_size": 20,
        "total_pages": 1
      },
      "total_count": 2
    }
  }
}

在dynamicBlocks开发人员文档中了解有关 GraphQL查询的更多信息。

使用Adobe Experience Platform Mobile SDK检索受众

您可以使用Adobe Experience Platform Mobile SDK检索Real-Time CDP受众。

安装 Audience Activation扩展。
为您的移动设备Commerce站点安装和配置SDK。

IMPORTANT

适用于iOS的Adobe Experience Platform Mobile SDK支持iOS 11或更高版本。

完成配置后，使用移动设备SDK操作检索受众数据。例如：

Edge.sendEvent(experienceEvent: experienceEvent) { (handles: [EdgeEventHandle]) in
    for handle in handles {
        if handle.type == "activation:pull" {
        let payloadItems = handle.payload ?? []
            for payloadItem in payloadItems {
                if let segments = payloadItem["segments"] as? any Sequence {
                    var segmentsArr = [Any]()
                    for segment in segments {
                        let response = segment as AnyObject?
                        segmentsArr.append(response?.object(forKey: "id")! ?? "")
                    }
                    print("Saving segments ->  \(segments)")
                    storage.set(segmentsArr, forKey: "segments")
                    print("End saving segments")
                }

                // Show segments
                let rSegments = storage.object(forKey: "segments") ?? nil;
                print("Retrieving segments -> \(rSegments)")
            }
        }
    }
}

检索数据后，您可以在Commerce应用程序中创建受众通知的购物车价格规则、动态块和相关的产品规则。

受众不显示在Commerce中

如果Real-Time CDP受众未显示在Commerce中，原因可能是：

连接无效
在 数据连接 配置页面中选择的身份验证类型不正确
生成的令牌权限不足

以下部分介绍了如何解决这些问题。

验证连接

要验证Adobe Experience Platform的凭据和响应，请运行以下命令：

bin/magento audiences:config:status

此命令返回连接状态。添加-v标记以提供额外的详细程度：

./bin/magento audiences:config:status -v

例如：

+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| Client ID                        | Client secret | Technical account ID                        | Technical account email                                 | Sandbox name |
+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| 1234bd57fac8497d8933327c535347d8 | *****         | 12341E116638D6B00A495C80@techacct.adobe.com | 12345-b95b-4894-a41c-a4130d26bd80@techacct.adobe.com | dev          |

配置中选择的身份验证类型不正确

打开您的Commerce实例。
在 管理员 侧边栏上，转到 Stores > Settings>Configuration。
展开 Services 并选择 Data Connection。
确保您在 Authentication Type 字段中指定的服务器到服务器授权方法正确。 Adobe建议使用 OAuth。已弃用JWT。了解详情。

生成的令牌权限不足

此问题可能是由于生成的令牌的API权限不足导致的。要确保令牌具有正确的权限，请执行以下操作：

确定贵组织中Adobe Experience Platform的系统管理员。
查找您将使用的项目和凭据。
识别技术帐户电子邮件，例如： fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com。
让系统管理员启动Adobe Experience Platform并转到 Permissions -> Users -> API credentials。
使用上面提供的技术帐户电子邮件，搜索要修改的凭据。
打开凭据，然后选择 Roles -> Add roles。
添加包含 Manage destinations 权限的角色。
单击 Save。
在控制台中重新生成访问令牌。
使用Target连接API验证令牌是否提供了有效的响应。

recommendation-more-help

09e7db7e-4210-474a-8bbf-c72a92c7537c