Integración con Marketo

Se necesita ayuda del desarrollador

Necesitará la ayuda de su equipo de desarrollo para configurar la integración. Por favor, comparta esta guía con ellos.

Esta guía explica cómo integrar Marketo con Pushwoosh. Podrá utilizar el canal de comunicación de Notificaciones Push Web como parte de sus campañas de marketing con Marketo.

Como ejemplo, imagine que un usuario visitó su página de destino de Marketo pero no realizó ninguna acción allí. Podría contactar a este usuario con una notificación push web como recordatorio. ¡Esta notificación push web también puede personalizarse con los datos de Marketo registrados para este usuario para lograr la máxima interacción!

Nota

HTTPS (“Páginas de destino seguras”) debe estar habilitado en su instancia de Marketo.

Aunque es posible ejecutar notificaciones push web con sitios web no seguros HTTP, recomendamos encarecidamente utilizar páginas web seguras con HTTPS. A partir de octubre de 2017 con el lanzamiento de Chrome 62, Google Chrome marca todas las páginas web no seguras que contienen formularios con la advertencia “No es seguro”.

Lea más aquí: 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

Si aún desea continuar con un sitio web no seguro HTTP, siga la guía Push web de Chrome/Firefox para sitios web HTTP.

Puede obtener un certificado SSL GRATUITO aquí: https://letsencrypt.org/

1. Creación del Service Worker

Siga esta guía y realice los pasos de prerrequisito y los pasos 1 - 2.2.

Después de completar los pasos anteriores, debería tener a mano los archivos manifest.json y pushwoosh-service-worker.js.

Cambie a Marketo Design Studio. Marketo solo puede subir archivos a la carpeta de recursos, la carpeta llamada “Images and Files”. Suba manifest.json y pushwoosh-service-worker.js a esta carpeta.

2. Creación de la página de suscripción push

Como se mencionó anteriormente, Marketo solo puede subir archivos a la carpeta de recursos, que es diferente del ámbito de las páginas de destino. Por ejemplo, si hace clic en cualquier archivo subido anteriormente y comprueba su URL, verá algo como “https://your-host-name.com/rs/765-IWA-819/images/pushwoosh-service-worker.js”. Sin embargo, si hace clic en la página de destino y comprueba su URL, será algo como: “https://your-host-name.com/lp/765-IWA-819/pushwoosh-landing.html”. Tenga en cuenta la parte “lp” en la URL de las páginas de destino y “rs” en la URL de los scripts.

Eso significa que necesitamos registrar nuestro script de Service Worker en un ámbito diferente al de las páginas de destino.

Para lograrlo, subiremos una página especial de suscripción push a la carpeta de recursos de Marketo y luego la abriremos desde la página de destino. Vamos a crear esta página de suscripción.

Obtenga el archivo push-subscription.html del siguiente gist: https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-push-subscription-html

Abra el archivo y cambie las siguientes líneas:

• Línea 8 - cambie el enlace a la URL del archivo manifest.json subido en el paso anterior.
• Línea 24 - cambie el valor del parámetro scope a la URL de su carpeta de recursos (esta es la carpeta donde está manifest.json).
• Línea 20 - cambie el valor del parámetro applicationCode a su ID de aplicación de Pushwoosh.

Tenga en cuenta que el script también mapea las notificaciones push centradas en el usuario de Pushwoosh con el Identificador de Lead de Marketo: userId:leadId (línea 26)

Suba el archivo resultante a la carpeta “Images and Files”. Ahora debería tener estos archivos en la carpeta:

3. Creación de la página de destino con suscripción push

Obtenga el archivo pushwoosh-template.html del siguiente gist: https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-pushwoosh-template-html

Abra el archivo y cambie las siguientes líneas:

• Línea 47 - cambie el valor del parámetro scope a la URL de su carpeta de recursos.
• Línea 65 - cambie el enlace a la URL del archivo push-subscription.html subido en el paso anterior.
• Línea 43 - cambie el valor del parámetro applicationCode a su ID de aplicación de Pushwoosh.

Este script, como el anterior, también mapea las notificaciones push centradas en el usuario de Pushwoosh con el Identificador de Lead de Marketo: userId:leadId (línea 49)

Ahora vaya a la sección “Templates” de sus páginas de destino de Marketo, cree la plantilla (llamada “pushwoosh-template” en la captura de pantalla a continuación) y copie y pegue el contenido del archivo resultante allí.

Ahora vamos a crear una nueva página de destino basada en esta plantilla.

En nuestro ejemplo, para mostrar las capacidades de la integración de Pushwoosh con la automatización de campañas de Marketo, por simplicidad, agregaremos un enlace simple a la página de destino. Vamos a crear una campaña que activará una notificación push personal cuando el usuario haga clic en este enlace.

Vamos a usar la misma URL que la página de destino.

<a href="https://na-ab24.marketo.com/lp/765-IWA-819/pushwoosh-landing.html">¡Envíenme una oferta!</a>

4. Creación del Webhook de Pushwoosh

Vaya a la sección “Admin” de Marketo y cree un nuevo Webhook con los siguientes parámetros:

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

Pegue el siguiente código como plantilla.

{
        "request": {
            "application": "INTRODUZCA_SU_ID_DE_APLICACIÓN_PUSHWOOSH",
            "auth": "INTRODUZCA_SU_TOKEN_DE_API_PUSHWOOSH_AQUÍ",
            "notifications": [{
                "send_date": "now",
                "ignore_user_timezone": true,
                "content": "¡Tenemos una nueva oferta para usted!",
                "users" : ["{{lead.Id:default="ABCD-EFGH"}}"]
            }]
        }
    }

Tenga en cuenta que usamos el ID de Lead de Marketo para referirnos al usuario en Pushwoosh. Vea más sobre las notificaciones push centradas en el usuario aquí.

En nuestro ejemplo muy simple, usamos un mensaje push estático. Sin embargo, puede usar toda la funcionalidad de createMessage

Para personalizar la notificación push, puede usar un Preset de Pushwoosh y pasar los valores de Marketo en los parámetros “dynamic_content_placeholders” de la llamada /createMessage para la personalización del push.

5. Integración con la campaña de automatización de Marketo

Vaya a la sección “Marketing Activities” de Marketo y cree una Campaña.

Para nuestro ejemplo, activaremos la campaña cuando el usuario haga clic en un enlace (el que creamos hace solo dos pasos) en nuestra página de destino.

b. Seleccione el Webhook “send_push” en la sección “Flow”

• Ahora abra la URL de la página de destino
• Haga clic en el botón “Sí, quiero” para abrir el diálogo de suscripción push
• Suscríbase a las notificaciones push
• Haga clic en el enlace “¡Envíenme una oferta!”

¡Ha recibido su notificación push automatizada de Marketo!