Intégration Marketo

Ce guide explique comment intégrer Marketo à Pushwoosh. Vous pourrez utiliser le canal de communication des notifications push web dans le cadre de vos campagnes marketing avec Marketo.

Par exemple, imaginez qu’un utilisateur visite votre page de destination Marketo sans y effectuer d’action. Vous pourrez alors recontacter cet utilisateur avec une notification push web pour lui rappeler votre offre. Cette notification push web peut également être personnalisée avec les données Marketo enregistrées pour cet utilisateur, afin d’obtenir un engagement maximal !

Suivez ce guide et effectuez les étapes prérequises ainsi que les étapes 1 à 2.2.

Après avoir terminé les étapes ci-dessus, vous devriez avoir les fichiers manifest.json et pushwoosh-service-worker.js à portée de main.

Passez au Marketo Design Studio. Marketo ne peut téléverser des fichiers que dans le dossier de ressources, appelé « Images and Files ».
Téléversez les fichiers manifest.json et pushwoosh-service-worker.js dans ce dossier.

Comme mentionné ci-dessus, Marketo ne peut téléverser des fichiers que dans le dossier de ressources, dont la portée (scope) est différente de celle des pages de destination.
Par exemple, si vous cliquez sur un fichier téléversé ci-dessus et que vous vérifiez son URL, vous verrez quelque chose comme « https://your-host-name.com/rs/765-IWA-819/images/pushwoosh-service-worker.js ».
Cependant, si vous cliquez sur la page de destination et que vous vérifiez son URL, ce sera quelque chose comme : « https://your-host-name.com/lp/765-IWA-819/pushwoosh-landing.html ».
Notez la partie « lp » dans les URL des pages de destination et « rs » dans les URL des scripts.

Cela signifie que nous devons enregistrer notre script Service Worker dans une portée (scope) différente de celle des pages de destination.

Pour ce faire, nous allons téléverser une page d’abonnement aux notifications push spéciale dans le dossier de ressources Marketo, puis l’ouvrir depuis la page de destination. Créons cette page d’abonnement.

Récupérez le fichier push-subscription.html depuis le gist suivant :
https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-push-subscription-html

Ouvrez le fichier et modifiez les lignes suivantes :

• Ligne 8 - remplacez le lien par l’URL du fichier manifest.json téléversé à l’étape précédente.
• Ligne 24 - remplacez la valeur du paramètre scope par l’URL de votre dossier de ressources (le dossier où se trouve manifest.json).
• Ligne 20 - remplacez la valeur du paramètre applicationCode par votre App Id Pushwoosh.

Notez que le script mappe également les notifications push de Pushwoosh centrées sur l’utilisateur avec l’identifiant de prospect (Lead Identifier) de Marketo : userId:leadId (ligne 26)

Téléversez le fichier résultant dans le dossier « Images and Files ». Vous devriez maintenant avoir ces fichiers dans le dossier :

Récupérez le fichier pushwoosh-template.html depuis le gist suivant :
https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-pushwoosh-template-html

Ouvrez le fichier et modifiez les lignes suivantes :

• Ligne 47 - remplacez la valeur du paramètre scope par l’URL de votre dossier de ressources.
• Ligne 65 - remplacez le lien par l’URL du fichier push-subscription.html téléversé à l’étape précédente.
• Ligne 43 - remplacez la valeur du paramètre applicationCode par votre App Id Pushwoosh.

Ce script, comme le précédent, mappe également les notifications push de Pushwoosh centrées sur l’utilisateur avec l’identifiant de prospect (Lead Identifier) de Marketo : userId:leadId (ligne 49)

Allez maintenant dans la section « Templates » de vos pages de destination Marketo, créez le modèle (nommé « pushwoosh-template » dans la capture d’écran ci-dessous) et copiez-y le contenu du fichier résultant.

Créons maintenant une nouvelle page de destination basée sur ce modèle.

Dans notre exemple, pour montrer les capacités de l’intégration de Pushwoosh avec l’automatisation de campagne Marketo, nous allons par souci de simplicité ajouter un simple lien à la page de destination. Nous allons créer une campagne qui déclenchera une notification push personnelle lorsque l’utilisateur cliquera sur ce lien.

Nous allons utiliser la même URL que la page de destination.

<a href="https://na-ab24.marketo.com/lp/765-IWA-819/pushwoosh-landing.html">Envoyez-moi une offre !</a>

Allez dans la section « Admin » de Marketo et créez un nouveau Webhook avec les paramètres suivants :

• URL - https://go.pushwoosh.com/json/1.3/createMessage
• Type de requête : POST

Collez le code suivant comme modèle.

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

Notez que nous utilisons l’ID de prospect (Lead ID) Marketo pour référencer l’utilisateur dans Pushwoosh. Pour en savoir plus sur les notifications push centrées sur l’utilisateur, cliquez ici.

Dans notre exemple très simple, nous utilisons un message push statique. Cependant, vous pouvez utiliser toutes les fonctionnalités de /createMessage

Pour personnaliser la notification push, vous pouvez utiliser un Preset de Pushwoosh et passer les valeurs de Marketo dans les paramètres « dynamic_content_placeholders » de l’appel /createMessage pour la personnalisation du push.

Allez dans la section « Marketing Activities » de Marketo et créez une campagne.

Pour notre exemple, nous déclencherons la campagne lorsque l’utilisateur cliquera sur un lien de notre page de destination (celui que nous avons créé deux étapes plus haut).

b. Sélectionnez le Webhook « send_push » dans la section « Flow »

• Maintenant, ouvrez l’URL de la page de destination
• Cliquez sur le bouton « Yes, I Want » pour ouvrir la boîte de dialogue d’abonnement aux notifications push
• Abonnez-vous aux notifications push
• Cliquez sur le lien « Send me an Offer! »

Vous avez reçu votre notification push automatisée depuis Marketo !