Marketo 集成

需要开发人员协助

您需要开发团队的帮助来设置此集成。请与他们分享本指南。

本指南介绍了如何将 Marketo 与 Pushwoosh 集成。您将能够使用网页推送通知通信渠道作为您在 Marketo 中营销活动的一部分。

例如，假设一个用户访问了您的 Marketo 着陆页但没有采取任何行动。您将能够通过网页推送通知联系到该用户，以作提醒。此网页推送通知还可以使用为该用户记录的 Marketo 数据进行个性化，以实现最大程度的互动！

注意

您的 Marketo 实例应启用 HTTPS（“安全着陆页”）。

虽然可以在不安全的 HTTP 网站上运行网页推送通知，但我们强烈建议使用 HTTPS 安全网页。 从 2017 年 10 月发布的 Chrome 62 开始，Google Chrome 会将所有包含表单的不安全网页标记为“不安全”警告。

在此处阅读更多信息： https://nation.marketo.com/docs/DOC-3891-faq-ssl-landing-pages-and-tracking-links https://nation.marketo.com/docs/DOC-4742-ssl-certificates-and-marketo-faq

如果您仍想使用不安全的 HTTP 网站，请遵循 适用于 HTTP 网站的 Chrome/Firefox 网页推送 指南。

您可以在此处获取免费的 SSL 证书： https://letsencrypt.org/

1. 创建 Service Worker

请遵循此 指南 并完成先决条件步骤以及步骤 1 - 2.2。

完成上述步骤后，您应该手头有准备好的 manifest.json 和 pushwoosh-service-worker.js 文件。

切换到 Marketo Design Studio。 Marketo 只能将文件上传到资源文件夹，即名为“Images and Files”的文件夹。 将 manifest.json 和 pushwoosh-service-worker.js 上传到这些文件夹。

2. 创建推送订阅页面

如上所述，Marketo 只能将文件上传到资源文件夹，该文件夹与着陆页的范围不同。 例如，如果您点击上面上传的任何文件并检查其 URL，您会看到类似“https://your-host-name.com/rs/765-IWA-819/images/pushwoosh-service-worker.js”的内容。 但是，如果您点击着陆页并检查其 URL，它将是类似“https://your-host-name.com/lp/765-IWA-819/pushwoosh-landing.html”的内容。 请注意着陆页 URL 中的 “lp” 部分和脚本 URL 中的 “rs” 部分。

这意味着我们需要在与着陆页不同的范围内注册我们的 Service Worker 脚本。

为实现此目的，我们将上传一个特殊的推送订阅页面到 Marketo 资源文件夹，然后从着陆页打开它。让我们创建这个订阅页面。

从以下 gist 获取 push-subscription.html 文件： https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-push-subscription-html

打开文件并更改以下行：

• 第 8 行 - 将链接更改为上一步中上传的 manifest.json 文件的 URL。
• 第 24 行 - 将 scope 参数值更改为您的资源文件夹的 URL（这是 manifest.json 所在的文件夹）。
• 第 20 行 - 将 applicationCode 参数值更改为您的 Pushwoosh App Id。

请注意，该脚本还将 Pushwoosh 以用户为中心的推送通知与 Marketo 的潜在客户标识符进行映射：userId:leadId（第 26 行）

将生成的文件上传到“Images and Files”文件夹。现在您应该在该文件夹中有这些文件：

3. 创建带有推送订阅的着陆页

从以下 gist 获取 pushwoosh-template.html 文件： https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-pushwoosh-template-html

打开文件并更改以下行：

• 第 47 行 - 将 scope 参数值更改为您的资源文件夹的 URL。
• 第 65 行 - 将链接更改为上一步中上传的 push-subscription.html 文件的 URL。
• 第 43 行 - 将 applicationCode 参数值更改为您的 Pushwoosh App Id。

与上一个脚本一样，此脚本也将 Pushwoosh 以用户为中心的推送通知与 Marketo 的潜在客户标识符进行映射：userId:leadId（第 49 行）

现在转到您的 Marketo 着陆页的“Templates”部分，创建一个模板（在下面的截图中称为“pushwoosh-template”），并将生成文件的内容复制粘贴到那里。

现在让我们基于此模板创建一个新的着陆页。

在我们的示例中，为了展示 Pushwoosh 与 Marketo 营销活动自动化的集成能力，为简单起见，我们将在着陆页上添加一个简单的链接。我们将创建一个营销活动，当用户点击此链接时，将触发个人推送通知。

我们将使用与着陆页相同的 URL。

<a href="https://na-ab24.marketo.com/lp/765-IWA-819/pushwoosh-landing.html">Send me an Offer!</a>

4. 创建 Pushwoosh Webhook

转到 Marketo 的“Admin”部分并使用以下参数创建一个新的 Webhook：

• URL - https://go.pushwoosh.com/json/1.3/createMessage
• Request Type: POST

将以下代码粘贴为模板。

{
        "request": {
            "application": "ENTER_YOUR_PUSHWOOSH_APP_ID",
            "auth": "ENTER_YOUR_PUSHWOOSH_API_TOKEN_HERE",
            "notifications": [{
                "send_date": "now",
                "ignore_user_timezone": true,
                "content": "We've got a new offer for you!",
                "users" : ["{{lead.Id:default="ABCD-EFGH"}}"]
            }]
        }
    }

请注意，我们使用 Marketo Lead ID 来在 Pushwoosh 中引用用户。有关以用户为中心的推送通知的更多信息，请参阅此处。

在我们这个非常简单的示例中，我们使用静态推送消息。但是，您可以使用 createMessage 的所有功能。

要个性化推送通知，您可以使用 Pushwoosh 的预设，并在 /createMessage 调用的 “dynamic_content_placeholders” 参数中传递来自 Marketo 的值，以实现推送个性化。

5. 与 Marketo 自动化营销活动集成

转到 Marketo 的“Marketing Activities”部分并创建一个营销活动。

在我们的示例中，当用户点击我们着陆页上的链接（即我们刚才创建的那个）时，我们将触发该营销活动。

b. 在“Flow”部分选择“send_push” Webhook

• 现在打开着陆页 URL
• 点击“Yes, I Want”按钮以打开推送订阅对话框
• 订阅推送通知
• 点击“Send me an Offer!”链接

您已收到您的 Marketo 自动推送通知！