Migration zur REST-API
Die Marketo Engage SOAP-API wird nach dem 31. Oktober 2025 eingestellt. Alle bestehenden Integrationen, die die SOAP-API verwenden, sollten bis zu diesem Datum eingestellt oder zur Marketo Engage RESTAPI migriert werden, um Service-Unterbrechungen zu vermeiden.
Migration
Die SOAP-API unterstützt im Vergleich zur REST-APII eine begrenzte Anzahl von Anwendungsfällen. Bei der Bestimmung, welche Endpunkte Sie Ihren Anwendungsfällen zuordnen sollen, sollten Sie die Best Practices für die Marketo-Integration befolgen
Referenzarchitekturen sind für die Anwendungsfälle CRM-Synchronisation und Data Warehouse- verfügbar.
Authentifizierung
Authentifizierungsdokumentation
Die Marketo REST-API verwendet OAuth 2.0-basierte Authentifizierung mit dem Grant-Typ „Client-Anmeldeinformationen“. Zugriffstoken sind eine Stunde nach der Erstellung gültig.
Leads
Die SOAP-API unterstützt Lead-Datensynchronisation, Munchkin-CookieVerknüpfung und Lead-Zusammenführung. Wenn Ihre Anwendung die SyncLead-Methode von SOAP aufruft und den marketoCookie festlegt, können Sie wie folgt migrieren:
- mithilfe der Leads synchronisieren REST-Methode, gefolgt von Zugeordneter Lead
- Sie können Formular senden aufrufen. Dies erfordert jedoch die Konfiguration einiger Marketing-Assets und eine Interaktion mit der Forms-API
Anwendungen, die den foreignSysPersonId Schlüsseltyp verwenden, sollten mithilfe eines benutzerdefinierten Lead-Felds zur Darstellung dieser externen Kennung nach migrieren und entweder Leads synchronisieren oder Massenimport von Leads REST-Methoden verwenden.
Meine Objekte
M Objects war ein Sammelkonzept zur Unterstützung des Exports von Opportunity-Attributionsdaten für die externe Analyse und arbeitete mit drei Objekttypen: Opportunities, Opportunity-Rollen und Programme.
REST-Dokumentation:
Statische Listen
Anwendungsfälle für statische Listen in der SOAP-API sind auf die Aufnahme von Mitgliedschafts- und Lead-Daten sowie das Entfernen der Mitgliedschaft beschränkt, was mit den REST-Methoden Zu Liste hinzufügen, Massenimport von Leads oder Aus Liste entfernen erreicht werden kann.
Aktivitäten
Die SOAP-API unterstützt nur das Abrufen von Aktivitäten.
REST-Dokumentation:
Kampagnen
REST-Dokumentation:
Die SOAP-API unterstützt nur drei Anwendungsfälle für intelligente Kampagnen: Auslösen von Leads, um sich für eine anforderbare intelligente Kampagne zu qualifizieren Abrufen dieser anforderbaren Kampagnen und Planen einer zukünftigen Ausführung einer intelligenten Kampagne.
Benutzerdefinierte Objekte
REST-Dokumentation:
Die SOAP-API unterstützt nur CRUD-Vorgänge für benutzerdefinierte Objekte.