Panoramica delle API Experience

Le API Experience sono un set di endpoint che puoi richiamare dal codice del tuo sito. Le nostre API offrono le stesse capacità di personalizzazione e di raccolta dei dati fornite dal nostro script per siti Web, ma devono essere richiamate dalla codebase per far sì che Dynamic Yield restituisca dati rilevanti. Una volta ricevuti i dati, spetta a te farne qualcosa nel codice del tuo sito.

Le API Experience offrono molteplici vantaggi. Esse:

• Forniscono un'esperienza impeccabile sul sito web, senza sfarfallii. 
• Offrono agli utenti la stessa esperienza digitale su canali diversi.
• Non espongono le tue campagne al browser, evitando di esporre le strategie interne.
• Aiutano a proteggere la privacy degli utenti e a rispettare le normative.

Prerequisiti

Gli aspetti principali di cui devi assicurarti per iniziare il tuo percorso di personalizzazione delle API sono:

1. Hai le risorse di sviluppo con cui lavorare
2. Sei in un'area servita da uno dei nostri data center
3. Se lavori con una CDN, assicurati di poter fornire contenuti dinamici (rispetto a pagine statiche e completamente memorizzate nella cache).

Per maggiori dettagli, consulta la sezione Verifica la tua preparazione nei nostri Documenti per sviluppatori.

Le API Experience

La famiglia di API Experience di Dynamic Yield include le seguenti API.

Scelta delle varianti

La scelta delle varianti, o l'endpoint Choose, è il tuo endpoint primario. Le chiamate Choose attivano una o più campagne Dynamic Yield per nome. L'attivazione risolve automaticamente le regole di targeting e l'allocazione dei gruppi di test e restituisce la variante corretta. In genere, dovresti effettuare questa chiamata come parte della pipeline di rendering della tua pagina più grande e dei tuoi contenuti. Le impostazioni della campagna si controllano tutte dalla console di Experience OS;. 

Sulle pagine che non eseguono lo script Dynamic Yield, l'API Choose può anche riportare le visualizzazioni di pagina.

Segnalazione delle visualizzazioni di pagina

Utilizzare questo endpoint per segnalare una visualizzazione di pagina, senza alcuna campagna collegata. La visualizzazione di pagina è sostanzialmente un alias per Choose, ma senza alcun nome di campagna. Nota che, se non utilizzi lo script Dynamic Yield, le visualizzazioni delle pagine vengono segnalate implicitamente nella chiamata Choose, mentre se sul tuo sito c'è lo script di Dynamic Yield, non vengono segnalate nella chiamata perché lo script riporta le visualizzazioni di pagina.

Reporting sul coinvolgimento

Dopo aver ricevuto le varianti dalla chiamata Choose e averle rese (o aver eseguito qualsiasi altra azione rilevante), il passo successivo è quello di ottenere un rapporto sul coinvolgimento con ogni variante renderizzata. In genere, si misurano i clic degli utenti sulla pagina, ma puoi misurare anche le impressioni. Queste metriche ti consentono di analizzare il successo delle tue campagne e di migliorarne le prestazioni.

Reporting sugli eventi

Il reporting di eventi significativi per l'utente (come Accesso, Aggiunta al carrello, Acquisto, Riproduzione video e così via) è fondamentale sia per la segmentazione che per la sperimentazione: in genere si prendono di mira gli utenti in base alle loro azioni passate o si imposta un evento come metrica primaria o secondaria per le campagne. Per maggiori informazioni sugli eventi predefiniti e personalizzati, consulta la sezione Reporting sugli eventi.

Utilizzo congiunto della personalizzazione basata su script e delle API Experience 

Che tu sia un principiante riguardo a Dynamic Yield oppure stai già utilizzando il nostro script sul tuo sito, puoi ottenere il meglio di entrambi i mondi combinando le campagne API e quelle che hai creato nella console di Experience OS. Ad esempio, se sei abituato a strumenti di test e personalizzazione lato client e desideri ridurre al minimo il time to value, restando aperto ad opzioni future, puoi iniziare rapidamente con lo script del sito Web e poi implementare gradualmente le campagne basate sulle API. Casi d'uso per i quali le campagne API sono particolarmente consigliate:

• Desideri lanciare campagne sensibili alle prestazioni (ad esempio, contenuti nella parte bassa della schermata).
• Disponi di campagne con dati sensibili che non vuoi siano esposti nel browser.
• Prevedi di eseguire un gran numero di test simultaneamente.

Scopri di più su Utilizzo congiunto delle API Experience e dello script Dynamic Yield per la personalizzazione Web

Implementazione delle campagne

Le APIExperience ti consentono di proporre contenuti sia sul Web che su app mobili dallo stesso sito e di creare anche un profilo utente unificato su più dispositivi, implementando eventi di identificazione con valori corrispondenti. In Experience OS puoi creare i seguenti tipi di campagne API Experience:

• Campagne di raccomandazioni: visualizzano automaticamente gli articoli più pertinenti per ciascun utente.
  Per la personalizzazione Web | Per la personalizzazione app     

• Campagne personalizzate: usa il potere dei test A/B e dell'allocazione automatica di Dynamic Yield, controllando completamente il rendering delle campagne sul tuo sito.
  Per la personalizzazione Web | Per la personalizzazione app

Scopri di più su Implementazione delle API Experience per le app mobili.

Dopo aver creato una campagna API, puoi visualizzarla in anteprima in Experience OS:

• Anteprima delle campagne di personalizzazione Web API
• Anteprima delle campagne API per la personalizzazione delle app