Extremo de acciones de marketing

Una acción de marketing, en el contexto de la gobernanza de datos de Adobe Experience Platform, es una acción que Experience Platform toma el consumidor de datos, para lo cual es necesario comprobar si se han infringido las políticas de uso de datos.

Puede administrar las acciones de marketing de su organización mediante el /marketingActions en la API del servicio de directivas.

Primeros pasos

Los extremos de API utilizados en esta guía forman parte de la variable Policy Service API. Antes de continuar, consulte la guía de introducción para obtener vínculos a documentación relacionada, una guía para leer las llamadas de API de ejemplo en este documento e información importante sobre los encabezados necesarios para realizar correctamente llamadas a cualquier Experience Platform API.

Recuperación de una lista de acciones de marketing

Puede recuperar una lista de acciones de marketing principales o personalizadas realizando una solicitud de GET a /marketingActions/core o /marketingActions/custom, respectivamente.

Formato de API

GET /marketingActions/core
GET /marketingActions/custom

Solicitud

La siguiente solicitud recupera una lista de acciones de marketing personalizadas mantenidas por su organización.

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}'

Respuesta

Una respuesta correcta devuelve los detalles de cada acción de marketing recuperada, incluida su name y href. El href se utiliza para identificar la acción de marketing cuando crear una política de uso de datos.

{
    "_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"
                }
            }
        }
    ]
}

Búsqueda de una acción de marketing específica

Busca los detalles de una acción de marketing específica incluyendo la acción de marketing name en la ruta de una petición GET.

Formato de API

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

Solicitud

La siguiente solicitud recupera una acción de marketing personalizada denominada 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}'

Respuesta

El objeto response contiene los detalles de la acción de marketing, incluida la ruta (_links.self.href) necesario para hacer referencia a la acción de marketing cuando definición de una política de uso de datos (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"
        }
    }
}

Crear o actualizar una acción de marketing personalizada

Puede crear una nueva acción de marketing personalizada o actualizar una existente, incluyendo el nombre existente o previsto de la acción de marketing en la ruta de una solicitud de PUT.

Formato de API

PUT /marketingActions/custom/{MARKETING_ACTION_NAME}

Solicitud

La siguiente solicitud crea una nueva acción de marketing denominada crossSiteTargeting, siempre que una acción de marketing del mismo nombre aún no exista en el sistema. Si un crossSiteTargeting La acción de marketing no existe; en su lugar, esta llamada actualiza esa acción de marketing en función de las propiedades proporcionadas en la carga útil.

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."
      }'

Respuesta

Una respuesta correcta devuelve los detalles de la acción de marketing. Si se ha actualizado una acción de marketing existente, la respuesta devuelve el estado HTTP 200 (OK). Si se crea una nueva acción de marketing, la respuesta devuelve el estado HTTP 201 (Creado).

{
    "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"
        }
    }
}

Eliminar una acción de marketing personalizada

Puede eliminar una acción de marketing personalizada incluyendo su nombre en la ruta de una petición de DELETE.

Formato de API

DELETE /marketingActions/custom/{MARKETING_ACTION_NAME}

Solicitud

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}'

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 (OK) con un cuerpo de respuesta en blanco.

Para confirmar la eliminación, intente lo siguiente buscar la acción de marketing. Debería recibir el error HTTP 404 (no encontrado) si la acción de marketing se ha eliminado del sistema.

Recursos de Business.Adobe.com

Omnichannel Personalization Responsive Forms Customer Journey Email Marketing Audience Targeting Identity Management