Erste Schritte für Entwickelnde get-started-developers

Auf dieser Seite: Implementieren Sie SDKs, Ereignis-Streaming, Endpunkte für benutzerdefinierte Aktionen und APIs, die Ihre Anwendungen mit Adobe Journey Optimizer verbinden, damit Ihre Journeys mit Echtzeitdaten arbeiten können.

Als Entwicklerin bzw. Entwickler sind Sie für die Implementierung und Integration von Adobe Journey Optimizer in Ihre Anwendungen und Systeme verantwortlich. Sie können mit der Arbeit mit Adobe Journey Optimizer beginnen, sobald Ihnen Systemadmin und Dateningenieurin bzw. -ingenieur Zugriff auf Ihre Umgebung gewährt und diese vorbereitet haben.

Ihre Rolle im Journey Optimizer-Ökosystem

Während andere Team-Mitglieder Journey Optimizer über die Benutzeroberfläche konfigurieren, konzentrieren Sie sich auf:

Ihre Dateningenieurin bzw. Ihr Dateningenieur verarbeitet Datenschemata, Ereigniskonfigurationen und Datenquellen. Ihre bzw. Ihr Admin richtet Berechtigungen und Kanalkonfigurationen ein. Marketing-Fachleute entwerfen die Journeys und Inhalte, die Ihre Implementierungen verwenden.

In diesem Handbuch werden die wesentlichen Schritte der technischen Implementierung für die ersten Schritte mit Journey Optimizer beschrieben. Gehen Sie wie folgt vor, um Ihre Implementierung einzurichten, unabhängig davon, ob Sie Apps, Web-Erlebnisse oder API-Integrationen erstellen.

Voraussetzungen prerequisites

Bevor Sie mit der Implementierung beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

Grundlegendes zur technischen Grundlage technical-foundation

Machen Sie sich mit den wichtigsten technischen Konzepten vertraut, bevor Sie sich mit der Implementierung befassen:

Einrichten von App-Integrationen mobile-integration

Konfigurieren des Adobe Experience Platform Mobile SDK

Das Mobile SDK ist eine Sammlung von Bibliotheken, die Sie direkt in Ihre iOS- oder Android-App einbetten. Es fungiert als Kommunikationsebene zwischen Ihrer App und Adobe Experience Platform: Es identifiziert Benutzende, sammelt Verhaltensereignisse und stellt Anweisungen von Journey Optimizer bereit – einschließlich Push-Benachrichtigungen, In-App-Nachrichten und personalisierter Inhalte. Ohne es hat Journey Optimizer keine Einsicht in die Aktivitäten Ihrer App-Benutzenden und keine Möglichkeit, sie zu erreichen.

Detaillierte Schritte zum Konfigurieren von Push-Benachrichtigungen finden Sie auf dieser Seite.

Implementieren von Code-basierten Erlebnissen (Mobile SDK)

Mit Code-basierten Erlebnissen können Sie personalisierte Inhalte für jede Oberfläche in Ihrer nativen App bereitstellen – von Onboarding-Bildschirmen und Produktdetailseiten bis hin zu In-App-Bannern und Feature Flags –, ohne dass eine neue App-Version erforderlich ist. Verwenden Sie das Mobile SDK, um personalisierte Inhalte zur Laufzeit abzurufen und zu rendern, sodass Ihr Team die volle Steuerung über Platzierung und Präsentation hat:

Implementieren von Web-Erlebnissen web-implementation

Einrichten des Adobe Experience Platform Web SDK

Das Web SDK (alloy.js) ist eine einzelne JavaScript-Bibliothek, die das Patchwork separater Adobe-Tags ersetzt, die Ihre Site andernfalls möglicherweise benötigt. Es erfasst Verhaltensdaten, streamt sie über einen von Ihnen konfigurierten Datenstrom an Adobe Experience Platform und erhält im Gegenzug Personalisierungsanweisungen – alles in einem Netzwerk-Roundtrip. Sobald es eingerichtet ist, kann Journey Optimizer Besuchende identifizieren, Journeys anhand ihrer Aktionen auslösen und Ihren Seiten sofort maßgeschneiderte Inhalte bereitstellen.

Implementieren von Code-basierten Erlebnissen (Web SDK)

Im Gegensatz zu visuellen Kanälen, bei denen Marketing-Fachleute das Layout vollständig steuern, bieten Code-basierte Erlebnisse Ihnen volle Kontroller darüber, wie personalisierte Inhalte auf der Seite gerendert werden. Journey Optimizer gibt eine JSON-Payload mit den Personalisierungsdaten zurück. Ihr Code entscheidet, wo und wie sie angezeigt werden. Dieses Modell funktioniert für jede Web-Oberfläche – Hero-Banner, Empfehlungskarussells, Suchergebnisrangfolgen, A/B-Testvarianten –, ohne dass ein visueller Editor oder ein Seitenveröffentlichungs-Workflow erforderlich ist.

Erkunden Sie Beispielimplementierungen auf GitHub, um Code-basierte Erlebnisse in Aktion zu sehen.

Erfahren Sie mehr über die ersten Schritte mit Code-basierten Erlebnissen.

Implementieren von Ereignis-Streaming event-streaming

Senden von Ereignissen zum Auslösen von Journeys

Journeys werden bei Ereignissen ausgeführt: eine Benutzerin bzw. ein Benutzer meldet sich an, fügt einen Artikel zu einem Warenkorb hinzu, schließt einen Kauf ab oder verwirft ein Formular. Ihre Aufgabe besteht darin, diese Ereignisse aus Ihrer Anwendung genau zum richtigen Zeitpunkt auszugeben. Jedes Ereignis ist eine XDM-strukturierte JSON-Payload, die an die Streaming-Aufnahme-API der Experience Platform gesendet wird. Journey Optimizer nimmt sie innerhalb von Millisekunden auf und leitet das Profil an eine beliebige passende Journey weiter. Das Ereignisschema und die Payload-Struktur werden von Ihrer Dateningenieurin bzw. Ihrem Dateningenieur definiert. Stimmen Sie sich mit ihr bzw. ihm ab, bevor Sie mit der Codierung beginnen.

Beispielimplementierung zum Senden eines Ereignisses über die API:

POST https://{DATACOLLECTION_ENDPOINT}/collection/{DATASTREAM_ID}
Content-Type: application/json

{
  "header": {
    "datasetId": "{DATASET_ID}",
    "imsOrgId": "{ORG_ID}",
    "source": {
      "name": "Web SDK"
    }
  },
  "body": {
    "xdmMeta": {
      "schemaRef": {
        "id": "{SCHEMA_ID}"
      }
    },
    "xdmEntity": {
      "_id": "unique-event-id",
      "eventType": "purchase",
      "timestamp": "2024-01-01T12:00:00Z",
      // ... your event data
    }
  }
}

Erfahren Sie mehr über das Arbeiten mit Journey-Ereignissen.

Entwickeln von Endpunkten benutzerdefinierter Aktionen custom-actions

Wenn eine Journey einen Schritt mit einer benutzerdefinierten Aktion erreicht, führt Journey Optimizer einen ausgehenden HTTP-Aufruf an eine von Ihnen angegebene URL durch: Ihr Backend, ein CRM, eine Treueplattform oder einen beliebigen REST-Endpunkt. Ihre Aufgabe besteht darin, diesen Endpunkt zu erstellen und bereitzustellen: Definieren Sie den Anfragevertrag (Payload-Form, Authentifizierungsmethode, Antwortformat), implementieren Sie die dahinter stehende Geschäftslogik und stellen Sie sicher, dass das von Journey Optimizer generierte Aufrufvolumen verarbeitet werden kann. Ihre bzw. Ihr Admin registriert den Endpunkt dann in Journey Optimizer, damit Marketing-Fachleute ihn als Schritt in ihren Journeys verwenden können.

Beispiel eines Anwendungsfalls: Schreiben von Journey-Ereignissen in Experience Platform unter Verwendung von benutzerdefinierten Aktionen.

Arbeiten mit Journey Optimizer-APIs apis

Nicht alles muss über die Journey Optimizer-Benutzeroberfläche erfolgen. Manchmal müssen Sie eine Kampagne über Ihr eigenes Backend auslösen, eine E-Mail-Adresse nach einer Datenschutzanfrage unterdrücken oder Inhaltsvorlagen aus einem externen CMS synchronisieren. Die REST-APIs von Journey Optimizer bieten Ihnen programmgesteuerten Zugriff auf die Kernfunktionen der Plattform. Alle Aufrufe verwenden OAuth-Server-zu-Server-Authentifizierung – die ältere JWT-Methode ist veraltet.

Testen und Debuggen testing

Bevor Ihre Implementierung live geht, müssen Sie darauf vertrauen können, dass Ereignisse zum richtigen Zeitpunkt starten, Journeys wie erwartet ausgelöst werden, benutzerdefinierte Aktionen unter realistischer Belastung funktionieren und personalisierte Inhalte korrekt gerendert werden. In diesem Abschnitt werden die Tools und Techniken zum frühzeitigen Erkennen von Problemen beschrieben – von der SDK-Protokollierung auf niedriger Ebene bis hin zu End-to-End-Journey-Testläufen mit echten Profilen.

Fortgeschrittene Entwicklerthemen advanced-topics

Sobald Ihre Kern-SDKs, Ereignisse und APIs eingerichtet sind, helfen Ihnen diese Themen weiter: Anreicherung von Journey-Daten zur Laufzeit, ohne das Profil aufzublähen, Umgang mit Einverständnissignalen, sodass Opt-outs an alle Integrationen übertragen werden, und Abstimmung Ihrer Implementierung auf den Durchsatz und die Zuverlässigkeit, die der Produktionsmaßstab erfordert.

Arbeiten mit kontextuellen Daten und Anreicherung

Journeys benötigen häufig mehr Daten als die, die im auslösenden Ereignis eingehen – einen Produktnamen, eine Treuestufe, eine Bestellzeilenelementliste. Anstatt all diese vorab in alle Profile zu laden, können Sie sie mit der kontextuellen Anreicherung zur Laufzeit aus AEP-Datensätzen nachschlagen oder von einer benutzerdefinierten Aktionsantwort weiterleiten. Ihre Nachrichten- und Verzweigungsbedingungen können dann auf diese Daten verweisen, ohne dass sie jemals dauerhaft im Profil gespeichert werden.

Arbeiten mit Einverständnis und Governance

Journey Optimizer setzt Richtlinien zur Data Governance und zum Einverständnis auf Plattformebene durch, aber Ihre Integration muss diese auch berücksichtigen. Wenn eine Kundin bzw. ein Kunde sich von Marketing-Nachrichten abmeldet oder wenn ein Datennutzungs-Label die Verwendung eines Felds einschränkt, müssen diese Regeln durch Ihre benutzerdefinierten Aktionen und Datensatzsuchen verbreitet werden – nicht nur durch die Blockierung von Aktionen in der Benutzeroberfläche.

Optimierung und Best Practices

In Journey Optimizer-Produktionsimplementierungen werden regelmäßig Millionen von Ereignissen und Tausende von Journey-Ausführungen pro Sekunde verarbeitet. Mit diesen Ressourcen können Sie Ihre Integration auf diese Größenordnung abstimmen. So verstehen Sie Ratenbeschränkungen, bevor Sie sie erreichen, vermeiden gängige Fallstricke beim Journey-Design, die Profile im Hintergrund verwerfen, und erstellen eine Fehlerbehebung, die sich kontrolliert abschwächt, anstatt undurchsichtig zu scheitern.

Aufrufen von Journey Optimizer-REST-APIs rest-apis

Neben der Implementierung von SDKs und Ereignis-Streaming können Sie Journey Optimizer auch programmgesteuert von Ihren eigenen Systemen aus steuern. Die vollständige API-Referenz, OpenAPI-Spezifikationen und Code-Beispiele finden Sie im Journey Optimizer-Entwicklerportal.

Ausführen von Kampagnen, die durch API ausgelöst werden api-triggered

Lösen Sie Transaktions- oder Marketing-Nachrichten aus einem externen System mithilfe der REST-API zur Ausführung interaktiver Nachricht aus. Vor dem Aufrufen des Endpunkts:

API-Referenz · Code-Beispiele · Arbeiten mit Kampagnen, die durch API ausgelöst werden

Begrenzung und Drosselung für externe Endpunkte capping-throttling

Wenn Journeys externe Systeme über benutzerdefinierte Aktionen oder Datenquellen aufrufen, schützen die Begrenzungs- und Drosselungs-APIs diese Systeme vor Überlastung. Durch Begrenzung werden Aufrufe abgelehnt, die das konfigurierte Limit überschreiten; durch Drosselung werden sie für bis zu 6 Stunden in die Warteschlange gestellt (nur Produktions-Sandboxes, benutzerdefinierte Aktionen).

Begrenzungs-API-Referenz · Arbeiten mit der Begrenzungs-API · Arbeiten mit der Drosselungs-API

Weitere REST-APIs more-rest-apis

Über Messaging und Begrenzungen hinaus stellt Journey Optimizer REST-Endpunkte für Unterdrückungsverwaltung, Inhaltsvorlagen, Kampagnenabruf, Testversand und Ausführung orchestrierter Kampagnen bereit. Verwenden Sie diese, wenn Sie Vorgänge automatisieren müssen, die andernfalls manuelle Schritte in der Benutzeroberfläche erfordern würden, z. B. das massenhafte Unterdrücken von Adressen nach einem Datenabruf oder das Synchronisieren von Vorlagen aus einer externen Inhalts-Pipeline.

| Validieren von Datensätzen und Auslösen der Ausführung orchestrierter Kampagnen | Datensatzvalidierung · Auslöser · Aktivieren von Datensätzen |

Zusätzliche Ressourcen additional-resources

Rollenübergreifendes Zusammenarbeiten next-steps

Ihre Implementierungsarbeit überschneidet sich mit anderen Team-Mitgliedern:

Starten der Implementierung

Bereit, mit dem Erstellen zu beginnen? Wählen Sie Ihren ersten Implementierungsbereich aus den obigen Abschnitten:

Jeder Abschnitt enthält Links zu detaillierter technischer Dokumentation, Code-Beispielen und Tutorials, die Sie bei der Implementierung unterstützen.

Weitere Rollenhandbücher other-role-guides

Zurück zu Überblick über Rollen und Verantwortlichkeiten · Zurück zu Erste Schritte