Audience Activation

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

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

发行说明

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

新建 — 新增功能
修复 — 修复和改进功能
错误 — 已知问题

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

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

支持的服务更新

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

支持的服务更新

2023年8月15日

修复 — 已更新 Real-Time CDP Audiences功能板 以简化筛选。

2023年6月27日

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

2023年5月30日

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

2.2.0-beta1

兼容性
兼容性

2024年2月16日

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

2.1.0

兼容性
兼容性

2024年1月24日

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

2.0.1

兼容性
兼容性

2023年11月16

修复 — 提高了稳定性。

2.0.0

兼容性
兼容性

2023年10月10日

新建 — 当您使用OAuth 2.0时 配置 Audience Activation扩展。
修复 — 提高了稳定性。

1.2.0

兼容性
兼容性

2023年8月15日

修复 — 更新了UI组件版本。

1.1.0

2023年5月30日

兼容性
兼容性

新建 — 添加了对 动态块 无头店面。

1.0.1

2023年5月11日

兼容性
兼容性

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

1.0.0

2023年3月31日

兼容性
兼容性

新建 — 正式发布版本

实现

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

  • 安装Adobe Commerce版本2.4.4或更高版本
  • 激活 Adobe Commerce作为Real-Time CDP中的目标
  • 安装 该 Audience Activation Admin中的扩展
  • 配置 该 Audience Activation Admin中的扩展

安装扩展

安装 Audience Activation 扩展来自 marketplace,或运行以下命令:

composer require magento/audiences

配置扩展

安装之后 Audience Activation 扩展上,您必须登录Commerce管理员并完成以下操作:

  1. 管理员 侧栏,转到 System > Services>Commerce Services Connector.

  2. 登录 到您的Adobe帐户,然后选择您的组织ID。

  3. 管理员 侧栏,转到 System > Services>Data Connection.

  4. Datastream ID 字段中,粘贴您创建的数据流的ID 已激活 Adobe Commerce作为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。
  5. 管理员 侧栏,转到 Stores > Settings>Configuration.

  6. 展开 Services 并选择 Data Connection.

  7. 添加 服务帐户和凭据详细信息。

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

使用 Audience Activation 扩展已启用,您可以:

Real-Time CDP受众功能板

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

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

w-700 modal-image
Real-Time CDP受众功能板

仪表板包含以下字段:

描述
Hide filters
可让您显示或隐藏可应用于功能板的任何筛选器。 目前,您可以应用的唯一过滤器是 Last updated. 通过此过滤器,您可以根据受众的上次更新时间为其选择日期范围。
Search
允许您在Commerce实例中搜索活动受众。
Name
在Real-Time CDP中提供给受众的名称。
Origin
指示受众的来源,如 Experience Platform.
Websites
指示将哪些网站配置为使用受众。
Dynamic Blocks
指示将哪些动态块配置为使用受众。
Cart Price Rules
指示将哪些购物车价格规则配置为使用受众。
Last updated
指示在Real-Time CDP中修改受众的时间。
Sync now
从Real-Time CDP中检索新的或更新受众。
Customize table
可让您显示或隐藏 OriginWebsitesDynamic BlocksCart Price Rules、和 Last updated 列。

Headless支持

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

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

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

整体架构如下:

w-700 modal-image
将数据从Headless店面发送到后端

在您之后 安装配置 在扩展中,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 输入属性。 如果指定一个或多个 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受众之前,您必须 为您的移动Commerce网站安装和配置SDK.

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

完成配置后,使用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中

如果Commerce中未显示Real-Time CDP受众,原因可能是:

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

以下两部分介绍了如何对这两种情况均进行故障排除。

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

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

生成的令牌权限不足

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

  1. 确定贵组织中Adobe Experience Platform的系统管理员。
  2. 查找您将使用的项目和凭据。
  3. 识别技术帐户电子邮件,例如: fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com.
  4. 让系统管理员启动Adobe Experience Platform并转到 Permissions -> Users -> API credentials.
  5. 使用上面提供的技术帐户电子邮件,搜索要修改的凭据。
  6. 打开凭据,然后选择 Roles -> Add roles.
  7. 添加 全部生产访问权限.
  8. 单击 Save.
  9. 重新生成 控制台中的访问令牌。
  10. 使用验证令牌是否提供有效响应 Target连接API.
recommendation-more-help
09e7db7e-4210-474a-8bbf-c72a92c7537c