3.2.2定义外部数据源

在本练习中,您将使用Adobe Journey Optimizer创建一个自定义外部数据源。

通过转到Adobe Experience Cloud登录Adobe Journey Optimizer。 单击​ Journey Optimizer

ACOP

您将被重定向到Journey Optimizer中的​ 主页 ​视图。 首先,确保使用正确的沙盒。 要使用的沙盒名为--aepSandboxName--。 然后,您将进入沙盒​ ​主页--aepSandboxName--视图。

ACOP

在左侧菜单中,向下滚动并单击​ 配置。 接下来,单击​ 数据源 ​下的​ 管理 ​按钮。

演示

您随后将看到​ 数据源 ​列表。
单击​ 创建数据Source ​以开始添加数据源。

演示

您将会看到一个空的数据源弹出窗口。

演示

在开始配置之前,您需要具有​ 打开天气地图 ​服务的帐户。 按照以下步骤创建帐户并获取API密钥。

转到https://openweathermap.org/。 在主页上单击​ 登录

天气图

单击​ 创建帐户

天气图

请填写详细信息。 单击​ 创建帐户

天气图

然后,您将被重定向到帐户页面。

天气图

在菜单中,单击​ API密钥 ​以检索API密钥,您需要设置该密钥自定义外部数据源。

天气图

API密钥 ​类似于: b2c4c36b6bb59c3458d6686b05311dc3

您可以在​ 此处 ​找到​ 当前天气 ​的API文档

对于此用例,您将使用按城市名称​ ​内置API请求,根据客户所在的城市实施与开放天气图的连接。

天气图

返回​ Adobe Journey Optimizer,进入您的空​ 外部数据Source ​弹出窗口。

演示

作为数据源的名称,请使用--aepUserLdap--WeatherApi

将描述设置为: Access to the Open Weather Map

开放天气地图API的URL为: http://api.openweathermap.org/data/2.5/weather?units=metric

演示

接下来,您需要选择要使用的身份验证。

使用以下变量:

字段
类型
API密钥
名称
APPID
您的API密钥
位置
查询参数

演示

最后,您需要定义​ FieldGroup,这基本上是您将发送到天气API的请求。 在我们的示例中,我们想使用城市的名称来请求该城市的当前天气。

演示

根据天气API文档,您需要发送参数q=City

演示

为了匹配预期的API请求,请按如下方式配置FieldGroup:

IMPORTANT
字段组名称必须是唯一的,请使用此命名约定: --aepUserLdap--WeatherByCity

演示

对于响应有效负载,您需要粘贴天气API将发送的响应示例。

您可以在API文档页面此处的​ JSON ​主题下找到预期的API JSON响应。

演示

或者,您可以从此处复制JSON响应:

{
   "coord": {
      "lon": 7.367,
      "lat": 45.133
   },
   "weather": [
      {
         "id": 501,
         "main": "Rain",
         "description": "moderate rain",
         "icon": "10d"
      }
   ],
   "base": "stations",
   "main": {
      "temp": 284.2,
      "feels_like": 282.93,
      "temp_min": 283.06,
      "temp_max": 286.82,
      "pressure": 1021,
      "humidity": 60,
      "sea_level": 1021,
      "grnd_level": 910
   },
   "visibility": 10000,
   "wind": {
      "speed": 4.09,
      "deg": 121,
      "gust": 3.47
   },
   "rain": {
      "1h": 2.73
   },
   "clouds": {
      "all": 83
   },
   "dt": 1726660758,
   "sys": {
      "type": 1,
      "id": 6736,
      "country": "IT",
      "sunrise": 1726636384,
      "sunset": 1726680975
   },
   "timezone": 7200,
   "id": 3165523,
   "name": "Province of Turin",
   "cod": 200
}

将上述JSON响应复制到剪贴板,然后转到自定义数据源配置屏幕。

单击​ 编辑有效负载 ​图标。

演示

您将看到一个弹出窗口,您现在必须粘贴上述JSON响应。

演示

粘贴您的JSON响应,之后您将看到此内容。 单击​ 保存

演示

您的自定义数据源配置现已完成。 向上滚动并单击​ 保存

演示

您的数据源现已创建成功,并且是​ 数据源 ​列表的一部分。

演示

后续步骤

转到3.2.3定义自定义操作

返回Adobe Journey Optimizer:外部数据源和自定义操作

返回所有模块

recommendation-more-help
4bbf020c-24db-4a43-b239-88fab142f02d