Show Menu
화제×

대상에 세그먼트 매핑

이러한 방법으로 세그먼트를 대상에 RESTful API 매핑합니다.

지원되는 대상 유형: URL 및 쿠키만

사용 가능한 POST 방법을 사용하여 세그먼트를 URL 및 cookie destinations 만 매핑할 수 있습니다. 현재, 세그먼트를 이러한 방법 server-to-server destinations 으로 매핑할 수 REST API 없습니다. 사용자 인터페이스를 대신 사용하십시오. 하지만 관련 대상 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 server-to-server 방법입니다. 그러나 현재 사용 가능한 이러한 방법으로 server-to-server 대상을 만들 수는 API 없습니다.

요청

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

Update a Destination by Destination 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
}