Créer une formule de classement

Dernière mise à jour : 18 mars 2025

Créé pour :

  • Expérimenté
  • Développeur

Vous pouvez créer une formule de classement en effectuant une requête POST sur l’API Bibliothèque des offres.

En-têtes Accept et Content-Type

Le tableau suivant montre les valeurs valides qui comprennent les champs Content-Type dans l’en-tête de la requête :

Nom de l'en-têteValeur
Content-Typeapplication/json

Format d’API

POST /{ENDPOINT_PATH}/ranking-formulas
ParamètreDescriptionExemple
{ENDPOINT_PATH}Chemin d’accès de point d’entrée pour les API Persistencehttps://platform.adobe.io/data/core/dps

Requête

curl -X POST 'https://platform.adobe.io/data/core/dps/ranking-formulas' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
    "name": "Test Ranking Function DPS",
    "description": "Ranking  function description",
    "exdFunction": true,
    "returnType": {
        "type": "integer"
    },
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "if(offer.rank.priority.isNotNull(), offer.rank.priority, 0) * if(offer.tags.intersects(boosted.tags), 2, 1)"
    },
    "definedOn": {
        "offer": {
            "schema": {
                "altId": "_experience.offer-management.personalized-offer",
                "version": "0"
            }
        },
        "boosted": {
            "schema": {
                "altId": "_xdm.context.foo",
                "version": "0"
            }
        }
    }
}'

Réponse

Une réponse renvoie les détails de la formule de classement qui vient d’être créée, y compris l’id. Vous pouvez utiliser l’id aux étapes suivantes pour mettre à jour ou supprimer votre formule de classement.

{
    "etag": 1,
    "createdBy": "{CREATED_BY}",
    "lastModifiedBy": "{MODIFIED_BY}",
    "id": "{ID}",
    "sandboxId": "{SANDBOX_ID}",
    "createdDate": "2023-05-31T15:09:11.771Z",
    "lastModifiedDate": "2023-05-31T15:09:11.771Z",
    "createdByClientId": "{CREATED_CLIENT_ID}",
    "lastModifiedByClientId": "{MODIFIED_CLIENT_ID}"
}
recommendation-more-help