SAP Marketing Cloud APIs

SAP Marketing Cloud APIs

Einführung
SAP Marketing Cloud bietet umfassende Tools und APIs zur Verwaltung von Marketingkampagnen, Kundendaten, Segmentierungen, Analysen und Personalisierung. Diese APIs helfen, Marketingprozesse zu automatisieren, und ermöglichen eine enge Integration mit anderen SAP-Lösungen und externen Systemen.


Die Customer Profile API ermöglicht den Zugriff auf detaillierte Kundendaten, die für personalisierte Marketingaktionen verwendet werden können.

  • Endpunkt: /sap/opu/odata/sap/API_CUSTOMER_PROFILES_SRV
  • Methoden:
    • GET /CustomerProfiles: Abrufen der Kundenprofile
    • GET /CustomerProfiles/{CustomerProfileID}: Abrufen von Detailinformationen zu einem bestimmten Kundenprofil
    • POST /CustomerProfiles: Erstellen eines neuen Kundenprofils
    • PUT /CustomerProfiles/{CustomerProfileID}: Aktualisieren eines bestehenden Kundenprofils
    • DELETE /CustomerProfiles/{CustomerProfileID}: Löschen eines Kundenprofils
  • JSON-Schema: Beispiel für die Erstellung eines Kundenprofils: { "CustomerProfileID": "12345", "FirstName": "Max", "LastName": "Mustermann", "Email": "max.mustermann@example.com", "Phone": "1234567890", "Address": { "Street": "Musterstraße 1", "City": "Musterstadt", "PostalCode": "12345", "Country": "DE" } }


Diese API unterstützt die Verwaltung von Marketingkampagnen, einschließlich der Erstellung, Bearbeitung und Überwachung von Kampagnen.

  • Endpunkt: /sap/opu/odata/sap/API_MARKETING_CAMPAIGNS_SRV
  • Methoden:
    • GET /MarketingCampaigns: Abrufen von Marketingkampagnen
    • GET /MarketingCampaigns/{CampaignID}: Abrufen von Details zu einer bestimmten Kampagne
    • POST /MarketingCampaigns: Erstellen einer neuen Kampagne
    • PUT /MarketingCampaigns/{CampaignID}: Aktualisieren einer Kampagne
    • DELETE /MarketingCampaigns/{CampaignID}: Löschen einer Kampagne
  • JSON-Schema: Beispiel für die Erstellung einer Kampagne: { "CampaignID": "campaign_001", "CampaignName": "Sommerangebot", "StartDate": "2024-06-01", "EndDate": "2024-06-30", "TargetAudience": "Existing Customers", "Budget": 5000, "Status": "Active" }


Mit der Segmentation API können Marketingteams gezielt Kundengruppen erstellen und verwalten, die auf spezifischen Kriterien basieren.

  • Endpunkt: /sap/opu/odata/sap/API_SEGMENTATION_SRV
  • Methoden:
    • GET /Segments: Abrufen von Segmenten
    • GET /Segments/{SegmentID}: Abrufen von Details zu einem Segment
    • POST /Segments: Erstellen eines neuen Segments
    • PUT /Segments/{SegmentID}: Aktualisieren eines Segments
    • DELETE /Segments/{SegmentID}: Löschen eines Segments
  • JSON-Schema: Beispiel für das Erstellen eines Segments: { "SegmentID": "segment_001", "SegmentName": "High Value Customers", "Criteria": { "MinSpend": 500, "MaxSpend": 5000 }, "Status": "Active" }


Diese API ermöglicht das Verwalten und Nachverfolgen von Leads, einschließlich der Zuweisung von Leads zu bestimmten Kampagnen oder Vertriebsmitarbeitern.

  • Endpunkt: /sap/opu/odata/sap/API_LEAD_MANAGEMENT_SRV
  • Methoden:
    • GET /Leads: Abrufen von Leads
    • GET /Leads/{LeadID}: Abrufen von Details zu einem Lead
    • POST /Leads: Erstellen eines neuen Leads
    • PUT /Leads/{LeadID}: Aktualisieren eines Leads
    • DELETE /Leads/{LeadID}: Löschen eines Leads
  • JSON-Schema: Beispiel für das Erstellen eines Leads: { "LeadID": "lead_001", "CustomerProfileID": "12345", "LeadStatus": "New", "AssignedTo": "SalesRep001", "Source": "WebForm", "CampaignID": "campaign_001", "LeadDate": "2024-05-01" }


Diese API ermöglicht die Verwaltung von E-Mail-Marketingkampagnen, einschließlich der Erstellung und dem Versand von E-Mails.

  • Endpunkt: /sap/opu/odata/sap/API_EMAIL_CAMPAIGNS_SRV
  • Methoden:
    • GET /EmailCampaigns: Abrufen von E-Mail-Kampagnen
    • GET /EmailCampaigns/{EmailCampaignID}: Abrufen von Details zu einer bestimmten E-Mail-Kampagne
    • POST /EmailCampaigns: Erstellen einer neuen E-Mail-Kampagne
    • PUT /EmailCampaigns/{EmailCampaignID}: Aktualisieren einer E-Mail-Kampagne
    • DELETE /EmailCampaigns/{EmailCampaignID}: Löschen einer E-Mail-Kampagne
  • JSON-Schema: Beispiel für das Erstellen einer E-Mail-Kampagne: { "EmailCampaignID": "email_campaign_001", "Subject": "Exclusive Summer Offer!", "RecipientList": ["max.mustermann@example.com", "jane.doe@example.com"], "Body": "Hurry up! Grab your exclusive summer offer before it's gone.", "SendDate": "2024-06-01", "Status": "Active" }


Die Analytics API ermöglicht den Zugriff auf Marketing- und Performance-Daten, die zur Analyse von Kampagnenergebnissen genutzt werden können.

  • Endpunkt: /sap/opu/odata/sap/API_ANALYTICS_SRV
  • Methoden:
    • GET /Reports: Abrufen von Marketingberichten
    • GET /Reports/{ReportID}: Abrufen von Details zu einem bestimmten Bericht
    • GET /CampaignPerformance: Abrufen von Kampagnenleistungsdaten
  • JSON-Schema: Beispiel für eine Leistungsanfrage einer Kampagne: { "CampaignID": "campaign_001", "Metrics": ["Clicks", "Conversions", "Revenue"], "StartDate": "2024-06-01", "EndDate": "2024-06-30" }


Mit der Event API können Marketingereignisse wie Benutzerinteraktionen und Aktionen erfasst und zur weiteren Analyse oder für Kampagnen genutzt werden.

  • Endpunkt: /sap/opu/odata/sap/API_EVENTS_SRV
  • Methoden:
    • GET /Events: Abrufen von Events
    • POST /Events: Erstellen eines neuen Events
    • GET /Events/{EventID}: Abrufen von Eventdetails
  • JSON-Schema: Beispiel für ein Event: { "EventID": "event_001", "EventType": "EmailOpened", "CustomerProfileID": "12345", "Timestamp": "2024-06-01T12:00:00Z", "AdditionalData": { "Subject": "Exclusive Summer Offer!" } }