文档 Audience Manager Audience Manager 用户指南

创建目标 create-destinations

Last update: Sat May 20 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
API

使用這些專案建立目的地 RESTful API 方法。

支援的目的地型別：僅限URL和Cookie

可用的 POST 方法可讓您建立 URL 和 cookie destinations 僅限。目前，您無法建立 server-to-server destinations 包含這些 REST API 方法。不過，相關目的地 GET 方法可讓您擷取關於 server-to-server destinations 已在使用者介面中建立。

建立非序列URL目的地 create-nonserial-dest

A POST 可讓您建立接受由單一索引鍵/值組所組成區段的目標的方法(例如 gender=male 或 gender=female)。

请求

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

示例请求

此請求會建立單一目的地。除非另有指示，否則所有要求值都是必要的。

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

响应

成功傳回要求 201 created 和目的地。

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

建立序列化URL目的地 create-serial-url-dest

A POST 可讓您建立接受與單一索引鍵相關聯之多個值的目的地的方法(例如 color=blue, red, green)。

请求

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

示例请求

指定secure URL 和分隔字元，用於傳入目的地的機碼值組。除非另有指示，否則所有要求值都是必要的。

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

响应

成功更新會傳回回應代碼 201 created 和目的地。

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

A POST 可讓您建立 cookie destination 接受由單一機碼值組組成的區段(例如， gender=male 或 gender=female)。

请求

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

示例请求

除非另有指示，否則所有要求值都是必要的。

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

响应

成功更新會傳回回應代碼 201 created 和目的地。

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

A POST 可讓您建立接受與單一索引鍵相關聯之多個值的目的地的方法(例如 color=blue, red, green)。

请求

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

示例请求

除非另有指示，否則所有要求值都是必要的。

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

响应

成功更新會傳回回應代碼 201 created 和目的地。

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

A POST 方法可讓您建立目的地，以接受包含具有不同值的多個索引鍵的區段(例如 gender=male; gender=female; color=blue; color=red)。

请求

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

示例请求

除非另有指示，否則所有要求值都是必要的。

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

响应

成功更新會傳回回應代碼 201 created 和目的地。

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

A POST 方法，可讓您建立可接受包含多個索引鍵和值的區段的目的地(例如 gender=male, female; color=blue, red, green)。

请求

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

示例请求

除非另有指示，否則所有要求值都是必要的。

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

响应

成功更新會傳回回應代碼 201 created 和目的地。

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

recommendation-more-help

de293fbf-b489-49b0-8daa-51ed303af695

创建目标 create-destinations

支援的目的地型別：僅限URL和Cookie

建立非序列URL目的地 create-nonserial-dest

请求

示例请求

响应

建立序列化URL目的地 create-serial-url-dest

请求

示例请求

响应

建立Cookie目的地：單一金鑰、非序列化 create-cookie-dest-single

请求

示例请求

响应

建立Cookie目的地：單一金鑰，序列化 create-cookie-dest-single-serial

请求

示例请求

响应

建立Cookie目的地：多索引鍵，非序列化 create-cookie-dest-multi

请求

示例请求

响应

建立Cookie目的地：多索引鍵，序列化 create-cookie-dest-multi-serial

请求

示例请求

响应