Audience Activation

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使用的扩展相关的功能更改和修复。

2.3.1

[兼容性]{class="badge informative" title="兼容性"}

2024年11月12日

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

2.3.0

[兼容性]{class="badge informative" title="兼容性"}

2024年7月29日

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

2.2.0

[兼容性]{class="badge informative" title="兼容性"}

2024年6月12日

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

2.1.1

[兼容性]{class="badge informative" title="兼容性"}

2024年4月4日

— 添加了对PHP 8.3的支持。

2.2.0-beta1

[兼容性]{class="badge informative" title="兼容性"}

2024年2月16日

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

2.1.0

[兼容性]{class="badge informative" title="兼容性"}

2024年1月24日

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

2.0.1

[兼容性]{class="badge informative" title="兼容性"}

2023年11月16日

— 改进的稳定性。

2.0.0

[兼容性]{class="badge informative" title="兼容性"}

2023年10月10日

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

1.2.0

[兼容性]{class="badge informative" title="兼容性"}

2023年8月15日

— 更新了UI组件版本。

1.1.0

2023年5月30日

[兼容性]{class="badge informative" title="兼容性"}

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

1.0.1

2023年5月11日

[兼容性]{class="badge informative" title="兼容性"}

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

1.0.0

2023年3月31日

[兼容性]{class="badge informative" title="兼容性"}

— 一般可用性版本

实现

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

安装扩展

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

composer require magento/audiences

配置扩展

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

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

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

Real-Time CDP受众功能板

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

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

{width="700" modal="regular"}

仪表板包含以下字段：

Headless支持

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

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

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

整体架构如下：

{width="700" modal="regular"}

在您安装和配置扩展后，Experience PlatformWeb 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输入属性。 如果在dynamicBlocks查询中指定了一个或多个audience_id值，它将返回分配给这些受众的动态块列表。

使用示例

以下查询返回与多个受众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受众。

完成配置后，使用Mobile 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          |

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

生成的令牌权限不足

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