Introduzione per sviluppatori get-started-developers

In questa pagina: implementa gli SDK, lo streaming di eventi, gli endpoint delle azioni personalizzate e le API che connettono le tue applicazioni ad Adobe Journey Optimizer in modo che i tuoi percorsi possano basarsi 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

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 di 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 dei dettagli dei prodotti 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

Web SDK (alloy.js) è un’unica libreria JavaScript che sostituisce l’insieme eterogeneo di tag Adobe separati di cui il sito potrebbe altrimenti avere bisogno. Raccoglie dati comportamentali, li invia a Adobe Experience Platform tramite uno stream di dati che configura e riceve nuovamente istruzioni di personalizzazione, il tutto in un unico ciclo di comunicazione. Una volta implementato, Journey Optimizer può identificare chi visita il sito, 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 i marketer controllano completamente il layout, le esperienze basate su codice ti garantiscono il pieno controllo sul modo in cui viene eseguito il rendering dei contenuti personalizzati sulla pagina. Journey Optimizer restituisce un payload JSON con i dati di personalizzazione; il tuo codice decide dove e come visualizzarlo. Questo modello funziona per qualsiasi superficie web: banner hero, caroselli di consigli, ranking 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 nel generare tali eventi dalla tua applicazione esattamente al momento giusto. Ogni evento è un payload JSON strutturato in base a uno schema XDM inviato all’API di acquisizione in streaming di Experience Platform; Journey Optimizer lo rileva in pochi millisecondi e indirizza il profilo verso il percorso corrispondente. Lo schema dell’evento e la struttura del payload sono definiti dal tuo Data Engineer: coordinati con questa persona 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 personalizzata, Journey Optimizer effettua una chiamata HTTP in uscita a un URL che fornisci: il tuo back-end, un CRM, una piattaforma fedeltà, qualsiasi endpoint REST. Il tuo lavoro consiste nel generare ed esporre tale endpoint: definisci il contratto di richiesta (forma del payload, metodo di autenticazione, formato della risposta), implementa la logica di business sottostante e assicurati che possa gestire il volume di chiamate che verrà generato da Journey Optimizer. L’Amministratore registra quindi l’endpoint in Journey Optimizer in modo che i marketer 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 avvenga tramite l’interfaccia utente di Journey Optimizer. A volte devi attivare una campagna dal tuo back-end, eliminare un indirizzo e-mail dopo una richiesta sulla privacy o sincronizzare modelli di contenuto da un CMS esterno. Le API REST di Journey Optimizer ti consentono di accedere in modo programmatico alle funzionalità di base della piattaforma. Tutte le chiamate utilizzano l’autenticazione da server a server OAuth: il metodo JWT precedente è obsoleto.

Test e debug testing

Prima che la tua implementazione venga pubblicata, devi assicurarti che: gli eventi si verifichino al momento giusto, i percorsi si attivino come previsto, le azioni personalizzate si comportino con un carico realistico e 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, ovvero arricchire i dati del percorso in fase di runtime senza appesantire il profilo, gestire i segnali di consenso in modo che le rinunce si propaghino attraverso ogni integrazione e ottimizzare l’implementazione per la velocità effettiva e l’affidabilità richieste dalla scala di produzione.

Utilizzo dei dati contestuali e arricchimento

I percorsi spesso necessitano di più dati rispetto a quelli forniti dall’evento di attivazione: un nome di prodotto, un livello di fedeltà, un elenco di voci dell’ordine. Anziché precaricare tutte queste informazioni in ogni profilo, l’arricchimento contestuale consente al tuo percorso di recuperarle in fase di esecuzione dai set di dati AEP o di trasferirle da una risposta di azione personalizzata. I tuoi messaggi e le condizioni del ramo potranno quindi fare riferimento a tali dati senza che questi vengano mai memorizzati in modo permanente nel 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 le tue azioni personalizzate e ricerche di set di dati, non solo bloccare le azioni nell’interfaccia utente.

Ottimizzazione e best practice

Le implementazioni nell’ambiente di produzione di Journey Optimizer gestiscono regolarmente milioni di eventi e migliaia di esecuzioni di percorsi al secondo. Queste risorse ti aiutano a ottimizzare la tua integrazione per quella scala, permettendoti di conoscere i limiti di frequenza prima di raggiungerli, evitare i comuni errori nella progettazione dei percorsi che possono causare la perdita silenziosa di profili e implementare una gestione degli errori che consenta al sistema di degradare in modo graduale anziché interrompersi senza fornire indicazioni chiare.

Chiamare le API REST di Journey Optimizer rest-apis

Oltre all’implementazione degli SDK e dello streaming di eventi, puoi anche gestire Journey Optimizer a livello programmatico dai tuoi sistemi. La documentazione completa delle API, le specifiche OpenAPI e gli esempi di codice si trovano nel portale per sviluppatori di di Journey Optimizer.

Eseguire le campagne attivate da API api-triggered

Attiva messaggi transazionali o di marketing da un sistema esterno utilizzando l’API REST per l’esecuzione di messaggi interattivi. Prima di chiamare l’endpoint:

Documentazione delle API · Esempi di codice · Utilizzare campagne attivate da API

Capping e throttling per gli endpoint esterni capping-throttling

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

Documentazione dell’API capping · Utilizzare l’API capping · Utilizzare l’API throttling

Altre API REST more-rest-apis

Oltre ai messaggi e alle limitazioni, Journey Optimizer espone endpoint REST per la gestione delle soppressioni, la creazione di modelli di contenuto, il recupero delle campagne, la verifica delle bozze e l’esecuzione di campagne orchestrate. 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 del set di dati · Trigger · Abilitare 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 al ruolo other-role-guides

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