Aggiungere un codice all'applicazione

Per lavorare con CloudWatch Evidently, aggiungi codice alla tua applicazione per assegnare una variante a ogni sessione utente e inviare parametri a Evidently. Usa l'operazione EvaluateFeature di CloudWatch Evidently per assegnare variazioni alle sessioni utente e l'operazione PutProjectEvents per inviare eventi a Evidently da utilizzare per calcolare i parametri per avvii o esperimenti.

Quando crei variazioni o parametri personalizzati, la console CloudWatch Evidently fornisce esempi del codice che devi aggiungere.

Per un esempio end-to-end, consulta Esercitazione: test A/B con l'applicazione Evidently di esempio.

Utilizzo di EvaluateFeature

Quando le varianti di funzionalità vengono utilizzate in un avvio o in un esperimento, l'applicazione utilizza l'operazione EvaluateFeature per assegnare a ogni sessione utente una variante. L'assegnazione di una variazione a un utente è un evento di valutazione. Quando si chiama questa operazione, si passa a quanto segue:

Valutazioni permanenti

CloudWatch Evidentemente utilizza valutazioni “permanenti”. Un'unica configurazione di entityId, funzionalità, configurazione delle funzionalità e evaluationContext riceve sempre la stessa assegnazione di variante. L'unica modifica delle assegnazioni delle variazioni temporali è quando un'entità viene aggiunta a un override o viene composto il traffico sperimentale.

Una configurazione delle funzionalità include:

Se l'allocazione del traffico di un esperimento viene aumentata, qualsiasi entityId che era stato precedentemente assegnato a un gruppo di trattamento sperimentale continuerà a ricevere lo stesso trattamento. Qualsiasi entityId precedentemente assegnato al gruppo di controllo, potrebbe essere assegnato a un gruppo di trattamento sperimentale, in base alla configurazione della variazione specificata per l'esperimento.

Se l'allocazione del traffico di un esperimento è ridotta, un entityId potrebbe passare da un gruppo di trattamento a un gruppo di controllo, ma non a un gruppo di trattamento diverso.

Utilizzo di PutProjectEvent

Per codificare un parametro personalizzato per Evidently, si utilizza l'operazione PutProjectEvents. Di seguito è riportato un semplice esempio di payload.

{
    "events": [
        {
            "timestamp": {{$timestamp}},
            "type": "aws.evidently.custom",
            "data": "{\"details\": {\"pageLoadTime\": 800.0}, \"userDetails\": {\"userId\": \"test-user\"}}"
        }
    ]
}

La entityIdKey può essere solo un entityId oppure è possibile rinominarlo in qualsiasi altro modo, ad esempio userId. Nell'evento reale, entityId può essere un nome utente, un ID sessione e così via.

"metricDefinition":{
    "name": "noFilter",
    "entityIdKey": "userDetails.userId", //should be consistent with jsonValue in events "data" fields
    "valueKey": "details.pageLoadTime"
},

Per garantire che gli eventi siano associati all'avvio o all'esperimento corretto, devi passare lo stessoentityId quando chiami sia EvaluateFeature che PutProjectEvents. Assicurati di chiamare PutProjectEvents dopo la chiamata EvaluateFeature, altrimenti i dati vengono eliminati e non verranno utilizzati da CloudWatch Evidentently.

L'operazione PutProjectEvents non richiede il nome della caratteristica come parametro di input. In questo modo, puoi utilizzare un unico evento in diversi esperimenti. Ad esempio, supponiamo che chiami EvaluateFeature con il entityId impostato su userDetails.userId. Se hai due o più esperimenti in esecuzione, puoi fare in modo che un singolo evento della sessione di quell'utente emetta parametri per ciascuno di questi esperimenti. Per fare questo, chiami PutProjectEvents una volta per ogni esperimento, usando lo stesso entityId.

Timing (Tempo)

Dopo che l'applicazione chiama EvaluateFeature, c'è un periodo di tempo di un'ora in cui gli eventi dei parametri da PutProjectEvents sono attribuiti basati su tale valutazione. Se si verificano altri eventi dopo il periodo di un'ora, non vengono attribuiti.

Tuttavia, se lo stesso entityId è usato per una nuova chiamata EvaluateFeature durante la finestra di un'ora di quella chiamata iniziale, viene utilizzato il risultato della successiva EvaluateFeature e il timer di un'ora viene riavviato. Ciò può accadere solo in determinate circostanze, ad esempio quando il traffico sperimentale viene composto tra i due incarichi, come spiegato nella sezione precedente Valutazioni permanenti.

Per un esempio end-to-end, consulta Esercitazione: test A/B con l'applicazione Evidently di esempio.