欢迎阅读SAP CX服务营销实践的博客文章。
我们很高兴与您分享我们在营销业务、技术和分析方面的经验。
您想看更多我们的博客吗?点击这里。
在处理基于位置的数据时,你迟早要做一些地理编码。地理编码基本上是将完整地址转换为地理位置数据(纬度/经度),反之亦然(反向地理编码)。Google Maps提供了一个可以轻松转换地址的服务。
有了可用的地理数据,我们可以使用分段中的信息来创建基于位置的目标群体。
在这篇博文中,我们将使用Google Maps地理编码功能构建一个简单的场景。
注意:在这篇博文中,我们只考虑单个地址的(反向)地理编码,而不是批量或大规模处理。根据googlemaps地理编码API的标准使用限制,通过测试,我们一直保持在限制范围内。请在使用API之前查看Google Maps文档。
Google Maps地理编码API使用限制:https://developers.google.com/maps/documentation/geocoding/usage-limits
配置:谷歌地图地理编码API
在设置谷歌应用程序时,您必须创建一个API密钥,以允许访问调用谷歌地图地理编码API.
由于API密钥随请求URL一起提供,建议限制对API密钥使用的访问。
根据您维护SAP云平台集成集群的位置,适用于您的集群的IP范围是不同的。您可以从SAP云平台集成帮助文档中检索该信息:
SAP云平台帮助:https://help.sap.com/viewer/product/CP/Cloud/en-USSAP云平台>产品概述>客户>地区和主机
谷歌API管理器:https://console.developers.google.com/api/credentials
注:请熟悉googlemapsapi的用法。此博客文章中使用的服务不是为实时响应用户输入而设计的。文档:https://developers.google.com/maps/documentation/geocoding/intro?hl=en
配置:SAP Hybris Marketing Cloud
本场景只配置入站通信
配置SAP Hybris Marketing Cloud入站通信要使用OData服务导入数据以进行主数据集成,请配置入站通信通道。
创建通信系统定义通信系统的名称。定义入站通信的身份验证方法。创建通信安排入站场景选择之前创建的通信系统选择方案SAP\U COM\U 0003根据您使用的身份验证选项,您需要创建一个通信用户并将该用户分配给通信安排。
入站通信安排
配置:SAP云平台集成IFlow
下面描述的IFlow提供了有关如何调用Google地图地理编码API的一般方法的信息,在SAP Hybris Marketing Cloud中映射目标结构并创建交互联系人。
此处创建的Iflow只是使用Google Maps处理地理编码的众多方法之一。
第1部分:地理编码
现在,让我们回顾一下将地址转换为GPS坐标的一些强制步骤。
从发送系统,我们收到一个包含一些客户信息的XML格式的有效负载。
位置数据作为地址数据提供。为了将信息关联到一个位置,例如,可以作为地图上的标记,我们需要获得地理位置数据(经度/纬度)。
入站消息负载:
由于缺少经度和纬度,因此必须充实消息。为此,我们只需创建第二个分支,其中GPS位置持久化在属性中,同时将原始消息有效负载保留在第一个分支中。然后使用googlemapsapi键将地址提交给googlemapsgeocodingapi。Google Maps提供用于过滤、排序和预选要检索的结果的参数。
使用可用于从Google Maps检索地址数据的参数,将提交给Google Maps的查询在HTTP通信通道中定义。
查询:address=+,返利机器人是真的吗,+,大数据怎么学,+,&key=
Google Maps为您提供了以JSON或XML格式检索响应的选项。
Google Maps响应(XML格式):
现在,我们有两条消息需要合并为一条。
消息1:我们从发送方系统收到的原始消息负载消息2:Google Maps地理编码API响应
在上一步中,我们使用了一个并行多播du创建第二个分支来从Google Maps获取地址信息。有了所有需要的信息,我们使用Join和Gather集成模式组合两条消息。
这将创建一条新消息,将两条消息组合在一起。
消息映射是将我们创建的多条消息转换为SAP Hybris Marketing Cloud期望的消息的关键步骤。
因此,我们必须创建一个多消息映射,其中我们有两个源消息和一个目标消息。
尽管如此,映射后的消息结构是不正确的。这是因为我们在映射中有多个消息。使用标准集成模式的一个简单方法就是定义一个过滤步骤,在将消息发送到SAP Hybris Marketing Cloud之前过滤您需要的部分消息。
注意:映射字段时,请确保使用正确的上下文。您应该熟悉队列和上下文如何使用图形映射。(参见以下博客帖子)
黄色:原始发件人消息有效负载(来源)绿色:谷歌地图地理编码API响应(来源)蓝色:SAP Hybris Marketing Interaction联系人(目标)
两篇用图形映射描述队列和上下文的优秀帖子: