Show Menu
ARGOMENTI×

Applicazione dei criteri di utilizzo dei dati tramite l'API di Servizio criteri

Dopo aver creato etichette di utilizzo dei dati per i dati e criteri di utilizzo per le azioni di marketing in base a tali etichette, potete utilizzare DULE Policy Service API per valutare se un'azione di marketing eseguita su un set di dati o su un gruppo arbitrario di etichette costituisce una violazione dei criteri. Potete quindi configurare i vostri protocolli interni per gestire le violazioni dei criteri in base alla risposta API.
Per impostazione predefinita, solo le politiche il cui stato è impostato per ENABLED poter partecipare alla valutazione. Per consentire DRAFT ai criteri di partecipare alla valutazione, è necessario includere il parametro query includeDraft=true nel percorso della richiesta.
In questo documento sono descritti i passaggi necessari per utilizzare l'API del servizio criteri per verificare la presenza di violazioni dei criteri in scenari diversi.

Introduzione

Questa esercitazione richiede una conoscenza approfondita dei seguenti concetti chiave relativi all'applicazione dei criteri DULE:
  • Governance dei dati: Il framework tramite il quale la piattaforma applica la conformità all'utilizzo dei dati.
    • Etichette di utilizzo dati: Le etichette di utilizzo dei dati vengono applicate ai set di dati (e/o ai singoli campi all'interno di tali set di dati), specificando le restrizioni relative alla modalità di utilizzo dei dati.
    • Criteri di utilizzo dei dati: I criteri di utilizzo dei dati sono regole che descrivono i tipi di azioni di marketing consentite o limitate per determinati set di etichette DULE.
  • Sandbox : Experience Platform fornisce sandbox virtuali che dividono una singola istanza della piattaforma in ambienti virtuali separati per sviluppare e sviluppare applicazioni per esperienze digitali.
Prima di avviare questa esercitazione, consultare la guida Guida per gli sviluppatori API di DULE Policy Service allo sviluppatore per informazioni importanti che è necessario conoscere per eseguire correttamente le chiamate all'API di servizio Criteri DULE, incluse le intestazioni richieste e come leggere le chiamate API di esempio.

Valutazione tramite etichette DULE e un'azione di marketing

È possibile valutare un criterio eseguendo il test di un'azione di marketing rispetto a un set di etichette DULE che sarebbe ipoteticamente presente all'interno di un dataset. Questo avviene tramite l'uso del parametro duleLabels query, dove le etichette DULE vengono fornite come un elenco di valori separati da virgola, come illustrato nell'esempio seguente.
Formato API
GET /marketingActions/core/{MARKETING_ACTION_NAME}/constraints?duleLabels={LABEL_1},{LABEL_2}
GET /marketingActions/custom/{MARKETING_ACTION_NAME}/constraints?duleLabels={LABEL_1},{LABEL_2}

Parametro
Descrizione
{MARKETING_ACTION_NAME}
Nome dell'azione di marketing associata al criterio DULE che si sta valutando.
{LABEL_1}
Etichetta di utilizzo dei dati per sottoporre a test l'azione di marketing. Deve essere fornita almeno un'etichetta. Quando si forniscono più etichette, queste devono essere separate da virgole.
Richiesta
La richiesta seguente verifica l’azione di exportToThirdParty marketing rispetto alle etichette C1 e C3 . Poiché il criterio di utilizzo dei dati creato in precedenza in questa esercitazione definisce l' C1 etichetta come una delle deny condizioni nella relativa espressione del criterio, l'azione di marketing deve attivare una violazione del criterio.
Le etichette di utilizzo dei dati sono sensibili alle maiuscole/minuscole. Le violazioni dei criteri si verificano solo se le etichette definite nelle relative espressioni dei criteri corrispondono esattamente. In questo esempio, un' C1 etichetta attiverebbe una violazione, mentre un' c1 etichetta no.
curl -X GET \
  https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/exportToThirdParty/constraints?duleLabels=C1,C3 \
  -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}'

Risposta
Una risposta di successo restituisce l'URL dell'azione di marketing, le etichette DULE su cui è stata eseguita la verifica e un elenco di eventuali criteri DULE violati a seguito del test dell'azione rispetto a tali etichette. In questo esempio, il criterio "Esporta dati in terze parti" è visualizzato nell' violatedPolicies array, a indicare che l'azione di marketing ha attivato la violazione prevista del criterio.
{
    "timestamp": 1565727821209,
    "clientId": "string",
    "userId": "string",
    "imsOrg": "{IMS_ORG}",
    "marketingActionRef": "https://platform-stage.adobe.io:443/data/foundation/dulepolicy/marketingActions/custom/exportToThirdParty",
    "duleLabels": [
        "C1",
        "C3"
    ],
    "violatedPolicies": [
        {
            "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"
        }
    ]
}

Proprietà
Descrizione
violatedPolicies
Un array che elenca eventuali criteri DULE violati eseguendo il test dell'azione di marketing (specificata in marketingActionRef ) rispetto a quella fornita duleLabels .

Valutare utilizzando i dataset

È possibile valutare un criterio DULE eseguendo il test di un'azione di marketing in base a uno o più set di dati da cui è possibile raccogliere le etichette DULE. A questo scopo, è necessario effettuare una richiesta POST a /marketingActions/core/{MARKETING_ACTION_NAME}/constraints e fornire gli ID del set di dati all’interno del corpo della richiesta, come illustrato nell’esempio di seguito.
Formato API
POST /marketingActions/core/{MARKETING_ACTION_NAME}/constraints
POST /marketingActions/custom/{MARKETING_ACTION_NAME}/constraints

Parametro
Descrizione
{MARKETING_ACTION_NAME}
Nome dell'azione di marketing associata al criterio DULE che si sta valutando.
Richiesta
La richiesta seguente esegue il test dell'azione di exportToThirdParty marketing in base a tre set di dati diversi. Ai set di dati si fa riferimento per tipo e ID in un array fornito nel payload.
curl -X POST \
  https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/exportToThirdParty/constraints
  -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 '[
    {
      "entityType": "dataSet",
      "entityId": "5c423dc25f2f2e00005e2319"
    },
    {
      "entityType": "dataSet",
      "entityId": "5cc323e15410ef14b749481e"
    },
    {
      "entityType": "dataSet",
      "entityId": "5cc1fb685410ef14b748c55f"
    }
  ]'

Proprietà
Descrizione
entityType
Ogni elemento nell'array di payload deve indicare il tipo di entità da definire. In questo caso d’uso, il valore sarà sempre "dataSet".
entityId
Ogni elemento nell'array di payload deve fornire l'ID univoco per un dataset.
Risposta
Una risposta corretta restituisce l'URL dell'azione di marketing, le etichette DULE raccolte dai set di dati forniti e un elenco di eventuali criteri DULE violati a seguito del test dell'azione rispetto a tali etichette. In questo esempio, il criterio "Esporta dati in terze parti" è visualizzato nell' violatedPolicies array, a indicare che l'azione di marketing ha attivato la violazione prevista del criterio.
{
    "timestamp": 1556324277895,
    "clientId": "{CLIENT_ID}",
    "userId": "{USER_ID}",
    "imsOrg": "{IMS_ORG}",
    "marketingActionRef": "https://platform.adobe.io:443/data/foundation/dulepolicy/marketingActions/custom/exportToThirdParty",
    "duleLabels": [
        "C1",
        "C2",
        "C4",
        "C5",
        "C6"
    ],
    "discoveredLabels": [
        {
            "entityType": "dataSet",
            "entityId": "5c423dc25f2f2e00005e2319",
            "dataSetLabels": {
                "connection": {
                    "labels": []
                },
                "dataSet": {
                    "labels": [
                        "C6"
                    ]
                },
                "fields": [
                    {
                        "labels": [
                            "C2",
                            "C5"
                        ],
                        "path": "/properties/_customer"
                    },
                    {
                        "labels": [
                            "C4",
                            "C5"
                        ],
                        "path": "/properties/geoUnit"
                    },
                    {
                        "labels": [
                            "C4"
                        ],
                        "path": "/properties/identityMap"
                    },
                    {
                        "labels": [
                            "C4"
                        ],
                        "path": "/properties/journeyAI"
                    },
                    {
                        "labels": [
                            "C5"
                        ],
                        "path": "/properties/createdByBatchID"
                    },
                    {
                        "labels": [
                            "C5"
                        ],
                        "path": "/properties/faxPhone"
                    }
                ]
            }
        },
        {
            "entityType": "dataSet",
            "entityId": "5cc323e15410ef14b749481e",
            "dataSetLabels": {
                "connection": {
                    "labels": []
                },
                "dataSet": {
                    "labels": [
                        "C5"
                    ]
                },
                "fields": [
                    {
                        "labels": [
                            "C2",
                        ],
                        "path": "/properties/_customer"
                    },
                    {
                        "labels": [
                            "C5"
                        ],
                        "path": "/properties/geoUnit"
                    },
                    {
                        "labels": [
                            "C1"
                        ],
                        "path": "/properties/identityMap"
                    }
                ]
            }
        },
        {
            "entityType": "dataSet",
            "entityId": "5cc1fb685410ef14b748c55f",
            "dataSetLabels": {
                "connection": {
                    "labels": []
                },
                "dataSet": {
                    "labels": [
                        "C5"
                    ]
                },
                "fields": [
                    {
                        "labels": [
                            "C5"
                        ],
                        "path": "/properties/createdByBatchID"
                    },
                    {
                        "labels": [
                            "C5"
                        ],
                        "path": "/properties/faxPhone"
                    }
                ]
            }
        }
    ],
    "violatedPolicies": [
        {
            "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"
        }
    ]
}

Proprietà
Descrizione
duleLabels
Elenco di etichette DULE estratte dai set di dati forniti nel payload della richiesta.
discoveredLabels
Un elenco dei set di dati forniti nel payload della richiesta, in cui sono visualizzate le etichette DULE a livello di set di dati e di campo che sono state trovate in ciascuno di essi.
violatedPolicies
Un array che elenca eventuali criteri DULE violati eseguendo il test dell'azione di marketing (specificata in marketingActionRef ) rispetto a quella fornita duleLabels .

Passaggi successivi

Leggendo questo documento, è stata verificata correttamente la presenza di violazioni dei criteri durante l'esecuzione di un'azione di marketing su un set di dati o un set di etichette DULE. Utilizzando i dati restituiti nelle risposte API, potete impostare protocolli all'interno dell'applicazione dell'esperienza per applicare correttamente le violazioni dei criteri quando si verificano.
Per i passaggi su come applicare criteri di utilizzo dei dati per segmenti di pubblico in Profilo cliente in tempo reale, consulta la seguente esercitazione .