Show Menu
SUJETS×

Création d’une stratégie d’utilisation des données

L’étiquetage et l’application de l’utilisation des données (DULE) constituent le mécanisme de base de la gouvernance des données de la plate-forme Adobe Experience. L'API dule-policy-service.yaml DULE Policy Service vous permet de créer et de gérer des stratégies DULE afin de déterminer les actions marketing à entreprendre par rapport aux données contenant certains libellés DULE.
Ce document fournit un didacticiel détaillé pour la création d’une stratégie DULE à l’aide de l’API Policy Service. Pour un guide plus complet sur les différentes opérations disponibles dans l’API, consultez le guide du développeur Policy Service.

Prise en main

Ce didacticiel nécessite une compréhension pratique des concepts clés suivants liés à la création et à l'évaluation des politiques DULE :
  • Gouvernance des données : Cadre selon lequel la plate-forme applique la conformité à l’utilisation des données.
  • Étiquettes d'utilisation des données : Les étiquettes d’utilisation des données sont appliquées aux champs de données XDM, en spécifiant les restrictions d’accès à ces données.
  • Modèle de données d’expérience (XDM) : Cadre normalisé selon lequel la plate-forme organise les données d’expérience client.
  • Sandbox : Experience Platform fournit des sandbox virtuels qui partitionnent une instance de plateforme unique en environnements virtuels distincts pour aider à développer et à développer des applications d’expérience numérique.
Avant de commencer ce didacticiel, veuillez consulter le guide du développeur pour obtenir des informations importantes que vous devez connaître afin de réussir à appeler l'API DULE Policy Service, y compris les en-têtes requis et comment lire des exemples d'appels d'API.

Définir une action marketing

Dans le cadre de la gouvernance des données, une action marketing est une action entreprise par un utilisateur de données de la plateforme d’expérience, pour laquelle il est nécessaire de vérifier les violations des stratégies d’utilisation des données.
La première étape de la création d'une stratégie DULE consiste à déterminer l'action marketing qu'elle évaluera. Pour ce faire, utilisez l’une des options suivantes :

Rechercher une action marketing existante

Vous pouvez rechercher les actions marketing existantes à évaluer par votre stratégie DULE en adressant une requête GET à l’un des /marketingActions points de terminaison.
Format d’API
Selon que vous recherchez une action marketing fournie par Experience Platform ou une action marketing personnalisée créée par votre entreprise, utilisez les points de marketingActions/core terminaison ou les marketingActions/custom points de terminaison, respectivement.
GET /marketingActions/core
GET /marketingActions/custom

Requête
La requête suivante utilise le point de marketingActions/custom terminaison, qui récupère une liste de toutes les actions marketing définies par votre organisation IMS.
curl -X GET \
  https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom \
  -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}'

Réponse
Une réponse positive renvoie le nombre total d'actions marketing trouvées ( count ) et liste les détails des actions marketing elles-mêmes dans la children baie.
{
    "_page": {
        "start": "sampleMarketingAction",
        "count": 2
    },
    "_links": {
        "page": {
            "href": "https://platform.adobe.io/marketingActions/custom?{?limit,start,property}",
            "templated": true
        }
    },
    "children": [
        {
            "name": "sampleMarketingAction",
            "description": "Marketing Action description.",
            "imsOrg": "{IMS_ORG}",
            "created": 1550714012088,
            "createdClient": "{CREATED_CLIENT}",
            "createdUser": "{CREATED_USER}",
            "updated": 1550714012088,
            "updatedClient": "{UPDATED_CLIENT}",
            "updatedUser": "{UPDATED_USER}",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/dulepolicy/marketingActions/custom/sampleMarketingAction"
                }
            }
        },
        {
            "name": "newMarketingAction",
            "description": "Another marketing action.",
            "imsOrg": "{IMS_ORG}",
            "created": 1550793833224,
            "createdClient": "{CREATED_CLIENT}",
            "createdUser": "{CREATED_USER}",
            "updated": 1550793833224,
            "updatedClient": "{UPDATED_CLIENT}",
            "updatedUser": "{UPDATED_USER}",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/dulepolicy/marketingActions/custom/newMarketingAction"
                }
            }
        }
    ]
}

Propriété
Description
_links.self.href
Chaque élément de la children baie contient un ID URI pour l’action marketing répertoriée.
Lorsque vous trouvez l’action marketing à utiliser, enregistrez la valeur de sa href propriété. Cette valeur est utilisée lors de l’étape suivante de la création d’une stratégie DULE.

Créer une action marketing

Vous pouvez créer une action marketing en envoyant une requête PUT au point de /marketingActions/custom/ terminaison et en fournissant un nom à l’action marketing à la fin du chemin de la requête.
Format d’API
PUT /marketingActions/custom/{MARKETING_ACTION_NAME}

Paramètre
Description
{MARKETING_ACTION_NAME}
Nom de la nouvelle action marketing que vous souhaitez créer. Ce nom agit comme l’identifiant principal de l’action marketing et doit donc être unique. Il est recommandé de donner à l’action marketing un nom descriptif mais concis.
Requête
La requête suivante crée une nouvelle action marketing personnalisée appelée "exportToThirdParty". Notez que la charge utile name de la demande est identique au nom fourni dans le chemin d’accès à la demande.
curl -X PUT \  
  https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/exportToThirdParty \
  -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}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "exportToThirdParty",
      "description": "Export data to a third party"
    }'

Propriété
Description
name
Nom de l’action marketing à créer. Ce nom doit correspondre au nom fourni dans le chemin d’accès à la requête, sinon une erreur 400 (Mauvaise requête) se produira.
description
Description intelligible de l’action marketing.
Réponse
Une réponse réussie renvoie l’état HTTP 201 (Créé) et les détails de l’action marketing nouvellement créée.
{
    "name": "exportToThirdParty",
    "description": "Export data to a third party",
    "imsOrg": "{IMS_ORG}",
    "created": 1550713341915,
    "createdClient": "{CREATED_CLIENT}",
    "createdUser": "{CREATED_USER",
    "updated": 1550713856390,
    "updatedClient": "{UPDATED_CLIENT}",
    "updatedUser": "{UPDATED_USER}",
    "_links": {
        "self": {
            "href": "https://platform.adobe.io:443/data/foundation/dulepolicy/marketingActions/custom/exportToThirdParty"
        }
    }
}

Propriété
Description
_links.self.href
ID URI de l’action marketing.
Enregistrez l’ID URI de l’action marketing nouvellement créée, car il sera utilisé à l’étape suivante de la création d’une stratégie DULE.

Création d’une stratégie DULE

Pour créer une nouvelle stratégie, vous devez fournir l’ID URI d’une action marketing avec une expression des étiquettes DULE qui interdisent cette action marketing.
Cette expression est appelée expression de stratégie et est un objet contenant soit (A) un libellé DULE, soit (B) un opérateur et des opérandes, mais pas les deux. En retour, chaque opérande est également un objet d’expression de stratégie. Par exemple, une politique relative à l’exportation de données vers un tiers peut être interdite si C1 OR (C3 AND C7) des étiquettes sont présentes. Cette expression serait spécifiée comme suit :
"deny": {
  "operator": "OR",
  "operands": [
    {
      "label": "C1"
    },
    {
      "operator": "AND",
      "operands": [
        {
          "label": "C3"
        },
        {
          "label": "C7"
        }
      ]
    }
  ]
}

Seuls les opérateurs OR et AND sont pris en charge.
Une fois que vous avez configuré votre expression de stratégie, vous pouvez créer une nouvelle stratégie DULE en envoyant une demande POST au point de /policies/custom terminaison.
Format d’API
POST /policies/custom

Requête
La requête suivante crée une stratégie DULE appelée "Exporter des données vers des tiers" en fournissant une action marketing et une expression de stratégie dans la charge utile de la requête.
curl -X POST \
  https://platform.adobe.io/data/foundation/dulepolicy/policies/custom \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
    "name": "Export Data to Third Party",
    "status": "DRAFT",
    "marketingActionRefs": [
      "../marketingActions/custom/exportToThirdParty"
    ],
    "description": "Conditions under which data cannot be exported to a third party",
    "deny": {
      "operator": "OR",
      "operands": [
        {"label": "C1"},
        {
          "operator": "AND",
          "operands": [
            {"label": "C3"},
            {"label": "C7"}
          ]
        }
      ]
    }
  }'

Propriété
Description
marketingActionRefs
Tableau contenant la href valeur d'une action marketing, obtenue à l'étape Définir une action marketing précédente. Bien que l’exemple ci-dessus ne liste qu’une seule action marketing, plusieurs actions peuvent également être fournies.
deny
Objet expression de stratégie. Définit les étiquettes et conditions DULE qui provoqueraient le rejet par la stratégie de l'action marketing référencée dans marketingActionRefs .
Réponse
Une réponse réussie renvoie l’état HTTP 201 (Créé) et les détails de la nouvelle stratégie créée.
{
    "name": "Export Data to Third Party",
    "status": "DRAFT",
    "marketingActionRefs": [
        "https://platform-stage.adobe.io:443/data/foundation/dulepolicy/marketingActions/custom/exportToThirdParty"
    ],
    "description": "Conditions under which data cannot be exported to a third party",
    "deny": {
        "operator": "OR",
        "operands": [
            {
                "label": "C1"
            },
            {
                "operator": "AND",
                "operands": [
                    {
                        "label": "C3"
                    },
                    {
                        "label": "C7"
                    }
                ]
            }
        ]
    },
    "imsOrg": "{IMS_ORG}",
    "created": 1565651746693,
    "createdClient": "{CREATED_CLIENT}",
    "createdUser": "{CREATED_USER",
    "updated": 1565651746693,
    "updatedClient": "{UPDATED_CLIENT}",
    "updatedUser": "{UPDATED_USER}",
    "_links": {
        "self": {
            "href": "https://platform-stage.adobe.io/data/foundation/dulepolicy/policies/custom/5d51f322e553c814e67af1a3"
        }
    },
    "id": "5d51f322e553c814e67af1a3"
}

Propriété
Description
id
Valeur générée par le système en lecture seule qui identifie de manière unique la stratégie DULE.
Enregistrez l’ID URI de la nouvelle stratégie DULE, tel qu’il est utilisé à l’étape suivante pour activer la stratégie.

Activer la stratégie DULE

Bien que cette étape soit facultative si vous souhaitez laisser votre stratégie DULE en DRAFT état, veuillez noter que, par défaut, une stratégie doit avoir son statut défini sur ENABLED pour pouvoir participer à l'évaluation. Consultez le didacticiel sur l’ application des stratégies DULE pour en savoir plus sur la manière de faire des exceptions pour les stratégies DRAFT d’état.
Par défaut, les stratégies DULE dont la status propriété est définie pour DRAFT ne pas participer à l’évaluation. Vous pouvez activer votre stratégie pour évaluation en envoyant une requête PATCH au point de /policies/custom/ terminaison et en fournissant l’identifiant unique de la stratégie à la fin du chemin de la demande.
Format d’API
PATCH /policies/custom/{POLICY_ID}

Paramètre
Description
{POLICY_ID}
Valeur id de la stratégie que vous souhaitez activer.
Requête
La requête suivante effectue une opération PATCH sur la status propriété de la stratégie DULE, en modifiant sa valeur DRAFT en ENABLED .
curl -X PATCH \
  https://platform.adobe.io/data/foundation/dulepolicy/policies/custom/5d51f322e553c814e67af1a3
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '[
    {
      "op": "replace",
      "path": "/status",
      "value": "ENABLED"
    }
  ]'

Propriété
Description
op
Type d'opération PATCH à effectuer. Cette demande effectue une opération de remplacement.
path
Chemin d’accès au champ à mettre à jour. Lors de l’activation d’une stratégie, la valeur doit être définie sur "/status".
value
Nouvelle valeur à affecter à la propriété spécifiée dans path . Cette requête définit la status propriété de la stratégie sur "ACTIVÉ".
Réponse
Une réponse réussie renvoie l’état HTTP 200 (OK) et les détails de la stratégie mise à jour, avec status maintenant la valeur ENABLED de cette dernière.
{
    "name": "Export Data to Third Party",
    "status": "ENABLED",
    "marketingActionRefs": [
        "https://platform-stage.adobe.io:443/data/foundation/dulepolicy/marketingActions/custom/exportToThirdParty"
    ],
    "description": "Conditions under which data cannot be exported to a third party",
    "deny": {
        "operator": "OR",
        "operands": [
            {
                "label": "C1"
            },
            {
                "operator": "AND",
                "operands": [
                    {
                        "label": "C3"
                    },
                    {
                        "label": "C7"
                    }
                ]
            }
        ]
    },
    "imsOrg": "{IMS_ORG}",
    "created": 1565651746693,
    "createdClient": "{CREATED_CLIENT}",
    "createdUser": "{CREATED_USER}",
    "updated": 1565723012139,
    "updatedClient": "{UPDATED_CLIENT}",
    "updatedUser": "{UPDATED_USER}",
    "_links": {
        "self": {
            "href": "https://platform-stage.adobe.io/data/foundation/dulepolicy/policies/custom/5d51f322e553c814e67af1a3"
        }
    },
    "id": "5d51f322e553c814e67af1a3"
}

Étapes suivantes

En suivant ce didacticiel, vous avez créé avec succès une stratégie d’utilisation des données pour une action marketing. Vous pouvez maintenant continuer à suivre le didacticiel sur l’ application des stratégies d’utilisation des données pour savoir comment vérifier les violations de stratégies et les gérer dans votre application d’expérience.
Pour plus d'informations sur les différentes opérations disponibles dans l'API de service de stratégie, consultez le guide du développeur Policy Service. Pour plus d’informations sur la manière d’appliquer des stratégies pour les données du Profil client en temps réel, voir le didacticiel sur l’ application de la conformité d’utilisation des données pour les segments d’audience.
Pour savoir comment gérer les stratégies d’utilisation dans l’interface utilisateur de la plate-forme d’expérience, consultez le guide d’utilisation de la stratégie.