Erste Schritte für Entwickelnde get-started-developers

Auf dieser Seite Implementieren Sie die SDKs, Ereignis-Streaming, benutzerdefinierten Aktionsendpunkte und APIs, die Ihre Programme mit Adobe Journey Optimizer verbinden, damit Ihre Journey mit Live-Daten 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

Mobile SDK ist eine Sammlung von Bibliotheken, die Sie direkt in Ihre iOS- oder Android-App einbetten. Sie fungiert als Kommunikationsebene zwischen Ihrer App und Adobe Experience Platform: Sie identifiziert Benutzende, sammelt Verhaltensereignisse und stellt Anweisungen von Journey Optimizer bereit - einschließlich Push-Benachrichtigungen, In-App-Nachrichten und personalisierter Inhalte. Ohne sie hat Journey Optimizer keine Einsicht in die Aktivitäten Ihrer App-Benutzer 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 Mobile 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 die Mobile SDK, um personalisierte Inhalte zur Laufzeit abzurufen und zu rendern, sodass Ihr Team die volle Kontrolle über Platzierung und Präsentation hat:

Implementieren von Web-Erlebnissen web-implementation

Einrichten des Adobe Experience Platform Web SDK

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 empfängt Personalisierungsanweisungen zurück - alles in einer Netzwerk-Roundtrip. Sobald sie eingerichtet ist, kann Journey Optimizer Besucher und Trigger-Journey anhand ihrer Aktionen identifizieren und Ihren Seiten sofort maßgeschneiderte Inhalte bereitstellen.

Implementieren von Code-basierten Erlebnissen (Web SDK)

Im Gegensatz zu visuellen Kanälen, bei denen Marketer das Layout vollständig steuern, bieten Code-basierte Erlebnisse Ihnen volle Verantwortung dafür, 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 wird. Dieses Modell funktioniert für jede Web-Oberfläche - Hero-Banner, Empfehlungskarussells, Suchergebnis-Rankings, 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

Journey werden bei Ereignissen ausgeführt: Ein Benutzer meldet sich an, fügt einen Artikel zu einem Warenkorb hinzu, schließt einen Kauf ab oder bricht ein Formular ab. 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 Experience Platform Streaming-Aufnahme-API gesendet wird. Journey Optimizer nimmt es innerhalb von Millisekunden auf und leitet das Profil an eine beliebige passende Journey weiter. Das Ereignisschema und die Payload-Struktur werden von Ihrem Dateningenieur definiert. Stimmen Sie sich mit ihnen 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 benutzerdefinierten Aktionsschritt 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 sie das von Journey Optimizer generierte Aufrufvolumen verarbeiten kann. Ihr Administrator registriert den Endpunkt dann in Journey Optimizer, damit Marketing-Experten ihn als Schritt in ihren Journey 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 einen Trigger über Ihr eigenes Backend durchführen, eine E-Mail-Adresse nach einer Datenschutzanfrage unterdrücken oder Inhaltsvorlagen aus einer 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 die Ereignisse zum richtigen Zeitpunkt ausgelöst werden, der Journey wie erwartet den Trigger ausführen, sich benutzerdefinierte Aktionen unter realistischer Last verhalten 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 Profilaufblähung, Handhabung von Einverständnissignalen, sodass Opt-outs sich über jede Integration ausbreiten, und Abstimmung Ihrer Implementierung auf den Durchsatz und die Zuverlässigkeit, die der Produktionsmaßstab erfordert.

Arbeiten mit kontextuellen Daten und Anreicherung

Journey benötigen häufig mehr Daten als die, die im auslösenden Ereignis eingehen - einen Produktnamen, eine Treuestufe, eine Bestellzeilenelementliste. Anstatt all dies in alle Profile vorab zu laden, können Sie es 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 erzwingt Richtlinien zur Data Governance und zum Einverständnis auf Plattformebene, aber Ihre Integration muss diese auch berücksichtigen. Wenn ein Kunde sich von Marketing-Nachrichten abmeldet oder wenn eine Datennutzungskennzeichnung 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 Produktions-Journey Optimizer-Implementierungen 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 Journey-Design-Fallstricke, die Profile im Hintergrund löschen, und erstellen Fehlerbehandlungsmethoden, die sich elegant abschwächen, anstatt opak 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.

API-ausgelöste Kampagnen ausführen api-triggered

Trigger von Transaktions- oder Marketing-Nachrichten aus einem externen System mithilfe der Interactive Message Execution REST-API. Vor dem Aufrufen des Endpunkts:

API-Referenz ・ Code-Beispiele ・ Arbeiten mit API-ausgelösten Kampagnen

Begrenzung und Drosselung für externe Endpunkte capping-throttling

Wenn Journey externe Systeme über benutzerdefinierte Aktionen oder Datenquellen aufrufen, schützen die Begrenzungs- und Einschränkungs-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).

Referenz zur Begrenzungs ・ Arbeiten mit der Begrenzungs- ・ Arbeiten mit der Drosselungs-API

Weitere REST-APIs more-rest-apis

Über Messaging und Begrenzungen hinaus stellt Journey Optimizer REST-Endpunkte für die Unterdrückungsverwaltung, Inhaltsvorlagen, den Kampagnenabruf, das Proofing und die orchestrierte Kampagnenausführung 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 Unterdrücken von Massenadressen nach einem Daten-Pull oder das Synchronisieren von Vorlagen aus einer externen Inhalts-Pipeline.

| Validieren von Datensätzen und Trigger Orchestrierte Kampagnenausführung | Datensatzvalidierung ・ Trigger ​ ・ Datensätze aktivieren |

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 Rollenleitfäden other-role-guides

Zurück zu Überblick über Rollen und Zuständigkeiten ・ Zurück zu Erste Schritte