Campagne di raccomandazioni API per le app

Le raccomandazioni ti aiutano a fare in modo che ogni utente visualizzi in automatico gli articoli più pertinenti. Questo articolo spiega come implementare un widget di raccomandazione utilizzando le nostre API Experience lato server. La procedura include:

1. creazione di una campagna di raccomandazioni API nella console Dynamic Yield.
2. Richiamo della campagna con una chiamata API lato server. Rendering del widget sul tuo sito.

Facoltativamente, puoi usare filtri in tempo reale nelle tue campagne di raccomandazioni API. 

Dopo aver impostato e lanciato le tue campagne API, puoi anche:

• ottenere un rapporto relativo ai clic sulla tua campagna. 
• Visualizzare i registri e risolvere problemi.

Creazione di una campagna di raccomandazioni API

Vai su Campagne API Aggiungi nuova › Raccomandazione e segui questa procedura:

1. Assegna un nome alla tua campagna e, nel caso, aggiungi note ed etichette.
2. Specifica il Selettore API. Questo selettore è necessario nella chiamata API.
3. Configura le impostazioni di targeting dell'esperienza per determinare quando, dove e a chi l'esperienza verrà mostrata, quindi, clicca su Avanti. 
4. Crea una variante. Per ogni campagna di raccomandazioni, puoi avere più varianti da utilizzare per testare impostazioni multiple o per eseguire il test su un gruppo di controllo:
   1. assegna un nome alla tua variante (visibile solo nella console Experience OS).
   2. Scegli un modello. Il modello ti consente di aggiungere un ulteriore carico utile alla chiamata, inclusi tutti i metadati che desideri trasmettere nella variante desiderata. Ad esempio, il titolo della raccomandazione che corrisponde alla strategia selezionata o alla definizione del design.
   3. Quando crei la variante, puoi selezionare anche la strategia e il numero di articoli da mostrare.
   4. Una volta completate tutte le varianti, clicca su Salva la variante.
5. Ora puoi impostare tipo di allocazione, metriche primarie e impostazioni avanzate dell'esperienza.
6. Definisci la quantità di traffico da allocare a ciascuna variante e al gruppo di controllo.
7. Clicca su Salva esperienza. 
8. Per creare un'esperienza mirata aggiuntiva (ad esempio, diverse strategie per segmenti di pubblico diversi), clicca sull'icona con il segno più .
9. Clicca su Salva e pubblica quando si può procedere.

Ora sei pronto per chiamare la tua campagna utilizzando la chiamata API Choose.

Casi d'uso

Includi SKU specifici

Un caso d'uso tipico consiste nel richiedere prodotti consigliati che rientrano in una specifica fascia di prezzo. In questo esempio, filtra i prodotti con un prezzo compreso tra 3.000 e 4.000$.

Esempio

"id": "0000000000015000"
}
"sessionld" : "1"
"selector": {
  "names": [
  0 : "Campagna di popolarità"
  ],
  "args": {
  "Campagna di popolarità": {
  "realtimeRules": [
  0: {
  "type" : "include"
  "slots" : []
  "query" : {
  "conditions" : [
  0: {
  "field" : "price"
  "arguments" : [
  0: {
  "action" : "GT"
  "value" : "3000"
  }
  ]
  }
  1 : {
  "field" : "price"
  "arguments" : [
  0: {
  "action" : "LT"
  "value" : "4000"
  }
                                    

Solo SKU per campagne di raccomandazione

Per ridurre la dimensione della risposta, puoi limitarla a includere solo gli SKU.

Esempio di richiesta solo SKU

{
  "user": {
  "id": "yaexono4ohphania"
  },
  "session": {
  "custom": "iquahngaishe2koh"
  },
  "selector": {
  "names": [
  "recs campaign"
  ]
  },
  "context": {
  "page": {
  "type": "PRODUCT",
  "data": [
  "7383723-010"
  ],
  "location": "https://example.org",
  "locale": "it_IT"
  },
  "device": {
  "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, come Gecko) Chrome/56.0.2924.87 Safari/537.36",
  "ip":"54.100.200.255"
  },
  "pageAttributes": {
  "customPageAttribute": "someValue"
  },
  "options": {
  "isImplicitPageview": vero
  }
  },
  "options":{
  "recsProductData": {
  "skusOnly": vero
  }
 } 

}

Esempio di risposta solo SKUS

{
  "sku": "1253557-035",
  "productData": {},
  "slotId": "l4WkdHl"

},

Utilizzo del parametro fieldFilter per le campagne di raccomandazione

Alcuni casi d'uso richiedono la chiamata di campi aggiuntivi, anziché solo lo SKU, ma forse non di tutti i campi. Specifica i campi desiderati utilizzando il parametro fieldFilter: crea una serie di stringhe dei campi pertinenti e verranno restituiti solo quei campi e quei valori. Tieni presente che, se la tua chiamata API include anche il parametro skusOnly: vero , sostituirà il parametro fieldFilter e la risposta includerà solo gli SKU, senza campi aggiuntivi.

Esempio di richiesta con campi filtrati

{
  "user": {
  "id": "yaexono4ohphania"
  },
  "session": {
  "custom": "iquahngaishe2koh"
  },
  "selector": {
  "names": [
  "recs campaign"
  ]
  },
  "context": {
  "page": {
  "type": "PRODUCT",
  "data": [
  "7383723-010"
  ],
  "location": "https://example.org",
  "locale": "it_IT"
  },
  "device": {
  "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, come Gecko) Chrome/56.0.2924.87 Safari/537.36",
  "ip":"54.100.200.255"
  },
  "pageAttributes": {
  "customPageAttribute": "someValue"
  },
  "options": {
  "isImplicitPageview": vero
  }
  },
  "options":{
  "recsProductData": {
  "fieldFilter": ["FieldName1", "FieldName2"]
  }
 } 
}