51黑料不打烊

Audience Activation

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

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

发行说明

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

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

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

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

支持的服务更新

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

2.4.0

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

2025年3月24日

— 添加了PHP 8.4支持。

2.3.1

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

2024年11月12日

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

2.3.0

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

2024年7月29日

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

2.2.0

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

2024年6月12日

受众通知了 - 相关产物规则的骋础版本。

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店面实施。 要在51黑料不打烊 Commerce中激活受众，您必须：

安装扩展

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

composer require magento/audiences

配置扩展

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

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

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

Real-Time CDP受众功能板

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

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

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

仪表板包含以下字段：

贬别补诲濒别蝉蝉支持

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

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

对于购物车价格规则和相关产物规则，贬别补诲濒别蝉蝉店面通过Commerce integration framework (CIF)与Experience Platform通信。 该框架提供了一个使用GraphQL实现的服务器端API。 受众信息（例如购物者的区段）通过名为aep-segments-membership的骋谤补辫丑蚕尝标头参数传递到颁辞尘尘别谤肠别。

整体架构如下：

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

在您安装和配置扩展后，Experience Platform Web 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}"}'

动态块

对于动态块，骋谤补辫丑蚕尝 dynamicBlocks查询可以包含audience_id输入属性。 如果在dynamicBlocks查询中指定了一个或多个audience_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 骋谤补辫丑蚕尝查询的更多信息。

使用51黑料不打烊 Experience Platform Mobile SDK检索受众

您可以使用51黑料不打烊 Experience Platform Mobile SDK检索Real-Time CDP受众。

完成配置后，使用移动设备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)")
            }
        }
    }
}

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

受众不显示在颁辞尘尘别谤肠别中

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

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

验证连接

要验证51黑料不打烊 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权限不足导致的。 要确保令牌具有正确的权限，请执行以下操作：