Интеграция с Marketo

В этом руководстве объясняется, как интегрировать Marketo с Pushwoosh. Вы сможете использовать канал коммуникации web push-уведомлений в рамках ваших маркетинговых кампаний в Marketo.

Например, представьте, что пользователь посетил вашу целевую страницу в Marketo, но не совершил на ней никаких действий. Вы сможете связаться с этим пользователем с помощью web push-уведомления в качестве напоминания. Это уведомление также можно персонализировать, используя данные Marketo, записанные для этого пользователя, для максимального вовлечения!

Следуйте этому руководству и выполните предварительные шаги и шаги 1 - 2.2.

После выполнения вышеуказанных шагов у вас должны быть под рукой готовые файлы manifest.json и pushwoosh-service-worker.js.

Переключитесь на Marketo Design Studio. Marketo может загружать файлы только в папку ресурсов, которая называется «Images and Files».
Загрузите manifest.json и pushwoosh-service-worker.js в эту папку.

Как упоминалось выше, Marketo может загружать файлы только в папку ресурсов, которая отличается от области видимости (scope) целевых страниц.
Например, если вы нажмете на любой загруженный выше файл и проверите его 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”.
Обратите внимание на часть «lp» в URL-адресах целевых страниц и «rs» в URL-адресах скриптов.

Это означает, что нам нужно зарегистрировать наш скрипт Service Worker в области видимости, отличной от целевых страниц.

Для этого мы загрузим специальную страницу подписки на push-уведомления в папку ресурсов Marketo, а затем откроем ее с целевой страницы. Давайте создадим эту страницу подписки.

Получите файл push-subscription.html из следующего gist:
https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-push-subscription-html

Откройте файл и измените следующие строки:

• Строка 8 — измените ссылку на URL файла manifest.json, загруженного на предыдущем шаге.
• Строка 24 — измените значение параметра scope на URL-адрес вашей папки ресурсов (это папка, где находится manifest.json).
• Строка 20 — измените значение параметра applicationCode на ваш Pushwoosh App Id.

Обратите внимание, что скрипт также сопоставляет push-уведомления Pushwoosh, ориентированные на пользователя, с идентификатором лида (Lead Identifier) Marketo: userId:leadId (строка 26)

Загрузите полученный файл в папку «Images and Files». Теперь в этой папке должны быть следующие файлы:

Получите файл pushwoosh-template.html из следующего gist:
https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-pushwoosh-template-html

Откройте файл и измените следующие строки:

• Строка 47 — измените значение параметра scope на URL-адрес вашей папки ресурсов.
• Строка 65 — измените ссылку на URL файла push-subscription.html, загруженного на предыдущем шаге.
• Строка 43 — измените значение параметра applicationCode на ваш Pushwoosh App Id.

Этот скрипт, как и предыдущий, также сопоставляет push-уведомления Pushwoosh, ориентированные на пользователя, с идентификатором лида Marketo: userId:leadId (строка 49)

Теперь перейдите в раздел «Templates» ваших целевых страниц Marketo, создайте шаблон (на скриншоте ниже он называется «pushwoosh-template») и вставьте в него содержимое полученного файла.

Теперь давайте создадим новую целевую страницу на основе этого шаблона.

В нашем примере, чтобы продемонстрировать возможности интеграции Pushwoosh с автоматизацией кампаний Marketo, для простоты мы добавим на целевую страницу простую ссылку. Мы собираемся создать кампанию, которая будет запускать персональное push-уведомление, когда пользователь нажимает на эту ссылку.

Мы будем использовать тот же URL, что и у целевой страницы.

<a href="https://na-ab24.marketo.com/lp/765-IWA-819/pushwoosh-landing.html">Пришлите мне предложение!</a>

Перейдите в раздел «Admin» в Marketo и создайте новый Webhook со следующими параметрами:

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

Вставьте следующий код в качестве шаблона.

{
        "request": {
            "application": "УКАЖИТЕ_ВАШ_PUSHWOOSH_APP_ID",
            "auth": "ВВЕДИТЕ_ВАШ_API-ТОКЕН_PUSHWOOSH",
            "notifications": [{
                "send_date": "now",
                "ignore_user_timezone": true,
                "content": "У нас есть новое предложение для вас!",
                "users" : ["{{lead.Id:default="ABCD-EFGH"}}"]
            }]
        }
    }

Обратите внимание, что мы используем Marketo Lead ID для обращения к пользователю в Pushwoosh. Подробнее о push-уведомлениях, ориентированных на пользователя, читайте здесь.

В нашем очень простом примере мы используем статическое push-сообщение. Однако вы можете использовать всю функциональность /createMessage

Для персонализации push-уведомлений вы можете использовать Preset из Pushwoosh и передавать значения из Marketo в параметрах «dynamic_content_placeholders» вызова /createMessage для персонализации push-уведомлений.

Перейдите в раздел «Marketing Activities» в Marketo и создайте кампанию.

В нашем примере мы будем запускать кампанию, когда пользователь нажимает на ссылку (ту, которую мы создали двумя шагами выше) на нашей целевой странице.

b. Выберите Webhook «send_push» в разделе «Flow»

• Теперь откройте URL-адрес целевой страницы
• Нажмите на кнопку «Да, хочу», чтобы открыть диалоговое окно подписки на push-уведомления
• Подпишитесь на push-уведомления
• Нажмите на ссылку «Пришлите мне предложение!»

Вы получили свое автоматизированное push-уведомление из Marketo!