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.
Introducción
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 list
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"
}
}
}
]
}
_page.count
children
name
_links.self.href
marketingActionsRefs
matriz cuando crear una política de uso de datos.Búsqueda de una acción de marketing específica lookup
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}
{MARKETING_ACTION_NAME}
name
propiedad de la acción de marketing que desea buscar.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 create-update
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}
{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."
}'
name
IMPORTANTE: esta propiedad debe coincidir con el
{MARKETING_ACTION_NAME}
en la ruta; de lo contrario, se producirá un error HTTP 400 (Solicitud incorrecta). En otras palabras, una vez creada una acción de marketing, su name
La propiedad no se puede cambiar.description
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 delete
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}
{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.