Gestire i rollout per i test delle funzioni

Riepilogo dei passaggi

  1. Abilita on-device decisioning per la tua organizzazione
  2. Crea un'attività A/B Test
  3. Definire la funzione e le impostazioni di rollout
  4. Implementare ed eseguire il rendering della funzione nell’applicazione
  5. Implementa il tracciamento degli eventi nell’applicazione
  6. Attivare l’attività A/B
  7. 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.

Alt immagine

NOTE
Per abilitare o disabilitare l'attivazione/disattivazione di On-Device Decisioning, è necessario disporre del ruolo utente amministratore o approvatore.

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

  1. In Adobe Target, passare alla pagina Activities, quindi selezionare Create Activity > A/B test.

    Alt immagine

  2. 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).

    Alt immagine

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à.

Alt immagine

  1. Nella sezione Content della stessa pagina, seleziona Create JSON Offer nel menu a discesa (1) come mostrato.

    Alt immagine

  2. 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).

    Alt immagine

  3. Fai clic su Next (1) per passare al passaggio Targeting della creazione di attività.

    Alt immagine

  4. 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.

    Alt immagine

  5. Nel passaggio Goals & Settings, scegli Adobe Target (1) come Reporting Source per visualizzare i risultati dell'attività nell'interfaccia utente Adobe Target.

  6. 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).

  7. Fare clic su Save & Close (3) per salvare l'attività.

    Alt immagine

4. Implementare ed eseguire il rendering della funzione nell’applicazione

Node.js
code language-js line-numbers
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);
    });
Java
code language-java line-numbers
    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.

Node.js
code language-js line-numbers
//... 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");
}
Java
code language-java line-numbers
//... 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

Alt immagine

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.

Alt immagine

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3