Salesforce目的地


段的Salesforce目的地允许您在不使用SOAP API的情况下识别Levile。

API访问

您需要使用Salesforce用户凭据提供对段的API访问权限。由于我们使用Salesforce的SOAP API,因此您需要提供电子邮件,密码和安全令牌以访问他们的API。

由于我们不想要求您的一个实际用户帐户的密码,我们建议您为段创建一个新的Salesforce用户帐户。我们意识到额外的用户账户费用,因此如果您愿意,可以随意使用现有帐户。

如果您决定为段API创建新用户帐户,请通过转到创建此用户设置>管理设置>用户>新用户,并使用系统管理员配置文件创建新用户。需要此配置文件才能为我们提供足够的权限来访问API。

还要确保在此Salesforce用户帐户中禁用IP安全性。这是因为我们的服务器经常改变,很难预测他们的IP。


确认

我们的目的地使得Salesforce简单。此目的地支持Salesforce用户最重要的痛点:将您的潜在客户从您的网站或移动应用程序中作为LeaveS进入Salesforce。manbetx客户端应用下载创建/更新引导是默认行为确认事件。如果您想定制这个,您可以利用它行动

识别领导者

让我们通过一个识别铅的快速JavaScript示例:

分析确认'YOUR_USERS_ID'{名称'彼得·吉本斯'标题'副总裁Derp'电子邮件'peter.gibbons@example.com'新万博app2.0下载'发动机'电话'570-690-4150'状态'加利福尼亚州'评分'热的'城市'东格林威治'postalCode'94115'国家'美国'街道'19123年林道'状态'ri.'},{'集成'{'销售队伍'真正的}});

此外,如果您使用的另一个目的地,如对讲者,这需要公司特质是一个对象,您可以按如下方式传递公司的名称,我们的目的地仍将按预期映射它。新万博app2.0下载

此外,您也可以在对象中发送地址数据。

分析确认'YOUR_USERS_ID'{名称'彼得·吉本斯'标题'副总裁Derp'电子邮件'peter.gibbons@example.com'新万博app2.0下载{ID666.名称'发动机'},电话'570-690-4150'状态'加利福尼亚州'评分'热的'地址{城市'东格林威治'postalCode'94115'国家'美国'街道'19123年林道'状态'ri.'}},{'集成':{'销售队伍'真正的}});

你打电话的时候确认,我们将检查这个铅是否存在基于电子邮件特征。如果它,我们会将领先优势与您传递的特征更新确认呼叫,否则我们将创建一个Salesforce Lead。

重要的:如果您计划使用段更新Salesforce中的自定义字段,则需要确保在Salesforce中创建自定义主导字段事先的发送数据。这Leads的Salesforce API需要新万博app2.0下载。如果此字段中的任何一个不存在于服务器端请求中,则会自动追加字符串'n / a'对于每个字段,即使您在先前的请求中提供这些字段。

例如,如果你想在Segment called中收集一个自定义特征testprop.,您可以创建一个名为的字段标签testprop.这将生成API名称为testprop__c.。我们将附加__C对于任何自定义特征,因此您不需要担心。确保保持与您的套管一致。如果在CamelCase中创建自定义字段,请确保发送特征到骆驼箱的段。如果您在SFDC中创建自定义字段snake_case然后一定要发送你的特征格式相同。

笔记:我们的Salesforce目的地需要每次活动都包含“Salesforce”:True在集成对象中。段不会尝试将任何事件发送到不包括其有效载荷中的Salesforce。Salesforce SOAP API具有非常严格的API限制,以防止用户无意地击中其限制,我们在所有事件中都需要这一点。

默认情况下,考虑到其严格的API限制,我们不会向Salesforce发送识别呼叫,这就是为什么我们要求您明确定义哪些标识呼叫发送给Salesforce。

团体

。团体()调用现在将创建或更新帐户对象在Salesforce内。当我们收到一组呼叫时,类似于。确认()打电话,我们将首先检查使用Groupid.查看帐户对象是否已经存在于您的SF帐户中。根据响应的不同,我们将更新该对象或创建一个新的对象。创建/更新帐户是默认行为团体事件。如果您想定制这个,您可以利用它行动

把这个样品。团体()调用您可能会发送到细分:

(Analytics.js)

分析团体'813.'{名称'Teemo Industries'地址{城市'东格林威治'状态'ri.'国家'我们'postalCode'02818.'街道'9000森林车道'},电话'222-555-4444'描述'制造伟大的哈士奇产品'雇员4.网站'https://example.com.'},{'集成'{'销售队伍'真正的}});

按照以下情况,上述呼叫将如下发送Salesforce的API规范

{的名字'Teemo Industries'账号'813.'比赛'东格林威治'账单资金'我们'BillingPostalcode.'02818.'BillingState'ri.'BillingStreet.'9000森林车道'在职员工人数4.电话'222-555-4444'网站'https://example.com.'描述'制造伟大的哈士奇产品'}

笔记:默认情况下我们将映射地址到帐户结算地址。如果你想把地址映射到帐户运输地址,您可以在段中的Salesforce设置中进行。您也可以选择将其映射到两个都结算和运输。

需要步骤

  • 您必须使用该目的地的V2。
  • 你必须通过traits.name.因为这是Salesforce for Contain对象所强加的必要字段。
  • 你必须通过{'Salesforce': true}在里面选项
  • 你必须包括账号作为您的页面布局的一部分,以便我们能够查找帐户对象使用Groupid.
    • 登录您的Salesforce帐户并转到设置
    • 构建>定制>账户>页面布局
    • 拖着账号现场到帐户详情
    • 点击保存

自定义特征

为了发送自定义特征,您必须按照您的工作量相同的步骤。确认()称呼。你必须预定义他们在Salesforce。我们将通过附加发送任何自定义特征__C

特质验证

Salesforce在语义特征上记录了严格的验证。如果他们超出限制,我们将修剪这些特征。请参阅他们的文档帐户对象主要的对象如果您不想看到它们修剪过,请确保在这些限制下发送特征值。

自定义操作

如果您需要手动配置段事件与Salesforce Resources互动的方式,可以使用此操作行动设置。此设置允许您在内部SFDC资源上触发标准的CRUD操作(创建、读取、更新/升级、删除),以响应段事件。您可以根据需要配置任意多的这些操作。每个操作必须与特定的追踪事件或全部确认事件。操作可以进一步配置为将事件属性映射到SFDC字段。以下是一个示例操作配置,它将在Salesforce中创建新案例,以响应响应问题提交追踪事件:

行动示例

upsert行动

Upsert操作要么在Salesforce中创建或更新资源。有关这些工作,您必须在操作配置中提供Upsert规则,即段可以用于确定是否存在要更新对象。如果段找不到对象,它会在SFDC中创建一个新对象。因此,UPSERT规则中的字段无法映射到Salesforce自动化字段(如)ID。除了Upsert规则之外,您还可以将要在“更新”或“创建”中设置的事件属性映射到“字段映射”条目中。这里有一个例子:

upsert行动例子

在此示例中,我们根据无论是基于是否都是在Salesforce中创建或更新用户身份物业确认事件地图与自定义的联系人UserId__cSFDC中的字段值。此外,Salesforce联系录制字段值电子邮件电话被分段事件填充traits.email.traits.phone分别。

故障排除

创建其他资源

为了减少API的复杂性,我们的Salesforce目的地有意只支持使用确认称呼。我们使您的目的地创建和更新带来非常容易。

要创建其他类型的资源,例如帐户或自定义对象,我们建议直接与Salesforce集成

沙盒模式

要与Salesforce Sandbox实例进行集成,请将沙箱设置切换为TRUE。

API调用限制

Salesforce既限制了请求的并发量,也限制了我们可以代表你向他们的API发出的每日请求的总量。检查这些限制。它们各版和您的购买用户许可证有所不同。

我们每次提出两个API请求确认。第一个请求是一个SQL查询,以确定此对象是否已存在。第二个是更新或创建该对象。

此外,每30分钟,我们的服务器都会询问两个查询:一个要续订连接的SessionID,另一个旨在描述您的Salesforce对象模型,以确定哪些Salesforce对象可用。

我如何检查我今天还剩下多少Salesforce API调用?

设置>管理设置>公司简介>公司信息新万博app2.0下载,您可以找到标有一个字段:API请求,最后24小时

如果我用完了电话,我该怎么办?

您可以减少使用Context.Integrations的Salesforce呼叫段的数量,或者购买更多Salesforce用户许可证。

查找字段

您可以添加任何您想要的查找字段,以帮助我们找到您想要更新的对象。

自定义字段不更新

确保您通过的特征匹配自定义字段的API名称和数据类型!

密码到期

默认情况下,Salesforce用户帐户将设置为90天后的密码过期。发生这种情况时,代表您代表您的API调用的Salesforce用户帐户将不再能够进行API调用。您需要设置一个新的密码,获取新的安全令牌,然后在段Salesforce目标设置中设置这些内容。

如果要将密码设置为永不过期,您可以这样做Salesforce设置了>管理设置了>安全控制>密码策略

更新铅状态

由于Salesforce API的约束,当前段不支持更新Salesforce Regent State字段。

个人

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

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

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

支持的来源和连接模式

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

网页 移动的 服务器
Device-mode
☁️云模式

段提供A.可选的基于设备连接模式移动的数据进入Salesforce,以便您可以使用直接从移动设备收集数据的Salesforce功能。为此,您必须将段 - Salesforce Mobile SDK打包使用段移动库。

设置

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

帐户的电子邮件

输入您的Salesforce帐户电子邮件。我们建议为段创建一个单独的帐户,以便您无需使用您的实际密码。

户口密码

Salesforce要求我们存储Salesforce用户的密码以访问其SOAP API。我们建议您将新的系统管理员用户配置文件添加到Salesforce帐户,以便您不必告诉我们您的实际密码。你可以做到这一点设置>管理设置>用户>新用户

行动

收到特定段事件时触发Salesforce中的操作。

始终启用

允许发送每一个事件到Salesforce,绕过需要设置'Salesforce':真实在您的曲目呼叫中。

自定义主导查找字段

此设置允许您提供Segment标识事件中的特征与您希望我们查找Lead的SFDC字段之间的映射。默认情况下,该集成将在identify事件中寻找电子邮件特征,并根据是否已经存在某个给定电子邮件地址在Salesforce中创建或更新一个lead。您可以使用此设置来覆盖该行为或使用多个查找字段。只需在左边输入Segment trait的名称,在右边输入相应的SFDC Field名称。如果它是一个自定义字段,请确保添加__c。如果你想将电子邮件与其他领域结合使用您需要在此设置中显式地将其定义为一行

沙箱

如果您与Sandbox环境集成的Salesforce实例,请启用此设置。

安全令牌

您可以找到您的安全令牌设置>个人设置>我的个人信息>重置我的安全令牌

将地址发送为帐单地址

这将把组调用中的地址特征映射为帐户对象的计费地址。

发送地址为送货地址

这将将组中的地址特征映射为您的帐户对象的送货地址。

版本

v1被弃用:不应使用前进并留下遗留兼容性。我们的V2集成支持从您的网站或移动应用程序中获得潜在客户进入Salesforce。manbetx客户端应用下载

此页面上次修改:11月10日2020年11月10日



开始分段

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