Introduzione per gli sviluppatori get-started-developers
In qualità di sviluppatore, sei responsabile dell'implementazione e dell'integrazione di Adobe Journey Optimizer nelle applicazioni e nei sistemi. Puoi iniziare a lavorare con Adobe Journey Optimizer una volta che l'Amministratore di sistema e il Data Engineer ti avranno concesso l'accesso e avranno preparato il tuo ambiente.
Il tuo ruolo nell’ecosistema Journey Optimizer
Mentre altri membri del gruppo configurano Journey Optimizer tramite l’interfaccia utente, ti concentrerai su:
- Implementazione degli SDK nelle applicazioni mobili e web
- Invio di eventi dalle applicazioni per l'attivazione di percorsi
- Creazione di endpoint API che Journey Optimizer può richiamare tramite azioni personalizzate
- Integrazione di Journey Optimizer con i sistemi e l'infrastruttura esistenti
- Verifica e debug delle implementazioni
Il Data Engineer gestirà schemi di dati, configurazioni di eventi e origini dati. L'Amministratore configurerà le autorizzazioni e le configurazioni dei canali. Gli addetti al marketing progetteranno percorsi e contenuti che utilizzano le tue implementazioni.
Questa guida descrive i passaggi tecnici essenziali per iniziare a utilizzare Journey Optimizer. Per la creazione di app mobili, esperienze web o integrazioni API, segui le sezioni seguenti per configurare la tua implementazione.
Prerequisiti prerequisites
Prima di iniziare l’implementazione, assicurati di disporre di:
* Informazioni sulle API RESTful e JSON
* Familiarità con la programmazione asincrona e le architetture basate su eventi
* Conoscenza dell'architettura delle applicazioni della tua organizzazione
* Ambiente di sviluppo con accesso alla base di codice dell'applicazione
* Strumenti di test come Postman per i test API
* Strumenti di sviluppo browser o strumenti di debug mobile
* e definizioni di eventi dal Data Engineer
* Requisiti e casi d'uso dei addetti al marketing
Comprendere la base tecnica technical-foundation
Prima di iniziare a implementare, acquisisci familiarità con i concetti tecnici di base:
-
Integrazione Adobe Experience Platform: Journey Optimizer è stato creato in modalità nativa in Adobe Experience Platform. Comprendere l’architettura di base ti aiuterà a creare implementazioni più efficaci. Ulteriori informazioni su come funziona Journey Optimizer.
-
Modelli dati XDM: Journey Optimizer utilizza Experience Data Model (XDM) per strutturare i dati di eventi e profili. In qualità di sviluppatore, devi capire come inviare dati conformi agli schemi configurati dal tuo Data Engineer. Informazioni sugli schemi XDM.
-
Autenticazione e sicurezza: tutte le implementazioni richiedono l'autenticazione corretta. Scopri come impostare l’autenticazione per SDK e API. Informazioni sull'autenticazione API.
Configurare le integrazioni di app mobili mobile-integration
Configurare Adobe Experience Platform Mobile SDK
Per abilitare le notifiche push, i messaggi in-app e altre funzionalità mobili, integra il SDK mobile di Adobe Experience Platform nelle tue applicazioni mobili.
-
Installa e configura il SDK mobile: segui la documentazione di Adobe Experience Platform Mobile SDK per iniziare a utilizzare l'integrazione con SDK.
-
Creare una proprietà mobile: configurare una proprietà mobile in Adobe Experience Platform Data Collection. Scopri come creare e configurare una proprietà mobile.
-
Configurare le notifiche push:
- Per app iOS: registra l'app con APN (Apple Push Notification Service). Ulteriori informazioni sono disponibili nella documentazione di Apple.
- Per app Android: configura Firebase Cloud Messaging per la tua app Android. Ulteriori informazioni sono disponibili nella documentazione di Google.
-
Verifica la tua integrazione mobile: utilizza il flusso di lavoro di avvio rapido per l'onboarding di dispositivi mobili per configurare e testare rapidamente la configurazione di dispositivi mobili.
I passaggi dettagliati per la configurazione delle notifiche push sono disponibili in questa pagina.
Implementare esperienze basate su codice (Mobile SDK)
Per la personalizzazione nativa delle app mobili tramite esperienze basate su codice:
- Segui questa esercitazione per l'implementazione di Mobile SDK
- Esamina implementazioni di esempio per iOS e Android
Implementare esperienze web web-implementation
Configurare Adobe Experience Platform Web SDK
Per le implementazioni basate su web, il Web SDK è il punto di integrazione principale:
-
Installa il Web SDK: segui la guida all'implementazione del Web SDK per configurare il SDK sul tuo sito Web.
-
Configura flussi di dati: crea e configura uno stream di dati in Adobe Experience Platform Data Collection con Journey Optimizer abilitato. Ulteriori informazioni sono disponibili nella documentazione sugli stream di dati.
-
Abilita notifiche push Web (facoltativo): configura la proprietà pushNotifications nella configurazione del Web SDK e utilizza il comando sendPushSubscription per registrare le sottoscrizioni push.
Implementare esperienze basate su codice (Web SDK)
Le esperienze basate su codice ti consentono di personalizzare qualsiasi punto di contatto digitale:
-
Scegliere il metodo di implementazione: lato client, lato server o ibrido. Rivedi esempi di implementazione per ogni approccio.
-
Definisci superfici: identifica le posizioni nell'applicazione in cui desideri distribuire contenuti personalizzati. Scopri la configurazione superficiale.
-
Implementa rendering del contenuto: utilizza il Web SDK per recuperare e applicare contenuti di personalizzazione. Consulta esercitazioni sull'implementazione basate su codice.
-
Invio di eventi di visualizzazione e interazione: tenere traccia di quando il contenuto viene visualizzato e quando gli utenti interagiscono con esso per l'analisi e l'ottimizzazione.
Esplora implementazioni di esempio su GitHub per visualizzare in azione le esperienze basate su codice.
Ulteriori informazioni su introduzione alle esperienze basate su codice.
Implementare lo streaming degli eventi event-streaming
Inviare eventi ai percorsi di attivazione
In qualità di sviluppatore, implementerai il codice per inviare eventi che attivano i percorsi. Il Data Engineer configurerà gli schemi e le definizioni degli eventi in Journey Optimizer.
-
Comprendere il payload dell'evento: rivolgiti al tuo Data Engineer per ottenere lo schema dell'evento e la struttura del payload richiesti. Il payload deve essere conforme allo schema XDM configurato. Scopri i requisiti dello schema eventi.
-
Implementa streaming eventi: invia eventi a Adobe Experience Platform utilizzando le API Streaming Ingestion. Scopri i passaggi per inviare eventi.
-
Gestisci tipi di evento:
- Eventi unitari: implementa l'invio di eventi per azioni specifiche della persona (ad esempio, clic sul pulsante, completamento dell'acquisto)
- Eventi di business: invia eventi correlati all'azienda (ad esempio, aggiornamenti di inventario, modifiche di prezzo)
-
Consegna evento di test: verificare che gli eventi siano ricevuti correttamente e attivare i percorsi come previsto. Informazioni sulla risoluzione dei problemi dell'evento.
Implementazione di esempio per l'invio di un evento tramite 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
}
}
}
Ulteriori informazioni sull'utilizzo di eventi di percorso.
Sviluppare endpoint di azione personalizzati custom-actions
Le azioni personalizzate consentono ai percorsi di richiamare le API. In qualità di sviluppatore, creerai gli endpoint API richiamati dalle azioni personalizzate:
-
Genera l'endpoint API: crea endpoint API RESTful che Journey Optimizer chiamerà durante l'esecuzione del percorso. L’endpoint deve:
- Accetta payload JSON
- Autentica richieste (OAuth, chiave API o JWT)
- Elabora le richieste entro i limiti di timeout appropriati
- Risposte restituite nel formato previsto
-
Comprendere le funzionalità delle azioni personalizzate: le azioni personalizzate possono connettersi a sistemi di terze parti come Epsilon, Slack, Firebase o ai tuoi servizi. Ulteriori informazioni sulle azioni personalizzate.
-
Utilizzare le configurazioni delle azioni: l'amministratore o il data engineer configurerà l'azione personalizzata in Journey Optimizer, definendo l'URL dell'endpoint API, il metodo di autenticazione e i parametri. Fornirai loro le tue specifiche API. Scopri la configurazione azione personalizzata.
-
Restituisci dati actionable: progetta l'API per restituire dati che possono essere utilizzati nei passaggi di percorso successivi. Scopri le risposte alle azioni.
-
Implementa limitazione di velocità: assicurati che gli endpoint possano gestire il volume previsto. Journey Optimizer applica un limite di 5000 chiamate/secondo, ma il sistema deve essere resiliente. Scopri le limitazioni e limitazioni.
Caso d'uso di esempio: Scrittura di eventi di percorso in Experience Platform mediante azioni personalizzate.
Utilizzare le API di Journey Optimizer apis
Journey Optimizer fornisce API REST complete per l’accesso programmatico:
-
Comprendere le funzionalità API: le API di Journey Optimizer consentono di creare, leggere, aggiornare ed eliminare varie risorse a livello di programmazione. Informazioni sulle API Journey Optimizer.
-
Autenticazione: segui questa esercitazione per configurare l'autenticazione API tramite Adobe Developer Console.
-
Esplora i riferimenti API: sfoglia la documentazione API completa e prova le API direttamente nel riferimento API di Adobe Journey Optimizer.
-
Campagne attivate da API: crea messaggi transazionali con campagne attivate da API. Per scenari con volumi elevati (fino a 5000 TPS), esplora la modalità High Throughput (richiede una licenza aggiuntiva).
-
API per la gestione delle decisioni: utilizza API specializzate per la gestione delle offerte e per il decisioning. Ulteriori informazioni sono disponibili nella Guida API per la gestione delle decisioni.
Test e debug testing
-
Implementazione debug di SDK: utilizza Adobe Experience Platform Assurance per controllare gli eventi di SDK, convalidare la raccolta dati e risolvere in tempo reale i problemi di integrazione. Ulteriori informazioni su Assurance.
-
Consegna evento di test: verifica che gli eventi dell'applicazione siano ricevuti correttamente da Adobe Experience Platform e attiva i percorsi come previsto. Monitora l’acquisizione degli eventi e convalida la struttura del payload.
-
Convalida integrazioni API: verifica gli endpoint di azione personalizzati per garantire che gestiscano correttamente le richieste di Journey Optimizer, rispondano entro i limiti di timeout e restituiscano i formati di dati previsti.
-
Utilizza la modalità di test con i profili di test: rivolgiti al tuo Data Engineer per accedere ai profili di test, quindi convalida l'implementazione utilizzando la modalità di test percorso. Scopri come verificare i percorsi.
-
Monitoraggio dei registri di SDK: abilita la registrazione di debug nell'implementazione di SDK per risolvere i problemi durante lo sviluppo:
- Mobile SDK: abilita la registrazione per visualizzare eventi SDK e chiamate API
- Web SDK: usa la console del browser per monitorare l'attività di SDK
-
Verifica la configurazione dello stream di dati: verificare che lo stream di dati sia configurato correttamente per l'invio di dati a Journey Optimizer. Verifica che gli eventi fluiscano attraverso lo stream di dati verso le destinazioni corrette.
-
Query dei dati del percorso per l'analisi: utilizzare le query SQL nel Data Lake per analizzare gli eventi dei passaggi del percorso, eseguire il debug dei problemi e monitorare le prestazioni delle azioni personalizzate. Esplora esempi di query per l'analisi del percorso, tra cui:
- Tracciamento di entrata/uscita profilo e motivi di eliminazione
- Metriche delle prestazioni delle azioni personalizzate (latenza, velocità effettiva, errori)
- Modelli di consegna degli eventi e di errore
- Stati dell’istanza del percorso
Argomenti per sviluppatori avanzati advanced-topics
Utilizzo dei dati contestuali e dell’arricchimento
- Iterazione su array: utilizza la sintassi Handlebars per visualizzare elenchi dinamici da eventi, risposte di azioni personalizzate e ricerche di set di dati nei messaggi. Scopri come iterare dati contestuali.
- Ricerca set di dati: implementa le ricerche dei set di dati per arricchire i dati di percorso dai set di dati di Adobe Experience Platform. Lavora con il tuo Data Engineer sulla configurazione. Scopri ricerca set di dati.
Lavorare con il consenso e la governance
Implementa la governance dei dati e i criteri di consenso nelle integrazioni:
- Governance dei dati: applica i criteri di utilizzo dei dati alle azioni personalizzate. Ulteriori informazioni sulla governance dei dati.
- Gestione del consenso: gestisci le preferenze di consenso del cliente nelle tue implementazioni. Scopri di più sul consenso.
Ottimizzazione e best practice
- Limitazione e limitazione: comprendi i limiti di velocità e implementa la limitazione appropriata. Informazioni su sistemi esterni.
- Ottimizzazione Percorso: seguire le best practice per Ottimizzazione percorso.
- Gestione degli errori: implementare una gestione affidabile degli errori. Rivedi codici di errore e guide alla risoluzione dei problemi.
Risorse aggiuntive additional-resources
- Developer Console: accedere a Adobe Developer Console per creare integrazioni e gestire le credenziali API.
- Codice di esempio: esplora implementazioni di esempio su GitHub.
- Video tutorial: scopri le esercitazioni pratiche in Experience League.
- Community sviluppatori: contatta altri sviluppatori e ottieni supporto nei forum della community Adobe.
Collaborazione tra ruoli next-steps
Il tuo lavoro di implementazione si interseca con altri membri del gruppo:
Collabora con Data Engineer sulle configurazioni di dati ed eventi:
-
Ottenere gli schemi XDM e le strutture di eventi necessari per implementare
-
Scopri quali eventi devi inviare e il formato del payload richiesto
-
Allineamento ai requisiti di raccolta dei dati e agli standard di qualità dei dati
-
Testare insieme la consegna degli eventi e l’acquisizione dei dati
Collabora con amministratori per l'accesso e le configurazioni:
-
Specifica le API per le azioni personalizzate che configureranno
-
Richiedi le autorizzazioni e le credenziali API necessarie
-
Coordinate sui requisiti di configurazione del canale (ad esempio, certificati push)
-
Allineamento su ambienti di test e strategia sandbox
Collabora con addetti al marketing sui requisiti di percorso e sui test:
-
Scopri quali interazioni utente devono attivare gli eventi
-
Implementare il tracciamento per migliorare le prestazioni dei contenuti e il coinvolgimento degli utenti
-
Test di supporto dei percorsi con le funzioni implementate
-
Risolvere i problemi relativi alla consegna o alla personalizzazione dei messaggi
Avvia implementazione
Pronto per iniziare a creare? Scegli la tua prima area di implementazione dalle sezioni precedenti:
- App mobile? Inizia con Integrazione con Mobile SDK
- Sito Web? Inizia con Installazione di Web SDK
- Integrazione con API? Passa a Utilizzo delle API
- Sistema personalizzato? Estrai Azioni personalizzate
Ogni sezione include collegamenti alla documentazione tecnica dettagliata, esempi di codice e tutorial per guidare l’implementazione.