Criar destinos

Crie destinos com esses métodos RESTful API.

Tipos de Destino Suportados: Somente URL e cookie

Os métodos disponíveis POST permitem criar somente URL e cookie destinations. No momento, não é possível criar server-to-server destinations com esses métodos REST API. No entanto, os métodos GET de destino relacionados permitem recuperar informações sobre server-to-server destinations criadas na interface do usuário.

Criar um destino de URL não serial

Um método POST que permite criar um destino que aceita segmentos compostos de pares de valores chave únicos (por exemplo, gender=male ou gender=female).

Solicitação

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

Solicitação de exemplo

Essa solicitação cria um único destino. Todos os valores de solicitação são obrigatórios, a menos que indicado de outra forma.

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

Resposta

Uma solicitação bem-sucedida retorna 201 created e o 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
} 

Criar um destino de URL serializado

Um método POST que permite criar um destino que aceita vários valores associados a uma única chave (por exemplo, color=blue, red, green).

Solicitação

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

Solicitação de exemplo

Especifique o URL seguro e o delimitador para o par de valores chave enviado para o destino. Todos os valores de solicitação são obrigatórios, a menos que indicado de outra forma.

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

Resposta

Uma atualização bem-sucedida retorna o código de resposta 201 created e o 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 
}

Criar um destino de cookie: Chave única, não serializada

Um método POST que permite criar um cookie destination que aceita segmentos compostos de pares de valores chave únicos (por exemplo, gender=male ou gender=female).

Solicitação

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

Solicitação de exemplo

Todos os valores de solicitação são obrigatórios, a menos que indicado de outra forma.

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

Resposta

Uma atualização bem-sucedida retorna o código de resposta 201 created e o 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
} 

Criar um destino de cookie: Chave Única, Serializada

Um método POST que permite criar um destino que aceita vários valores associados a uma única chave (por exemplo, color=blue, red, green).

Solicitação

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

Solicitação de exemplo

Todos os valores de solicitação são obrigatórios, a menos que indicado de outra forma.

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

Resposta

Uma atualização bem-sucedida retorna o código de resposta 201 created e o 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
}

Criar um destino de cookie: Múltiplas Chave, Não Serializada

Um método POST que permite criar um destino que aceita segmentos que contêm várias chaves com valores diferentes (por exemplo, gender=male; gender=female; color=blue; color=red).

Solicitação

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

Solicitação de exemplo

Todos os valores de solicitação são obrigatórios, a menos que indicado de outra forma.

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

Resposta

Uma atualização bem-sucedida retorna o código de resposta 201 created e o 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 
}

Criar um destino de cookie: Multi-Chave, Serializada

Um método POST que permite criar um destino que aceita segmentos que contêm várias chaves e valores (por exemplo, gender=male, female; color=blue, red, green).

Solicitação

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

Solicitação de exemplo

Todos os valores de solicitação são obrigatórios, a menos que indicado de outra forma.

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

Resposta

Uma atualização bem-sucedida retorna o código de resposta 201 created e o 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 
}