Marketo V2目的地


开始

要开始向Marketo发送数据,您必须做两件事。这两个步骤都要求您使用管理员账户登录。

在目的地设置中输入您的市场凭证

我们需要您的Munchkin帐户ID,客户机密秘密和客户端ID。

获取您的Munchkin帐户ID登录您的Marketo帐户,单击右上角的admin,然后单击左侧栏上的munchkin。

要获取您的客户端密钥和客户端ID,您必须创建具有完整API访问的角色,仅用户API,然后在Marketo中创建服务。

要使用完整API访问创建角色:

  1. 点击管理在右上角。
  2. 点击用户和角色在左边的栏上。
  3. 点击一下角色标签。
  4. 点击新角色。命名您的角色并选中API Access框以分配用户完全API访问权限。单击Create。

现在您已经创建了一个API角色,您必须将该角色分配给一个仅使用API的用户。

  1. 单击Users选项卡。
  2. 单击“Invite New User”,填写步骤1中需要的信息。
  3. 分配在步骤2中为此用户创建的新角色,然后只检查API框。单击“下一步”然后发送。

接下来,创建一个服务,并从该服务获取客户端秘密和客户端ID。

  1. 单击左侧栏上的LaunchPoint。
  2. 从下拉下来单击“新建”,然后单击“新建服务”。
  3. 在下拉列表中选择Custom for the Service。
  4. 选择您邀请的新API。此用户必须仅是API用户被分配一个具有完全API访问权限的角色。

  5. 单击您创建的新服务的“详细信息”,将使用客户端密钥和客户端ID显示一个小窗口。将它们复制并粘贴到目标的设置中。

在Marketo中创建用户ID和匿名ID字段

  1. 单击右上角的Admin。
  2. 单击左侧栏上的Field Management。
  3. 单击“新建自定义”字段。
  4. 选择字符串作为类型。
  5. 无论您想要什么,将该字段命名为。
  6. 将API名称设置为用户标识对于用户ID字段,然后anonymousId获取匿名ID字段。重要的是:用户ID和匿名ID字段的API名称必须为用户标识anonymousId确切地。如果API名称中的任何内容是不同的,则目的地将无法正常工作。

识别

当你打电话识别,部分使用Marketo的REST APIupsert领导。我们将将以下规范分段特征映射到Marketo的标准字段:

分段特征 mareto的标准字段
地址 城市
地址 国家
地址 邮政编码
地址.State. 状态
生日 出生日期
新万博app2.0下载 新万博app2.0下载
电子邮件 电子邮件
名称 第一个
性别 把社会性别
名称 去年
电话 电话

这是一个示例javascript。确认()调用所有标准特征:

分析识别(1234,{:Robyn Rihanna,:芬蒂,电子邮件:rihanna@example.com.,性别:女人,电话:555-555-5555,新万博app2.0下载:semment.com.,生日:1988-02-20T00:00:00.000Z,createdAt:2007-05-31T00:00:00.000Z,地址:{城市:尤金,国家:美国,postalCode:97405,状态:俄勒冈州}});

如果你还想从你的。确认()调用更新市场中的字段,必须在目标设置中映射它们。笔记:风俗地址特质必须在顶层特征对象,不在地址目的。

  • 段特征。你送来的trait的名字。确认()调用。
  • 市场名称。Marketo为该字段休息API名称。要在Marketo中获取REST API名称,请单击“字段管理”,然后单击“出口字段名称”。将下载传播表,第一列是您的市场字段的REST API名称。确保准确地复制和粘贴REST API名称。区分大小写。
  • 市场类型。当您进入Field Management时,单击右侧栏中的字段名称,您将看到字段类型。

跟踪

当你打电话跟踪,段将事件映射到预定义mareto的自定义活动。发送时有两个重要的事情可以注意到。追踪()拨打市场电话:

  1. 必须将它们映射到您的市场营销自定义活动在您的目的地设置。如果您没有在目的地设置中映射一个跟踪调用到自定义活动,我们将不会将事件发送到Marketo,以帮助限制对Marketo的API调用的数量。

  2. 您必须:

这是一个样品红宝石。追踪()事件:

分析追踪(事件:分部事件,属性:{:亚历克斯})

  • 段事件名。你的片段事件名称。
  • Marketo活动ID。当你在mareto的自定义活动,点击您想要将段轨道事件映射到的右侧栏中的Marketo活动。将ID复制并粘贴到目标设置中。

  • 段属性名称。在您的。追踪()调用。这是区分大小写的,所以请确保名称与您传递它的方式完全匹配。追踪()调用。
  • 市场名称。自定义活动的Marketo属性的名称。给定自定义活动的属性名称可以在Marketo自定义属性的Fields选项卡中找到。单击右侧栏中的自定义活动,将出现自定义活动的属性列表。请确保复制并粘贴您的字段的API名称完全像它在Marketo中出现。区分大小写。

  • 市场类型。市场属性的类型。属性类型可以在Marketo自定义属性的Fields选项卡中找到。单击右侧栏中的自定义活动,将出现自定义活动的属性列表。

  • 主要领域。当在Marketo中创建一个自定义活动时,你必须设置一个主字段。如果您不确定哪个字段被设置为主字段,那么当您在Marketo中查看自定义活动的字段列表时,主字段旁边会有一个红色的星星。

页面

当你打电话页面,部分使用Marketo的munchkin.js.visitWebPage方法。URL是由您构建的。页()将事件和属性对象转换成Marketo所期望的形式,因此无需自己操心。

Marketo的visitWebPage方法需要URL和用户代理。任何缺少这些字段的调用都不会发送到Marketo。用户代理是自动收集的客户端,但如果您正在发送。页()从服务器调用时,确保设置了用户代理。

这是一个示例节点。页()事件:

分析({用户标识:019MR8MF4R.,类别:文档,名称:node.js库,属性:{url://www.asianminres.com/docs/万博水晶宫connections/sources/catalog/libraries/server/node.,小路:/ docs万博水晶宫 / connections / scess / catalog / libraries / server / node /,标题:Node.js库 - 段,介绍人:https://github.com/secmentio/analytics-node.},语境:{用户代理:Mozilla / 5.0(Macintosh;英特尔Mac OS X 10_9_5)AppleWebkit / 537.36(如壁虎)Chrome / 40.0.2214.115 Safari / 537.36}});

追踪Marketo的匿名活动

如果您只想在市场上追踪已知用户,请将轨道匿名活动设置设置为false。此设置为假时有几件事可以注意到:

  1. 任何没有用户ID的呼叫都将被拒绝。
  2. 不会有匿名活动被发送到Marketo。即使在用户被知道之后,他们之前的任何匿名活动都不会被发送到Marketo。

If you’d like to track anonymous activity but don’t want to have to parse through or view unknown leads, Marketo lets you create Smart Lists that will filter your leads (i.e. if you’d only like to view leads that have a user ID or an email). To do this, when you are in your Lead Database, click All Leads, then New. From the drop down, click New Smart List. Select the folder you’d like the Smart List to live in. After you’ve created the Smart List, select what field you’d like to filter by on the right side bar, drag it to the filters and then select what you’d specifically like to filter by for that field.

Marketo API限制

我们尽最大努力限制我们对Marketo的API调用数量,但如果你达到了每天50k的限制,我们建议只发送你需要的事件到Marketo。为了防止事件发送到Marketo,您可以通过以下方法选择目的地:

分析识别({用户标识:97234974,特征:{:亚历克斯},集成:{市场:错误的,谷歌分析:真正的}})

混合装置/云模式

另一种选择是使用MarketoDevice-mode(假设您正在从网站上跟踪事件)。Marketo不会限制源自Web SDK的API调用,但它也只支持捕获识别和页面事件。如果您还想捕获跟踪事件,可以选择通过我们的服务器端集成来路由这些。

要启用此“混合”模式,请选择“混合”模式发送跟踪事件服务器端设置并遵循映射说明跟踪上面定义的事件。

防止重复的引线

Marketo可以让你根据任何领域升级线索。如果你在跟踪匿名活动,我们会使用email和userId以及anonymousId。我们将首先使用电子邮件,因为这是一个领域,Marketo推荐是唯一为您的线索。然而,许多。追踪()。页()电话不包括电子邮件地址,所以我们将使用用户标识anonymousId通过了你的。追踪()。页()呼叫将这些事件与市场联系起来。

您可以执行以下操作之一以防止重复的引线:

  1. 受到推崇的:上传CSV将您的用户ID添加到市场上的所有领导使目的地。在你创建userId字段在Marketo中,您可以使用电子邮件列和Userid列上传所有用户的列表。您的CSV应该如下所示:
电子邮件 用户标识
alex.com ABC1234
natasha.com XYZ9876.

要将列表上传到Marketo,当您在铅数据库中,单击所有引线。然后单击“新建”,然后从下拉下来“导入列表”。选择CSV,然后单击“下一步”。确保“电子邮件地址”和“UserId”是所选的市场字段,然后单击“下一步”。为列表命名或选择预先存在的列表。选择“无”进行采集程序。然后单击“导入”。

  1. 手动合并市场领先。跟随这些合并指令在启用目的地后在市场上找到的任何重复的领导。
  2. 请先拨打识别。这已经是推荐的最佳实践我们的一部分
  3. 通过您的一封电子邮件。追踪()。页()调用。

从Marketo迁移到Marketo V2

有一些必要的步骤必须采取从分部的遗留市场V1目的地迁移到Marketo V2。

重要提示:一旦完成使用Marketo V2,请确保禁用Marketo。如果留下两个启用,您的市场帐户可能会有重复数据。

  1. 您的Marketo证书在您的区段目的地设置需要更新。我们的Marketo目的地使用了Marketo的SOAP API,而Marketo V2使用了Marketo的REST API,这需要不同的凭证。检查开始你将需要什么证书的指南。
  2. 必须在Marketo中创建两个自定义字段:UserID和AnonyousID。查看开始有关如何在Marketo中创建这些自定义字段的确切详细信息。
  3. 跟踪调用必须映射到目标设置中。我们的市场目的地发送追踪在Marketo的Munchkin访问网页事件。在Marketo V2,我们将发送您的跟踪呼叫到您的Marketo自定义活动。详细说明这里
  4. 如果有任何您想要在您的Marketo发送到市场的自定义主角领域识别调用时,必须将它们添加到目标设置中。详细说明这里
  5. 更新Marketo中任何依赖于V1发送方式的内容。追踪()您的自定义活动触发的事件。例如,我们的V1 Marketo目的地将跟踪事件发送为“访问网页”事件/ event / 。因此,如果您的工作流是由“访问网页”事件触发的,其中包含网页/ event / ,你必须把“访问网页”事件触发器换成你的自定义属性触发器。在右侧栏中,点击“Triggers”下的“Custom”文件夹,选择您为自定义活动设置的触发器:

    要弄清楚该自定义活动的触发名称是什么,导航到Marketo> Marketo自定义活动的管理部分>点击侧栏的活动,您将看到触发器名称:

  6. 当启用Marketo V2时,由于Marketo API的工作方式,有可能创建重复的leads,特别是当第一个启用目的地时。要想避免这种情况,请查看“防止重复线索”。

个人

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

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

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

支持的来源和连接模式

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

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

段提供可选的云基础连接模式网页数据与市场v2。作为提醒,这将从您的网站中删除Marketo V2 JavaScript库,从而提高性能。

段提供A.可选基于连接模式移动数据传输到Marketo V2,这样你就可以使用Marketo V2功能直接从移动设备收集数据。要做到这一点,您必须将Segment- marketo V2移动SDK与Segment移动库打包。

设置

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

API的私钥

设备模式:你可以在下面找到你的API私钥管理员>集成> Munchkin> API配置在你的mareto的账户

客户机ID

您的Marketo REST API客户端ID。

客户的秘密

您的市场休息API客户秘密。

mareto的自定义活动

云模式要发送到Marketo的跟踪呼叫,您必须是云模式或从我们的服务器端库中发送跟踪事件。使用这些字段将段跟踪事件名称映射到Marketo自定义活动。我们只会发送您指定的事件。

Marketo自定义字段

使用您希望映射到段标识特征的Marketo Lead字段的这些字段。

Munchkin帐户ID.

您可以找到您的帐户IDadmin>集成> munchkin>跟踪代码在你的mareto的账户

发送跟踪事件服务器端

仅在设备模式下使用Marketo时适用。此设置将通过与Marketo REST API的服务器端集成来路由您的所有曲目事件。页面并识别事件仍将使用我们的客户端集成与Marketo JavaScript SDK发送。

跟踪匿名活动

云模式:我们的Marketo整合允许您选择是否您想跟踪匿名线索在Marketo。如果你不想在Marketo中追踪匿名线索,你必须在你的活动中传递一个用户ID。

此页面上次修改:2021年3月18日



开始分段

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