Zum Inhalt springen
EntwicklerdokumentationSupport Demo anfordern Anmelden
Pushwoosh.com

Marketo-Integration

Diese Anleitung erklärt, wie Sie Marketo mit 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 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 aufgezeichneten 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 und 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, der „Images and Files“ heißt. Laden Sie manifest.json und pushwoosh-service-worker.js in diesen Ordner hoch.

Hochladen der manifest.json- und Service-Worker-Dateien 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 Landing Pages unterscheidet. Wenn Sie zum Beispiel 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 Landing Page klicken und deren URL überprüfen, wird es etwas wie: „https://your-host-name.com/lp/765-IWA-819/pushwoosh-landing.html“ sein. Beachten Sie den Teil „lp“ in den URLs der Landing Pages und „rs“ in den Skript-URLs.

Das bedeutet, wir müssen unser Service Worker-Skript in einem anderen Geltungsbereich als dem der Landing Pages registrieren.

Um dies zu erreichen, laden wir eine spezielle Push-Abonnementseite in den Marketo-Ressourcenordner hoch und öffnen sie dann von der Landing Page 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 im Ordner haben:

In den Marketo-Ordner 'Images and Files' hochgeladene Dateien

3. Erstellen einer Landing Page 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 „Vorlagen“ Ihrer Marketo-Landingpages, erstellen Sie die Vorlage (im Screenshot unten „pushwoosh-template“ genannt) und kopieren Sie den Inhalt der resultierenden Datei dorthin.

Erstellen der pushwoosh-template im Marketo-Vorlagenbereich

Erstellen wir nun eine neue Landing Page auf Basis dieser Vorlage.

Erstellen einer neuen Landing Page auf Basis der pushwoosh-Vorlage

In unserem Beispiel fügen wir der Landing Page der Einfachheit halber einen einfachen Link hinzu, um die Möglichkeiten der Pushwoosh-Integration mit der Marketo-Kampagnenautomatisierung 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 Landing Page verwenden.

<a href="https://na-ab24.marketo.com/lp/765-IWA-819/pushwoosh-landing.html">Schicken Sie mir ein Angebot!</a>
Landing Page 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": "IHRE_PUSHWOOSH_APP_ID_EINGEBEN",
            "auth": "IHR_PUSHWOOSH_API_TOKEN_HIER_EINGEBEN",
            "notifications": [{
                "send_date": "now",
                "ignore_user_timezone": true,
                "content": "Wir haben ein neues Angebot für Sie!",
                "users" : ["{{lead.Id:default="ABCD-EFGH"}}"]
            }]
        }
    }

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

Webhook-Konfiguration im Marketo-Admin-Bereich

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

Um Push-Benachrichtigungen 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 „Marketingaktivitäten“ von Marketo und erstellen Sie eine Kampagne.

In unserem Beispiel lösen wir die Kampagne aus, wenn der Benutzer auf einen Link (den wir gerade zwei Schritte zuvor erstellt haben) auf unserer Landing Page klickt.

Trigger-Konfiguration für das Benutzerklick-Ereignis in der Marketo-Kampagne

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

Auswahl des send_push-Webhooks im Kampagnen-Flow-Bereich
  • Öffnen Sie nun die URL der Landing Page
  • Klicken Sie auf die Schaltfläche „Ja, ich möchte“, um den Dialog zum Push-Abonnement zu öffnen
  • Abonnieren Sie die Push-Benachrichtigungen
  • Klicken Sie auf den Link „Schicken Sie mir ein Angebot!“

Sie haben Ihre automatisierte Marketo-Push-Benachrichtigung erhalten!

Automatisierte Marketo-Push-Benachrichtigung erfolgreich gesendet