Erste Schritte für Entwickler get-started-developers
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:
- Implementieren von SDKs in Mobile- und Web-Anwendungen
- Senden von Ereignissen von Ihren Anwendungen zum Auslösen von Journeys
- Erstellen von API-Endpunkten, die Journey Optimizer über benutzerdefinierte Aktionen aufrufen kann
- Integrieren von Journey Optimizer mit Ihren vorhandenen Systemen und Infrastrukturen
- Testen und Debuggen Ihrer Implementierungen
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 Verständnis von RESTful-APIs und JSON
* Erfahrung mit asynchroner Programmierung und ereignisgesteuerten Architekturen
* Kenntnis der Anwendungsarchitektur Ihres Unternehmens
* Entwicklungsumgebung mit Zugriff auf die Code-Basis Ihrer Anwendung
* Test-Tools wie Postman für API-Tests
* Browser-Entwicklungs-Tools oder Mobile-Debugging-Tools
* XDM-Schemata und Ereignisdefinitionen von Dateningenieurin bzw. -ingenieur
* Anforderungen und Anwendungsfälle von Marketing-Fachleuten
Grundlegendes zur technischen Grundlage technical-foundation
Machen Sie sich mit den wichtigsten technischen Konzepten vertraut, bevor Sie sich mit der Implementierung befassen:
-
Adobe Experience Platform-Integration: Journey Optimizer basiert nativ auf Adobe Experience Platform. Wenn Sie die zugrunde liegende Architektur verstehen, können Sie effektivere Implementierungen erstellen. Erfahren Sie mehr über die Funktionsweise von Journey Optimizer.
-
XDM-Datenmodelle: Journey Optimizer verwendet das Experience-Datenmodell (XDM), um Ereignis- und Profildaten zu strukturieren. Als Entwicklerin bzw. Entwickler müssen Sie verstehen, wie Sie Daten senden, die den von Ihrer Dateningenieurin bzw. Ihrem Dateningenieur konfigurierten Schemata entsprechen. Erfahren Sie mehr über XDM-Schemata.
-
Authentifizierung und Sicherheit: Alle Implementierungen erfordern eine ordnungsgemäße Authentifizierung. Erfahren Sie, wie Sie die Authentifizierung für SDKs und APIs einrichten. Erfahren Sie mehr über die API-Authentifizierung.
Einrichten von App-Integrationen mobile-integration
Konfigurieren des Adobe Experience Platform Mobile SDK
Um Push-Benachrichtigungen, In-App-Nachrichten und andere Mobile-Funktionen zu aktivieren, integrieren Sie das Adobe Experience Platform Mobile SDK in Ihre Apps.
-
Installieren und Konfigurieren des Mobile SDK: Befolgen Sie die Dokumentation zum Adobe Experience Platform Mobile SDK, um mit der SDK-Integration loszulegen.
-
Erstellen einer Mobile-Eigenschaft: Richten Sie eine Mobile-Eigenschaft in Adobe Experience Platform Data Collection ein. Erfahren Sie, wie Sie eine Mobile-Eigenschaft erstellen und konfigurieren.
-
Konfigurieren von Push-Benachrichtigungen:
- Für iOS-Apps: Registrieren Sie Ihre App bei APNs (Apple Push Notification Service). Erfahren Sie mehr in der Dokumentation von Apple.
- Für Android-Apps: Richten Sie Firebase Cloud Messaging für Ihre Android-App ein. Erfahren Sie mehr in der Dokumentation von Google.
-
Testen Ihrer Mobile-Integration: Verwenden Sie den Schnellstart-Workflow für Mobile-Onboarding, um Ihre Mobile-Einrichtung schnell zu konfigurieren und zu testen.
Detaillierte Schritte zum Konfigurieren von Push-Benachrichtigungen finden Sie auf dieser Seite.
Implementieren von Code-basierten Erlebnissen (Mobile SDK)
Für die native App-Personalisierung mithilfe von Code-basierten Erlebnissen:
- Befolgen Sie dieses Tutorial bei der Implementierung von Mobile SDK
- Überprüfen Sie die Beispielimplementierungen für iOS und Android
Implementieren von Web-Erlebnissen web-implementation
Einrichten des Adobe Experience Platform Web SDK
Bei Web-basierten Implementierungen ist das Web SDK Ihr primärer Integrationspunkt:
-
Installieren des Web SDK: Befolgen Sie das Implementierungshandbuch des Web SDK, um das SDK auf Ihrer Website einzurichten.
-
Konfigurieren von Datenströmen: Erstellen und konfigurieren Sie einen Datenstrom in Adobe Experience Platform Data Collection, während Journey Optimizer aktiviert ist. Erfahren Sie mehr in der Dokumentation zu Datenströmen.
-
Aktivieren von Web-Push-Benachrichtigungen (optional): Konfigurieren Sie die pushNotifications-Eigenschaft in Ihrer Web-SDK-Konfiguration und verwenden Sie den sendPushSubscription-Befehl zum Registrieren von Push-Abonnements.
Implementieren von Code-basierten Erlebnissen (Web SDK)
Code-basierte Erlebnisse ermöglichen es Ihnen, jeden digitalen Kontaktpunkt zu personalisieren:
-
Auswählen Ihrer Implementierungsmethode: Client-seitig, Server-seitig oder hybrid. Sehen Sie sich die Implementierungsbeispiele für jeden Ansatz an.
-
Definieren von Oberflächen: Identifizieren Sie die Bereiche in Ihrer Anwendung, an denen Sie personalisierte Inhalte bereitstellen möchten. Erfahren Sie mehr über die Oberflächenkonfiguration.
-
Implementieren des Inhalts-Renderings: Verwenden Sie das Web SDK, um Personalisierungsinhalte abzurufen und anzuwenden. Siehe Tutorials zur Code-basierten Implementierung.
-
Senden von Anzeige- und Interaktionsereignissen: Verfolgen Sie aus Analyse- und Optimierungszwecken, wann Inhalte angezeigt werden und wann Benutzende mit diesen interagieren.
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
Als Entwicklern bzw. Entwickler implementieren Sie den Code zum Senden von Ereignissen, die Journeys auslösen. Ihre Dateningenieurin bzw. Ihr Dateningenieur konfiguriert die Ereignisschemata und -definitionen in Journey Optimizer.
-
Grundlegendes zur Ereignis-Payload: Arbeiten Sie mit Ihrer Dateningenieurin bzw. Ihrem Dateningenieur zusammen, um das Ereignisschema und die erforderliche Payload-Struktur zu erhalten. Die Payload muss dem konfigurierten XDM-Schema entsprechen. Erfahren Sie mehr über Anforderungen an Ereignisschemata.
-
Implementeiren von Ereignis-Streaming: Senden Sie Ereignisse mithilfe der Streaming-Aufnahme-APIs an Adobe Experience Platform. Erfahren Sie mehr über die Schritte zum Senden von Ereignissen.
-
Verarbeiten von Ereignistypen:
- Unitäre Ereignisse: Implementieren des Ereignisversands für personenspezifische Aktionen (z. B. Klick auf eine Schaltfläche, Kaufabschluss)
- Geschäftsereignisse: Senden von geschäftsbezogenen Ereignissen (z. B. Bestandsaktualisierungen, Preisänderungen)
-
Testen des Ereignisversands: Überprüfen Sie, ob die Ereignisse ordnungsgemäß empfangen werden und die Journeys wie erwartet auslösen. Erfahren Sie mehr über die Fehlerbehebung bei Ereignissen.
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
Benutzerdefinierte Aktionen ermöglichen es Journeys, Ihre APIs aufzurufen. Als Entwicklerin bzw. Entwickler erstellen Sie die API-Endpunkte, die durch benutzerdefinierte Aktionen aufgerufen werden:
-
Erstellen Ihres API-Endpunkts: Erstellen Sie RESTful-API-Endpunkte, die Journey Optimizer während der Journey-Ausführung aufruft. Ihr Endpunkt sollte:
- JSON-Payloads akzeptieren
- Anfragen authentifizieren (OAuth, API-Schlüssel oder JWT)
- Anforderungen innerhalb angemessener Timeout-Limits verarbeiten
- Antworten im erwarteten Format zurückgeben
-
Grundlegendes zu den Funktionen von benutzerdefinierten Aktionen: Benutzerdefinierte Aktionen können eine Verbindung zu Drittanbietersystemen wie Epsilon, Slack, Firebase oder Ihren eigenen Diensten herstellen. Weitere Informationen über benutzerdefinierte Aktionen.
-
Arbeiten mit Aktionskonfigurationen: Ihre bzw. Ihr Admin oder Ihre Dateningenieurin bzw. Ihr Dateningenieur konfiguriert die benutzerdefinierte Aktion in Journey Optimizer und definiert die API-Endpunkt-URL, Authentifizierungsmethode und Parameter. Sie geben ihnen Ihre API-Spezifikation. Erfahren Sie mehr über die Konfiguration benutzerdefinierter Aktionen.
-
Zurückgeben verwertbarer Daten: Konzipieren Sie Ihre API so, dass sie Daten zurückgibt, die in nachfolgenden Journey-Schritten verwendet werden können. Erfahren Sie mehr über Aktionsantworten.
-
Implementieren einer Ratenbegrenzung: Stellen Sie sicher, dass Ihre Endpunkte das erwartete Volumen verarbeiten können. Journey Optimizer begrenzt die Anzahl der Aufrufe pro Sekunde auf 5.000. Ihr System sollte jedoch resilient sein. Erfahren Sie mehr über Begrenzung und Drosselung.
Beispiel eines Anwendungsfalls: Schreiben von Journey-Ereignissen in Experience Platform unter Verwendung von benutzerdefinierten Aktionen.
Arbeiten mit Journey Optimizer-APIs apis
Journey Optimizer bietet umfassende REST-APIs für den programmgesteuerten Zugriff:
-
Grundlegendes zu API-Funktionen: Mit Journey Optimizer-APIs können Sie verschiedene Ressourcen programmgesteuert erstellen, lesen, aktualisieren und löschen. Erfahren Sie mehr über Journey Optimizer-APIs.
-
Authentifizierung: Befolgen Sie dieses Tutorial, um die API-Authentifizierung mit Adobe Developer Console einzurichten.
-
Erkunden von API-Referenzen: Sehen Sie sich die vollständige API-Dokumentation an und probieren Sie APIs direkt in der Adobe Journey Optimizer-API-Referenz aus.
-
Durch APIs ausgelöste Kampagnen: Erstellen Sie Transaktions-Messaging mit durch APIs ausgelösten Kampagnen. Bei Szenarien mit hohem Volumen (bis zu 5.000 TPS) sollten Sie den Modus mit hohem Durchsatz in Erwägung ziehen (Add-on-Lizenz erforderlich).
-
Entscheidungs-Management-APIs: Verwenden Sie spezielle APIs für Angebotsverwaltung und Entscheidungsfindung. Erfahren Sie mehr im Handbuch zur Entscheidungs-Management-API.
Testen und Debuggen testing
-
Debuggen der SDK-Implementierung: Verwenden Sie Adobe Experience Platform Assurance, um SDK-Ereignisse zu untersuchen, die Datenerfassung zu validieren und Integrationsprobleme in Echtzeit zu beheben. Erfahren Sie mehr über Assurance.
-
Testen des Ereignisversands: Überprüfen Sie, ob Ereignisse aus Ihrer Anwendung von Adobe Experience Platform empfangen werden und Journeys wie erwartet auslösen. Überwachen Sie die Ereignisaufnahme und überprüfen Sie die Payload-Struktur.
-
Validieren von API-Integrationen: Testen Sie die Endpunkte Ihrer benutzerdefinierten Aktion, um sicherzustellen, dass sie Journey Optimizer-Anfragen korrekt verarbeiten, innerhalb der Timeout-Limits reagieren und die erwarteten Datenformate zurückgeben.
-
Verwenden des Testmodus mit Testprofilen: Arbeiten Sie mit Ihren Dateningenieurinnen und -ingenieuren zusammen, um Zugriff auf Testprofile zu erhalten, und validieren Sie dann Ihre Implementierung mithilfe des Journey-Testmodus. Erfahren Sie mehr über das Testen von Journeys.
-
Überwachen von SDK-Protokollen: Aktivieren Sie die Debug-Protokollierung in Ihrer SDK-Implementierung, um Probleme während der Entwicklung zu beheben:
- Mobile SDK: Aktivieren der Protokollierung, um SDK-Ereignisse und API-Aufrufe anzuzeigen
- Web SDK: Verwenden der Browser-Konsole, um SDK-Aktivität zu überwachen
-
Überprüfen der Datenstromkonfiguration: Stellen Sie sicher, dass Ihr Datenstrom ordnungsgemäß konfiguriert ist, um Daten an Journey Optimizer zu senden. Überprüfen Sie, ob Ereignisse durch den Datenstrom zu den richtigen Zielen fließen.
-
Abfrage von Journey-Daten für die Analyse: Verwenden Sie SQL-Abfragen im Data Lake, um Journey-Schrittereignisse zu analysieren, Probleme zu debuggen und die Leistung benutzerdefinierter Aktionen zu überwachen. Erkunden Sie Abfragebeispiele für die Journey-Analyse, einschließlich:
- Tracking von Profileintritten/-ausstiegen und Verwerfungsgründe
- Leistungsmetriken für benutzerdefinierte Aktionen (Latenz, Durchsatz, Fehler)
- Ereignisversand- und Fehlermuster
- Journey-Instanzstatus
Fortgeschrittene Entwicklerthemen advanced-topics
Arbeiten mit kontextuellen Daten und Anreicherung
- Iteration über Arrays: Verwenden Sie die Handlebars-Syntax, um dynamische Listen aus Ereignissen, benutzerdefinierten Aktionsantworten und Datensatzsuchen in Nachrichten anzuzeigen. Erfahren Sie mehr über das Iterieren über kontextuelle Daten.
- Datensatzsuche: Implementieren von Datensatzsuchen zur Anreicherung von Journey-Daten aus Adobe Experience Platform-Datensätzen. Arbeiten Sie bei der Konfiguration mit Ihrer Dateningenieurin bzw. Ihrem Dateningenieur zusammen. Erfahren Sie mehr über die Datensatzsuche.
Arbeiten mit Einverständnis und Governance
Implementieren von Data-Governance- und Einverständnisrichtlinien in Ihre Integrationen:
- Data Governance: Wenden Sie Datennutzungsrichtlinien auf benutzerdefinierte Aktionen an. Erfahren Sie mehr über Data Governance.
- Einverständnisverwaltung: Verarbeiten Sie die Voreinstellungen für das Kundeneinverständnis in Ihren Implementierungen. Erfahren Sie mehr über Einverständnis.
Optimierung und Best Practices
- Begrenzung und Drosselung: Machen Sie sich mit den Ratenbegrenzungen vertraut und implementieren Sie geeignete Drosselungen. Erfahren Sie mehr über externe Systeme.
- Journey-Optimierung: Befolgen Sie die Best Practices für die Journey-Optimierung.
- Fehlerbehandlung: Implementieren Sie eine robuste Fehlerbehandlung. Sehen Sie sich Fehler-Codes und Handbücher zur Fehlerbehebung an.
Weitere Ressourcen additional-resources
- Developer Console: Greifen Sie auf die Adobe Developer Console zu, um Integrationen zu erstellen und API-Anmeldedaten zu verwalten.
- Beispiel-Code: Sehen Sie sich Beispielimplementierungen auf GitHub an.
- Video-Tutorials: Lernen Sie durch praktische Tutorials auf Experience League.
- Entwickler-Community: Treten Sie mit anderen Entwickelnden in Kontakt und erhalten Sie Unterstützung in den Adobe-Community-Foren.
Rollenübergreifendes Zusammenarbeiten next-steps
Ihre Implementierungsarbeit überschneidet sich mit anderen Team-Mitgliedern:
Arbeiten Sie mit Dateningenieurinnen und -ingenieuren bei Daten und Ereigniskonfigurationen zusammen:
-
Abrufen der XDM-Schemata und Ereignisstrukturen, die Sie implementieren müssen
-
Verstehen, welche Ereignisse gesendet werden müssen und welches Payload-Format erforderlich ist
-
Abstimmen der Anforderungen an die Datenerfassung und der Datenqualitätsstandards
-
Gemeinsames Testen des Ereignisversands und der Datenaufnahme
Arbeiten Sie mit Admins bei Zugriff und Konfigurationen zusammen:
-
Angeben von API-Spezifikationen für benutzerdefinierte Aktionen, die sie konfigurieren
-
Anfordern von erforderlichen Berechtigungen und API-Anmeldedaten
-
Koordinieren der Anforderungen an die Kanalkonfiguration (z. B. Push-Zertifikate)
-
Abstimmen zu Testumgebungen und Sandbox-Strategie
Arbeiten Sie mit Marketing-Fachleuten bei Journey-Anforderungen und Tests zusammen:
-
Verstehen, welche Benutzerinteraktionen Ereignisse auslösen sollen
-
Implementieren des Trackings für Inhaltsleistung und Benutzerinteraktion
-
Unterstützen von Tests von Journeys mit Ihren implementierten Funktionen
-
Beheben von Problemen beim Nachrichtenversand oder bei der Personalisierung
Starten der Implementierung
Bereit, mit dem Erstellen zu beginnen? Wählen Sie Ihren ersten Implementierungsbereich aus den obigen Abschnitten:
- App? Beginnen Sie mit der Mobile SDK-Integration
- Website? Beginnen Sie mit der Web SDK-Einrichtung
- API-Integration? Wechseln Sie zu Arbeiten mit APIs
- Benutzerdefiniertes System? Sehen Sie sich benutzerdefinierte Aktionen an
Jeder Abschnitt enthält Links zu detaillierter technischer Dokumentation, Code-Beispielen und Tutorials, die Sie bei der Implementierung unterstützen.