설명서 Audience Manager Audience Manager 사용 안내서

대상 만들기 create-destinations

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
API

이 RESTful API 메서드로 대상을 만듭니다.

지원되는 대상 유형: URL 및 쿠키만

사용 가능한 POST 메서드를 사용하면 URL 및 cookie destinations만 만들 수 있습니다. 현재 이 REST API 메서드로 server-to-server destinations을(를) 만들 수 없습니다. 그러나 관련 대상 GET 메서드를 사용하면 사용자 인터페이스에서 만든 server-to-server destinations에 대한 정보를 검색할 수 있습니다.

비-직렬 URL 대상 만들기 create-nonserial-dest

단일 키-값 쌍(예: gender=male 또는 gender=female)으로 구성된 세그먼트를 받는 대상을 만들 수 있는 POST 메서드입니다.

요청

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

단일 키와 연결된 여러 값을 받는 대상을 만들 수 있는 POST 메서드입니다(예: color=blue, red, green).

요청

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

샘플 요청

대상에 전달된 키-값 쌍의 보안 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
}

단일 키-값 쌍(예: gender=male 또는 gender=female)으로 구성된 세그먼트를 받는 cookie destination을(를) 만들 수 있는 POST 메서드입니다.

요청

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
}

단일 키와 연결된 여러 값을 받는 대상을 만들 수 있는 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
}

값이 다른 여러 키(예: gender=male; gender=female; color=blue; color=red)가 포함된 세그먼트를 허용하는 대상을 만들 수 있는 POST 메서드입니다.

요청

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
}

여러 키와 값이 포함된 세그먼트를 허용하는 대상을 만들 수 있는 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 및 쿠키만

비-직렬 URL 대상 만들기 create-nonserial-dest

요청

샘플 요청

응답

직렬화된 URL 대상 만들기 create-serial-url-dest

요청

샘플 요청

응답

쿠키 대상 만들기: 단일 키, 직렬화되지 않음 create-cookie-dest-single

요청

샘플 요청

응답

쿠키 대상 만들기: 단일 키, 직렬화됨 create-cookie-dest-single-serial

요청

샘플 요청

응답

쿠키 대상 만들기: 다중 키, 직렬화되지 않음 create-cookie-dest-multi

요청

샘플 요청

응답

쿠키 대상 만들기: 다중 키, 직렬화됨 create-cookie-dest-multi-serial

요청

샘플 요청

응답