Endpunkt für eine Marketo-Aktivität erstellen oder bearbeiten

Endpunkte stellen die Konfigurationsinformationen bereit, mit deren Hilfe Studio und die Integrationseinheit eine Verbindung zur Marketo-Plattform herstellen. Der Marketo-Connector unterstützt nur den OAuth-Authentifizierungsmechanismus, um Benutzer für die Ausführung von Operationen zu berechtigen. Der Marketo-Connector unterstützt nur HTTPS-Verbindungen.

Marketo-Endpunkt auswählen oder bearbeiten

  1. Konfigurieren Sie den Marketo-Endpunkt im Teilfenster Endpunkt erstellen oder Endpunkt bearbeiten, wie in der folgenden Tabelle beschrieben.
    Anmerkung: Eine Änderung der Konfigurationseigenschaften eines Endpunkts betrifft alle Orchestrierungen, die diesen Endpunkt im Projekt verwenden. Die Bearbeitungen sind global, nicht lokal.
  2. Klicken Sie auf Verbindung testen, um sicherzustellen, dass die Verbindungsdetails gültig sind und Sie erfolgreich eine Verbindung zu Marketo herstellen können.
  3. Klicken Sie auf OK.
Tabelle 1. Verbindungseigenschaften
Feldname Beschreibung
Hostname Der Hostname für die Marketo-Instanz (Cloud).
API-Version Die API-Version für die Marketo-Instanz. Standardwert: v1
Client-ID Die OAuth-Client-ID für den Zugriff auf die Marketo-Instanz.
Geheimer Schlüssel für Client Der geheime OAuth-Clientschlüssel für den Zugriff auf die Marketo-Instanz.

Die folgenden Parameter sind für die Verbindungstestanzeige für den Endpunkt erforderlich, um eine Verbindung über einen Proxy herzustellen:

Feldname Beschreibung
Hostname Der Hostname des Proxy-Netzes.
Port Die Portnummer des Proxy-Netzes.
Benutzername Der Benutzername für den Zugriff auf den Service über ein Proxy-Netz.
Kennwort Das Kennwort für den Zugriff auf den Service über ein Proxy-Netz.
Anmerkung: Im Abschnitt 'Eingaben zuordnen' jeder Aktivität sind relevante Felder der Endpunktanzeige verfügbar, um die Werte während der Ausführung überschreiben zu können. Benutzer können Daten für verschiedene Gruppen von Parametern angeben, um Proxy-Details, Verbindungsdetails oder Authentifizierungsdetails zu überschreiben. Die Angabe von Daten nur für einen Teil der Felder in einer ausgewählten Gruppe ist für die Überschreibung nicht zulässig.

Vom Marketo-Connector unterstützte Objekte

Die folgenden Objekte werden vom Marketo-Connector sowie von der für das unterstützte Objekt verfügbaren API unterstützt:

Tabelle 2. Operationen 'Erstellen', 'Abrufen', 'Aktualisieren' und 'Löschen'
Marketo-Objekte Erstellen Aktualisieren Upsert Löschen Alle Objekte abrufen Abrufen Suchen
Lead Ja Ja Ja Ja Ja Ja
List Ja Ja Ja
Campaign Ja Ja Ja
Opportunity Ja Ja Ja Ja Ja
Company Ja Ja Ja Ja Ja
Sales Person Ja Ja Ja Ja Ja
Custom Object Ja Ja Ja Ja Ja
Opportunity Roles Ja Ja Ja Ja Ja
Lead Activity Ja
Deleted Leads Ja
Lead Changes Ja
Actity Types Ja
Folder Ja Ja Ja Ja Ja Ja
Folder Content Ja
Email Template Ja Ja Ja Ja Ja Ja
Email Template Content Ja Ja
E-Mail Ja Ja Ja Ja Ja Ja
Email Content Ja Ja
Email Dynamic Content Ja Ja
Snippet Ja Ja Ja Ja Ja
Snippet Content Ja Ja
Snippet Dynamic Content Ja Ja
Datei Ja Ja Ja Ja
Segmentation Ja
Segment Ja

Atomare Operationen:

  • Für Leads
    • Lead mergen
    • Paging-Token abrufen
  • Für Listen
    • Leads aus Liste entfernen
    • Leads zu Liste hinzufügen
    • Member einer Liste
  • Bulk APIs für Lead
    • Leads importieren
    • Import-Lead-Status abrufen
    • Importfehlerdatei abrufen
    • Importwarnungsdatei abrufen
  • Für Kampagnen
    • Kampagnen planen
    • Kampagnen anfordern
  • Für E-Mail
    • E-Mail-Inhalte im bearbeitbaren Abschnitt aktualisieren
    • Beispiel-E-Mail senden
  • Für E-Mail, E-Mail-Schablonen und Snippets
    • Objekte genehmigen
    • Genehmigung für Objekte aufheben
    • Objekte verwerfen
    • Objekte klonen

Unterstützung für angepasste Objekte (Custom Objects):

Marketo unterstützt angepasste Objekte. Der Benutzer kann ein angepasstes Objekt nur über die Marketo-Benutzerschnittstelle (UI) definieren. Wenn ein Objekt definiert wurde, kann der Benutzer Datensätze des angepassten Objekts über den Connector erstellen, aktualisieren, löschen und suchen sowie Upserts (Aktualisieren/Einfügen) für Datensätze ausführen.

Da der Connector mit XML-basierten Ein-/Ausgaben arbeitet, werden nur solche angepassten Objekte unterstützt, deren Namen die folgenden Kriterien erfüllen:
  • Sie beginnen mit einem Buchstaben.
  • Sie enthalten nur alphanumerische Zeichen.
  • Sie enthalten als Sonderzeichen nur das Unterstreichungszeichen (_).
Anmerkung: Angepasste Objekte, die die obigen Kriterien nicht erfüllen, werden nicht in der Liste von Objekten für Aktivitäten aufgeführt.

Unterstützung für angepasste Felder

Marketo unterstützt angepasste Felder nur für Lead-Objekte und für angepasste Objekte.

Für Erstellungs- und Aktualisierungsaktivitäten haben Lead-Objekte in der Anzeige 'Eingaben zuordnen' zusätzliche Knoten für angepasste Felder, sodass der Benutzer Werte für diese Felder angeben kann.

Für Aktivitäten zum Abrufen, Abrufen aller Objekte und Suchen von Objekten enthält das Antwortobjekt Daten für angepasste Felder, sofern solche vorhanden sind.

Beispiel für 'Eingaben zuordnen'/'Ausgaben zuordnen' für ein Lead-Objekt:

 company
 billingStreet
 billingCity
 . .
 customField1
 customField2