IBM通用行为交换目的地


IBM的普遍行为交换(UBX)是一个API,允许用户在IBM解决方案和应用程序中共享客户交互,行为和目标受众 - 包括沃森的营销组合—无需定制软件集成。实际上,UBX是IBM生态系统的“部分”。一旦数据被路由到IBM,您就可以将其发送到UBX投资组合中的任何目的地。

注意:IBM UBX目前处于测试阶段,该文档最后一次更新是在2018年5月7日。这意味着可能还有一些bug需要我们解决,我们很高兴听到你们的想法。如果您有兴趣加入或有任何反馈,以帮助我们改进IBM UBX目的地及其文档,让我们知道!!

入门

注意:要使UBX中的段启用,请在UBX仪表板中导航到“端点”,选择“注册新终端点”,然后选择“段”。添加了段端点后,联系分部支持使用您的新终点的“端点认证密钥”,有助于激活您的新端点。请注意,在启用段UI *中的目的地之前,UBX中的端点将无法接收段数据*,并且*从Segment的支持团队中的端点激活端点。

在开始之前,请确保IBM UBX支持您选择实现的源类型和连接模式。您可以了解更多信息这里的连接模式

网络 移动的 服务器
设备模式
☁️云模式
  1. 从段Web应用程序中,点击目录
  2. 在目录中搜索“IBM UBX”,选择它,并选择将目标连接到哪个源。
  3. 在段设置UI中输入UBX API URL和Publisher的端点身份验证密钥。在设置UBX帐户后,您应该很快收到了一个带有此URL的电子邮件。如果您无法找到URL,请联系UBX支持(URL也被称为“基本URL”IBM UBX文档)。要找到端点身份验证密钥,请导航到UBX中的“端点”选项卡,然后向最右边查找3个垂直点。单击它们并选择“端点详细信息”。
  4. 在UBX仪表板中注册和配置段端点,以便访问相应的端点身份验证密钥。通过导航到“端点”执行此操作,然后“注册新终端点”并选择“段”。然后单击“寄存器”继续。

  5. 一旦注册,新端点的状态将在“端点”选项卡中保持“Pending”,直到它被激活。要激活一个端点,请在邮件中包含您的UBX帐户的API URL和您的端点认证密钥,以使用我们的分段技术支持的形式

  6. 段将在24小时内激活您的端点,此时其状态将更新为UBX仪表板中的“活动”。现在,您可以再次抓取终端身份验证密钥并将其粘贴到段UI中的UBX设置中。

您可以了解有关在UBX中定义和激活应用程序的更多信息在他们的文档中

一般追踪的建议

我们鼓励客户审查manbetx客户端应用下载UBX的动态事件库密切熟悉UBX的被测的事件和属性。许多UBX消费者只接受特定事件;同样,当特定事件包括特定属性时,许多消费者函数最佳。虽然段提供强大的开箱映射(下面记录),但我们仍然建议密切地审查动态事件库,以确保您发送事件和属性,使您能够充分利用UBX消费者。

页面调用将向UBX发送“页面视图事件”(代码IBMPageView.)。以下映射可能适用:

部分财产 UBX属性名称
的名字 Siteid.
_**注:**和' track '事件一样,用户发送的所有属性没有被映射到上面,将作为属性发送到UBX。要发送一个没有映射到上面的UBX规范的属性,只需直接将段属性名设置为UBX属性代码(例如:“pageID ')。_请记住,您可以在[dynamic event library](https://ubx-pilot.ibmmarketingcloud.com/#/taxonomy)中找到ubx特有的事件和属性代码。Track Segment与UBX的集成支持所有公共识别UBX事件类型。但是要注意,UBX事件目的地将只接收它们订阅的事件。若要从片段发布者处订阅UBX目的地的事件,请导航到“事件”选项卡并选择“订阅事件”。请确保您将UBX事件订阅者端点订阅到您希望它们从分段发布者处消费的事件。请注意,虽然Segment支持所有UBX规范的事件,但我们已经将以下段规范的事件及其属性映射到它们的UBX对等物:###事件映射#### Mobile events
分部事件名称 UBX事件代码
应用程序背景 AppsessionClose.
申请已打开 Appsessionopen.
安装应用程序 oppinstalled.
应用程序卸载 appuninstalled.
申请崩溃了 appcrashed.
我们此时没有定义任何特定的移动属性映射,因为段的规格和UBX的规范不共享密切相关的移动属性。注意,您仍然可以通过[UBX的动态事件库](https://ubx-pilot.ibmmarketingcloud.com/#/taxonomy)中定义的任何属性代码传递,并且段将在下游传递这些值。####电子商务事件
分部事件名称 UBX事件代码
加产品 Cartadd.
订单完成 ibmcartPurchase
产品被 ibmproductView
产品已删除 弹药枪
产品搜索 ibmsearchedSite
产品审查了 WrotEreview.
属性
段属性名称 UBX属性名称
ORDER_ID. orderid.
全部的 合计订单
ordertax.
折扣 orderdiscount.
优惠券 ORDERPROMO.
产品 产品列表
cart_id orderid.
product_id ProductId.
的名字 productName
价格 基本价格
URL. productURL
image_url imageURL
review_body 审查
####视频事件
分部事件名称 UBX事件代码
视频内容已完成 ibmelementvideocompleted
视频播放开始 ibmelementVideoLaunched
视频播放暂停 ibmelmentvideopaused
视频播放恢复 ibmelmentvideoplayed
属性
段属性名称 UBX属性名称
位置 videotimestamp.
总长度 录像机长度
####电子邮件事件
分部事件名称 UBX事件代码
电子邮件反弹 emailBounce
电子邮件链接点击 电子邮件点击
电子邮件已打开 EmaidOpen
取消订阅 emailOptOut
属性
段属性名称 UBX属性名称
电子邮件主题 主题行
list_id. messagegroupid.
list_name messageGroupName
link_url. Clickull.
_**注**:要发送一个UBX事件或属性,没有映射上面,简单地设置段事件或属性名,直接UBX指定的事件或属性代码(例如:“opptyQualified”)。_请记住,您可以在[dynamic event library](https://ubx-pilot.ibmmarketingcloud.com/#/taxonomy)中找到ubx特有的事件和属性代码。###属性映射段还将一些属性从上下文对象映射到它们的等效UBX属性。注意,UBX只支持几种数据类型- ' string ', ' number ', ' boolean '和' date '。Segment将自动丢弃这里没有提到的任何类型的属性,但object除外,我们将尝试对其进行stringify。如果不能,预计将看到' [object object] '作为UBX中的值出现。
部分财产 UBX属性名称
context.device.type 设备类型
context.ip. IP.
context.location.latte 纬度
context.locale. 地区
context.Location.City. 位置
context.location.country. locationCountry
context.Location.Longitude. 经度
Context.Device.Manufacturer. 制造商
context.campaign.medium. marketingSource
context.campaign.source. mediaSource
context.device.model. 型号名称
context.os.name 操作系统
Context.UserAgent. 平台
context.os.version VERSESOS.
(context.screen.width)*(context.screen.height) 解析度
###特定于集成的选项映射段将以下集成特定选项映射到UBX:
集成['IBM-UBX']。频道 渠道
集成['IBM-UBX']。子信道 attributes.subchannel.
集成的ibm-ubx .contactConsent attributes.contactConsent
包含所有三个特定于集成的选项的事件可能看起来像这样:track('Order Completed' {// properties}, {integrations: {'ibm-ubx': {channel: 'crm', subChannel: 'chat', contactConsent: 'email,opt-in'}}})- ' channel ': Segment first检查这个值是否在特定于集成的选项中定义;如果没有,我们发现“analytics-android”或“analytics-ios”库,“channel”设置为“mobile”;对于所有其他图书馆,“频道”设置为“网络”。—“subChannel”:该值不被附加到传出的有效负载上,除非用户明确定义。—“ContactConsent”:除非用户明确定义,该值不会被附加到发送的有效载荷中。传递给Segment的值必须是' channel, subscritionoption '格式。目前,唯一可接受的渠道是“电子邮件”和“短信”,唯一可接受的订阅选项是“选择加入”和“选择退出”。的更多信息,请参考IBM UBX的文档的子通道(在这里)(https://www.ibm.com/support/knowledgecenter/SS9JVY/UBX/Event_taxonomy_ubx/Best_practice_event_attributes.html)(*最佳实践事件属性*文章)和“通道”(在这里)(https://www.ibm.com/support/knowledgecenter/SS9JVY/UBX/Events_ubx/Event_publication.html)。 Note that recommended values for these fields is often determined by the downstream tools connected to UBX (e.g. Watson Customer Engagement tools). ## Troubleshooting ### Not seeing any data from Segment appear in UBX - Check to ensure your Segment publisher endpoint is "Active". If not, see [Getting Started](#getting-started) above. - Ensure you've subscribed your UBX destinations to the appropriate events. ## FAQ Segment does not auto-generate events other than an initial `page` call when using our Analytics.js library and mobile lifecycle events when mobile lifecycle tracking is enabled using Segment's Android or iOS library. This means some events supported and in some cases expected by downstream UBX destinations - including *abandonment events* - must be derived by the customer. One approach would be to integrate with a marketing tool such as [Braze](//www.asianminres.com/docs/connections/destinations/catalog/braze/) or [Bronto](//www.asianminres.com/docs/connections/destinations/catalog/bronto/), in which you can [set up rules that generate abandonment events](//www.asianminres.com/docs/guides/destinations/how-do-i-automate-multi-channel-re-engagement-campaigns/#1st-line-of-defense-the-push-notification), which are then be sent back through Segment and downstream to UBX. Another approach may be to schedule a cron job in your database that checks for users who have triggered a `Product Added` event, but who never went on to trigger an `Order Completed` event. In this case, one can logically deduce that the user abandoned his cart, hence you should trigger a server-side Segment event based on this rule, which Segment will process and pass downstream to UBX. Segment's integration with UBX supports the following UBX abandonment events: - ibmabandonedConversion - ibmbrowseAbandonment - ibmbrowseAbandonmentItem - ibmcartAbandonment - ibmcartAbandonmentItem You can find more information about these events in [UBX's Event Taxonomy](https://ubx-pilot.ibmmarketingcloud.com/#/taxonomy).

个人

您可以发送使用的计算特征和受众使用细分人格到达这个目的地用户属性。要了解更多关于人物角色的信息,请联系我们演示

对于用户属性目的地,一个确认调用被发送到目的地,针对正在添加和删除的每个用户。属性名称是受众名称的Snake_cased版本,具有真正/假值以指示成员资格。例如,当用户首先在过去30天内完成订单时,PersonAs会向属性发送标识呼叫order_completed_last_30days:真。当用户不再满足这种情况时(例如,自上次订单以来已经超过30天),Personas将该值设置为错误的

当您第一次创建受众时,Personas为受众中的每个用户发送一个识别呼叫。之后的用户同步只会向自上次同步后成员发生变化的用户发送更新。

设置

段允许您从段应用程序更改这些目标设置,而无需触摸任何代码。

API URL.

在此输入您的UBX帐户的基本URL端点。在设置UBX帐户后,可以在您从UBX收到的电子邮件中找到。它避开了格式https:// <子域名> .ubx.ibmmarketing.cloud / <路径>

身份验证键

您可以通过查看UBX中的端点详细信息来找到终点的授权密钥。它应该看起来像eff08b68 - 0000 - 0000 - 9 - a19 - 8 e43dbeeb201:我们

将IBM UBX添加到Integrations对象

将IBM UBX添加到一体化JSON对象(例如,从特定源过滤数据),使用以下一个有效名称之一进行此集成:

  • IBMubx.

  • IBM UBX.

此页面上次修改:2010年10月20日



开始使用细分

细分是将网站和移动应用数据整合到300多个分析和增长工具的最简单方法。
或者
创建免费帐户