Oracle Orkeys目的地


在这一页上


入门

在你的目的地页面启用Responsys之前,你必须在你的段目的地设置中设置一些东西。一旦设置完成,您就可以使用.identify ()调用添加记录简介列表简介扩展表。追踪()调用添加记录补充桌子

预先要求步骤

  1. 选择托管你的Responsys帐户。
登录端点
InterAct2. InterAct2.Responsys.net.
InterAct5. interact5.responsys.net
rsys8 InterAct.rsys8.net.
rsys9 InterAct.rsys9.Net.

请注意:您可以通过简单地前往您的Oracle Orkeys登录屏幕并查看您的URL来找到您的帐户端点。

Responsy-Pod-Settings

  1. 输入您的用户名密码对于您的Orkeys帐户。我们需要这些凭据才能从Oracle中检索Auth令牌,以便代表您的帐户发送数据。

  2. 输入默认值的名称文件夹您要将分段数据发送到。别担心,您可以使用目标特定选项覆盖每次调用的默认文件夹名称.identify ()

  3. 输入默认值的名称配置文件列表你想在哪里存储你的.identify ()呼叫。同样,这可以通过视图的基础使用目的地特定选项来覆盖在这里

  4. 选择是否要设置您的默认权限状态成为选择参加或者选择退出。除非另有配置,否则默认为选择退出。如果您不确定此设置的含义,您可以阅读更多条件在这里

输入了这些所需的设置后,您已准备好将您的Oracle Orkeys帐户集成通过段平台!

确认

你可以用两件事与细分.identify ()关于Responsys的电话:

  • Upsert记录到配置文件列表
  • 通过在a中插入相应的记录来扩展该记录简介扩展表

将记录合并到配置文件列表

带一个样品.identify ()电话:

// Analytics.js.分析确认'r'{电子邮件'wubba-lubba-dub-dub@morty.com.'seasonTwo真的电话'4012221738'地址{街道'19日森林巷'城市'东格林威治'状态'ri.'邮政编码'02818.'国家'美国'}});

重要的:为了合并记录,我们的目的地要求所有.identify ()至少包含一个用户身份或者traits.email.!!

上面的呼叫将尝试首先在具有匹配的提供的配置文件列表中找到现有记录用户身份'瑞克'或者电子邮件'wubba-lubba-dub-dub@morty.com'。如果找到记录,我们将在使用我们的信息传递信息时,我们将更新其余的列。识别规格。以下是我们如何将Spec'd段特征映射到Orkingys的语义配置文件列表列:

分部特质名称 Responsys配置文件列表列名
用户身份 顾客ID_
电子邮件 EMAIL_ADDRESS_
电话 MOBILE_NUMBER_
address.street POSTAL_ADDRESS_1_
地址 CITY_
地址.State. 状态_
address.postalCode 邮政编码_
address.country COUNTRY_

电子邮件和移动权限状态

如果您想跟踪在您的应用程序中展示或退出营销通信的用户,并且网站表示自定义特征的键将映射到OrkeysEmail_permission_status_或者mobile_permission_status_段设置中的字段。笔记:此自定义特征密钥的值必须是布尔值。当值为true表示用户想要选择in and false表示用户想要选择退出。段将该布尔转换为适当的Orkey接受格式(一世或者O.)。

Responsys没有创建配置文件列表的API,所以您必须在他们的UI中手动创建一个

将记录合并到配置文件扩展表

如果您想将记录发送到a简介扩展表(宠物),此目的地可以为您创建宠物,或者您只需输入您现有宠物的任何任何宠物的名称即可。匹配列名将是用户身份电子邮件(必须至少发送一个)。所以一定要包括用户身份或者traits.email.在你的.identify ()拨打!

通过Segment创建Profile扩展表:

你所要做的就是在你的部分目标设置中输入你想要的宠物的名字。

说以下是你的第一个.identify ()在您输入尚未存在的宠物名称后致电尚未存在的宠物名称:

// Analytics.js.分析确认'r'{电子邮件'wubba-lubba-dub-dub@morty.com.'姓名'r'年龄60天才真的});

这将在其列所在的位置创建一个PET姓名年龄天才。自从电子邮件已经映射到您的个人资料列表中,我们不会在您的宠物中创建重复的列。我们还将根据您发送的trait的值自动设置列类型。我们将运行一个快速验证,例如检查任意的长度细绳值,以确保我们设置了适当的str ###以及检查任何数字值应该是一个整数或者数字在Orkeyys中。

下面是我们如何映射列类型,以及当可以设置多个有效列类型时的默认类型(例如,一个有24个字符的字符串值仍然默认为)STR500

分段特征价值类型 可能的Orkeys列类型 默认
时间戳 时间戳 时间戳
数字 整数,数字 数字
细绳 CHAR,STR25,STR100,STR255,STR500,STR4000 STR500
布尔* str25,str100,str255,str500,str4000 STR25

笔记:Orkingys没有布尔列类型,因此我们将纵笔串行'真的'或者'错误的'

重要的由于Responsys将拒绝任何试图合并给定概要扩展表中不存在的列的消息,我们将确保这样做只有发送已接受的列名称。因此,保持跟踪代码,目标设置和表架构在SYNC中的Orkey中非常重要!

合并记录到现有的概要扩展表

如果您已经使用了您要使用的配置文件扩展表,只需在设置中输入列表的名称。注意我们将只有在你的模式中发送匹配列名的trait,这意味着在发送请求之前,我们将删除任何在你的宠物中没有预先定义的trait。

覆盖默认文件夹和列表名称

如果您需要更多的灵活性或需要添加不同的用户到不同的文件夹或配置文件列表/扩展表,您可以使用我们的目标特定选项

// Analytics.js.分析确认'r'{贵宾真的},{Responsys{列表名称'segment_vip_emails.'//配置文件列表名文件夹名称'segment_vips.'/ /文件夹名乳名'segment_vip_users.'//配置文件扩展表名称}});

上面的呼叫将覆盖段目标设置中的所有默认名称。它是将用户的程序化铲斗实施到特定文件夹和列表是一种很好的方法!

追踪

你可以发送段。追踪()要添加的事件(合并)记录到任何补充表。但是,目前无法为您的配置文件列表呈现给定的补充表的所有有效列,这意味着您必须显式映射您的曲目事件和属性的名称,并提供相应的reponsys表名称和列名称和类型。

通过段创建补充表:

就像我们的.identify ()调用工作,您可以选择通过在您的设置中提供所有必要的映射来选择段创建补充表。我们将首先尝试将记录上载到该表名,如果不存在,我们将使用段目标设置中提供的确切列映射为您创建表。如果您不希望这样做,则无需将每列映射到段属性,因为Orkeys允许您部分地更新记录,但除此之外主要键

重要的:如果您对其段进行任何更新。追踪()或者在不更新目标设置中更改的情况下,您可以在不更新更改的情况下,您可以风险记录未正确添加,以便完全拒绝消息。特别是如果改变有关主要键配置

将记录合并到现有的补充表

只要您提供反映您的补充表现有模式的确切映射,我们可以添加记录。如果您不希望这样做,则无需将每列映射到段属性,因为Orkeys允许您部分地更新记录,但除此之外主要键

主要键

所有补充表必须至少有一个首要的关键。Responsys每个表最多支持4个。无论您选择将哪个属性设置为主键之一,都必须具有惟一的值,这一点非常重要。否则,您将冒着覆盖补充表中的历史记录的风险。

请注意,如果您使用的是给定表的多个主键,则只需要其中一个需要发送唯一值,以便成功添加新记录。

使用Segment的messageId作为主键

确保您选择唯一主键的最简单方法是启用使用段消息ID。此功能将发送segment_message_id.作为主要键列,具有段的值MessageId.字段。因为这个属性是由Segment唯一生成的,所以您可以确保不会覆盖表中的任何历史记录。

请注意,这确实计入了每个表的四个主键的限制。

如果您想为现有的补充表使用此功能,则可以修改架构并添加列segment_message_id.。如果您不这样做但启用此选项,则所有曲目事件将被Orkey拒绝。

此外,如果您不提供分段与全部对于主键列名,Responsys API将拒绝消息。

地图上标识

为了将补充表中的事件记录与配置文件列表或配置文件扩展表中的匹配记录相加,我们建议启用地图段userid.选择。如果启用,我们将发送用户身份附加到。追踪()载荷作为Responsys字段。

重要的:确保您映射了现有的补充表,您已在表中创建一个名为的字段顾客ID_!!否则如果您尚未创建该表并依赖于分段执行此操作,我们将创建该字段顾客ID_并设置字段类型为STR500

地图电子邮件

因为我们仍然接受.identify ()电话没有用户身份it’就这么久吧traits.email.,您也可以为您的方式启用此。追踪()事件如果要使用事件记录使用电子邮件。我们会查询context.traits.email(如果你使用的是移动库,它会自动缓存),properties.email和回退用户身份字段如果它是有效的电子邮件地址。

重要的:如果您映射一个现有的补充表,请确保在表中创建了一个名为EMAIL_ADDRESS_!!否则,如果您尚未创建该表并依赖于分段执行此操作,我们将创建该字段EMAIL_ADDRESS_并设置字段类型为STR500

常见问题解答

你如何处理嵌套对象?

我们将用下划线分隔符平铺任何作为数组和对象嵌套对象的特征或属性。

请采取以下事项。追踪()使用一些嵌套属性调用:

// Analytics.js.分析跟踪'看着瑞克和莫蒂'{展示{标题'瑞克和父母'插曲{季节1类别['喜剧']}}});

我们会将列名称发送为:

  • show_title.“里克和莫蒂”
  • show_episode_season'1'请注意: Responsys接受字符串作为列类型NUMBER和INTEGER,所以我们总是使用stringify数字S)
  • show_episode_categories_0.'喜剧'

重要的:映射段属性时,您知道您将作为嵌套对象发送的那些,请务必键入展开版本。例如,如果您发送:

// 特性{地址{街道'100加州街道'}}

你应该进入address_street作为段属性名称。

我在段调试器中看到了“无法在一个字段中完成”融合!

当您试图将一条记录插入到概要扩展表中,但除了我们用来匹配列的特征外,没有提供任何其他特征时,就会发生此错误。对于宠物,我们用你的用户身份或者traits.email.从你的.identify ()调用插入记录。你需要发送至少一个其他特征,将映射到你的宠物的领域。

角色

您可以发送使用生成的计算特征和受众段角色到达这个目的地用户属性。要了解有关Personala的更多信息,请联系我们演示

对于用户属性目的地,一个确认对于添加和删除的每个用户,呼叫被发送到目的地。属性名是用户名的snake_大小写版本,用true/false值表示成员关系。例如,当用户在过去30天内第一次完成一个订单时,Personas发送一个带有属性的标识呼叫ORDER_COMPLETED_LAST_30DAYS:TRUE。当用户不再满足这种情况时(例如,自上次订单以来已经超过30天),Personas将该值设置为

当您第一次创建受众时,PersonAs为观众中的每个用户发送标识呼叫。后来的受众同步只为其成员身份自上次同步以来的成员身份更改的用户发送更新。

支持的来源和连接方式

在开始之前,请确保Responsys支持您选择实现的源类型和连接模式。你可以了解更多联系方式在这里

网页 移动的 服务器
设备模式
☁️云模式

部分提供了一个选修的基于设备连接模式移动的数据转到Orkeys,以便您可以使用直接从移动设备收集数据的OrkeyS功能。为此,您必须使用段移动库打包段 - Orkey Mobile SDK。

设置

Segment让你改变这些目标设置从Segment应用程序,而不需要碰触任何代码。

电子邮件权限状态特性映射

请输入您想要映射到的特质EMAIL_PEERMISSION_STATUS_。这将允许你追踪那些选择在你的应用和网站中加入或退出营销交流的用户。这个特征的价值必须是布尔值。

活动

使用这些字段将分段事件名称映射到OrkeyS补充表。我们只会发送您指定的事件和属性。

文件夹名称

请输入保存提供的配置文件列表和配置文件扩展表的默认文件夹名称。

移动权限状态特性映射

请输入您想要映射到MOBILE_PERMISSION_STATUS_的特征。这将允许你追踪那些选择在你的应用和网站中加入或退出营销交流的用户。这个特征的价值必须是布尔值。

密码

请输入您的帐户密码。

托管您的Orkeys帐户的POD。只需在登录屏幕期间检查您的URL。这是对您帐户的任何请求都需要。默认为InterAct2.

简介扩展表

请输入默认配置文件扩展表的名称。

配置文件列表名称

请输入默认配置文件列表。确保配置文件列表位于提供的文件夹名称中。

默认权限设置为“OPTIN”

选择是否应该添加到配置文件列表中的记录'选择参加'而不是默认'选择退出'

用户名

请输入您的帐户的用户名。

此页面上次修改:2020年6月12日



开始使用细分

段是将网站和移动应用程序数据集成到超过300个分析和增长工具的最简单方法。
或者
建立免费账户