將區段對應至目的地

使用這些RESTful API方法將區段對應至目的地。

支援的目的地類型：僅限URL和Cookie

可用的POST方法只允許將區段對應至URL和cookie destinations。目前，您無法使用這些REST API方法將區段對應至server-to-server destinations。請改用使用者介面。不過，相關目標GET方法可讓您擷取有關在使用者介面中建立之server-to-server destinations的資訊。

將區段對應至非序列化URL目的地

POST方法可讓您將區段對應至非序列URL目的地。

請求

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

POST方法可讓您將區段對應至單鍵、非序列化的cookie目的地。

請求

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

POST方法可讓您將區段對應至多鍵、非序列化的cookie目的地。

請求

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

POST方法可讓您將區段對應至多鍵序列化cookie destination。

請求

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

將區段對應至伺服器對伺服器目的地

POST方法可讓您將區段對應至現有的server-to-server目的地。但請注意，您無法使用目前可用的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"
}

批量建立目標映射

POST方法可讓您傳入cookie或URL目標映射的陣列。

請求

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更新目標

PUT方法可讓您透過destinationId更新現有目的地。

請求

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
}

Third Party Integrations Second Party Data Flow Analysis Tag Management Video Analytics Ad Hoc Analysis

將區段對應至目的地

支援的目的地類型：僅限URL和Cookie

將區段對應至非序列化URL目的地

請求

範例要求

回應

將區段對應至序列化URL目的地

請求

範例要求

回應

將區段對應至Cookie目的地：單鍵，非序列化

請求

範例要求

回應

將區段對應至Cookie目的地：多鍵，非序列化

請求

範例要求

回應

將區段對應至Cookie目的地：多鍵，序列化

請求

範例要求

回應

將區段對應至伺服器對伺服器目的地

請求

範例要求

回應

批量建立目標映射

請求

範例要求

回應

將多個區段新增至目標

請求

範例要求

回應

按目標ID更新目標

請求

範例要求

回應

通過映射ID更新到目標的映射

請求

範例要求

回應

Business.Adobe.com 資源

本頁內容

檢視下一個:

學習

說明文件

社群

技術支援

資源

Adobe 帳戶

Adobe