Campagne con codice personalizzato API per il web

Le campagne API personalizzate ti consentono di sfruttare la potenza dei test A/B di Dynamic Yield e dell'allocazione automatica, controllando al contempo il modo in cui le campagne vengono visualizzate sul tuo sito. Le varianti delle tue campagne API personalizzate sono file JSON, quindi ogni chiamata genererà un file JSON che puoi usare per renderizzare un elemento sul tuo sito. 

Creazione di campagne personalizzate tramite API lato server 

Fase 1: creare la campagna

1. Nella sezione dedicata alla Personalizzazione web, clicca su Crea campagna.
2. Seleziona l'opzione per il Codice personalizzato API.
   
3. Inserisci un nome e aggiungi note ed etichette (opzionale).
4. Specifica il Selettore API. Questo fattore è necessario nelle chiamate API rivolte alla campagna. 
5. Se necessario, puoi specificare un gruppo di selettori. Scopri di più sui gruppi di selettori.
6. Se necessario, nelle Impostazioni avanzate, puoi scegliere di proporre più varianti per decisione (ad esempio, per le opzioni tipo carosello o a griglia). 
7. Clicca su Avanti.

Fase 2: creare varianti

1. Nella schermata Experience, puoi assegnare un nome alla tua esperienza e selezionare per crearne una nuova o copiare una variante esistente. Puoi anche scegliere di gestire la tua sincronizzazione con un feed di dati.
   
   
   • Se dovessi selezionare l'opzione per una Nuova variante, visualizzerai la schermata del modello. Clicca sull'opzione che desideri, quindi crea la tua variante in formato JSON. 
     
   • Se dovessi selezionare Copia da un'altra esperienza, apparirà la tua lista delle esperienze. 
     
     Seleziona l'esperienza che desideri, quindi Copia la variante (ti redirigerà alla fase di allocazione) o Copia e modifica (per elaborare il file JSON).
   • Se dovessi cliccare su sincronizza con un feed di dati, ti verrà proposta la lista dei modelli. Seleziona un modello, quindi indica qual è il feed da sincronizzare.
2. Clicca su Salva variante.
3. Ripeti l'operazione per tutte le varianti che desideri.

Fase 3: configura e salva l'esperienza 

1. Allocazione:
   1. puoi impostare allocazione, metriche primarie e impostazioni avanzate dell'esperienza.
   2. Configura la quantità di traffico da allocare a ciascuna variante e gruppo di controllo.
   3. Clicca su Avanti.
2. Targeting
   1. puoi configurare targeting e impostazioni dell'esperienza per determinare quando, dove e a chi verrà proposta l'esperienza, quindi clicca su Avanti. 
3. Salva, visualizza in anteprima e pubblica:
   1. puoi salvare la tua esperienza come bozza se desideri visualizzarla in anteprima e modificarla prima di pubblicarla. Quando è tutto pronto, imposta la variante come attiva e poi salvala.
   2. Clicca sull'icona più  per creare un'esperienza mirata aggiuntiva.
   3. Anteprima:
      • dopo aver salvato la campagna, puoi visualizzare in anteprima le varianti mentre le modifichi.
      • Per visualizzare l'anteprima della campagna, vai all'elenco delle campagne, passa il mouse sopra l'elemento desiderato e clicca sull'icona dell'anteprima per vedere come i tuoi visitatori visualizzeranno la variante. 
   4. Quando hai finito, puoi cliccare su Pubblica.

Richiamare una campagna personalizzata lato server

Nel tuo codice, puoi usare la stringa DYAP.choose() per richiamare una variante di una campagna.  

Percorso 

https://dy-api.com/v2/serve/user/choose 

Esempio per Node.JS

var request = require("richiesta");

var options = {
  method: 'POST',
  url: 'https://dy-api.com/v2/serve/user/choose',
  headers: {'content-type': 'application/json', 'dy-api-key': 'your-api-key'},
  body: `{
  "selector": {
  "names": [
  "test1"
  ]
  },
  "user":{
  "id": "CustomUserID123"
  },
  "session": {
  "custom": "MyCustomSession345"
  },
  "context":{
  "page":{
  "type": "HOMEPAGE",
  "location": "https://example.org",
  "locale": "en_US"
  "data":[]
  },
  "device": {
  "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36",
  "ip":"54.100.200.255"
  }
  },
  "options": {
  "isImplicitPageview": falsoe
  " returnAnalyticsMetadata": false
  }}`
};

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

Per maggiori dettagli, consulta la sezione dedicata al riferimento API. 

Interazione nella segnalazione

Per includere i clic nei report sulle tue campagne di Dynamic Yield, puoi usare la funzione di interazione nella segnalazione tramite chiamata API.

Per maggiori dettagli, consulta la sezione dedicata al riferimento API.  

Convalida dell'implementazione

Puoi verificare i Registri API per visualizzare la cronologia delle chiamate API recenti, il loro stato e molto altro ancora.