Introduzione per sviluppatori get-started-developers

In questa pagina: implementa gli SDK, lo streaming di eventi, gli endpoint di azione personalizzati e le API che connettono le applicazioni a Adobe Journey Optimizer in modo che i tuoi percorsi possano essere eseguiti su dati live.

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:

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:

Informazioni sulle basi tecniche technical-foundation

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

Impostare le integrazioni delle app per dispositivi mobili mobile-integration

Configurare Adobe Experience Platform Mobile SDK

Il Mobile SDK è una raccolta di librerie da incorporare direttamente nell’app iOS o Android. Agisce come livello di comunicazione tra l’app e Adobe Experience Platform: identifica gli utenti, raccoglie eventi comportamentali e fornisce istruzioni da Journey Optimizer, tra cui notifiche push, messaggi in-app e contenuti personalizzati. Senza di esso, Journey Optimizer non ha alcuna visibilità su ciò che gli utenti della tua app stanno facendo e nessun modo per raggiungerli.

I passaggi dettagliati per la configurazione delle notifiche push sono disponibili in questa pagina.

Implementare esperienze basate su codice (Mobile SDK)

Le esperienze basate su codice ti consentono di distribuire contenuti personalizzati a qualsiasi superficie dell’app mobile nativa, da schermate di onboarding e pagine di dettaglio del prodotto a banner in-app e flag di funzioni, senza richiedere una nuova versione dell’app. Utilizza Mobile SDK per recuperare ed eseguire il rendering di contenuti personalizzati in fase di runtime, dando al team il controllo completo su posizionamento e presentazione:

Implementare le esperienze web web-implementation

Impostare Adobe Experience Platform Web SDK

Il Web SDK (alloy.js) è un’unica libreria JavaScript che sostituisce il patchwork di tag Adobe separati di cui il sito potrebbe avere bisogno. Raccoglie dati comportamentali, li invia a Adobe Experience Platform tramite un flusso di dati configurato e riceve nuovamente istruzioni di personalizzazione, il tutto in un unico round trip in rete. Una volta implementato, Journey Optimizer può identificare i visitatori, attivare i percorsi dalle loro azioni e distribuire immediatamente contenuti personalizzati alle tue pagine.

Implementare esperienze basate su codice (Web SDK)

A differenza dei canali visivi in cui gli addetti al marketing controllano completamente il layout, le esperienze basate su codice ti danno la piena proprietà del modo in cui il contenuto personalizzato viene riprodotto sulla pagina. Journey Optimizer restituisce un payload JSON con i dati di personalizzazione; il codice decide dove e come visualizzarlo. Questo modello funziona per qualsiasi superficie web: banner hero, caroselli di consigli, classificazioni dei risultati di ricerca, varianti di test A/B, senza bisogno di un editor visivo o di un flusso di lavoro di pubblicazione delle pagine.

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

Percorsi eseguiti in base a eventi: un utente effettua l’accesso, aggiunge un elemento al carrello, completa un acquisto e abbandona un modulo. Il tuo lavoro consiste nell’emettere tali eventi dall’applicazione esattamente al momento giusto. Ogni evento è un payload JSON strutturato in XDM inviato all’API Streaming Ingestion di Experience Platform; Journey Optimizer lo raccoglie in pochi millisecondi e instrada il profilo in qualsiasi percorso corrispondente. Lo schema dell’evento e la struttura del payload sono definiti dal Data Engineer, che si coordina con loro prima di iniziare la codifica.

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

Quando un percorso raggiunge un passaggio di azione personalizzato, Journey Optimizer effettua una chiamata HTTP in uscita a un URL fornito: il tuo back-end, un CRM, una piattaforma fedeltà, qualsiasi endpoint REST. Il tuo lavoro consiste nel generare ed esporre tale endpoint: definire il contratto di richiesta (forma payload, metodo di autenticazione, formato di risposta), implementare la logica di business sottostante e assicurarti che possa gestire il volume di chiamata che verrà generato da Journey Optimizer. L’Amministratore registra quindi l’endpoint in Journey Optimizer in modo che gli addetti al marketing possano utilizzarlo come passaggio nei propri percorsi.

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

Utilizzare le API di Journey Optimizer apis

Non è necessario che tutto accada tramite l’interfaccia utente di Journey Optimizer. A volte è necessario attivare una campagna dal proprio backend, eliminare un indirizzo e-mail dopo una richiesta di privacy o sincronizzare modelli di contenuto da un CMS esterno. Le API REST di Journey Optimizer consentono di accedere in modo programmatico alle funzionalità di base della piattaforma. Tutte le chiamate utilizzano l’autenticazione server-to-server OAuth: il metodo JWT precedente è obsoleto.

Test e debug testing

Prima che l’implementazione venga pubblicata, devi essere sicuro che gli eventi si attivino al momento giusto, che i percorsi si attivino come previsto, che le azioni personalizzate si comportino con un carico realistico e che il rendering dei contenuti personalizzati venga eseguito correttamente. Questa sezione descrive gli strumenti e le tecniche per rilevare i problemi in anticipo, dalla registrazione SDK di basso livello alle esecuzioni di test di percorso end-to-end con profili reali.

Argomenti per sviluppatori avanzati advanced-topics

Una volta implementati gli SDK, gli eventi e le API principali, questi argomenti ti aiutano ad andare oltre: arricchire i dati del percorso in fase di runtime senza gonfiare il profilo, gestire i segnali di consenso in modo che le rinunce si propaghino attraverso ogni integrazione e ottimizzare l’implementazione per il throughput e l’affidabilità richiesti dalla scala di produzione.

Utilizzo dei dati contestuali e arricchimento

I percorsi spesso necessitano di più dati rispetto a quelli che arrivano nell’evento scatenante: un nome di prodotto, un livello fedeltà, un elenco di voci dell’ordine. Invece di precaricare tutto questo in ogni profilo, l’arricchimento contestuale consente al percorso di esaminarlo in fase di esecuzione dai set di dati di AEP o di portarlo avanti da una risposta di azione personalizzata. I messaggi e le condizioni del ramo possono quindi fare riferimento a tali dati senza mai essere memorizzati in modo permanente sul profilo.

Lavorare con il consenso e la governance

Journey Optimizer applica la governance dei dati e i criteri di consenso a livello di piattaforma, ma anche la tua integrazione deve rispettarli. Quando un cliente rinuncia alle comunicazioni di marketing, o quando un’etichetta di utilizzo dei dati limita la modalità di utilizzo di un campo, queste regole devono propagarsi tramite azioni personalizzate e ricerche di set di dati, non solo bloccando le azioni nell’interfaccia utente.

Ottimizzazione e best practice

Le implementazioni Journey Optimizer di produzione gestiscono regolarmente milioni di eventi e migliaia di esecuzioni di percorso al secondo. Queste risorse consentono di ottimizzare l’integrazione in base a tale scala: comprendere i limiti di velocità prima di raggiungerli, evitare le comuni insidie di progettazione del percorso che causano la caduta silenziosa dei profili e creare una gestione degli errori che si riduca gradualmente anziché fallire in modo poco trasparente.

Chiama API REST di Journey Optimizer rest-apis

Oltre all’implementazione degli SDK e allo streaming di eventi, puoi anche gestire Journey Optimizer a livello di programmazione dai tuoi sistemi. Il riferimento API completo, le specifiche OpenAPI e gli esempi di codice si trovano nel portale per sviluppatori di Journey Optimizer.

Eseguire campagne attivate da API api-triggered

Attivare messaggi transazionali o di marketing da un sistema esterno utilizzando l’API REST di esecuzione interattiva dei messaggi. Prima di chiamare l’endpoint:

Riferimento API · Esempi di codice · Utilizzo di campagne attivate da API

Limitazione e limitazione per gli endpoint esterni capping-throttling

Quando i percorsi chiamano sistemi esterni tramite azioni personalizzate o origini dati, le API di limitazione e limitazione proteggono tali sistemi dal sovraccarico. Il limite rifiuta le chiamate che superano il limite configurato; la limitazione le mette in coda per un massimo di 6 ore (solo sandbox di produzione, azioni personalizzate).

Riferimento API di limitazione · Utilizzare l’API di limitazione · Utilizzare l’API di limitazione

Altre API REST more-rest-apis

Oltre ai messaggi e ai limiti, Journey Optimizer espone endpoint REST per la gestione dell’eliminazione, la creazione di modelli di contenuto, il recupero delle campagne, la verifica e l’esecuzione orchestrata delle campagne. Utilizzali quando devi automatizzare operazioni che altrimenti richiederebbero passaggi manuali nell’interfaccia utente, ad esempio la soppressione in blocco degli indirizzi dopo un richiamo di dati o la sincronizzazione di modelli da una pipeline di contenuto esterna.

| Convalidare i set di dati e attivare l’esecuzione di una campagna orchestrata | Convalida set di dati · Trigger · Abilita set di dati |

Risorse aggiuntive additional-resources

Collaborare tra ruoli next-steps

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

Iniziare l’implementazione

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

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

Altre guide ruolo other-role-guides

Torna a Panoramica su ruoli e responsabilità · Torna a Inizia