Erste Schritte für Entwickler get-started-developers
Als Entwickler sind Sie für die Implementierung und Integration von Adobe Journey Optimizer in Ihre Anwendungen und Systeme verantwortlich. Sie können mit Adobe Journey Optimizer arbeiten, sobald Ihnen Systemadministrator und der Datentechniker Zugriff gewährt und Ihre Umgebung 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 Programmen an Trigger-Journey
- Erstellen von API-), die Journey Optimizer über benutzerdefinierte Aktionen aufrufen kann
- Integrieren von Journey Optimizer mit vorhandenen Systemen und Infrastrukturen
- Testen und Debuggen Ihrer Implementierungen
Ihr Dateningenieur verarbeitet Datenschemata, Ereigniskonfigurationen und Datenquellen. Ihr Administrator richtet Berechtigungen und Kanalkonfigurationen ein. Marketer entwerfen die Journey und Inhalte, die Ihre Implementierungen verwenden.
In diesem Handbuch werden die wesentlichen technischen Implementierungsschritte für die ersten Schritte mit Journey Optimizer beschrieben. Gehen Sie wie folgt vor, um Ihre Implementierung einzurichten, unabhängig davon, ob Sie Mobile Apps, Web-Erlebnisse oder API-Integrationen erstellen.
Voraussetzungen prerequisites
Bevor Sie mit der Implementierung beginnen, stellen Sie Folgendes sicher:
* Grundlegendes zu RESTful-APIs und JSON
* Vertrautheit mit asynchroner Programmierung und ereignisgesteuerten
* Kenntnis der Anwendungsarchitektur Ihres Unternehmens
* Entwicklungsumgebung mit Zugriff auf die Code-Basis Ihrer Anwendung
* Testtools wie Postman für API-Tests
* Browser-Entwicklertools oder mobile Debugging-Tools
* XDM-Schemata und Ereignisdefinitionen von Ihren Data Engineer
* Anforderungen und Anwendungsfälle von Ihren Marketern
Technische Grundlagen 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 Funktionsweise von Journey Optimizer.
-
XDM-Datenmodelle: Journey Optimizer verwendet das Experience-Datenmodell (XDM), um Ereignis- und Profildaten zu strukturieren. Als Entwickler müssen Sie verstehen, wie Sie Daten senden, die den von Ihrem/Ihrem konfigurierten Schemata . Informationen zu 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 API-.
Einrichten von Mobile-App-Integrationen mobile-integration
Konfigurieren der Adobe Experience Platform Mobile SDK
Um Push-Benachrichtigungen, In-App-Nachrichten und andere mobile Funktionen zu aktivieren, integrieren Sie die Adobe Experience Platform Mobile SDK in Ihre Mobile Apps.
-
Installieren und Konfigurieren der Mobile SDK: Befolgen Sie die Dokumentation zu Adobe Experience Platform Mobile SDK um mit der SDK-Integration zu beginnen.
-
Eigenschaft für Mobilgeräte erstellen: Richten Sie eine Eigenschaft für Mobilgeräte in Adobe Experience Platform Data Collection ein. Erfahren Sie, wie eine Mobile-Eigenschaft erstellen und konfigurieren.
-
Konfigurieren von Push-Benachrichtigungen:
-
Mobile-Integration testen: 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 Mobile-App-Personalisierung mithilfe von Code-basierten Erlebnissen:
- Folgen Sie diesem Tutorial für die Implementierung von Mobile SDK
- Überprüfen Sie die Beispielimplementierungen für iOS und Android
Implementieren von Web-Erlebnissen web-implementation
Einrichten der Adobe Experience Platform Web SDK
Bei Web-basierten Implementierungen ist die Web-SDK Ihr primärer Integrationspunkt:
-
Installieren der Web-SDK: Befolgen Sie die Implementierungshandbuch für Web-SDK, um die SDK auf Ihrer Website einzurichten.
-
Datenströme konfigurieren: Erstellen und konfigurieren Sie einen Datenstrom in Adobe Experience Platform Data Collection mit aktivierter Journey Optimizer. Weitere Informationen finden Sie in der Dokumentation zu Datenströmen.
-
Web-Push-Benachrichtigungen aktivieren (optional): Konfigurieren Sie die pushNotificationsEigenschaft 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 Touchpoint zu personalisieren:
-
Wählen Sie Ihre Implementierungsmethode aus Client-, Server-seitig oder Hybrid. Überprüfen Sie Implementierungsbeispiele für jeden Ansatz.
-
Oberflächen definieren: Identifizieren Sie die Stellen in Ihrer Anwendung, an denen Sie personalisierte Inhalte bereitstellen möchten. Erfahren Sie mehr über Oberflächenkonfiguration.
-
Implementieren des Content-Renderings: Verwenden Sie die Web-SDK, um Personalisierungsinhalte abzurufen und anzuwenden. Siehe Code-basierte Implementierungstutorials.
-
Anzeige- und Interaktionsereignisse senden: Verfolgen Sie, wann Inhalte angezeigt werden und wann Benutzer damit interagieren, um sie zu analysieren und zu optimieren.
Erkunden Sie Beispielimplementierungen auf GitHub, um Code-basierte Erlebnisse in Aktion zu sehen.
Weitere Informationen über Erste Schritte mit Code-basierten Erlebnissen.
Ereignis-Streaming implementieren event-streaming
Ereignisse an Trigger-Journey senden
Als Entwickler implementieren Sie den Code zum Senden von Ereignissen, die Trigger-Journey senden. Ihr Dateningenieur konfiguriert die Ereignisschemata und -definitionen in Journey Optimizer.
-
Ereignis-Payload verstehen: Wenden Sie sich an Ihren Dateningenieur, um das Ereignisschema und die erforderliche Payload-Struktur zu erhalten. Die Payload muss dem konfigurierten XDM-Schema entsprechen. Erfahren Sie mehr über Anforderungen an Ereignisschemas.
-
Ereignis-Streaming implementieren: Senden von Ereignissen an Adobe Experience Platform mithilfe der Streaming-Aufnahme-APIs. Erfahren Sie Schritte zum Senden von Ereignissen.
-
Ereignistypen verarbeiten:
- Unitäre Ereignisse: Implementieren des Ereignisversands für personenspezifische Aktionen (z. B. Button-Klick, Kaufabschluss)
- Geschäftsereignisse: Senden von geschäftlichen Ereignissen (z. B. Bestandsaktualisierungen, Preisänderungen)
-
Ereignisversand testen: Überprüfen Sie, ob die Ereignisse ordnungsgemäß empfangen wurden und die Trigger-Journey wie erwartet funktionieren. Erfahren Sie mehr über 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
}
}
}
Weitere Informationen über Arbeiten mit Journey-Ereignissen.
Entwickeln benutzerdefinierter Aktionsendpunkte custom-actions
Benutzerdefinierte Aktionen ermöglichen es Journey, Ihre APIs aufzurufen. Als Entwickler erstellen Sie die API-Endpunkte, die durch benutzerdefinierte Aktionen aufgerufen werden:
-
API-Endpunkt erstellen: Erstellen Sie RESTful-API-Endpunkte, die Journey Optimizer während der Journey-Ausführung aufruft. Ihr Endpunkt sollte:
- Akzeptieren von JSON-Payloads
- Authentifizierungsanfragen (OAuth, API-Schlüssel oder JWT)
- Anforderungen innerhalb angemessener Zeitlimits verarbeiten
- Antworten im erwarteten Format zurückgeben
-
Grundlegendes zu den von benutzerdefinierten Aktionen: Benutzerdefinierte Aktionen können eine Verbindung zu Drittanbietersystemen wie Epsilon, Slack, Firebase oder Ihren eigenen Services herstellen. Weitere Informationen über benutzerdefinierte Aktionen.
-
Arbeiten mit Aktionskonfigurationen: Ihr Administrator oder Datentechniker 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 Konfiguration benutzerdefinierter Aktionen.
-
Verwertbare Daten zurückgeben: Entwerfen Sie Ihre API, um Daten zurückzugeben, die in nachfolgenden Journey-Schritten verwendet werden können. Erfahren Sie mehr Aktionsantworten.
-
Ratenbegrenzung implementieren: 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 robust sein. Erfahren Sie mehr Begrenzung und Drosselung.
Anwendungsbeispiel: Schreiben von Journey-Ereignissen in Experience Platform Verwenden benutzerdefinierter 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-.
-
Authentifizierung: Befolgen Sie dieses Tutorial, um die API-Authentifizierung mit Adobe Developer Console einzurichten.
-
API-Referenzen erkunden: Durchsuchen Sie die vollständige API-Dokumentation und probieren Sie APIs direkt in der Adobe Journey Optimizer-API-Referenz aus.
-
API-ausgelöste: Erstellen Sie Transaktionsnachrichten mit API-ausgelösten Kampagnen. Bei Szenarien mit hohem Volumen (bis zu 5.000 TPS) sollten Sie den Hochdurchsatzmodus“ Add-on-Lizenz erforderlich).
-
Entscheidungs-Management-: Verwenden Sie spezielle APIs für Angebotsverwaltung und Entscheidungsfindung. Weitere Informationen finden Sie im Handbuch zur Entscheidungs-Management-API.
Testen und Debuggen testing
-
SDK-Implementierung debuggen: Verwenden Sie Adobe Experience Platform Assurance, um SDK-Ereignisse zu untersuchen, die Datenerfassung zu validieren und Integrationsprobleme in Echtzeit zu beheben. Weitere Informationen zu Assurance.
-
Ereignisversand testen: Überprüfen Sie, ob Ereignisse aus Ihrer Anwendung von Adobe Experience Platform und den Trigger-Journey korrekt und wie erwartet empfangen werden. Überwachen der Ereignisaufnahme und Überprüfen der Payload-Struktur.
-
Validieren von API-Integrationen: Testen Sie Ihre benutzerdefinierten Aktionsendpunkte, um sicherzustellen, dass sie Journey Optimizer-Anfragen korrekt verarbeiten, innerhalb der Zeitüberschreitungsgrenzen reagieren und die erwarteten Datenformate zurückgeben.
-
Testmodus mit Testprofilen verwenden: Wenden Sie sich an Ihren Dateningenieur, um Zugriff auf Testprofile zu erhalten, und validieren Sie dann Ihre Implementierung mithilfe des Journey-Testmodus. Erfahren Sie, wie Journey testen.
-
SDK-Protokolle überwachen: 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 Sie die Browser-Konsole, um die Aktivität von SDK 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/Austritten und Verwerfen von Gründen
- Leistungsmetriken für benutzerdefinierte Aktionen (Latenz, Durchsatz, Fehler)
- Ereignisversand- und Fehlermuster
- Journey-Instanzstatus
Fortgeschrittene Entwicklerthemen advanced-topics
Arbeiten mit kontextuellen Daten und Anreicherungen
- Iteration über Arrays: Verwenden Sie die Handlebars-Syntax, um dynamische Listen aus Ereignissen, benutzerdefinierten Aktionsantworten und Datensatzsuchen in Nachrichten anzuzeigen. Erfahren Sie mehr über Iterieren von kontextuellen Daten.
- Datensatzsuche: Implementieren von Datensatzsuchen zur Anreicherung von Journey-Daten aus Adobe Experience Platform-Datensätzen. Arbeiten Sie bei der Konfiguration mit Ihrem Dateningenieur zusammen. Weitere Informationen 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. Weitere Informationen zu Data Governance.
- Einverständnisverwaltung: Handhabung der Voreinstellungen für das Kundeneinverständnis in Ihren Implementierungen. Weitere Informationen zu Zustimmung.
Optimierung und Best Practices
- Begrenzung und Drosselung: Machen Sie sich mit den Ratenbeschränkungen vertraut und implementieren Sie geeignete Drosselungen. Informationen zu externen Systemen.
- Journey-Optimierung: Befolgen Sie die Best Practices für die Journey-Optimierung.
- Fehlerbehandlung: Implementieren Sie eine robuste Fehlerbehandlung. Lesen Sie Fehlercodes und Handbücher zur Fehlerbehebung.
Weitere Ressourcen additional-resources
- Developer Console: Greifen Sie auf die Adobe Developer Console zu, um Integrationen zu erstellen und API-Anmeldeinformationen zu verwalten.
- Beispielcode: Erkunden Sie Beispielimplementierungen auf GitHub.
- Anleitungsvideos: Lernen Sie durch praktische Tutorials zu Experience League.
- Entwickler-Community: Treten Sie mit anderen Entwicklern in Kontakt und erhalten Sie Unterstützung in den Adobe-Community-Foren.
Rollenübergreifend zusammenarbeiten next-steps
Ihre Implementierungsarbeit überschneidet sich mit anderen Team-Mitgliedern:
Zusammenarbeit mit Dateningenieuren bei Daten- und Ereigniskonfigurationen:
-
Abrufen der XDM-Schemata und Ereignisstrukturen, die Sie implementieren müssen
-
Verstehen, welche Ereignisse gesendet werden müssen, und deren erforderliches Payload-Format
-
Angleichung der Anforderungen an die Datenerfassung und der Datenqualitätsstandards
-
Gemeinsames Testen des Versands und der Datenaufnahme
Zusammenarbeit mit Administratoren bei Zugriff und Konfigurationen:
-
Angeben von API-Spezifikationen für benutzerdefinierte Aktionen, die sie konfigurieren werden
-
Erforderliche Berechtigungen und API-Anmeldedaten anfordern
-
Koordinieren der Anforderungen an die Kanalkonfiguration (z. B. Push-Zertifikate)
-
Ausrichtung an Testumgebungen und Sandbox-Strategie
Zusammenarbeit mit Marketern bei Journey-Anforderungen und -Tests:
-
Verstehen, welche Benutzerinteraktionen Trigger-Ereignisse auslösen sollen
-
Implementieren des Trackings für Content-Performance und Benutzerinteraktion
-
Unterstützen von Tests von Journey mit Ihren implementierten Funktionen
-
Fehlerbehebung bei Problemen beim Nachrichtenversand oder bei der Personalisierung
Mit der Implementierung beginnen
Bereit mit dem Bau zu beginnen? Wählen Sie Ihren ersten Implementierungsbereich aus den obigen Abschnitten:
- Mobile App? Schritte mit der Mobile SDK-Integration
- Website? Erste Schritte mit Einrichten von Web SDK
- API-Integration? Wechseln zu Arbeiten mit APIs
- Benutzerdefiniertes System? Auschecken benutzerdefinierte Aktionen
Jeder Abschnitt enthält Links zu detaillierten technischen Dokumentationen, Code-Beispielen und Tutorials, die Sie bei der Implementierung unterstützen.