In diesem Artikel werden die Schritte zum Aufbau einer Marketingautomation mithilfe des HTTP-Request-Jobs im Whiteboard erläutert.

Diese Funktion sollte möglichst von technisch versierten Anwendern genutzt werden, da sie grundlegende Kenntnisse zu HTTP-Requests erfordert.

Das Vorgehen ist ähnlich dem zum Erstellen eines anderen beliebigen Whiteboards. Die Job-spezifischen Einstellungen, die Sie definieren, umfassen: Request-Parameter und Parser-Merkmale zur Verarbeitung der HTTP-Antwort.

HTTP-Request definieren

  1. Legen Sie ein neues Whiteboard an.

    HTTP-Request ist mit jeder Art von Whiteboard verfügbar: ereignisbasiert, terminiert und sich wiederholend.
    HTTP-Antwort ist folgendermaßen verfügbar:

    • Ereignisbasiert: verfügbar
    • Terminiert: mit Ereigniszone verfügbar
    • Sich wiederholend: nicht verfügbar – ausschließlich für HTTP-Requests verfügbar
  2. Wählen Sie das Eingabeereignis aus (zum Beispiel, Tritt Verteiler bei), und fügen Sie den Job Senden Sie Einen HTTP-Request hinzu.

  3. Definieren Sie die Methode: Get, Post, Put, Patch und Delete.
  4. Aktivieren Sie optional die Auswahl Mit dem Whiteboard-Ablauf fortfahren, wenn der Request fehlschlägt.
  5. Wählen Sie den Inhaltstyp für Ihren Request aus. Folgende Inhaltstypen sind verfügbar: application/json, application/xml and application/x-www-form-urlencoded.
    Er wird als Ihr Request-Header verwendet. Mithilfe der Schaltfläche Header hinzufügen können Sie jetzt weitere Header hinzufügen.
  6. Klicken Sie auf Parameter hinzufügen. Legen Sie einen Namen für den Parameter fest, und konfigurieren Sie seinen Wert.

    Bis zu zehn Parameter können in Ihrer Automatisierung hinzugefügt werden.

  7. Konfigurieren Sie den Parser für den Antworttext. Sie können die vom Server empfangenen Parameterwerte verwenden. 

    1. Wählen Sie im Abschnitt Parser für HTTP-Antworttext den Parsertyp aus, und klicken Sie auf Parser hinzufügen.

      Der Textparser ist für die branchenüblichen Formate XML und JSON geeignet. Die Verwendung eines benutzerdefinierten Regex-ähnlichen Parsers ist ebenfalls möglich. 

      ParsertypDetails
      XMLWeitere Informationen finden Sie im Internet, zum Beispiel hier.
      JSONWeitere Informationen finden Sie im Internet, zum Beispiel hier.
      Nur-TextDiese Option ist für Ihren benutzerdefinierten Parser unter Verwendung von Mapp Engage-Funktionen.
      Keine

      Wählen Sie diese Option aus, wenn Sie kein Interesse an Parametern haben.

    2. Geben Sie die Parsing-Formel sowie Name und Typ des Parameters ein. Klicken Sie auf Parser speichern.

    3. Fügen Sie weitere Parser nach Bedarf hinzu.

Konfigurieren des Events HTTP Response Received

Sie haben alles für Ihren HTTP-Request eingerichtet. Das Ereignis HTTP-Antwort Erhalten ist jetzt verfügbar. Sie können auf Basis der HTTP-Antwortstatus (Wert oder Bereich) und/oder der Parameter einen Kriterienabgleich definieren.

Als Standard-Anwendungsfall richten Sie diesen als Mehrfachereignis-Konfiguration ein. Sie können ihn jedoch auch als Einzelereignis einrichten und als Filter verwenden.

6. Fügen Sie das Ereignis HTTP-Antwort erhalten zu Ihrem Automatisierungs-Workflow hinzu.

7. Definieren Sie einen Kriterienabgleich auf Basis der HTTP-Antwortstatus, der Parameter oder einer Kombination aus beidem.

a. basierend auf den HTTP-Antwortstatus:

b. basierend auf Ihren Parametern:

c. Fügen Sie optional einen negativen Pfad hinzu, und konfigurieren Sie diesen ebenfalls.

Klicken Sie auf Speichern.

HTTP-Antwortwerte verwenden

Die geparsten HTTP-Antwortwerte stehen als Ereigniswerte für den nächsten Whiteboard-Job zur Verfügung. Weitere Details zum Aufbau von Whiteboard-Automatisierungen finden Sie in der Online-Hilfe zu Whiteboards.

Anwendungsfälle und How-tos