セグメントの宛先へのマッピング map-segments-to-a-destination
これらの RESTful API メソッドを使用して、セグメントを宛先にマッピングします。
サポートされている宛先のタイプ:URL および Cookie のみ
利用可能な POST
メソッドは、URL および cookie destinationsにのみセグメントをマッピングできます。現在、これらの REST API メソッドを使用して、server-to-server destinationsにセグメントをマッピングすることはできません。代わりにユーザーインターフェイスを使用してください。ただし、宛先の関連 GET
メソッドでは、ユーザーインターフェイスで作成されたserver-to-server destinationsの情報を取得できます。
シリアル化されていない URL ベースの宛先へのセグメントのマッピング map-segment-non-serial
シリアル化されていない URL 宛先にセグメントをマッピングするための POST
メソッド。
リクエスト
POST https://api.demdex.com/v1/destinations/
<destinationId>
/mappings/
リクエストのサンプル
特に指示のない限り、すべてのリクエスト値が必須です。
{
"sid":87723,
"traitType":"SEGMENT",
"url":"https://adobe.com",
"startDate":"2012-07-04"
}
応答
{
"mappingId":65334,
"traitType":"SEGMENT",
"traitValue":0,
"destinationId":4033,
"elementName":"Sample games",
"elementDescription":"Sample games pixel",
"elementStatus":"active",
"createTime":1338940094000,
"updateTime":1338940094000,
"crUID":694,
"upUID":694,
"sid":87723,
"startDate":"2012-07-03",
"endDate":null,
"priority":null,
"url":"https://adobe.com",
"secureUrl":null,
"tagCode":null,
"secureTagCode":null,
"traitAlias":null
}
シリアル化された URL ベースの宛先へのセグメントのマッピング map-segment-serial
シリアル化された POST
宛先にセグメントをマッピングするための URL メソッド。
リクエスト
POST https://api.demdex.com/v1/destinations/
<dataOrderId>
/traits/
リクエストのサンプル
このリクエストでは、traitAlias
はキーと値のペアのキーに対応します。特に指示のない限り、すべてのリクエスト値が必須です。
{
"sid":87723,
"traitType":"SEGMENT",
"startDate":"2012-07-04",
"traitAlias":"123"
}
応答
{
"mappingId":65335,
"traitType":"SEGMENT",
"traitValue":0,
"destinationId":4034,
"elementName":"Sample Games",
"elementDescription":"Migration of Sample Games Pixel",
"elementStatus":"active",
"createTime":1338940401000,
"updateTime":1338940401000,
"crUID":694,
"upUID":694,
"sid":87723,
"startDate":"2012-07-03",
"endDate":null,
"priority":null,
"url":"123",
"secureUrl":"123",
"tagCode":null,
"secureTagCode":null,
"traitAlias":"123"
}
Cookie ベースの宛先へのセグメントのマッピング:単一キー、非シリアル化 map-segment-cookie-noserial
単一キーでシリアル化されていない cookie 宛先にセグメントをマッピングするための POST
メソッド。
リクエスト
POST https://api.demdex.com/v1/destinations/
<destinationId>
/mappings/
リクエストのサンプル
このリクエストでは、valueAlias
はキーと値のペアの値に対応します。特に指示のない限り、すべてのリクエスト値が必須です。
{
"sid":87723,
"traitType":"SEGMENT",
"startDate":"2012-07-04",
"valueAlias":"123"
}
応答
{
"destinationMappingId":65336,
"traitType":"SEGMENT",
"traitValue":0,
"destinationId":4035,
"elementName":"Sample Games",
"elementDescription":"Migration of Sample Games Pixel",
"elementStatus":"active",
"createTime":1338940704000,
"updateTime":1338940704000,
"crUID":694,
"upUID":694,
"sid":87723,
"startDate":"2012-07-03",
"endDate":null,
"priority":1,
"traitAlias":null,
"valueAlias":"123"
}
Cookie ベースの宛先へのセグメントのマッピング:複数キー、非シリアル化 map-segment-cookie-multi-noserial
複数キーのシリアル化されていない cookie の宛先にセグメントをマッピングするための POST
メソッドをを使用します。
リクエスト
POST https://api.demdex.com/v1/destinations/
<destinationId>
/mappings/
リクエストのサンプル
このリクエストでは、traitAlias
と valueAlias
はキーと値のペアのキーと値をそれぞれ設定します。特に指示のない限り、すべてのリクエスト値が必須です。
{
"sid":87723,
"traitType":"SEGMENT",
"startDate":"2012-07-04",
"traitAlias":"type",
"valueAlias":"123"
}
応答
{
"mappingId":65338,
"traitType":"SEGMENT",
"traitValue":0,
"destinationId":4037,
"elementName":"Sample Games",
"elementDescription":"Migration of Sample Games Pixel",
"elementStatus":"active",
"createTime":1338941092000,
"updateTime":1338941092000,
"crUID":694,
"upUID":694,
"sid":87723,
"startDate":"2012-07-03",
"endDate":null,
"priority":1,
"traitAlias":"type",
"valueAlias":"123"
}
Cookie ベースの宛先へのセグメントのマッピング:複数キー、シリアル化 map-segment-cookie-multi-serial
複数キーのシリアル化された cookie destinationにセグメントをマッピングするための POST
メソッド。
リクエスト
POST https://api.demdex.com/v1/destinations/
<destinationId>
/mappings/
リクエストのサンプル
このリクエストでは、traitAlias
と valueAlias
はキーと値のペアのキーと値を設定します。特に指示のない限り、すべてのリクエスト値が必須です。
{
"sid":87723,
"traitType":"SEGMENT",
"startDate":"2012-07-04",
"traitAlias":"type",
"valueAlias":"123"
}
応答
{
"destinationMappingId":65340,
"traitType":"SEGMENT",
"traitValue":0,
"destinationId":4038,
"elementName":"Sample Games",
"elementDescription":"Migration of Sample Games Pixel",
"elementStatus":"active",
"createTime":1338941273000,
"updateTime":1338941273000,
"crUID":694,
"upUID":694,
"sid":87723,
"startDate":"2012-07-03",
"endDate":null,
"priority":2,
"traitAlias":"type",
"valueAlias":"123"
}
サーバー間宛先へのセグメントのマッピング map-segment-s2s
既存のserver-to-server宛先にセグメントをマッピングするための POST
メソッド。現在利用可能なこれらの API メソッドを使用して server-to-server を作成することはできません。
リクエスト
POST https://api.demdex.com/v1/destinations/
<destinationId>
/mappings/
リクエストのサンプル
このリクエストでは、traitAlias
はキーと値のペアのキーに対応します。特に指示のない限り、すべてのリクエスト値が必須です。
{
"sid":87723,
"traitType":"SEGMENT",
"startDate":"2012-07-04",
"traitAlias":"123"
}
応答
{
"destinationMappingId":65341,
"traitType":"SEGMENT",
"traitValue":0,
"destinationId":566,
"elementName":"Sample",
"elementDescription":"",
"elementStatus":"active",
"createTime":1338942118000,
"updateTime":1338942118000,
"crUID":308,
"upUID":308,
"sid":84326,
"startDate":"2012-07-03",
"endDate":null,
"priority":null,
"traitAlias":"123"
}
宛先マッピングの一括作成 bulk-create
cookie または URL 宛先マッピングの配列を渡す POST
メソッド
リクエスト
POST https://api.demdex.com/v1/destinations/
<destinationId>
/bulk-create
リクエストのサンプル
特に指示のない限り、すべてのリクエスト値が必須です。
[
{
"sid": 105123,
"traitType":"SEGMENT",
"url":"https://adobe.com",
"startDate":"2012-11-20"
},
{
"sid": 121070,
"traitType":"SEGMENT",
"url":"https://my.adobeconnect.com",
"startDate":"2012-11-21"
}
]
応答
レスポンスが正常に処理されると、作成されたマッピングの配列が返されます。
[
{
"mappingId": 103454,
"traitType": "SEGMENT",
"traitValue": 0,
"destinationId": 780,
"elementName": "Case of the Mondays",
"elementDescription": "test",
"elementStatus": "active",
"createTime": 1353373234000,
"updateTime": 1353373234000,
"crUID": 1065,
"upUID": 1065,
"sid": 105123,
"startDate": "2012-11-19",
"endDate": null,
"priority": null,
"url": "https://adobe.com",
"secureUrl": null,
"tagCode": null,
"secureTagCode": null,
"traitAlias": null
},
{
"mappingId": 103455,
"traitType": "SEGMENT",
"traitValue": 0,
"orderId": 780,
"elementName": "Test Trait",
"elementDescription": "This trait",
"elementStatus": 1,
"createTime": 1353373234000,
"updateTime": 1353373234000,
"crUID": 1065,
"upUID": 1065,
"sid": 121070,
"startDate": "2012-11-20",
"endDate": null,
"priority": null,
"url": "https://my.adobeconnect.com",
"secureUrl": null,
"tagCode": null,
"secureTagCode": null,
"traitAlias": null
}
]
宛先への複数のセグメントの追加 add-segments-dest
宛先に複数のセグメントをマッピングできる POST
メソッド。
リクエスト
POST https://api.demdex.com/v1/destinations/
<destinationId>
bulk-create
リクエストのサンプル
複数の宛先マッピングを配列で作成します。特に指示のない限り、すべてのリクエスト値が必須です。
[
{
"sid": 105123,
"traitType":"SEGMENT",
"url":"https://adobe.com",
"startDate":"2012-11-20"
},
{
"sid": 121070,
"traitType":"SEGMENT",
"url":"https://my.adobeconnect.com",
"startDate":"2012-11-21"
}
]
応答
作成されたマッピングの配列を返します。
[
{
"destinationMappingId": 103454,
"traitType": "SEGMENT",
"traitValue": 0,
"destinationId": 780,
"elementName": "Case of the Mondays",
"elementDescription": "test",
"elementStatus": "active",
"createTime": 1353373234000,
"updateTime": 1353373234000,
"crUID": 1065,
"upUID": 1065,
"sid": 105123,
"startDate": "2012-11-19",
"endDate": null,
"priority": null,
"url": "https://adobe.com",
"secureUrl": null,
"tagCode": null,
"secureTagCode": null,
"traitAlias": null
},
{
"traitToDataOrderId": 103455,
"traitType": "SEGMENT",
"traitValue": 0,
"destinationId": 780,
"elementName": "Test Trait",
"elementDescription": "This trait",
"elementStatus": 1,
"createTime": 1353373234000,
"updateTime": 1353373234000,
"crUID": 1065,
"upUID": 1065,
"sid": 121070,
"startDate": "2012-11-20",
"endDate": null,
"priority": null,
"url": "https://my.adobeconnect.com",
"secureUrl": null,
"tagCode": null,
"secureTagCode": null,
"traitAlias": null
}
]
宛先 ID による宛先の更新 update-dest-data-order
destinationId
で既存の宛先を更新できる PUT
メソッド。
リクエスト
PUT https://api.demdex.com/v1/destinations/
<destinationId>
リクエストのサンプル
特に指示のない限り、すべてのリクエスト値が必須です。
{
"name":"Updated URL Destination (not serialized)",
"description":"new description",
"destinationType":"PUSH",
"serializationEnabled":false
}
応答
{
"destinationType": "PUSH",
"destinationId": 780,
"dataSourceId": null,
"pid": 1099,
"name": "Updated URL Destination (not serialized)",
"description": "new description",
"startDate": null,
"endDate": null,
"status": 1,
"createTime": 1348851790000,
"updateTime": 1353372029000,
"crUID": 884,
"upUID": 1065,
"domainRestrictions":"all_domains",
"tagType": 0,
"serializationEnabled": false,
"urlFormatString": null,
"secureUrlFormatString": null,
"delimiter": null,
"mappings": null
}
マッピング ID による宛先へのマッピングの更新 update-mapping-dest-id
指定した PUT
で宛先へのマッピングを更新できる mappingId
メソッド。
リクエスト
PUT https://api.demdex.com/v1/destinations/mappings/
<mappingId>
リクエストのサンプル
特に指示のない限り、すべてのリクエスト値が必須です。
{
"sid": 105123,
"traitType":"SEGMENT",
"url":"https://adobe.com",
"startDate":"2012-11-20"
}
応答
{
"mappingId": 103453,
"traitType": "SEGMENT",
"traitValue": 0,
"destinationId": 780,
"elementName": "sample",
"elementDescription": "test",
"elementStatus": "active",
"createTime": 1353373005000,
"updateTime": 1353373005000,
"crUID": 1065,
"upUID": 1065,
"sid": 105123,
"startDate": "2012-11-19",
"endDate": null,
"priority": null,
"url": "https://www.adobe.com/send?%ALIAS%",
"secureUrl": null,
"tagCode": null,
"secureTagCode": null,
"traitAlias": null
}
* [宛先のシリアル化](https://experienceleague.adobe.com/docs/audience-manager/user-guide/features/destinations/destinations-reference/key-value-pairs.html?lang=ja#destination-serialized) * [キーと値のペアの解説 ](https://experienceleague.adobe.com/docs/audience-manager/user-guide/reference/key-value-pairs-explained.html?lang=ja)