宛先の作成

これらの RESTful API メソッドで宛先を作成します。

サポートされている宛先のタイプ：URL および Cookie のみ

使用可能な POST メソッドでは、URL および cookie destinationsのみを作成できます。現在は、REST API メソッドで server-to-server destinations を使用できます。ただし、宛先の関連 GET メソッドでは、ユーザーインターフェイスで作成されたserver-to-server destinationsの情報を取得できます。

非シリアル URL 宛先の作成

単一のキーと値のペア（例：gender=male や gender=female）で構成されるセグメントを受け入れる宛先を作成できる POST メソッド。

リクエスト

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

リクエストのサンプル

このリクエストでは、1 つの宛先を作成します。特に指示のない限り、すべてのリクエスト値が必須です。

{
   "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 宛先の作成

単一のキーに関連付けられた複数の値（例：color=blue, red, green）を受け入れる宛先を作成できる POST メソッド。

リクエスト

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
}

Cookie 宛先の作成：単一のキー、非シリアル化

単一のキーと値のペア（例：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
}

Cookie 宛先の作成：単一のキー、シリアル化

単一のキーに関連付けられた複数の値（例：color=blue, red, green）を受け入れる宛先を作成できる POST メソッド。

リクエスト

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
}

Cookie 宛先の作成：複数キー、非シリアル化

異なる値を持つ複数のキー（例：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
}

Cookie 宛先の作成：複数キー、シリアル化

複数のキーと値（例：gender=male, female; color=blue, red, green）を含むセグメントを受け入れる宛先を作成できる POST メソッド。

リクエスト

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
}

* [宛先のシリアル化](/docs/audience-manager/user-guide/features/destinations/destinations-reference/key-value-pairs.html?lang=ja#destination-serialized) * [キーと値のペアの解説 ](/docs/audience-manager/user-guide/reference/key-value-pairs-explained.html?lang=ja)