セグメントの宛先へのマッピング

これらの RESTful API メソッドを使用して、セグメントを宛先にマッピングします。

利用可能な POST メソッドは、URL および cookie destinationsにのみセグメントをマッピングできます。現在、これらの REST API メソッドを使用して、server-to-server destinationsにセグメントをマッピングすることはできません。代わりにユーザーインターフェイスを使用してください。ただし、宛先の関連 GET メソッドでは、ユーザーインターフェイスで作成されたserver-to-server destinationsの情報を取得できます。

シリアル化されていない URL ベースの宛先へのセグメントのマッピング

シリアル化されていない 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 ベースの宛先へのセグメントのマッピング

シリアル化された 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 宛先にセグメントをマッピングするための 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 の宛先にセグメントをマッピングするための POST メソッドをを使用します。

リクエスト

POST https://api.demdex.com/v1/destinations/<destinationId>/mappings/

リクエストのサンプル

このリクエストでは、traitAliasvalueAlias はキーと値のペアのキーと値をそれぞれ設定します。特に指示のない限り、すべてのリクエスト値が必須です。

{
   "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 destinationにセグメントをマッピングするための POST メソッド。

リクエスト

POST https://api.demdex.com/v1/destinations/<destinationId>/mappings/

リクエストのサンプル

このリクエストでは、traitAliasvalueAlias はキーと値のペアのキーと値を設定します。特に指示のない限り、すべてのリクエスト値が必須です。

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

サーバー間宛先へのセグメントのマッピング

既存の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"
}

宛先マッピングの一括作成

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
    }
]

宛先への複数のセグメントの追加

宛先に複数のセグメントをマッピングできる 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 による宛先の更新

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 による宛先へのマッピングの更新

指定した 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
}

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now