Marketo-AusgabeTool

Mit dem Marketo-Ausgabe-Tool können Sie einen Aufruf an den Marketo-REST-API-Endpunkt ausführen: Leads erstellen/aktualisieren. Die Daten werden basierend auf der Aktion, die Sie bei der Konfiguration angeben, an Marketo ausgegeben.

Wichtig

Dieses Tool ist nicht automatisch im Lieferumfang von Alteryx Designer enthalten. Wenn Sie dieses Tool verwenden möchten, können Sie es von der Alteryx Community herunterladen.

Tool-Konfiguration

Marketo-Anmeldeinformationen

URL : die Marketo-REST-Instanz zum Abrufen von Datensätzen. Diese Informationen befinden sich in Marketo („Admin“ > „Integration“ > „Web Services“ > „REST-API“).

ClientID : Client-ID für den API-Rolle-Benutzer. Diese Informationen befinden sich in Marketo („Admin“ > „Integration“ > „LaunchPoint“).

Client-Geheimnis : Client-Geheimnis für den API-Rolle-Benutzer. Diese Informationen befinden sich in Marketo („Admin“ > „Integration“ > „LaunchPoint“).

Weitere Informationen zum Einrichten des Webdienstes und der Benutzerrollen für den Zugriff auf die Marketo-REST-API finden Sie auf der Website mit Dokumentation zu Marketo REST.

Optionen

Schlüsselfeld : Diese Dropdown-Liste enthält die Felder, die Sie als Eingabe für das Tool verwendet haben. Anhand dieses Feldes sucht Marketo nach doppelten Datensätzen. Wenn kein Feld angegeben ist, wird standardmäßig das E-Mail-Feld verwendet.

Wenn die Datensätze das Feld „ID“ enthalten, muss „ID“ als Schlüsselfeld gewählt werden.

Wählen Sie eine Ausgabeaktion .

Erstellen oder Aktualisieren (Standard) : Erstellt basierend auf dem Schlüsselfeld einen Lead, falls dieser nicht vorhanden ist, bzw. aktualisiert den ggf. vorhandenen Lead.
Duplikat erstellen : Erstellt einen zweiten Lead, wenn bereits ein Lead vorhanden ist.
Nur aktualisieren : Aktualisiert den ggf. bereits vorhandenen Lead. Wenn der Lead noch nicht vorhanden ist, wird keine Aktion durchgeführt.
Nur erstellen : Erstellt einen neuen Lead, wenn der Lead noch nicht vorhanden ist. Wird übersprungen, wenn bereits der Lead bereits vorhanden ist.

Partitionsname : Wenn in der Marketo-Instanz, auf die Sie zugreifen, Partitionen konfiguriert wurden, werden sie in der Dropdown-Liste angezeigt. Diese Feldauswahl ist erforderlich, wenn die auszugebende Instanz über Lead-Partitionen verfügen soll. Wenn keine Partitionen verfügbar sind, wird „Standard“ verwendet.

Datenaspekte

Im Ergebnisfenster wird eine Meldung mit einer Statusübersicht zu den übermittelten Datensätzen angezeigt.

Basierend auf den übermittelten Datensätzen wurden drei Datensätze übersprungen und zwei Datensätze erstellt.

Fehlermeldungen wie Authentifizierungsfehler usw. werden im Konfigurationsfenster angezeigt. Fehlermeldungen wie Meldungen bei fehlenden Konfigurationseinstellungen werden über dem Tool im Workflow angezeigt.

Das Tool sendet Batches von maximal 300 Datensätzen, wobei jeder Batch als separater API-Aufruf gilt, bis die von Marketo festgelegte Obergrenze pro Tag erreicht ist. Informationen zu Obergrenzen pro Tag finden Sie in der Dokumentation zur Marketo-REST-API . Anfragen an die REST-API zählen bei der täglichen Obergrenze für die SOAP-API nicht mit.

Sie sollten vor dem Zurückschreiben nach Marketo sicherstellen, dass die Marketo-Feldstrukturen in Alteryx beibehalten werden, um Fehler zu vermeiden. Der Marketo-Connector konvertiert die Daten in die richtigen Datentypen, bevor die Daten in Marketo ausgegeben werden, solange die Feldnamen gültig sind. Werden die Feldnamen nicht in Marketo gefunden, schlägt die Ausgabe fehl.

Datum/Uhrzeit-Felder

Alle Datumsangaben in Marketo werden mit einem UTC-Versatz gespeichert. Dieses Format umfasst die lokale Zeit mit einem angehängten Versatz, der positiv oder negativ sein kann. Ein Datum/Uhrzeit-Wert in Marketo könnte beispielsweise wie folgt aussehen, wobei das in Marketo eingegebene Datum aus einer Zeitzone stammt, die 6 Stunden vor UTC (Mountain Daylight Time) liegt:

2012-02-28T14:00:00-06:00.

Datum aus Marketo lesen

Um Alteryx-Creators das Arbeiten mit diesen Datum/Uhrzeit-Werten zu vereinfachen, konvertiert Alteryx den aus Marketo ausgelesenen Datum/Uhrzeit-Wert in einen Datum/Uhrzeit-Wert des lokalen Computers. Dadurch können Experten in ihrer lokalen Zeit mit den Datum/Uhrzeit-Werten arbeiten. Angenommen, Ihre Zeit liegt ebenfalls 6 Stunden vor der UTC-Zeit, würde der zuvor angeführte Datum/Uhrzeit-Wert beispielsweise in einem Alteryx-Workflow oder einer Alteryx-App wie folgt aussehen:

2012-02-28 14:00:00

Wenn Sie nur 4 Stunden vor der UTC-Zeit liegen, würde er wie folgt zurückgegeben werden:

2012-02-28 16:00:00

Datum in Marketo schreiben

Beim Zurückschreiben von Datum/Uhrzeit-Werten in Marketo mithilfe eines Einfügungs- oder Aktualisierungsvorgangs konvertiert Alteryx die Werte in das von Marketo erwartete Format zurück. Dies erfolgt durch Berechnen des UTC-Versatzes auf dem lokalen Computer und Anhängen des entsprechenden Werts an das Ende des Datum/Uhrzeit-Werts. Alteryx fügt zwischen den Datum- und Uhrzeit-Teilen des Datum/Uhrzeit-Werts ein „T“ ein, wie in den Beispielen oben dargestellt.

Wenn anhand der Beispiele oben ein Datum/Uhrzeit-Wert aus einer Zeitzone mit einem Versatz von -6:00 geschrieben wurde:

2012-02-28T14:00:00-06:00.

Und später beim Zurückschreiben nach Marketo (unverändert) von einem Computer mit einem UTC-Versatz von -4:00 Stunden würde das Zurückschreiben in Marketo folgendermaßen lauten:

2012-02-28T16:00:00-04:00.

Beide Zeiten sind identisch und stellen denselben zeitlichen Moment dar.

In diesem Abschnitt: