DocumentaciónAudience ManagerGuía del usuario de Audience Manager

Crear destinos

Última actualización: 20 de julio de 2024
  • Temas:
  • API

Crear destinos con estos métodos RESTful API.

Tipos de destino admitidos: solo URL y cookie

Los métodos POST disponibles solo le permiten crear URL y cookie destinations. Actualmente, no puede crear server-to-server destinations con estos métodos REST API. Sin embargo, los métodos relacionados con el destino GET le permiten recuperar información sobre server-to-server destinations creado en la interfaz de usuario.

Crear un destino de URL no serie

Un método POST que le permite crear un destino que acepta segmentos compuestos de pares clave-valor únicos (por ejemplo, gender=male o gender=female).

Solicitud

POST https://api.demdex.com/v1/destinations/

Solicitud de ejemplo

Esta solicitud crea un único destino. Todos los valores de solicitud son obligatorios a menos que se indique lo contrario.

{
   "name":"Sample URL Destination (not serialized)",
   "description":"",
   "destinationType":"PUSH",
   "serializationEnabled":false
}

Respuesta

Una solicitud correcta devuelve 201 created y el destino.

{
   "destinationType":"PUSH",
   "destinationId":4033,
   "dataSourceId":null,
   "pid":1099,
   "name":"Sample URL Destination (not serialized)",
   "description":"",
   "startDate":null,
   "endDate":null,
   "status":"ACTIVE",
   "destinationType":"PUSH",
   "createTime":1338937116000,
   "updateTime":1338937116000,
   "crUID":694,
   "upUID":694,
   "domainRestrictions":"all_domains",
   "tagType":0,
   "serializationEnabled":false,
   "urlFormatString":"https://www.adobe.com/send?%ALIAS%",
   "secureUrlFormatString":"https://www.adobe.com/send?%ALIAS%",
   "delimiter":null,
   "mappings":null
}

Crear un destino de URL serializado

Método POST que permite crear un destino que acepta varios valores asociados a una sola clave (por ejemplo, color=blue, red, green).

Solicitud

POST https://api.demdex.com/v1/destinations/

Solicitud de ejemplo

Especifique el URL seguro y el delimitador para el par clave-valor pasado al destino. Todos los valores de solicitud son obligatorios a menos que se indique lo contrario.

{
   "name":"Sample URL Destination (Serialized)",
   "description":"",
   "destinationType":"PUSH",
   "serializationEnabled":true,
   "urlFormatString":"https://www.adobe.com/send?data=%ALIAS%",
   "secureUrlFormatString":"https://www.adobe.com/%ALIAS%",
   "delimiter":","
}

Respuesta

Una actualización correcta devuelve el código de respuesta 201 created y el destino.

{
   "destinationType":"PUSH",
   "destinationId":4034,
   "dataSourceId":null,
   "pid":1099,
   "name":"Sample URL Destination (Serialized)",
   "description":"",
   "startDate":null,
   "endDate":null,
   "status":"active",
   "destinationType":"PUSH",
   "createTime":1338937420000,
   "updateTime":1338937420000,
   "crUID":694,
   "upUID":694,
   "domainRestrictions":"all_domains",
   "tagType":0,
   "serializationEnabled":true,
   "urlFormatString":"https://www.adobe.com/send?%ALIAS%",
   "secureUrlFormatString":"https://www.adobe.com/%ALIAS%",
   "delimiter":"-",
   "mappings":null
}

Crear un destino de cookie: clave única, no serializada

Un método POST que le permite crear un(a) cookie destination que acepta segmentos compuestos de pares clave-valor únicos (por ejemplo, gender=male o gender=female).

Solicitud

POST https://api.demdex.com/v1/destinations/

Solicitud de ejemplo

Todos los valores de solicitud son obligatorios a menos que se indique lo contrario.

{
   "name":"Cookie Destination Single Key Not Serialized",
   "destinationType":"ADS",
   "adServerTypeID":1,
   "cookieName":"adobe",
   "cnameDomain":"adobe.com",
   "maxSize":"2048",
   "ttl":"0",
   "domainRestrictions":"inclusion",
   "siteIDs":[
      312
   ],
   "formatType":"single_key",
   "singleKey":"key",
   "keySeparator":"=",
   "valueSeparator":",",
   "serializationEnabled":false
}

Respuesta

Una actualización correcta devuelve el código de respuesta 201 created y el destino.

{
   "destinationType":"ADS",
   "destinationId":4035,
   "pid":1099,
   "name":"Cookie Destination Single Key Not Serialized",
   "status":"active",
   "destinationType":"ADS",
   "createTime":1338937984000,
   "updateTime":1338937984000,
   "crUID":694,
   "upUID":694,
   "domainRestrictions":"inclusion",
   "cnameDomain":"adobe.com",
   "cookieName":"adobe",
   "singleKey":"key",
   "keySeparator":"=",
   "valueSeparator":",",
   "formatType":"single_key",
   "transferMethod":0,
   "serializationEnabled":false,
   "maxSize":2048,
   "ttl":0,
   "siteIDs":[
      312
   ],
   "uparamEnabled":false
}

Crear un destino de cookie: clave única, serializada

Método POST que permite crear un destino que acepta varios valores asociados a una sola clave (por ejemplo, color=blue, red, green).

Solicitud

POST https://api.demdex.com/v1/destinations/

Solicitud de ejemplo

Todos los valores de solicitud son obligatorios a menos que se indique lo contrario.

{
   "name":"Cookie Destination Single Key Serialized",
   "destinationType":"ADS",
   "adServerTypeID":1,
   "cookieName":"adobe",
   "cnameDomain":"adobe.com",
   "maxSize":"2048",
   "ttl":"0",
   "domainRestrictions":"all_domains",
   "siteIDs":[

   ],
   "formatType":"single_key",
   "singleKey":"k",
   "keySeparator":"=",
   "valueSeparator":",",
   "serializationEnabled":true,
   "serializationSeparator":"#"
}

Respuesta

Una actualización correcta devuelve el código de respuesta 201 created y el destino.

{
   "destinationType":"ADS",
   "destinationId":4036,
   "pid":1099,
   "name":"Cookie Destination Single Key Serialized",
   "status":"active",
   "destinationType":"ADS",
   "createTime":1338938329000,
   "updateTime":1338938329000,
   "crUID":694,
   "upUID":694,
   "domainRestrictions":"all_domains",
   "cnameDomain":"adobe.com",
   "cookieName":"adobe",
   "singleKey":"k",
   "keySeparator":"=",
   "valueSeparator":",",
   "formatType":"single_key",
   "transferMethod":0,
   "serializationEnabled":true,
   "serializationSeparator":"#",
   "maxSize":2048,
   "ttl":0,
   "siteIDs":[

   ],
   "uparamEnabled":false
}

Crear un destino de cookie: clave múltiple, no serializado

Un método POST que le permite crear un destino que acepta segmentos que contienen varias claves con valores diferentes (por ejemplo, gender=male; gender=female; color=blue; color=red).

Solicitud

POST https://api.demdex.com/v1/destinations/

Solicitud de ejemplo

Todos los valores de solicitud son obligatorios a menos que se indique lo contrario.

{
   "name":"Ad Server Multi-Key Not Serialized",
   "destinationType":"ADS",
   "adServerTypeID":1,
   "cookieName":"adobe",
   "cnameDomain":"adobe.com",
   "maxSize":"2048",
   "ttl":"0",
   "domainRestrictions":"all_domains",
   "siteIDs":[

   ],
   "formatType":"key_value",
   "keySeparator":"=",
   "valueSeparator":",",
   "serializationEnabled":false
}

Respuesta

Una actualización correcta devuelve el código de respuesta 201 created y el destino.

{
   "destinationType":"ADS",
   "destinationId":4037,
   "pid":1099,
   "name":"Ad Server Multi-Key Not Serialized",
   "status":1,
   "destinationType":"ADS",
   "createTime":1338938666000,
   "updateTime":1338938666000,
   "crUID":694,
   "upUID":694,
   "domainRestrictions":"all_domains",
   "cnameDomain":"adobe.com",
   "cookieName":"adobe",
   "keySeparator":"=",
   "valueSeparator":",",
   "formatType":"key_value",
   "transferMethod":0,
   "serializationEnabled":false,
   "maxSize":2048,
   "ttl":0,
   "siteIDs":[

   ],
   "uparamEnabled":false
}

Crear un destino de cookie: clave múltiple, serializado

Un método POST que le permite crear un destino que acepta segmentos que contienen múltiples claves y valores (por ejemplo, gender=male, female; color=blue, red, green).

Solicitud

POST https://api.demdex.com/v1/destinations/

Solicitud de ejemplo

Todos los valores de solicitud son obligatorios a menos que se indique lo contrario.

{
   "name":"Cookie Destination Multi-Key Serialized",
   "destinationType":"ADS",
   "adServerTypeID":1,
   "cookieName":"adobe",
   "cnameDomain":"adobe.com",
   "maxSize":"2048",
   "ttl":"0",
   "domainRestrictions":"all_domains",
   "siteIDs":[

   ],
   "formatType":"key_value",
   "keySeparator":"=",
   "valueSeparator":",",
   "serializationEnabled":true,
   "serializationSeparator":"#"
}

Respuesta

Una actualización correcta devuelve el código de respuesta 201 created y el destino.

{
   "destinationType":"ADS",
   "destinationId":4038,
   "pid":1099,
   "name":"Ad Server Multi-Key Serialized",
   "status":"active",
   "destinationType":"ADS",
   "createTime":1338938872000,
   "updateTime":1338938872000,
   "crUID":694,
   "upUID":694,
   "domainRestrictions":"all_domains",
   "cnameDomain":"adobe.com",
   "cookieName":"adobe",
   "keySeparator":"=",
   "valueSeparator":",",
   "formatType":"key_value",
   "transferMethod":0,
   "serializationEnabled":true,
   "serializationSeparator":"#",
   "maxSize":2048,
   "ttl":0,
   "siteIDs":[

   ],
   "uparamEnabled":false
}
Related Articles
  • Destinos
  • Serialización de destino
  • Pares de clave-valor explicados
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695