Marketo integration

Use Marketo data for the maximum user engagement

This guide explains how to integrate Marketo with Pushwoosh. You would be able to use Web Push Notifications communication channel as a part of your marketing campaigns with Marketo.

As an example, imagine a user visited your Marketo landing page but did not take an action there. You would be able to reach this user with web push notification as a reminder. This web push notification can also be personalized with Marketo data recorded for this user for the maximum engagement!

HTTPS ("Secured Landing Pages") should be enabled on your Marketo instance.

While it is possible to run web push notifications with HTTP unsecured websites we strongly advise to use HTTPS secured web pages. Beginning in October 2017 with the release of Chrome 62, Google Chrome marks all unsecured web pages containing forms with the “Not secure” warning.

If you still want to go with HTTP unsecured website, follow the Chrome/Firefox Web Push for HTTP websites guide.

You can get FREE SSL certificate here: https://letsencrypt.org/

1. Creating the Service Worker

Follow this guide and do the prerequisite steps and steps 1 - 2.2.

After completing the steps above you should have manifest.json and pushwoosh-service-worker.js files ready at hand.

Switch to Marketo Design Studio. Marketo can only upload files to the resource folder, the folder called "Images and Files". Upload manifest.json and pushwoosh-service-worker.js to these folder.

2. Creating push subscription page

As it was mentioned above Marketo can only upload files to the resource folder which is different from the scope of the landing pages. For example if you click on any file uploaded above and check its URL you'll see something like "https://your-host-name.com/rs/765-IWA-819/images/pushwoosh-service-worker.js". However if you click on the landing page and check its URL it will be something like: "https://your-host-name.com/lp/765-IWA-819/pushwoosh-landing.html". Note "lp" part in the landing pages URL's and "rs" in the script URL's.

That means we need to register our Service Worker script in a scope different from the landing pages.

To achieve that we'll upload special push subscription page to Marketo resources folder and then open it from the landing page. Let's create this subscription page.

Get the push-subscription.html file from the following gist: https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-push-subscription-html

Open the file and change the following lines:

Line 8 - change the link to the URL of manifest.json file uploaded in the previous step.
Line 24 - change the scope parameter value to the URL of your resources folder (this is the folder where manifest.json is).
Line 20 - change the applicationCode parameter value to your Pushwoosh App Id.

Note the script also maps Pushwoosh user-centric push notifications with Lead Identifier of the Marketo: userId:leadId (line 26)

Upload resulting file to the "Images and Files" folder. Now you should have these files in the folder:

3. Creating landing page with push subscription

Get the pushwoosh-template.html file from the following gist: https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-pushwoosh-template-html

Open the file and change the following lines:

Line 47 - change the scope parameter value to the URL of your resources folder.
Line 65 - change the link to the URL of push-subscription.html file uploaded in the previous step.
Line 43 - change the applicationCode parameter value to your Pushwoosh App Id.

This script as a previous one also maps Pushwoosh user-centric push notifications with Lead Identifier of the Marketo: userId:leadId (line 49)

Now go to the "Templates" section of your Marketo landing pages, create the template (called "pushwoosh-template" in the screenshot below) and copy-paste the contents of the resulting file there.

Now let's create a new landing page based on this template.

In our example to show capabilities of Pushwoosh integration with Marketo campaign automation for the sake of simplicity we'll add a simple link to the landing page. We are going to create a campaign that will trigger personal push notification when the user clicks on this link.

We are going to use the same URL as the landing page.

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

4. Creating Pushwoosh Webhook

Go to the "Admin" section of Marketo and create a new Webhook with the following parameters:

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

Paste the following code as a template.

{
        "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"}}"]
            }]
        }
    }

Note that we use Marketo Lead ID to refer user in Pushwoosh. See more about user-centric push notifications here.

In our very simple example we use static push message. However you can use all the functionality of /createMessage

To personalize push notification you can use Preset from Pushwoosh and pass the values from Marketo in "dynamic_content_placeholders" parameters of the /createMessage call for push personalization.