Documentazione Journey Optimizer Guida di Journey Optimizer

Introduzione per gli sviluppatori get-started-developers

Last update: Tue Jan 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Esperto
Sviluppatore

In qualità di sviluppatore, sei responsabile dell’implementazione e dell’integrazione di Adobe Journey Optimizer nelle applicazioni e nei sistemi. Una volta che l’amministratore di sistema e il data engineer ti avranno concesso l’accesso e avranno preparato il tuo ambiente, potrai iniziare a utilizzare Adobe Journey Optimizer.

Il tuo ruolo nell’ecosistema Journey Optimizer

Mentre altri membri del team configurano Journey Optimizer tramite l’interfaccia utente, potrai concentrarti su:

Implementazione degli SDK nelle applicazioni per dispositivi mobili e web
Invio di eventi dalle applicazioni per attivare i percorsi
Creazione di endpoint API che Journey Optimizer può richiamare tramite azioni personalizzate
Integrazione di Journey Optimizer con i sistemi e l’infrastruttura esistenti
Test 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. I marketer progetteranno percorsi e contenuti che utilizzano le tue implementazioni.

Questa guida descrive i passaggi di implementazione tecnica essenziali per iniziare a utilizzare Journey Optimizer. Per la creazione di app per dispositivi mobili, esperienze web o integrazioni API, segui le sezioni di seguito per impostare la tua implementazione.

Prerequisiti prerequisites

Prima di iniziare l’implementazione, assicurati di disporre di:

Categoria

Requisiti

Competenze tecniche

* Esperienza con JavaScript (per Web SDK) o Swift/Kotlin (per Mobile SDK)
* 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

Accesso e autorizzazioni

* Accesso ad Adobe Developer Console per le credenziali API
* Ambiente di sviluppo con accesso alla base di codice dell’applicazione
* Strumenti di test come Postman per i test delle API
* Strumenti per sviluppatori browser o di debug per dispositivi mobili

Da altri membri del team

* Accesso all’ambiente concesso dall’amministratore
* Schemi XDM e definizioni di eventi dal data engineer
* Requisiti e casi d’uso dai marketer

Informazioni sulle basi tecniche technical-foundation

Prima di iniziare a implementare, acquisisci familiarità con i concetti tecnici di base:

Integrazione Adobe Experience Platform: Journey Optimizer è stato creato nativamente in Adobe Experience Platform. Comprendere l’architettura di base ti aiuterà a creare implementazioni più efficaci. Ulteriori informazioni sul funzionamento di 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. Scopri gli schemi XDM.
Autenticazione e sicurezza: tutte le implementazioni richiedono la corretta autenticazione. Scopri come configurare l’autenticazione per SDK e API. Scopri l’autenticazione API.

Impostare le integrazioni delle app per dispositivi mobili mobile-integration

Configurare Adobe Experience Platform Mobile SDK

Per abilitare le notifiche push, i messaggi in-app e altre funzionalità mobili, integra Adobe Experience Platform Mobile SDK nelle tue applicazioni per dispositivi mobili.

Installa e configura Mobile SDK: segui la documentazione di Adobe Experience Platform Mobile SDK per iniziare a utilizzare l’integrazione con SDK.
Creare una proprietà mobile: imposta 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). Per ulteriori informazioni consulta la documentazione di Apple.
- Per app Android: imposta Firebase Cloud Messaging per la tua app Android. Per ulteriori informazioni consulta la documentazione di Google.
Testa l’integrazione per dispositivi mobili: utilizza il flusso di lavoro di avvio rapido per l’onboarding su dispositivi mobili per configurarne e testarne rapidamente la configurazione.

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 per dispositivi mobili tramite esperienze basate su codice:

Segui questo tutorial per l’implementazione di Mobile SDK
Rivedi le implementazioni di esempio per iOS e Android

Implementare le esperienze web web-implementation

Impostare Adobe Experience Platform Web SDK

Per le implementazioni basate su web, il Web SDK è il punto di integrazione principale:

Installare il Web SDK: segui la guida all’implementazione del Web SDK per impostare SDK sul tuo sito web.
Configurare stream di dati: crea e configura uno stream di dati in Adobe Experience Platform Data Collection con Journey Optimizer abilitato. Per ulteriori informazioni consulta la documentazione degli stream di dati.
Abilitare le notifiche push web (facoltativo): configura la proprietà pushNotifications nella configurazione del Web SDK e utilizza il comando sendPushSubscription per registrare gli abbonamenti 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 gli esempi di implementazione per ogni approccio.
Definire le superfici: identifica le posizioni nell’applicazione in cui desideri distribuire contenuti personalizzati. Scopri la configurazione della superficie.
Implementare il rendering del contenuto: utilizza il Web SDK per recuperare e applicare contenuti di personalizzazione. Consulta i tutorial sull’implementazione basata su codice.
Inviare eventi di visualizzazione e interazione: tieni traccia di quando il contenuto viene visualizzato e quando gli utenti interagiscono con esso per l’analisi e l’ottimizzazione.

Esplora le implementazioni di esempio su GitHub per vedere in azione le esperienze basate su codice.

Ulteriori informazioni sull’introduzione alle esperienze basate su codice.

Implementare lo streaming evento event-streaming

Inviare eventi per attivare i percorsi

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.

Informazioni sul payload evento: collabora con il data engineer per ottenere lo schema evento e la struttura del payload richiesto. Il payload deve essere conforme allo schema XDM configurato. Scopri i requisiti dello schema evento.
Implementare lo streaming evento: invia eventi ad Adobe Experience Platform utilizzando le API di acquisizione in streaming. Scopri i passaggi per inviare eventi.
Gestire tipi di evento:
- Eventi unitari: implementa l’invio di eventi in base ad azioni specifiche della persona (ad esempio, clic sul pulsante, completamento dell’acquisto)
- Eventi di business: invia eventi correlati all’azienda (ad esempio, aggiornamenti dell’inventario, modifiche dei prezzi)
Testare la consegna evento: verifica che gli eventi siano ricevuti correttamente e attivino i percorsi come previsto. Scopri la risoluzione dei problemi degli eventi.

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 del percorso.

Sviluppare endpoint di azione personalizzate custom-actions

Le azioni personalizzate consentono ai percorsi di richiamare le API. In qualità di sviluppatore, creerai gli endpoint API richiamati dalle azioni personalizzate:

Generare l’endpoint API: crea endpoint API RESTful che Journey Optimizer chiamerà durante l’esecuzione del percorso. L’endpoint deve:
- Accettare i payload JSON
- Autenticare le richieste (OAuth, chiave API o JWT)
- Elaborare le richieste entro i limiti di timeout appropriati
- Restituire risposte nel formato previsto
Informazioni sulle 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.
Utilizza 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. Informazioni sulla configurazione delle azioni personalizzate.
Restituire dati actionable: progetta l’API per restituire dati che possono essere utilizzati nei passaggi successivi del percorso. Scopri le risposte alle azioni.
Implementare la limitazione della frequenza: 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 il capping e throttling.

Caso d’uso di esempio: Scrittura di eventi del percorso in Experience Platform mediante azioni personalizzate.

Utilizzare le API di Journey Optimizer apis

Journey Optimizer fornisce API REST complete per l’accesso programmatico:

Informazioni sulle funzionalità API: le API di Journey Optimizer ti consentono di creare, leggere, aggiornare ed eliminare varie risorse a livello di programmazione. Scopri le API di Journey Optimizer.
Autenticazione: segui questo tutorial per configurare l’autenticazione API tramite Adobe Developer Console.
Esplorare i riferimenti API: sfoglia la documentazione API completa e prova le API direttamente nel riferimento API di Journey Optimizer.
Campagne attivate da API: crea messaggistica transazionale con campagne attivate da API. Per scenari con volumi elevati (fino a 5000 TPS), esplora la modalità velocità effettiva elevata (richiede una licenza aggiuntiva).
API per la gestione delle decisioni: utilizza API specializzate per la gestione delle offerte e delle decisioni. Per ulteriori informazioni consulta la guida API per la gestione delle decisioni.

Test e debug testing

Debug dell’implementazione SDK: utilizza Adobe Experience Platform Assurance per ispezionare gli eventi SDK, convalidare la raccolta dati e risolvere in tempo reale i problemi di integrazione. Scopri Assurance.
Testa la consegna evento: verifica che gli eventi dall’applicazione siano ricevuti correttamente da Adobe Experience Platform e attivino i percorsi nel modo previsto. Monitora l’acquisizione degli eventi e convalida la struttura del payload.
Convalidare le integrazioni API: testa gli endpoint dell’azione personalizzata per garantire che gestiscano correttamente le richieste di Journey Optimizer, rispondano entro i limiti di timeout e restituiscano i formati dati previsti.
Utilizza la modalità test con i profili di test: collabora con il tuo data engineer per accedere ai profili di test, quindi convalida l’implementazione utilizzando la modalità di test del percorso. Scopri come testare i percorsi.
Monitorare i registri SDK: abilita la registrazione di debug nell’implementazione SDK per risolvere i problemi durante lo sviluppo:
- Mobile SDK: abilita la registrazione per vedere gli eventi SDK e le chiamate API
- Web SDK: usa la console browser per monitorare l’attività SDK
Verificare la configurazione dello stream di dati: assicurati 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: utilizza 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 gli esempi di query per l’analisi del percorso, tra cui:
- Tracciamento di entrata/uscita del 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 arricchimento

Iterazione su array: utilizza la sintassi Handlebars per visualizzare elenchi dinamici da eventi, risposte di azioni personalizzate e ricerche nei set di dati nei messaggi. Scopri come iterare dati contestuali.
Ricerca nei set di dati: implementa le ricerche nei set di dati per arricchire i dati del percorso dai set di dati di Adobe Experience Platform. Collabora con il data engineer sulla configurazione. Scopri la ricerca nei 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 del consenso della clientela nelle tue implementazioni. Scopri il consenso.

Ottimizzazione e best practice

Capping e throttling: comprendi i limiti di frequenza e implementa il throttling appropriato. Scopri i sistemi esterni.
Ottimizzazione del percorso: segui le best practice per l’ottimizzazione del percorso.
Gestione degli errori: implementa una solida gestione degli errori. Rivedi i codici di errore e le guide alla risoluzione dei problemi.

Risorse aggiuntive additional-resources

Developer Console: accedi ad Adobe Developer Console per creare integrazioni e gestire le credenziali API.
Codice di esempio: esplora le implementazioni di esempio su GitHub.
Video tutorial: scopri i tutorial pratici in Experience League.
Community sviluppatori: contatta altri sviluppatori e ottieni supporto nei forum della community Adobe.

Collaborare tra ruoli next-steps

Il tuo lavoro di implementazione si interseca con altri membri del gruppo:

Lavorare con i data enginner

Collabora con i data engineer sulle configurazioni di dati ed eventi:

Ottieni gli schemi XDM e le strutture di eventi necessari per l’implementazione
Scopri quali eventi devi inviare e il formato del payload richiesto
Allinea i requisiti di raccolta dati e agli standard di qualità dei dati
Testa la consegna di eventi insieme all’acquisizione di dati

Lavorare con gli amministratori

Collabora con gli amministratori per l’accesso e le configurazioni:

Fornisci le specifiche API per le azioni personalizzate che configureranno
Richiedi le autorizzazioni e le credenziali API necessarie
Coordina i requisiti di configurazione dei canali (ad esempio, certificati push)
Allinea gli ambienti di test e strategia sandbox

Lavorare con i marketer

Collabora con i marketer sui requisiti del percorso e sui test:

Scopri quali interazioni utente devono attivare gli eventi
Implementa il tracciamento per le prestazioni dei contenuti e il coinvolgimento utente
Test di supporto dei percorsi con funzioni implementate
Risolvere i problemi relativi alla consegna o alla personalizzazione dei messaggi

Iniziare l’implementazione

Tutto pronto per iniziare a creare? Scegli la tua prima area di implementazione dalle sezioni precedenti:

App per dispositivi mobili? Inizia con Integrazione di Mobile SDK
Sito web? Inizia con Configurazione di Web SDK
Integrazione dell’API? Vai a Utilizzo delle API
Sistema personalizzato? Consulta Azioni personalizzate

Ogni sezione include collegamenti alla documentazione tecnica dettagliata, esempi di codice e tutorial per guidare l’implementazione.

recommendation-more-help

b22c9c5d-9208-48f4-b874-1cefb8df4d76