Integração com Marketo

É necessária a ajuda de um desenvolvedor

Você precisará da ajuda da sua equipe de desenvolvimento para configurar a integração. Por favor, compartilhe este guia com eles.

Este guia explica como integrar o Marketo com a Pushwoosh. Você poderá usar o canal de comunicação de Notificações Push Web como parte de suas campanhas de marketing com o Marketo.

Como exemplo, imagine que um usuário visitou sua landing page do Marketo, mas não realizou nenhuma ação lá. Você poderá alcançar esse usuário com uma notificação push web como um lembrete. Essa notificação push web também pode ser personalizada com os dados do Marketo registrados para esse usuário para o máximo engajamento!

Nota

O HTTPS (“Landing Pages Seguras”) deve estar ativado na sua instância do Marketo.

Embora seja possível executar notificações push web com sites HTTP não seguros, recomendamos fortemente o uso de páginas web seguras com HTTPS. A partir de outubro de 2017, com o lançamento do Chrome 62, o Google Chrome marca todas as páginas web não seguras que contêm formulários com o aviso “Não seguro”.

Leia mais aqui: 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

Se você ainda quiser usar um site HTTP não seguro, siga o guia Chrome/Firefox Web Push para sites HTTP.

Você pode obter um certificado SSL GRATUITO aqui: https://letsencrypt.org/

1. Criando o Service Worker

Siga este guia e execute os passos de pré-requisito e os passos 1 - 2.2.

Após concluir os passos acima, você deve ter os arquivos manifest.json e pushwoosh-service-worker.js prontos.

Vá para o Marketo Design Studio. O Marketo só pode fazer upload de arquivos para a pasta de recursos, a pasta chamada “Images and Files”. Faça o upload de manifest.json e pushwoosh-service-worker.js para esta pasta.

2. Criando a página de inscrição para push

Como mencionado acima, o Marketo só pode fazer upload de arquivos para a pasta de recursos, que é diferente do escopo das landing pages. Por exemplo, se você clicar em qualquer arquivo carregado acima e verificar sua URL, verá algo como “https://your-host-name.com/rs/765-IWA-819/images/pushwoosh-service-worker.js”. No entanto, se você clicar na landing page e verificar sua URL, será algo como: “https://your-host-name.com/lp/765-IWA-819/pushwoosh-landing.html”. Note a parte “lp” nas URLs das landing pages e “rs” nas URLs dos scripts.

Isso significa que precisamos registrar nosso script de Service Worker em um escopo diferente das landing pages.

Para conseguir isso, faremos o upload de uma página especial de inscrição para push para a pasta de recursos do Marketo e, em seguida, a abriremos a partir da landing page. Vamos criar esta página de inscrição.

Obtenha o arquivo push-subscription.html do seguinte gist: https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-push-subscription-html

Abra o arquivo e altere as seguintes linhas:

• Linha 8 - altere o link para a URL do arquivo manifest.json que foi carregado no passo anterior.
• Linha 24 - altere o valor do parâmetro scope para a URL da sua pasta de recursos (esta é a pasta onde o manifest.json está).
• Linha 20 - altere o valor do parâmetro applicationCode para o seu App Id da Pushwoosh.

Note que o script também mapeia as notificações push centradas no usuário da Pushwoosh com o Lead Identifier do Marketo: userId:leadId (linha 26)

Faça o upload do arquivo resultante para a pasta “Images and Files”. Agora você deve ter estes arquivos na pasta:

3. Criando a landing page com inscrição para push

Obtenha o arquivo pushwoosh-template.html do seguinte gist: https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-pushwoosh-template-html

Abra o arquivo e altere as seguintes linhas:

• Linha 47 - altere o valor do parâmetro scope para a URL da sua pasta de recursos.
• Linha 65 - altere o link para a URL do arquivo push-subscription.html carregado no passo anterior.
• Linha 43 - altere o valor do parâmetro applicationCode para o seu App Id da Pushwoosh.

Este script, assim como o anterior, também mapeia as notificações push centradas no usuário da Pushwoosh com o Lead Identifier do Marketo: userId:leadId (linha 49)

Agora vá para a seção “Templates” das suas landing pages do Marketo, crie o template (chamado “pushwoosh-template” na captura de tela abaixo) e copie e cole o conteúdo do arquivo resultante lá.

Agora vamos criar uma nova landing page baseada neste template.

Em nosso exemplo, para mostrar as capacidades da integração da Pushwoosh com a automação de campanhas do Marketo, por uma questão de simplicidade, adicionaremos um link simples à landing page. Vamos criar uma campanha que irá disparar uma notificação push pessoal quando o usuário clicar neste link.

Vamos usar a mesma URL da landing page.

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

4. Criando o Webhook da Pushwoosh

Vá para a seção “Admin” do Marketo e crie um novo Webhook com os seguintes parâmetros:

• URL - https://go.pushwoosh.com/json/1.3/createMessage
• Tipo de Requisição: POST

Cole o seguinte código como um 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 que usamos o Lead ID do Marketo para referenciar o usuário na Pushwoosh. Veja mais sobre notificações push centradas no usuário aqui.

Em nosso exemplo muito simples, usamos uma mensagem push estática. No entanto, você pode usar toda a funcionalidade do createMessage

Para personalizar a notificação push, você pode usar um Preset da Pushwoosh e passar os valores do Marketo nos parâmetros “dynamic_content_placeholders” da chamada /createMessage para personalização do push.

5. Integrando com a campanha de automação do Marketo

Vá para a seção “Marketing Activities” do Marketo e crie uma Campanha.

Para o nosso exemplo, vamos disparar a campanha quando o usuário clicar em um link (aquele que criamos apenas dois passos acima) em nossa landing page.

b. Selecione o Webhook “send_push” na seção “Flow”

• Agora abra a URL da landing page
• Clique no botão “Yes, I Want” para abrir o diálogo de inscrição para push
• Inscreva-se para receber as notificações push
• Clique no link “Send me an Offer!”

Você recebeu sua notificação push automatizada do Marketo!