Crear destinos

Última actualización: 20 de julio de 2024

Crear destinos con estos métodos RESTful API.

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
}

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
}

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
}

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
}