Interact-API-Datenfluss
Die folgende Abbildung zeigt eine einfache Implementierung der Interact-API. Ein Besucher meldet sich bei der Website an und navigiert zu einer Seite, die Angebote enthält. Der Besucher wählt ein Angebot aus und meldet sich ab. Auch wenn die Interaktion einfach ist, so gibt es doch mehrere Ereignisse, die im Touchpoint und im Laufzeitserver auftreten.
Wenn sich ein Besucher anmeldet, löst dies startSession aus.
Diagram showing simple implementation of the Interact API dataflow
In diesem Beispiel führt die Methode startSession vier Schritte durch. Erstens erstellt sie eine neue Laufzeitsitzung. Zweitens sendet sie eine Anforderung, das Kundenprofil in die Sitzung zu laden. Drittens sendet sie eine Anforderung, die Profildaten zu verwenden und ein interaktives Ablaufdiagramm zu starten, um den Kunden in Segmente zu platzieren. Dieses Ablaufdiagramm wird asynchron ausgeführt. Viertens lädt die Laufzeitumgebung etwaige Angebotsunterdrückungs- und globale bzw. individuelle Angebotsverfahrensinformationen in die Sitzung. Die Sitzungsdaten werden für die Dauer der Sitzung im Speicher gehalten.
Der Besucher navigiert durch die Site, bis er einen vordefinierten Interaktionspunkt erreicht. In der Abbildung ist der zweite Interaktionspunkt (Auswahl der Auswahloption) eine Stelle, an der der Besucher auf einen Link klickt, der eine Gruppe von Angeboten darstellt. Der Touchpoint-Manager hat den Link so konfiguriert, dass eine Methode executeBatch ausgelöst wird.
Diagram of the API call triggering the executeBatch method
Die Methode executeBatch ermöglicht es Ihnen, mehr als eine Methode in einem einzelnen Aufruf an den Laufzeitserver aufzurufen. Diese bestimmte executeBatch-Methode ruft zwei andere Methoden auf, getOffers und postEvent. Die Methode getOffers fordert eine Liste von Angeboten an. Die Laufzeitumgebung verwendet die Segmentierungsdaten, die Angebotsunterdrückungsliste, die Verfahrensregeln und das Lernmodul, um einen Satz von Angeboten vorzuschlagen. Die Laufzeitumgebung gibt einen Satz von Angeboten zurück, der auf der Inhaltsseite angezeigt wird.
Die Methode postEvent löst eines der Ereignisse aus, das in der Designumgebung definiert wurde. In diesem bestimmten Fall sendet das Ereignis eine Anforderung, die angezeigten Angebote im Kontaktverlauf zu protokollieren.
Der Besucher wählt eines der Angebote aus (Angebot auswählen).
Diagram showing the postEvent method
Die der Auswahl des Angebots zugeordnete Schaltfläche ist konfiguriert, eine weitere Methode postEvent zu senden. Dieses Ereignis sendet eine Anforderung, die Angebotsannahme im Antwortverlauf zu protokollieren.
Nach dem Auswählen des Angebots ist der Besucher mit der Website fertig und meldet sich ab. Der Abmeldebefehl ist mit der Methode endSession verknüpft.
Diagram showing the end of the API workflow (the endSession method)
Die Methode endSession schließt die Sitzung. Wenn der Besucher vergisst sich abzumelden, gibt es ein konfigurierbares Sitzungszeitlimit um sicherzustellen, dass jede Sitzung einmal endet. Wenn Sie Daten bewahren wollen, die an die Sitzung übergeben werden, wie in Parametern aufgenommene Informationen in der Methode startSession oder setAudience, wenden Sie sich an die Person, die interaktive Ablaufdiagramme erstellt. Die Person, die ein interaktives Ablaufdiagramm erstellt, kann den Prozess "Momentaufnahme" verwenden, um diese Daten in eine Datenbank zu schreiben, bevor die Sitzung endet und diese Daten verloren gehen. Sie können dann die Methode postEvent verwenden, um das interaktive Ablaufdiagramm aufzurufen, das den Prozess "Momentaufnahme" enthält.
Dieses Beispiel ist sehr einfach (der Besucher unternimmt nur vier Aktionen - anmelden, zur Seite mit den Angeboten navigieren, ein Angebot auswählen und abmelden; was eine einfache Interaktion ist), um die grundlegenden Informationen darzustellen, wie die Anwendungsprogrammierschnittstelle zwischen Ihrem Touchpoint und der Laufzeitumgebung funktioniert. Sie können Ihre Integration so kompliziert wie nötig gestalten (innerhalb den Begrenzungen Ihrer Leistungsanforderungen).