Gestion des critères personnalisés

Dernière mise à jour : 2023-11-14
  • Créé pour :
  • Developer

Parfois, les algorithmes fournis par Recommendations ne sont pas en mesure de faire apparaître des éléments spécifiques que vous souhaitez promouvoir. Dans ce cas, les critères personnalisés vous permettent de fournir un ensemble spécifique d’éléments recommandés pour un élément ou une catégorie clé donnée.

Pour créer des critères personnalisés, définissez et importez le mappage souhaité entre l’élément clé ou la catégorie et les éléments recommandés. Ce processus est décrit dans la section documentation sur les critères personnalisés. Comme indiqué dans cette documentation, vous pouvez créer, modifier et supprimer des critères personnalisés via l’interface utilisateur de Target. Cependant, Target fournit également un ensemble d’API de critères personnalisés qui permettent une gestion plus détaillée de vos critères personnalisés.

AVERTISSEMENT

Pour les critères personnalisés, effectuez toutes les actions (création, modification, suppression) pour un critère personnalisé donné à l’aide des API, ou effectuez toutes les actions (création, modification, suppression) à l’aide de l’interface utilisateur. La gestion de vos critères personnalisés par le biais d’une combinaison de l’interface utilisateur et de l’API peut entraîner des informations conflictuelles ou des résultats inattendus. Par exemple, la création d’un critère personnalisé dans l’interface utilisateur, mais sa modification via l’API, ne reflétera pas vos mises à jour dans l’interface utilisateur, même si elles seront mises à jour dans le serveur principal, comme visible via l’API.

Création de critères personnalisés

Pour créer des critères personnalisés à l’aide de la variable Création d’une API de critères personnalisés, la syntaxe est la suivante :

POST https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom

AVERTISSEMENT

Les critères personnalisés créés à l’aide de l’API Créer des critères personnalisés, comme décrit dans cet exercice, s’affichent dans l’interface utilisateur, où ils sont conservés. Vous ne pourrez pas les modifier ni les supprimer de l’interface utilisateur. Vous pouvez les modifier ou les supprimer. via l’API, mais dans les deux cas, ils continueront à apparaître dans l’interface utilisateur de Target. Pour conserver l’option de modification ou de suppression de l’interface utilisateur, créez les critères personnalisés à l’aide de l’interface utilisateur par la documentation, plutôt que d’utiliser l’API Créer des critères personnalisés .

Suivez les étapes ci-après seulement lorsque vous avez lu l’avertissement ci-dessus et que vous êtes à l’aise avec la création de critères personnalisés qui ne peuvent pas être supprimés par la suite de l’interface utilisateur.

  1. Vérifier TENANT_ID et API_KEY pour Création de critères personnalisés référencez les variables d’environnement Postman établies précédemment. Utilisez l’image ci-dessous pour la comparaison.

    CreateCustomCriteria1

  2. Ajoutez Corps as raw JSON qui définit l’emplacement de votre fichier CSV de critères personnalisés. Utilisez l’exemple fourni dans la section Création d’une API de critères personnalisés la documentation en tant que modèle, qui fournit votre environmentId et d’autres valeurs si nécessaire. Pour cet exemple, nous utilisons LAST_PURCHASED comme clé.

    CreateCustomCriteria2

  3. Envoyez la requête et observez la réponse, qui contient les détails des critères personnalisés que vous venez de créer.

    CreateCustomCriteria3

  4. Pour vérifier que vos critères personnalisés ont été créés, accédez dans Adobe Target à Recommendations > Critères et recherchez vos critères par nom, ou utilisez la variable Liste des critères personnalisés à l’étape suivante.

    CreateCustomCriteria4

Dans ce cas, nous avons une erreur. Examinons l’erreur en examinant de plus près les critères personnalisés, en utilisant la variable Liste des critères personnalisés.

Liste des critères personnalisés

Pour récupérer une liste de tous vos critères personnalisés avec des détails pour chacun d’eux, utilisez la variable Liste des critères personnalisés. La syntaxe est la suivante :

GET https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom

  1. Vérifier TENANT_ID et API_KEY comme auparavant, et envoyez la demande. Dans la réponse, notez l’identifiant de critère personnalisé, ainsi que les détails concernant le message d’erreur mentionné précédemment.
    ListCustomCritères

Dans ce cas, l’erreur s’est produite car les informations du serveur sont incorrectes, ce qui signifie que Target ne peut pas accéder au fichier CSV contenant la définition de critères personnalisés. Modifions les critères personnalisés pour corriger ce problème.

Modifier des critères personnalisés

Pour modifier les détails d’une définition de critère personnalisée, utilisez le Modifier l’API de critères personnalisés. La syntaxe est la suivante :

POST https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId

  1. Vérifier TENANT_ID et API_KEY, comme auparavant.
    EditCustomCriteria1

  2. Indiquez l’identifiant du critère personnalisé (unique) que vous souhaitez modifier.
    EditCustomCriteria2

  3. Dans le corps, fournissez le JSON mis à jour avec les informations correctes du serveur. (Pour cette étape, spécifiez l’accès FTP à un serveur auquel vous pouvez accéder.)
    EditCustomCriteria3

  4. Envoyez la requête et notez la réponse.
    EditCustomCriteria4

Vérifions le succès des critères personnalisés mis à jour, en utilisant la variable Obtention de l’API de critères personnalisés.

Obtenir des critères personnalisés

Pour afficher les détails d’un critère personnalisé spécifique, utilisez le Obtention de l’API de critères personnalisés. La syntaxe est la suivante :

GET https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId

  1. Indiquez l’identifiant du critère personnalisé dont vous souhaitez obtenir les détails. Envoyez la requête et passez en revue la réponse.
    GetCustomCritère.png
  2. Vérifiez la réussite. (Dans notre cas, vérifiez qu’il n’y a pas d’autres erreurs FTP.)
    GetCustomCrit1.png
  3. (Facultatif) Vérifiez que la mise à jour s’affiche avec précision dans l’interface utilisateur.
    GetCustomCritères2.png

Suppression de critères personnalisés

À l’aide de l’ID de critère indiqué précédemment, supprimez vos critères personnalisés à l’aide de la variable Supprimer l’API de critères personnalisés. La syntaxe est la suivante :

DELETE https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId

  1. Indiquez l’identifiant du critère personnalisé (unique) que vous souhaitez supprimer. Cliquez sur Envoyer.
    DeleteCustomCriteria1

  2. Vérifiez que les critères ont été supprimés à l’aide de l’option Obtenir des critères personnalisés.
    DeleteCustomCritère2
    Dans ce cas, l’erreur 404 attendue indique que les critères supprimés sont introuvables.

REMARQUE

Pour rappel, les critères ne seront pas supprimés de l’interface utilisateur de Target même s’ils ont été supprimés, car ils ont été créés à l’aide de l’API Créer des critères personnalisés .

Félicitations ! Vous pouvez désormais créer, répertorier, modifier, supprimer et obtenir des détails sur des critères personnalisés à l’aide de l’API Recommendations. Dans la section suivante, vous utiliserez l’API de diffusion Target pour récupérer les recommandations.

<!— Suite : "Récupération de Recommendations avec l’API de diffusion côté serveur" > —>

Sur cette page