これらの RESTful API メソッドで宛先を作成します。
使用可能な POST
メソッドでは、URL および cookie destinationsのみを作成できます。現在は、REST API メソッドで server-to-server destinations を使用できます。ただし、宛先の関連 GET
メソッドでは、ユーザーインターフェイスで作成されたserver-to-server destinationsの情報を取得できます。
単一のキーと値のペア(例: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
}
単一のキーに関連付けられた複数の値(例: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
}
単一のキーと値のペア(例: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
}
単一のキーに関連付けられた複数の値(例: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
}
異なる値を持つ複数のキー(例: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
}
複数のキーと値(例: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)