Show Menu
ARGOMENTI×

Applicazione dei criteri di utilizzo dei dati tramite l' Policy Service API

Dopo aver creato etichette di utilizzo dei dati per i dati e criteri di utilizzo per le azioni di marketing relative a tali etichette, è possibile utilizzare 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' Policy Service API 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 di utilizzo dei dati:
  • Governance dei dati: Il framework in base al quale Platform viene applicata 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 certi set di etichette di utilizzo dei dati.
  • Sandbox : Experience Platform fornisce sandbox virtuali che dividono una singola Platform istanza in ambienti virtuali separati per sviluppare e sviluppare applicazioni per esperienze digitali.
Prima di avviare questa esercitazione, consulta la guida Guida introduttiva all' Policy Service API allo sviluppatore per informazioni importanti che devi conoscere per effettuare correttamente le chiamate all' Policy Service API, comprese le intestazioni richieste e come leggere le chiamate API di esempio.

Valutare utilizzando etichette e un'azione di marketing

È possibile valutare un criterio eseguendo il test di un'azione di marketing rispetto a un insieme di etichette di utilizzo dei dati che potrebbero essere presenti all'interno di un dataset. Questo avviene tramite l'uso del parametro duleLabels query, dove le etichette 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 di utilizzo dei dati 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 corretta restituisce l'URL dell'azione di marketing, le etichette di utilizzo su cui è stata eseguita la verifica e un elenco di eventuali criteri 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 tutti i criteri violati eseguendo il test dell'azione di marketing (specificata in marketingActionRef ) rispetto a quelli forniti duleLabels .

Valutare utilizzando i dataset

È possibile valutare un criterio di utilizzo dei dati eseguendo il test di un'azione di marketing in base a uno o più set di dati da cui è possibile raccogliere le etichette. A questo scopo, è necessario effettuare una richiesta di POST e fornire ID di set di dati all’interno del corpo della richiesta, come illustrato nell’esempio di seguito. /marketingActions/core/{MARKETING_ACTION_NAME}/constraints
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 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 di utilizzo raccolte dai set di dati forniti e un elenco di eventuali criteri 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 di utilizzo dei dati 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 a livello di set di dati e di campi presenti in ciascuno di essi.
violatedPolicies
Un array che elenca tutti i criteri violati eseguendo il test dell'azione di marketing (specificata in marketingActionRef ) rispetto a quelli forniti duleLabels .

Passaggi successivi

Leggendo questo documento, hai verificato con successo la presenza di violazioni dei criteri durante l'esecuzione di un'azione di marketing su un dataset o un set di etichette di utilizzo dei dati. 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 i segmenti di pubblico in Real-time Customer Profile, consulta la seguente esercitazione .