Gestire i rollout per i test delle funzioni
- Argomenti:
- APIs/SDKs
Creato per:
- Sviluppatore
Riepilogo dei passaggi
- Abilita on-device decisioning per la tua organizzazione
- Crea un'attività A/B Test
- Definire la funzione e le impostazioni di rollout
- Implementare ed eseguire il rendering della funzione nell’applicazione
- Implementa il tracciamento degli eventi nell’applicazione
- Attivare l’attività A/B
- Regola rollout e allocazione del traffico in base alle esigenze
1. Abilita on-device decisioning per la tua organizzazione
L’abilitazione del decisioning sul dispositivo garantisce che un’attività A/B venga eseguita con latenza vicina allo zero. Per abilitare questa funzione, passare a Administration > Implementation > Account details in Adobe Target e attivare/disattivare On-Device Decisioning.
Dopo aver attivato l'interruttore On-Device Decisioning, Adobe Target inizia a generare artefatti regola per il client.
2. Creare un'attività A/B Test
-
In Adobe Target, passare alla pagina Activities, quindi selezionare Create Activity > A/B test.
-
Nel modale Create A/B Test Activity, lascia selezionata l'opzione predefinita Web (1), seleziona Form come compositore esperienza (2), seleziona Default Workspace con No Property Restrictions (3), quindi fai clic su Next (4).
3. Definisci la funzione e le impostazioni di rollout
Nel passaggio Experiences della creazione di attività, fornisci un nome per l'attività (1). Immetti il nome della posizione (2) all'interno dell'applicazione in cui desideri gestire i rollout per la funzione. Ad esempio, ondevice-rollout
o homepage-addtocart-rollout
sono nomi di posizione che indicano le destinazioni per la gestione dei rollout di funzionalità. Nell'esempio seguente, ondevice-rollout
è la posizione definita per l'Esperienza A. Facoltativamente, puoi aggiungere perfezionamenti del pubblico (4) per limitare la qualifica all’attività.
-
Nella sezione Content della stessa pagina, seleziona Create JSON Offer nel menu a discesa (1) come mostrato.
-
Nella casella di testo JSON Data che viene visualizzata, immetti la variabile del flag di funzione per la funzione che intendi eseguire il rollout con questa attività nell'Esperienza A (1), utilizzando un oggetto JSON valido (2).
-
Fai clic su Next (1) per passare al passaggio Targeting della creazione di attività.
-
Nel passaggio Targeting, mantieni il pubblico All Visitors (1), per semplicità. Ma regola l'allocazione del traffico (2) al 10%. In questo modo la funzione sarà limitata al 10% dei visitatori del sito. Fare clic su Avanti (3) per passare al passaggio Goals & Settings.
-
Nel passaggio Goals & Settings, scegli Adobe Target (1) come Reporting Source per visualizzare i risultati dell'attività nell'interfaccia utente Adobe Target.
-
Scegli un Goal Metric per misurare l'attività. In questo esempio, una conversione corretta si basa sull'acquisto o meno di un articolo da parte dell'utente, come indicato dal fatto che l'utente abbia raggiunto o meno la posizione orderConfirm (2).
-
Fare clic su Save & Close (3) per salvare l'attività.
4. Implementare ed eseguire il rendering della funzione nell’applicazione
targetClient.getAttributes(["ondevice-rollout"]).then(function(attributes) {
const featureFlags = attributes.asObject("ondevice-rollout");
// Your flag variables are now available in the featureFlags object variable.
//If you failed to qualify for the Activity, you will have an empty object.
console.log(featureFlags);
});
Attributes attrs = targetJavaClient.getAttributes(targetDeliveryRequest, "ondevice-rollout");
Map<String, Object> featureFlags = attrs.toMboxMap("ondevice-rollout");
// Your flag variables are now available in the featureFlags object variable.
//If you failed to qualify for the Activity, you will have an empty object.
System.out.println(featureFlags);
5. Implementa il tracciamento degli eventi nell’applicazione
Dopo aver reso disponibile nell’applicazione la variabile flag di funzione, puoi utilizzarla per abilitare qualsiasi funzione che fa già parte dell’applicazione. Se un visitatore non è idoneo per l’attività, significa che non è stato incluso nel bucket del 10% definito come pubblico.
//... Code removed for brevity
if(featureFlags.enable == "yes") { //Fell within 10% traffic
console.log("Render Feature");
}
else {
console.log("Disable Feature");
}
// alternatively, the getValue method could be used on the Attributes object.
if(attributes.getValue("ondevice-rollout", "enable") === "yes") { //Fell within 10% traffic
console.log("Render Feature");
}
else {
console.log("Disable Feature");
}
//... Code removed for brevity
if("yes".equals(String.valueOf(featureFlags.get("enable")))) { //Fell within 10% traffic
System.out.println("Render Feature");
}
else {
System.out.println("Disable Feature");
}
// alternatively, the getString method could be used on the Attributes object.
if("yes".equals(attrs.getString("ondevice-rollout", "enable"))) { //Fell within 10% traffic
System.out.println("Render Feature");
}
else {
System.out.println("Disable Feature");
}
6. Attivare l’attività di rollout
7. Regola il rollout e l’allocazione del traffico in base alle esigenze
Dopo aver attivato l’attività, modificala in qualsiasi momento per aumentare o ridurre l’allocazione del traffico in base alle esigenze.
Aumento dell’allocazione del traffico dal 10% al 50% a causa del successo del rollout iniziale.