MARKETING-SUCCESS-BLOG

Marketing Cloud Process Notation (MCPN) – mein Template zur Dokumentation komplexer Use Cases

Jeder begeisterte Marketing Cloud Consultant kennt das Gefühl:
Solange man tüfteln und sich einer spannenden Lösung Schritt für Schritt nähern kann, macht die Arbeit richtig Spaß. Zwischen Data Extensions, Automations und CloudPages verfeinert man das technische Konstrukt so lange, bis man endlich weiß: „Jetzt funktioniert es!“

Und dann kommt der mühsame Teil: Aufräumen und Dokumentieren.

Selbst nach mehreren Jahren in Projekten hatte ich keinen klaren Weg, um meine Prozesse sauber zu dokumentieren – verständlich für Marketer und Entwickler, die später Anpassungen vornehmen müssen.
Irgendwann hatte ich genug davon und habe mir ein eigenes Template gebaut: die Marketing Cloud Process Notation (MCPN).

Im Wesentlichen enthält das Template alle Elemente der Salesforce Marketing Cloud, die für eine Dokumentation relevant sind. Das Herzstück ist eine grafische Darstellung der chronologischen Abfolge – etwa von SQL Activities in Automations, Journey Starts oder File Imports.
So entsteht ein Gesamtüberblick über den gesamten Use Case – nicht nur einzelne Ausschnitte oder Screenshots. Besonders hilfreich ist das, wenn Drittsysteme beteiligt sind, z. B. durch API Calls oder File Drops aus externen Quellen.
Für jemanden, der neu in ein Projekt einsteigt, ist dieser Kontext oft der entscheidende Unterschied zwischen „Ich verstehe gar nichts“ und „Ich bin startklar“.

Über die Jahre habe ich das Template laufend weiterentwickelt und seinen Einsatz erweitert.
Heute nutze ich es nicht nur für die Dokumentation bestehender Use Cases, sondern auch zur Planung neuer Anwendungsfälle – etwa um komplexe Setups vor der Implementierung zu visualisieren, potenzielle Blocker früh zu erkennen und sicherzustellen, dass kein Schritt vergessen wird.

Wie kann man das Template nutzen?

Das Template kann ganz einfach über draw.io verwendet und individuell angepasst werden.
Draw.io ist eine kostenlose Software zur Erstellung von Flowcharts – besonders praktisch, weil sich Diagramme nahtlos in Confluence einbetten lassen. So können Dokumentationen auch später noch leicht aktualisiert werden.

Fazit

Das MCPN-Template hilft mir täglich, komplexe Marketing Cloud Use Cases zu planen, zu dokumentieren und verständlich zu kommunizieren – intern, mit Kunden oder mit neuen Teammitgliedern.

Wie dokumentiert ihr eure Use Cases – und warum so, wie ihr es tut?

Anleitung

  1. Speichere das Template auf deinem Computer und entpacke die .zip-Datei
  2. Öffne https://draw.io in deinem Browser (bspw. Google Chrome)
  3. In draw.io, klicke „File“ > „Import From“ > „Device“
  4. Optional: Erstelle dir eine Kopie von der originalen Seite, passe die Lanes aus dem Beispiel-Use Case an oder erstelle deine eigenen und starte mit deiner Dokumentation.

Kontakt

E-Mail:
info@marketing-success-lab.com

Linkedin:
https://www.linkedin.com/in/oliveraichinger/