Criar uma política de governança de dados na API
A variável API de serviço de política O permite criar e gerenciar políticas de governança de dados para determinar quais ações de marketing podem ser executadas em relação aos dados que contêm determinados rótulos de uso de dados.
Este documento fornece um tutorial passo a passo para a criação de uma política de governança usando o Policy Service API.
/policies
manual de endpoint para o API de controle de acesso. Para saber como criar uma política de consentimento, consulte o guia de interface do usuário de políticas.Introdução
Este tutorial requer um entendimento prático dos seguintes conceitos-chave envolvidos na criação e avaliação de políticas:
- Governança de dados do Adobe Experience Platform: a estrutura pela qual Platform aplica a conformidade com o uso de dados.
- Rótulos de uso de dados: os rótulos de uso de dados são aplicados aos campos de dados XDM, especificando restrições sobre como esses dados podem ser acessados.
- Experience Data Model (XDM): o quadro normalizado pelo qual Platform organiza os dados de experiência do cliente.
- Sandboxes: Experience Platform O fornece sandboxes virtuais que particionam uma única Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.
Antes de iniciar este tutorial, reveja a guia do desenvolvedor para obter informações importantes que você precisa saber para fazer chamadas com êxito para o Policy Service API, incluindo cabeçalhos necessários e como ler chamadas de API de exemplo.
Definir uma ação de marketing define-action
No framework de governança de dados, uma ação de marketing é uma ação que Experience Platform o consumidor de dados utiliza, para o qual há a necessidade de verificar violações das políticas de uso de dados.
A primeira etapa na criação de uma política de uso de dados é determinar qual ação de marketing a política avaliará. Isso pode ser feito usando uma das seguintes opções:
Pesquisar uma ação de marketing existente look-up
Você pode pesquisar ações de marketing existentes a serem avaliadas pela sua política fazendo uma solicitação GET para uma das /marketingActions
pontos finais.
Formato da API
Se você estiver procurando uma ação de marketing fornecida por Experience Platform ou uma ação de marketing personalizada criada por sua organização, use o marketingActions/core
ou marketingActions/custom
pontos de extremidade, respectivamente.
GET /marketingActions/core
GET /marketingActions/custom
Solicitação
A solicitação a seguir usa o marketingActions/custom
endpoint, que busca uma lista de todas as ações de marketing definidas pela organização.
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: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Resposta
Uma resposta bem-sucedida retorna o número total de ações de marketing encontradas (count
) e lista os detalhes das próprias ações de marketing na children
matriz.
{
"_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": "{ORG_ID}",
"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": "{ORG_ID}",
"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"
}
}
}
]
}
_links.self.href
children
contém uma ID de URI para a ação de marketing listada.Quando encontrar a ação de marketing que deseja usar, registre o valor da href
propriedade. Esse valor é usado durante a próxima etapa do criação de uma política.
Criar uma nova ação de marketing create-new
Você pode criar uma nova ação de marketing fazendo uma solicitação PUT para o /marketingActions/custom/
e fornecer um nome para a ação de marketing no final do caminho da solicitação.
Formato da API
PUT /marketingActions/custom/{MARKETING_ACTION_NAME}
{MARKETING_ACTION_NAME}
Solicitação
A solicitação a seguir cria uma nova ação de marketing personalizada chamada "exportToThirdParty". Observe que name
na carga da solicitação é o mesmo que o nome fornecido no caminho da solicitação.
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: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "exportToThirdParty",
"description": "Export data to a third party"
}'
name
description
Resposta
Uma resposta bem-sucedida retorna o status HTTP 201 (Criado) e os detalhes da ação de marketing recém-criada.
{
"name": "exportToThirdParty",
"description": "Export data to a third party",
"imsOrg": "{ORG_ID}",
"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"
}
}
}
_links.self.href
Registre a ID de URI da ação de marketing recém-criada, pois ela será usada na próxima etapa da criação de uma política.
Criar uma política create-policy
A criação de uma nova política exige que você forneça a ID de URI de uma ação de marketing com uma expressão dos rótulos de uso que proíbem essa ação de marketing.
Essa expressão é chamada de expressão de política e é um objeto que contém (A) um rótulo ou (B) um operador e operandos, mas não ambos. Por sua vez, cada operando também é um objeto de expressão de política. Por exemplo, uma política relacionada à exportação de dados para terceiros pode ser proibida se C1 OR (C3 AND C7)
rótulos estão presentes. Essa expressão seria especificada como:
"deny": {
"operator": "OR",
"operands": [
{
"label": "C1"
},
{
"operator": "AND",
"operands": [
{
"label": "C3"
},
{
"label": "C7"
}
]
}
]
}
Depois de configurar sua expressão de política, você pode criar uma nova política fazendo uma solicitação POST para o /policies/custom
terminal.
Formato da API
POST /policies/custom
Solicitação
A solicitação a seguir cria uma política chamada "Exportar dados para terceiros" fornecendo uma ação de marketing e uma expressão de política na carga da solicitação.
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: {ORG_ID}' \
-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"}
]
}
]
}
}'
marketingActionRefs
href
valor de uma ação de marketing, obtido na variável etapa anterior. Embora o exemplo acima liste apenas uma ação de marketing, várias ações também podem ser fornecidas.deny
marketingActionRefs
.Resposta
Uma resposta bem-sucedida retorna o status HTTP 201 (Criado) e os detalhes da política recém-criada.
{
"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": "{ORG_ID}",
"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"
}
id
Registre a ID de URI da política recém-criada, como ela é usada na próxima etapa para habilitar a política.
Ativar a política
DRAFT
status, observe que, por padrão, uma política deve ter seu status definido como ENABLED
para participar na avaliação. Consulte o guia sobre aplicação de políticas para obter informações sobre como abrir exceções para políticas no DRAFT
status.Por padrão, as políticas que têm seus status
propriedade definida como DRAFT
não participar da avaliação. Você pode ativar sua política para avaliação fazendo uma solicitação PATCH para a /policies/custom/
e fornecendo o identificador exclusivo para a política no final do caminho da solicitação.
Formato da API
PATCH /policies/custom/{POLICY_ID}
{POLICY_ID}
id
valor da política que você deseja ativar.Solicitação
A solicitação a seguir executa uma operação PATCH no status
propriedade da política, alterando seu valor de DRAFT
para 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: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '[
{
"op": "replace",
"path": "/status",
"value": "ENABLED"
}
]'
op
path
value
path
. Essa solicitação define o valor de status
propriedade para "ENABLED".Resposta
Uma resposta bem-sucedida retorna o status HTTP 200 (OK) e os detalhes da política atualizada, com seus status
agora definida como ENABLED
.
{
"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": "{ORG_ID}",
"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"
}
Próximas etapas
Ao seguir este tutorial, você criou com sucesso uma política de uso de dados para uma ação de marketing. Agora você pode seguir para o tutorial em aplicação de políticas de uso de dados para saber como verificar violações de política e tratá-las no aplicativo de experiência.
Para obter mais informações sobre as diferentes operações disponíveis no Policy Service , consulte a Guia do desenvolvedor do Serviço de política. Para obter informações sobre como aplicar políticas para Real-Time Customer Profile dados, consulte o tutorial em aplicação da conformidade com o uso de dados para segmentos de público-alvo.
Para saber como gerenciar políticas de uso na Experience Platform consulte a seção guia do usuário da política.