Documentação Experience Platform Guia do Data Governance

Endpoint de ações de marketing

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Governança de dados

Criado para:

Desenvolvedor

Uma ação de marketing, no contexto da Governança de dados do Adobe Experience Platform, é uma ação que um consumidor de dados Experience Platform toma, para a qual é necessário verificar violações das políticas de uso de dados.

Você pode gerenciar ações de marketing para sua organização usando o ponto de extremidade /marketingActions na API de Serviço de política.

Introdução

Os pontos de extremidade de API usados neste guia fazem parte da Policy Service API. Antes de continuar, consulte o guia de introdução para obter links para a documentação relacionada, um guia para ler as chamadas de API de exemplo neste documento e informações importantes sobre os cabeçalhos necessários para fazer chamadas com êxito para qualquer API do Experience Platform.

Recuperar uma lista de ações de marketing list

Você pode recuperar uma lista de ações de marketing principais ou personalizadas fazendo uma solicitação GET para /marketingActions/core ou /marketingActions/custom, respectivamente.

Formato da API

GET /marketingActions/core
GET /marketingActions/custom

Solicitação

A solicitação a seguir recupera uma lista de ações de marketing personalizadas mantidas pela sua 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 os detalhes de cada ação de marketing recuperada, incluindo seus name e href. O valor href é usado para identificar a ação de marketing ao criar uma política de uso de dados.

{
    "_page": {
        "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": "string",
            "createdUser": "string",
            "updated": 1550714012088,
            "updatedClient": "string",
            "updatedUser": "string",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/sampleMarketingAction"
                }
            }
        },
        {
            "name": "newMarketingAction",
            "description": "Another marketing action.",
            "imsOrg": "{ORG_ID}",
            "created": 1550793833224,
            "createdClient": "string",
            "createdUser": "string",
            "updated": 1550793833224,
            "updatedClient": "string",
            "updatedUser": "string",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/newMarketingAction"
                }
            }
        }
    ]
}

Propriedade

Descrição

_page.count

O número total de ações de marketing retornadas.

children

Uma matriz de objetos que contém os detalhes das ações de marketing recuperadas.

name

O nome da ação de marketing, que atua como seu identificador exclusivo quando procura uma ação de marketing específica.

_links.self.href

Uma referência de URI para a ação de marketing, que pode ser usada para concluir a matriz marketingActionsRefs ao criar uma política de uso de dados.

Pesquisar uma ação de marketing específica lookup

Você pesquisa os detalhes de uma ação de marketing específica incluindo a propriedade name da ação de marketing no caminho de uma solicitação GET.

Formato da API

GET /marketingActions/core/{MARKETING_ACTION_NAME}
GET /marketingActions/custom/{MARKETING_ACTION_NAME}

Parâmetro

Descrição

{MARKETING_ACTION_NAME}

A propriedade name da ação de marketing que você deseja pesquisar.

Solicitação

A solicitação a seguir recupera uma ação de marketing personalizada chamada combineData.

curl -X GET \
  https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/combineData \
  -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

O objeto de resposta contém os detalhes da ação de marketing, incluindo o caminho (_links.self.href) necessário para fazer referência à ação de marketing ao definir uma política de uso de dados (marketingActionsRefs).

{
    "name": "combineData",
    "description": "Combine multiple data sources together.",
    "imsOrg": "{ORG_ID}",
    "created": 1550793805590,
    "createdClient": "string",
    "createdUser": "string",
    "updated": 1550793805590,
    "updatedClient": "string",
    "updatedUser": "string",
    "_links": {
        "self": {
            "href": "https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/combineData"
        }
    }
}

Criar ou atualizar uma ação de marketing personalizada create-update

Você pode criar uma nova ação de marketing personalizada ou atualizar uma existente, incluindo o nome existente ou pretendido da ação de marketing no caminho de uma solicitação PUT.

Formato da API

PUT /marketingActions/custom/{MARKETING_ACTION_NAME}

Parâmetro

Descrição

{MARKETING_ACTION_NAME}

O nome da ação de marketing a ser criada ou atualizada. Se uma ação de marketing com o nome fornecido já existir no sistema, essa ação de marketing será atualizada. Se não existir, uma nova ação de marketing será criada para o nome fornecido.

Solicitação

A solicitação a seguir cria uma nova ação de marketing chamada crossSiteTargeting, desde que uma ação de marketing com o mesmo nome ainda não exista no sistema. Se uma ação de marketing crossSiteTargeting existir, essa chamada atualizará a ação de marketing com base nas propriedades fornecidas na carga.

curl -X PUT \
  https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/crossSiteTargeting \
  -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": "crossSiteTargeting",
        "description": "Perform targeting on information obtained across multiple web sites."
      }'

Propriedade

Descrição

name

O nome da ação de marketing a ser criada ou atualizada.

IMPORTANTE: esta propriedade deve corresponder ao {MARKETING_ACTION_NAME} no caminho; caso contrário, ocorrerá um erro HTTP 400 (Solicitação inválida). Em outras palavras, depois que uma ação de marketing é criada, sua propriedade name não pode ser alterada.

description

Uma descrição opcional para fornecer mais contexto para a ação de marketing.

Resposta

Uma resposta bem-sucedida retorna os detalhes da ação de marketing. Se uma ação de marketing existente foi atualizada, a resposta retorna o status HTTP 200 (OK). Se uma nova ação de marketing foi criada, a resposta retorna o status HTTP 201 (Criado).

{
    "name": "crossSiteTargeting",
    "description": "Perform targeting on information obtained across multiple web sites.",
    "imsOrg": "{ORG_ID}",
    "created": 1550713341915,
    "createdClient": "string",
    "createdUser": "string",
    "updated": 1550713856390,
    "updatedClient": "string",
    "updatedUser": "string",
    "_links": {
        "self": {
            "href": "https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/crossSiteTargeting"
        }
    }
}

Excluir uma ação de marketing personalizada delete

Você pode excluir uma ação de marketing personalizada incluindo o nome dela no caminho de uma solicitação DELETE.

NOTE

As ações de marketing referenciadas pelas políticas existentes não podem ser excluídas. Tentar excluir uma dessas ações de marketing resultará em um erro HTTP 400 (Solicitação inválida) junto com uma mensagem que inclui as IDs de todas as políticas que fazem referência à ação de marketing.

Formato da API

DELETE /marketingActions/custom/{MARKETING_ACTION_NAME}

Parâmetro

Descrição

{MARKETING_ACTION_NAME}

O nome da ação de marketing que você deseja excluir.

Solicitação

curl -X DELETE \
  https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/crossSiteTargeting \
  -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 Status HTTP 200 (OK) com um corpo de resposta em branco.

Você pode confirmar a exclusão tentando pesquisar a ação de marketing. Você deverá receber um erro HTTP 404 (Não encontrado) se a ação de marketing tiver sido removida do sistema.

recommendation-more-help

834e0cae-2761-454a-be4d-62f0fd4b4456