Campagnes de recommandations d’API pour le web

Les recommandations vous permettent d’afficher automatiquement les éléments les plus pertinents pour chaque utilisateur. Cet article vous explique comment mettre en œuvre un widget de recommandation à l’aide de nos API Experience côté serveur. Le processus comprend :

1. La création d’une campagne de recommandation d’API dans la console Dynamic Yield.
2. Appeler la campagne avec un appel API côté serveur. Le widget est rendu sur votre site.

En option, vous pouvez utiliser des filtres en temps réel dans vos campagnes de recommandation d’API. 

Une fois que vous avez configuré et exécuté vos campagnes API, vous pouvez également :

1. Obtenir un rapport sur les clics de votre campagne. 
2. Consulter les journaux et résoudre les problèmes.

Créer une campagne de recommandation d’API

Campagnes API Ajouter nouveau › Recommandation, puis réalisez les actions suivantes :

1. Donnez un nom à votre campagne et, éventuellement, ajoutez des notes et des tags.
2. Spécifiez le sélecteur d’API. Ce sélecteur est requis dans les appels d’API. 
3. Définissez les paramètres de ciblage de l’expérience pour déterminer quand, où et pour qui l’expérience est affichée, puis cliquez sur Suivant. 
4. Créer une variation. Vous pouvez avoir plusieurs variations pour une campagne de recommandation, que vous pouvez utiliser pour tester plusieurs paramètres ou pour effectuer des tests par rapport à un groupe témoin :
   1. Donnez un nom à votre variation (visible uniquement sur la console Experience OS).
   2. Choisissez un modèle. Le modèle vous permet d’ajouter une charge utile supplémentaire à l’appel. Il peut s’agir de n’importe quelle métadonnée que vous souhaitez transmettre avec la variation. Par exemple, le titre de la recommandation qui correspond à la stratégie sélectionnée ou à la définition de la conception.
   3. Lorsque vous créez la variation, vous pouvez également sélectionner la stratégie et le nombre d’éléments à afficher.
   4. Lorsque vous avez terminé avec chaque variation, cliquez sur Enregistrer la variation.
5. Définissez les paramètres l’allocation, la mesure principale et les d’expérience avancée.
6. Définissez la part de votre trafic à allouer à chaque variation et au groupe témoin,
7. Cliquez sur Enregistrer l’expérience. 
8. Pour créer une expérience ciblée supplémentaire (par exemple, différentes stratégies pour différents publics), cliquez sur l’icône Plus .
9. Cliquez sur Enregistrer et publier lorsque vous êtes prêt à poursuivre.

Vous êtes maintenant prêt à appeler votre campagne à l'aide de l'appel d'API Choose. 

Cas d’utilisation

Inclue des SKU spécifiques

Un cas d’utilisation typique consiste à demander les produits recommandés qui se situent dans une fourchette de prix spécifique. Dans cet exemple, il s’agit de filtrer les produits dont le prix est compris entre 3000 et 4000 euros.

Exemple

"id": "0000000000015000"
}
"sessionld" : "1"
"selector": {
  "names": [
  0 : "Popularity Campaign"
  ],
  "args": {
  "Popularity Campaign": {
  "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"
  }
                                    

SKU uniquement pour les campagnes de recommandation

Pour réduire la taille de la réponse, vous pouvez limiter la réponse aux SKU.

Exemple de demande de SKU uniquement

{
  "user": {
  "id": "yaexono4ohphania"
  },
  "session": {
  "custom": "iquahngaishe2koh"
  },
  "selector": {
  "names": [
  "recs campaign"
  ]
  },
  "context": {
  "page": {
  "type": "PRODUCT",
  "data": [
  "7383723-010"
  ],
  "location": "https://example.org",
  "locale": "en_US"
  },
  "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"
  },
  "pageAttributes": {
  "customPageAttribute": "someValue"
  },
  "options": {
  "isImplicitPageview": true
  }
  },
  "options":{
  "recsProductData": {
  "skusOnly": true
  }
  }
}

Exemple de réponse de SKU uniquement

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

Utilisation du paramètre fieldFilter pour les campagnes de recommandations

Certains cas d’utilisation requièrent l’appel à des champs supplémentaires, plutôt qu’au seul SKU, mais peut-être pas à tous les champs. Spécifiez les champs souhaités à l’aide du paramètre fieldFilter : créez un tableau de chaînes de caractères pour les champs concernés, et seuls ces champs et valeurs seront renvoyés. Notez que si votre appel de l’API inclut également le paramètre skusOnly: true, il remplace le paramètre fieldFilter et la réponse ne comprend que les SKU et aucun champ supplémentaire.

Exemple de demande de champs filtrés

{
  "user": {
  "id": "yaexono4ohphania"
  },
  "session": {
  "custom": "iquahngaishe2koh"
  },
  "selector": {
  "names": [
  "recs campaign"
  ]
  },
  "context": {
  "page": {
  "type": "PRODUCT",
  "data": [
  "7383723-010"
  ],
  "location": "https://example.org",
  "locale": "en_US"
  },
  "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"
  },
  "pageAttributes": {
  "customPageAttribute": "someValue"
  },
  "options": {
  "isImplicitPageview": true
  }
  },
  "options":{
  "recsProductData": {
  "fieldFilter": [ ["FieldName1", "FieldName2"]
  }
  }
}