Zum Inhalt springen
EntwicklerdokumentationSupport Demo anfordern Anmelden
Pushwoosh.com

Marketo-Integration

Diese Anleitung erklärt, wie Sie Marketo in Pushwoosh integrieren. Sie können den Kommunikationskanal Web-Push-Benachrichtigungen als Teil Ihrer Marketingkampagnen mit Marketo nutzen.

Stellen Sie sich zum Beispiel vor, ein Benutzer hat Ihre Marketo-Landingpage besucht, aber dort keine Aktion ausgeführt. Sie könnten diesen Benutzer mit einer Web-Push-Benachrichtigung als Erinnerung erreichen. Diese Web-Push-Benachrichtigung kann auch mit den für diesen Benutzer erfassten Marketo-Daten personalisiert werden, um ein maximales Engagement zu erzielen!

1. Erstellen des Service Workers

Anchor link to

Folgen Sie dieser Anleitung und führen Sie die Voraussetzungsschritte sowie die Schritte 1 - 2.2 durch.

Nach Abschluss der obigen Schritte sollten Sie die Dateien manifest.json und pushwoosh-service-worker.js zur Hand haben.

Wechseln Sie zum Marketo Design Studio. Marketo kann Dateien nur in den Ressourcenordner hochladen, den Ordner namens „Images and Files“. Laden Sie manifest.json und pushwoosh-service-worker.js in diesen Ordner hoch.

Hochladen der Dateien manifest.json und service worker in Marketo

2. Erstellen der Push-Abonnementseite

Anchor link to

Wie oben erwähnt, kann Marketo Dateien nur in den Ressourcenordner hochladen, der sich vom Geltungsbereich der Landingpages unterscheidet. Wenn Sie beispielsweise auf eine der oben hochgeladenen Dateien klicken und deren URL überprüfen, sehen Sie etwas wie „https://your-host-name.com/rs/765-IWA-819/images/pushwoosh-service-worker.js“. Wenn Sie jedoch auf die Landingpage klicken und deren URL überprüfen, wird sie etwa so aussehen: „https://your-host-name.com/lp/765-IWA-819/pushwoosh-landing.html“. Beachten Sie den Teil „lp“ in den URLs der Landingpages und „rs“ in den Skript-URLs.

Das bedeutet, wir müssen unser Service Worker-Skript in einem anderen Geltungsbereich als den Landingpages registrieren.

Um dies zu erreichen, laden wir eine spezielle Push-Abonnementseite in den Marketo-Ressourcenordner hoch und öffnen sie dann von der Landingpage aus. Erstellen wir diese Abonnementseite.

Holen Sie sich die Datei push-subscription.html aus dem folgenden Gist: https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-push-subscription-html

Öffnen Sie die Datei und ändern Sie die folgenden Zeilen:

  • Zeile 8 – ändern Sie den Link zur URL der im vorherigen Schritt hochgeladenen Datei manifest.json.
  • Zeile 24 – ändern Sie den Wert des Parameters scope auf die URL Ihres Ressourcenordners (dies ist der Ordner, in dem sich manifest.json befindet).
  • Zeile 20 – ändern Sie den Wert des Parameters applicationCode auf Ihre Pushwoosh App-ID.

Beachten Sie, dass das Skript auch benutzerzentrierte Push-Benachrichtigungen von Pushwoosh mit der Lead-ID von Marketo verknüpft: userId:leadId (Zeile 26)

Laden Sie die resultierende Datei in den Ordner „Images and Files“ hoch. Jetzt sollten Sie diese Dateien in dem Ordner haben:

In den Ordner „Images and Files“ von Marketo hochgeladene Dateien

3. Erstellen einer Landingpage mit Push-Abonnement

Anchor link to

Holen Sie sich die Datei pushwoosh-template.html aus dem folgenden Gist: https://gist.github.com/shaders/2b518e3acaf9b4712d5260205243343d#file-pushwoosh-template-html

Öffnen Sie die Datei und ändern Sie die folgenden Zeilen:

  • Zeile 47 – ändern Sie den Wert des Parameters scope auf die URL Ihres Ressourcenordners.
  • Zeile 65 – ändern Sie den Link zur URL der im vorherigen Schritt hochgeladenen Datei push-subscription.html.
  • Zeile 43 – ändern Sie den Wert des Parameters applicationCode auf Ihre Pushwoosh App-ID.

Dieses Skript verknüpft wie das vorherige auch benutzerzentrierte Push-Benachrichtigungen von Pushwoosh mit der Lead-ID von Marketo: userId:leadId (Zeile 49)

Gehen Sie nun zum Abschnitt „Templates“ Ihrer Marketo-Landingpages, erstellen Sie die Vorlage (im Screenshot unten „pushwoosh-template“ genannt) und fügen Sie den Inhalt der resultierenden Datei dort ein.

Erstellen der pushwoosh-Vorlage im Abschnitt „Vorlagen“ von Marketo

Erstellen wir nun eine neue Landingpage basierend auf dieser Vorlage.

Erstellen einer neuen Landingpage basierend auf der pushwoosh-Vorlage

In unserem Beispiel fügen wir der Landingpage einen einfachen Link hinzu, um die Möglichkeiten der Pushwoosh-Integration mit der Marketo-Kampagnenautomatisierung der Einfachheit halber zu zeigen. Wir werden eine Kampagne erstellen, die eine persönliche Push-Benachrichtigung auslöst, wenn der Benutzer auf diesen Link klickt.

Wir werden dieselbe URL wie die Landingpage verwenden.

<a href="https://na-ab24.marketo.com/lp/765-IWA-819/pushwoosh-landing.html">Senden Sie mir ein Angebot!</a>
Landingpage mit Link für ein Push-Benachrichtigungsangebot

4. Erstellen eines Pushwoosh-Webhooks

Anchor link to

Gehen Sie zum „Admin“-Bereich von Marketo und erstellen Sie einen neuen Webhook mit den folgenden Parametern:

Fügen Sie den folgenden Code als Vorlage ein.

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

Beachten Sie, dass wir die Marketo Lead-ID verwenden, um den Benutzer in Pushwoosh zu referenzieren. Erfahren Sie mehr über benutzerzentrierte Push-Benachrichtigungen hier.

Webhook-Konfiguration im Admin-Bereich von Marketo

In unserem sehr einfachen Beispiel verwenden wir eine statische Push-Nachricht. Sie können jedoch die gesamte Funktionalität von createMessage nutzen.

Um eine Push-Benachrichtigung zu personalisieren, können Sie ein Preset von Pushwoosh verwenden und die Werte von Marketo in den „dynamic_content_placeholders“-Parametern des /createMessage-Aufrufs zur Push-Personalisierung übergeben.

5. Integration mit der Marketo-Automatisierungskampagne

Anchor link to

Gehen Sie zum Abschnitt „Marketing Activities“ von Marketo und erstellen Sie eine Kampagne.

Für unser Beispiel lösen wir die Kampagne aus, wenn der Benutzer auf einen Link (den wir gerade zwei Schritte zuvor erstellt haben) auf unserer Landingpage klickt.

Trigger-Konfiguration für das Klickereignis des Benutzers in der Marketo-Kampagne

b. Wählen Sie den „send_push“-Webhook im Abschnitt „Flow“ aus.

Auswahl des send_push-Webhooks im Abschnitt „Flow“ der Kampagne
  • Öffnen Sie nun die URL der Landingpage
  • Klicken Sie auf die Schaltfläche „Ja, ich möchte“, um den Dialog zum Abonnieren von Push-Benachrichtigungen zu öffnen
  • Abonnieren Sie die Push-Benachrichtigungen
  • Klicken Sie auf den Link „Senden Sie mir ein Angebot!“

Sie haben Ihre automatisierte Push-Benachrichtigung von Marketo erhalten!

Automatisierte Push-Benachrichtigung von Marketo erfolgreich gesendet